从Jenkins调用Docker容器遇套接字权限拒绝问题求助

我来帮你搞定这个Docker权限问题！首先得明确：在macOS上，Docker Desktop的运行机制和Linux不一样，/var/run/docker.sock其实是个软链接到Docker Desktop容器内部的路径，本地的系统组权限（比如daemon组）根本管不到它——这就是你加jenkins用户到daemon组没用的核心原因。

核心问题分析 #

macOS上Docker默认只给当前登录的桌面用户授权访问Docker daemon，而Jenkins默认是用jenkins系统用户运行的，这个用户不在Docker的授权列表里，自然连不上docker.sock。

解决方案（推荐第一种，最安全） #

方案1：修改Jenkins运行用户为你的桌面用户

因为你的桌面用户已经有Docker访问权限，让Jenkins用这个用户运行就能直接解决问题：

1. 停止Jenkins服务：

   sudo launchctl unload /Library/LaunchDaemons/org.jenkins-ci.plist
   

2. 编辑Jenkins的启动配置文件：

   sudo nano /Library/LaunchDaemons/org.jenkins-ci.plist
   

3. 找到<key>UserName</key>这一行，把后面的<string>jenkins</string>改成你的桌面用户名（比如你的例子里是pmaugeri）：

   <key>UserName</key>
   <string>pmaugeri</string>
   

4. 保存并退出（按Ctrl+O，回车，再Ctrl+X）。
5. 修复Jenkins目录的权限，避免后续报错：

   sudo chown -R pmaugeri:pmaugeri /Users/Shared/Jenkins
   

6. 重新启动Jenkins服务：

   sudo launchctl load /Library/LaunchDaemons/org.jenkins-ci.plist
   

7. 重启后，在Jenkins流水线里再次运行whoami，应该会输出你的用户名（pmaugeri），此时docker run命令就能正常执行了。

方案2：给jenkins用户配置sudo免密运行docker（不推荐，有安全风险）

如果不想修改Jenkins运行用户，可以让jenkins用户免密用sudo执行docker命令：

1. 编辑sudoers文件：

   sudo visudo
   

2. 在文件末尾添加一行：

   jenkins ALL=(ALL) NOPASSWD: /usr/local/bin/docker
   

3. 保存退出（按Esc，输入:wq回车）。
4. 修改你的Jenkins流水线，把docker命令加上sudo：

   node {
       sh 'whoami'
       sh 'sudo docker run -d --mount source=devops-lab,target=/root/data pmaugeri/alpine-akamai-cli'
       // 或者用Docker Pipeline插件的话：
       docker.image('pmaugeri/alpine-akamai-cli').withRun('--mount source=devops-lab,target=/root/data', '', 'sudo') { }
   }
   

   注意：这种方法会给jenkins用户无限制的sudo权限执行docker，有一定安全隐患，只适合测试环境。

为什么之前加daemon组没用？ #

你看到的/var/run/docker.sock是软链接，实际指向的是/Users/pmaugeri/Library/Containers/com.docker.docker/Data/s60——这个路径属于Docker Desktop的容器内部，本地的系统组权限对它完全无效。macOS上Docker的权限控制是通过桌面用户的授权来实现的，和Linux的docker组机制不一样。

内容的提问来源于stack exchange，提问作者pmaugeri