让非root用户构建Docker镜像的三种方法

 更新时间:2025年04月18日 10:31:57   作者:代码怪兽大作战  
在默认情况下,Docker 需要 root 权限或 sudo 才能运行,这对于日常开发和 CI/CD 流水线可能不够方便,那么,如何让 非 root 用户 也能构建和运行 Docker 容器呢?本篇文章将介绍 三种方法 来实现这一目标,需要的朋友可以参考下

前言

在默认情况下,Docker 需要 root 权限或 sudo 才能运行。这对于日常开发和 CI/CD 流水线可能不够方便,也可能带来安全隐患。那么,如何让 非 root 用户 也能构建和运行 Docker 容器呢?

本篇文章将介绍 三种方法 来实现这一目标,并推荐最佳实践。

方法 1:将用户加入 Docker 组(推荐)

Docker 允许 docker 组的用户运行 Docker 命令,因此最简单的方法是将你的用户加入 docker 组。

  • 创建 Docker 组(如果不存在)
sudo groupadd docker
  • 将用户加入 Docker 组
sudo usermod -aG docker $USER
  • 如果你要添加其他用户,替换 $USER 为具体的用户名:
sudo usermod -aG docker your-username
  • 重新登录使权限生效

执行以下命令让组权限立即生效,或者注销并重新登录:

newgrp docker
  • 测试是否生效
docker ps

如果能正确输出 Docker 运行中的容器列表,而 不需要 sudo,则说明配置成功。

方法 2:使用 sudo 运行 Docker(不推荐)

如果你不想修改用户组,可以在每次执行 Docker 命令时使用 sudo

sudo docker build -t myimage .

但这样使用起来不方便,并且某些 CI/CD 或自动化脚本可能不兼容 sudo,所以 不推荐 这种方式。

方法 3:使用 Docker Rootless 模式

Docker 提供了 Rootless Mode(无特权模式),允许普通用户运行 Docker 容器,而无需 root 权限。

  • 安装 Rootless Docker
curl -fsSL https://get.docker.com/rootless | sh
  • 设置环境变量

安装完成后,执行以下命令来配置环境变量:

export PATH=$HOME/bin:$PATH
export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/docker.sock

让这些配置永久生效:

echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
echo 'export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/docker.sock' >> ~/.bashrc
source ~/.bashrc
  • 启动 Rootless Docker
systemctl --user start docker

Rootless 模式适用于不允许修改系统用户组的环境,比如某些企业级服务器。

总结

方法适用场景推荐级
添加用户到 docker 组适用于大多数情况,安全且便捷⭐⭐⭐⭐⭐(推荐)
使用 sudo 运行 Docker适用于临时使用,但不够方便⭐⭐⭐(不推荐)
Docker Rootless 模式适用于不能修改用户组的环境⭐⭐⭐⭐

最佳实践

如果你的服务器上有多个开发人员共用 Docker,建议使用 docker 组方式,这样既安全又方便。

你可以使用以下命令快速完成设置:

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
docker ps  # 测试是否生效

如果 docker ps 仍然报错,尝试 重新登录系统 或 重启 Docker

sudo systemctl restart docker

这样,你的非 root 用户就可以 直接运行 Docker 并构建镜像 了!

到此这篇关于让非root用户构建Docker镜像的三种方法的文章就介绍到这了,更多相关非root用户构建Docker镜像内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Docker部署SpringBoot项目,本地运行正常,部署至服务器报错zip file closed问题

    Docker部署SpringBoot项目,本地运行正常,部署至服务器报错zip file close

    这篇文章主要介绍了Docker部署SpringBoot项目,本地运行正常,部署至服务器报错zip file closed问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-06-06
  • 利用宝塔面板和docker快速部署网站的基本流程

    利用宝塔面板和docker快速部署网站的基本流程

    当你有了一台服务器,就会折腾往这台服务器上部署各种好玩的网站,本文将以部署filebrowser举例介绍网站部署的基本流程,感兴趣的朋友一起看看吧
    2023-12-12
  • 在docker容器中运行flask应用过程

    在docker容器中运行flask应用过程

    这篇文章主要介绍了在docker容器中运行flask应用过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-06-06
  • 如何修改Docker部署gitlab的外部访问地址和端口

    如何修改Docker部署gitlab的外部访问地址和端口

    这篇文章主要介绍了如何修改Docker部署gitlab的外部访问地址和端口问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-05-05
  • 解决Docker x509 insecure registry的问题

    解决Docker x509 insecure registry的问题

    这篇文章主要介绍了解决Docker x509 insecure registry的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-03-03
  • Docker 实用技巧总结

    Docker 实用技巧总结

    这篇文章主要介绍了Docker 实用技巧总结的相关资料,需要的朋友可以参考下
    2016-10-10
  • Docker 教程之镜像列出详细介绍

    Docker 教程之镜像列出详细介绍

    这篇文章主要介绍了Docker 教程之镜像列出详细介绍的相关资料,需要的朋友可以参考下
    2016-12-12
  • 在Dockerfile中copy和add的区别及说明

    在Dockerfile中copy和add的区别及说明

    COPY和ADD都是Dockerfile中用于文件复制的命令,但COPY仅用于本地文件或目录的复制,不支持自动解压缩;而ADD除了复制本地文件或目录外,还支持解压缩和从URL下载文件,在一般情况下,建议使用COPY命令
    2025-03-03
  • Docker使用run命令部署MySQL的流程步骤

    Docker使用run命令部署MySQL的流程步骤

    容器化技术为数据库部署带来了革命性的变化,MySQL作为最流行的开源关系型数据库之一,结合Docker容器可以实现快速部署、环境隔离和便捷管理,本文给大家介绍了Docker使用run命令部署MySQL的流程步骤,需要的朋友可以参考下
    2025-03-03
  • Docker Stack 部署web集群的方法步骤

    Docker Stack 部署web集群的方法步骤

    这篇文章主要介绍了Docker Stack 部署web集群的方法步骤,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-02-02

最新评论