Podman容器内调用API创建容器失败问题求助

我有一个Podman容器，内部包含Python脚本用于创建指定镜像名和容器名的容器，但容器内运行脚本时失败，容器外相同逻辑的脚本可正常工作。

问题复现 #

mkdir trial
cd trial

touch Dockerfile
touch create_container.py

Python脚本（容器内）：

from podman import PodmanClient
import sys

def create_container(image_name, container_name):
    with PodmanClient() as client:
        try:
            container = client.containers.create(image=image_name, name=container_name)
            container.start()
            print(f"Container '{container_name}' created and started successfully.")
            print(f"Container ID: {container.id}")
        except Exception as e:
            print(f"Error creating container: {e}")
            sys.exit(1)

if __name__ == "__main__":
    if len(sys.argv) != 3:
        sys.exit(1)
    image_name = sys.argv[1]
    container_name = sys.argv[2]
    create_container(image_name, container_name)

Dockerfile：

FROM python:3.8.5-slim-buster
WORKDIR /app

COPY create_container.py .
RUN pip install podman

ENTRYPOINT ["python", "create_container.py"]

运行命令：

podman build -t test
podman run --rm --privileged --network host -v /run/podman/podman.sock:/run/podman/podman.sock test <镜像名称> trial

报错信息：

Error creating container: http://%2Ftmp%2Fpodmanpy-runtime-dir-fallback-root%2Fpodman%2Fpodman.sock/v5.2.0/libpod/containers/create (POST operation failed)

排查与解决步骤 #

1. 强制指定Podman Client的Socket路径

Podman Python库默认会尝试临时socket路径，需硬编码指定宿主机挂载的socket地址，同时确保权限：

• 修改Python脚本：

  with PodmanClient(uri="unix:///run/podman/podman.sock") as client:
  

• 确保容器内用户对socket有读写权限：
  运行容器时添加--user root，或在宿主机调整socket权限：

  sudo chmod 666 /run/podman/podman.sock
  

  （生产环境建议将容器用户加入宿主机podman组，而非开放666权限）

2. 确保宿主机Podman服务持续监听Socket

修改/usr/lib/systemd/system/podman.service后，需重启服务生效：

sudo systemctl daemon-reload
sudo systemctl restart podman.service podman.socket

也可以临时启动持续运行的服务：

podman system service --time=0 unix:///run/podman/podman.sock &

3. 明确设置PODMAN_SOCKET环境变量

Podman Python库优先读取该变量，可通过两种方式设置：

• 在Dockerfile中添加：

  ENV PODMAN_SOCKET=/run/podman/podman.sock
  

• 或运行容器时传递：

  podman run --rm --privileged --network host -v /run/podman/podman.sock:/run/podman/podman.sock -e PODMAN_SOCKET=/run/podman/podman.sock test <镜像名称> trial
  

4. 匹配Podman Python库与宿主机版本

容器内安装的podman Python库版本必须与宿主机Podman版本兼容：

1. 查看宿主机版本：podman --version
2. 在Dockerfile中指定对应版本安装：

   RUN pip install podman==5.2.0  # 替换为宿主机对应的版本
   

5. 备选：改用Podman CLI调用

如果Python库方式仍有问题，可直接在容器内调用podman命令行：

• 修改Dockerfile安装podman：

  RUN apt-get update && apt-get install -y podman
  

• 修改Python脚本：

  import subprocess
  import sys
  
  def create_container(image_name, container_name):
      try:
          subprocess.run(
              ["podman", "run", "-d", "--name", container_name, image_name],
              check=True, capture_output=True, text=True
          )
          print(f"Container '{container_name}' created and started successfully.")
          result = subprocess.run(
              ["podman", "inspect", "-f", "{{.Id}}", container_name],
              check=True, capture_output=True, text=True
          )
          print(f"Container ID: {result.stdout.strip()}")
      except subprocess.CalledProcessError as e:
          print(f"Error creating container: {e.stderr}")
          sys.exit(1)
  

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