Docker”Got permission denied while trying to connect to the Docker daemon socket”错误的解决方法【2026年最新版】
在开始使用Docker时，最常遇到的错误之一就是”Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock”。本文将针对2026年最新环境，详细介绍该错误的原因和具体解决方法。这是所有在Linux（Ubuntu、CentOS、Debian等）上使用Docker的用户必读的内容。
这个错误是什么？会出现哪些症状
安装Docker后，或在Linux服务器上执行 docker 命令时，你可能会看到以下错误信息：
docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post "http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/create": dial unix /var/run/docker.sock: connect: permission denied.
这个错误几乎会在所有Docker命令中出现，包括 docker ps、docker run、docker-compose up 等。具体来说，你可能会遇到以下症状：
docker run hello-world失败：安装Docker后进行验证时最先遇到的情况docker ps无法显示容器列表：即使有正在运行的容器，也因权限错误而无法查看docker-compose up无法启动：使用Docker Compose的多容器应用无法正常启动- CI/CD流水线失败：Jenkins、GitHub Actions、GitLab CI等中的Docker命令因权限错误而停止
- VS Code的Dev Containers扩展无法连接：远程开发环境中无法连接到Docker
当此错误发生时，Docker的所有功能都将无法使用，导致开发工作完全停滞。对于初次使用Docker的用户来说，这是一个非常令人困惑的错误。
该错误发生的原因
原因1：当前用户不在docker组中
这是最常见的原因。Docker守护进程默认使用Unix套接字（/var/run/docker.sock）进行通信，而该套接字由root（管理员）用户拥有。普通用户要执行Docker命令，需要属于 docker 组。仅安装Docker并不会自动将当前用户添加到该组，因此会出现权限错误。
# 检查套接字权限
ls -la /var/run/docker.sock
# 输出示例：srw-rw---- 1 root docker 0 Feb 12 10:00 /var/run/docker.sock
原因2：更改组后未重新登录
执行 sudo usermod -aG docker $USER 将用户添加到docker组后，没有注销并重新登录。在Linux中，组成员资格的变更在启动新会话（登录）之前不会生效。这是一个非常常见的疏忽，”已经执行了命令但还是不行”这样的问题在Stack Overflow和Reddit上频繁出现。
原因3：Docker守护进程未运行
当Docker服务本身已停止时，也会出现类似的错误。这种情况发生在服务器重启后Docker未设置自动启动，或Docker安装不完整时。
# 检查Docker服务状态
sudo systemctl status docker
原因4：/var/run/docker.sock的权限被错误修改
当套接字文件的权限被手动更改，或被安全工具重置时会发生此问题。套接字应该是 srw-rw----，所有者为 root:docker；如果权限不同，则无法正常连接。
原因5：SELinux或AppArmor的访问限制
在安全增强的Linux发行版（RHEL、CentOS、Fedora等）上，SELinux可能会阻止对Docker套接字的访问。同样，在Ubuntu等系统上，AppArmor也可能成为原因。
解决方法1：将用户添加到docker组（推荐）
这是最安全、最推荐的解决方法，也是Docker官方文档推荐的方案。
步骤1：检查docker组是否存在
首先，确认系统中是否存在docker组。通常在Docker安装时会自动创建，但建议确认一下。
# 检查docker组是否存在
cat /etc/group | grep docker
如果组不存在，使用以下命令创建：
# 创建docker组
sudo groupadd docker
步骤2：将当前用户添加到docker组
使用以下命令将当前登录用户添加到docker组：
# 将当前用户添加到docker组
sudo usermod -aG docker $USER
命令说明：
– usermod：修改用户账户的命令
– -a：追加模式（不从现有组中移除）
– -G docker：指定docker组
– $USER：自动填充当前登录的用户名
如果要添加特定用户，请将 $USER 替换为用户名：
# 添加特定用户的示例
sudo usermod -aG docker username
步骤3：使组变更生效
方法A：注销并重新登录（最可靠）
# SSH连接的情况
exit
# 然后重新通过SSH连接
# 桌面环境的情况
# 注销后重新登录
方法B：使用newgrp命令即时生效（仅当前终端）
# 在当前shell会话中立即启用docker组
newgrp docker
此方法仅对当前终端会话有效。打开新终端时，需要注销并重新登录。
步骤4：验证配置是否正确
# 检查是否属于docker组
groups
# 测试Docker是否正常工作
docker run hello-world
如果显示 Hello from Docker! 消息，则表示配置已正确完成。
注意事项
- 忘记
-a选项（追加）会导致用户”仅”属于docker组，从其他所有组中移除。请务必一起使用-aG - 属于docker组的用户相当于拥有root权限。请只添加受信任的用户
- 在WSL2（Windows Subsystem for Linux）环境中，可能需要重启WSL（
wsl --shutdown）
解决方法2：使用sudo执行Docker命令
这是在无法更改组设置的环境中，或临时使用Docker时的解决办法。
在所有Docker命令前加上 sudo，以root权限执行：
# 使用sudo执行Docker命令
sudo docker run hello-world
sudo docker ps
sudo docker-compose up -d
此方法可以立即执行，但有以下缺点：
- 每次都需要输入
sudo - 在Docker Compose和脚本中的执行变得繁琐
- CI/CD流水线中可能无法使用
sudo - 环境变量和Docker上下文设置使用的是
root用户的设置
长期使用时，强烈建议采用解决方法1中的docker组添加方案。
使用Docker Compose时：
# Docker Compose
sudo docker compose up -d
# 旧版Docker Compose（v1）
sudo docker-compose up -d
解决方法3：使用Docker Rootless模式（高级）
自Docker 20.10起正式支持的Rootless模式，允许以普通用户权限运行Docker守护进程。截至2026年，Docker Engine 27.x系列进一步提升了稳定性，是注重安全的生产环境推荐的方案。
Rootless模式的优点
- 完全不需要root权限
- 显著降低安全风险
- 减少容器内部对主机的入侵风险
安装步骤
首先，安装所需的依赖包：
# Ubuntu/Debian
sudo apt-get install -y uidmap dbus-user-session
# CentOS/RHEL
sudo yum install -y shadow-utils fuse-overlayfs
接下来，运行Rootless模式的设置脚本：
# 停止现有的Docker（rootful）
sudo systemctl disable --now docker.service docker.socket
# 安装Rootless模式
dockerd-rootless-setuptool.sh install
设置环境变量：
# 添加到~/.bashrc或~/.zshrc
export PATH=/usr/bin:$PATH
export DOCKER_HOST=unix:///run/user/$(id -u)/docker.sock
# 应用设置
source ~/.bashrc
# 验证是否正常工作
docker run hello-world
注意事项
- Rootless模式有一些功能限制（绑定特权端口80/443、某些存储驱动等）
- 无法直接使用以root权限创建的镜像和卷
- 网络配置可能与标准模式不同
如何预防此错误
为了避免Docker权限错误，请日常采取以下预防措施。
1. 安装Docker后立即配置组设置
安装Docker后，在执行第一个命令之前完成docker组的添加。将此步骤纳入安装文档或设置脚本中，可以提高每次设置的效率。
# 安装后的设置脚本示例
#!/bin/bash
sudo groupadd docker 2>/dev/null
sudo usermod -aG docker $USER
echo "请注销后重新登录"
2. 使用Ansible或Shell脚本自动化
在自动化团队开发或服务器构建时，将Docker安装和组配置纳入自动化脚本中。
3. 确认CI/CD流水线的权限设置
对于GitHub Actions、GitLab CI、Jenkins等，请提前确认Docker套接字的访问权限是否正确配置。许多CI/CD平台需要专门的Docker使用设置。
4. 定期检查Docker服务状态
# 启用Docker自动启动
sudo systemctl enable docker
# 检查Docker服务状态
sudo systemctl status docker
5. 绝对不要使用chmod 666
你可能在网上看到 chmod 666 /var/run/docker.sock 这种”解决方法”，但从安全角度来看这是极其危险的。它会授予所有用户对Docker守护进程的访问权限，实质上等同于将root权限赋予每个用户。在生产环境中绝对不要使用。
总结
Docker”Got permission denied while trying to connect to the Docker daemon socket”错误是几乎所有开始使用Docker的Linux用户都会遇到的非常常见的错误。但是，只要正确理解其原因和解决方法，就可以在几分钟内解决。
最重要的要点：
– 推荐： 使用 sudo usermod -aG docker $USER 将用户添加到docker组，然后注销并重新登录
– 临时方案： 使用 sudo docker 立即执行命令
– 注重安全： 考虑使用Docker Rootless模式
如果问题仍然存在，请检查以下内容：
1. Docker服务是否正在运行？（sudo systemctl status docker）
2. 套接字文件权限是否正确？（ls -la /var/run/docker.sock）
3. SELinux/AppArmor的设置是否有影响？
如果仍然无法解决，建议在Docker社区论坛或Stack Overflow上附上环境信息（操作系统、Docker版本、完整错误信息）进行提问。
コメント