docker-py无法识别普通用户运行的Podman容器，原因及合规性疑问

问题根源：和Podman用户命名空间机制直接相关 #

Podman的核心特性之一就是用户命名空间隔离：

• root用户运行容器时，使用系统级的Podman运行环境，对应socket路径为/run/podman/podman.sock
• 普通用户运行容器时，Podman会为该用户创建专属的存储、运行时环境，对应的socket路径是$XDG_RUNTIME_DIR/podman/podman.sock（通常为/run/user/[你的UID]/podman/podman.sock）

你用docker.from_env()创建客户端时，默认会读取系统默认的Docker/Podman socket路径（即root用户的socket），因此只能识别root用户创建的容器，看不到普通用户的容器。

使用docker-py对接Podman算不算不良实践？ #

不算，但并非最优选择：

• Podman官方兼容Docker API，因此用docker-py这类Docker客户端工具操作Podman是被允许的，简单场景下可以正常工作。
• 但如果是长期维护的项目，更推荐使用Podman官方提供的podman Python库——它专门针对Podman的特性（如用户隔离、无守护进程模式、Pod支持等）设计，适配性更好，也能避免这类路径适配问题。

解决方法 #

方法1：给docker-py指定普通用户的Podman socket路径 #

手动指定当前用户的Podman socket地址，让docker-py连接到正确的运行环境：

import docker
import os

# 获取当前用户的UID，拼接对应的Podman socket路径
user_uid = os.getuid()
podman_socket = f"/run/user/{user_uid}/podman/podman.sock"

client = docker.DockerClient(base_url=f'unix://{podman_socket}')
containers = client.containers.list(all=True)
print(f"containers are: {len(containers)}")

方法2：改用Podman官方Python库 #

先安装官方库：

pip install podman

编写代码时，它会自动识别当前用户的Podman环境，无需手动指定socket路径：

from podman import PodmanClient

with PodmanClient() as client:
    containers = client.containers.list(all=True)
    print(f"containers are: {len(containers)}")

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