Ubuntu 22.04下Python Docker SDK连接异常问题求助

核心问题 #

终端能正常执行docker run命令，但Python SDK连不上Docker服务，本质原因是Python进程未获取到Docker的连接路径，或无权限访问Docker套接字。你添加版本号后暂时不报错，是因为跳过了API版本自动检测环节，但实际连接并未建立，所以后续执行容器运行命令时依旧出错。

具体解决步骤 #

1. 手动指定Docker套接字路径 #

先在终端执行以下命令，查看Docker使用的套接字路径：

echo $DOCKER_HOST

• 本地默认路径通常为 unix:///var/run/docker.sock
• 若使用Docker Desktop for Linux，路径可能是 unix:///home/你的用户名/.docker/desktop/docker.sock

将路径手动写入Python代码：

import docker

# 替换为你实际获取到的套接字路径
client = docker.DockerClient(base_url='unix:///var/run/docker.sock')
# 执行ping测试连接有效性
print(client.ping())

2. 修复Docker套接字权限 #

默认情况下，/var/run/docker.sock属于docker用户组，若当前用户不在该组内，Python进程将无权限访问：

# 将当前用户加入docker用户组
sudo usermod -aG docker $USER
# 必须重新登录系统或重启终端，确保权限生效

3. 确保虚拟环境继承终端环境变量 #

使用Poetry或venv时，避免直接在IDE中启动脚本，需先在终端激活虚拟环境，再运行代码——部分IDE不会自动继承终端中的DOCKER_HOST等环境变量。

4. 验证连接状态 #

运行以下代码测试连接是否正常：

import docker

try:
    client = docker.from_env()
    print(f"连接成功！Docker API版本: {client.version()['ApiVersion']}")
except Exception as e:
    print(f"连接失败原因: {str(e)}")

若仍失败，检查套接字文件是否存在及权限：

ls -l /var/run/docker.sock

正常输出应为 srw-rw---- 1 root docker 0 ...，确认你的用户已在docker组内。

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