Jenkins 执行 Docker 构建报 permission denied 通常是因为容器内的 Jenkins 用户没有权限访问宿主机的 Docker 守护进程 socket 文件，或者挂载目录的 UID/GID 不匹配。最推荐的修复方式是将 Jenkins 用户加入 docker 用户组，并修正挂载目录的所有者权限。

命令速用版

以下命令适用于 Linux 宿主机环境，用于快速修复 Jenkins 用户权限和目录所有权。

# 1. 将 jenkins 用户加入 docker 用户组
sudo usermod -aG docker jenkins

# 2. 修正挂载目录所有者为 Jenkins 默认 UID 1000
sudo chown -R 1000:1000 /path/to/jenkins_home

# 3. 修正 docker.sock 权限（临时方案，生产环境慎用）
sudo chmod 666 /var/run/docker.sock

为什么会这样

权限错误的本质是容器内进程 UID 与宿主机文件系统权限不匹配。Jenkins 官方镜像默认使用 UID 1000 运行，而宿主机上的 Docker socket 文件或挂载目录可能属于 root 或其他用户，导致容器内进程被内核拒绝访问。

Docker 容器虽然隔离了环境，但进程仍运行在宿主机内核上。当 Jenkins 容器尝试访问挂载的/var/jenkins_home 目录或/var/run/docker.sock 时，宿主机内核检查该 UID 是否有对应权限。如果宿主机上没有对应 UID 或权限不足，就会抛出 Permission denied。此外，SELinux 安全策略也可能拦截容器对文件的访问。

分步处理

场景一：Jenkins 无法执行 Docker 命令

如果报错信息包含"Got permission denied while trying to connect to the Docker daemon"，说明 Jenkins 用户无权访问 Docker 守护进程。

操作步骤：将宿主机上的 jenkins 用户添加到 docker 用户组，使其有权访问 docker.sock。

# 创建 docker 组（如果不存在）
sudo groupadd docker

# 添加 jenkins 用户到 docker 组
sudo usermod -aG docker jenkins

# 更新组身份（需重启 Jenkins 或重新登录）
newgrp docker

场景二：Jenkins 无法写入挂载目录

如果报错信息涉及"/var/jenkins_home"或"Permission denied"写入日志，说明挂载卷权限不足。

操作步骤：将宿主机上挂载目录的所有者修改为 UID 1000，匹配容器内 Jenkins 用户。

# 假设宿主机挂载目录为/data/jenkins_home
sudo chown -R 1000:1000 /data/jenkins_home

# 确保目录有读写执行权限
sudo chmod -R 755 /data/jenkins_home

场景三：SELinux 拦截

在 CentOS 等开启 SELinux 的系统上，即使权限正确也可能被拦截。

操作步骤：修改挂载目录的 SELinux 上下文或临时关闭 SELinux。

# 修改目录安全上下文
sudo chcon -Rt svirt_sandbox_file_t /data/jenkins_home

# 或临时设置为宽容模式（排查用）
sudo setenforce 0

怎么验证是否生效

验证分为权限检查和服务功能测试两步，确保配置已加载且业务正常。

检查用户组：确认 jenkins 用户已包含在 docker 组中。

id jenkins
# 输出应包含 groups=...,999(docker)

检查 Docker 连接：在 Jenkins 构建任务中执行 Docker 命令。

docker info
# 若无权限报错且显示服务器信息，则修复成功

检查文件写入：观察 Jenkins 日志是否仍有"Permission denied"。

docker logs jenkins
# 无报错且服务正常启动即为生效

常见坑

• 直接 chmod 777 docker.sock 存在安全风险，仅限测试环境使用
• 修改用户组后未重启 Jenkins 服务，导致组权限未生效
• 宿主机目录 UID 与容器内 UID 不一致，导致持续写入失败
• SELinux 未配置规则，即使 chmod 正确也被内核拦截

常见问题

修改用户组后需要重启 Jenkins 吗？

需要重启 Jenkins 服务或重新登录用户才能使组权限生效。

可以直接用 root 用户运行 Jenkins 容器吗？

不推荐，使用 root 运行容器会降低安全性，建议修正 UID 权限。

为什么 chmod 777 不推荐生产使用？

777 权限允许所有用户读写执行，存在严重的安全漏洞风险。

参考来源

• Jenkins+Docker 权限避坑指南：为什么你的/var/jenkins_home 总报 Permission denied?
• Jenkins 执行 Docker 命令报错：Got permission denied while trying to connect to the Docker daemon
• Docker 安装 Jenkins 时权限被拒绝如何解决？
• CentOS Docker Jenkins 启动报错深度解析：从 Permission denied 到权限体系最佳实践
• 解决 Docker 中的 Permission Denied 问题