如何通过Python Docker SDK将Docker挂载文件保存到任意目录？

问题原因 #

你这段代码的核心错误是混淆了Docker Volume和主机目录绑定（Bind Mount）的用法：

• 你要挂载的是主机本地的桌面目录（带斜杠的绝对路径），但却指定了type="volume"
• Docker Volume的名称只能包含[a-zA-Z0-9][a-zA-Z0-9_.-]这类字符，带斜杠的绝对路径不符合Volume命名规则，直接触发了400请求错误。

修正后的代码 #

要挂载主机目录保存文件，需将挂载类型改为bind，同时确保主机路径是绝对路径且已存在：

import os
import docker

client = docker.from_env()

# 定义主机要挂载的绝对路径（比如你的桌面目录）
host_dir = "/home/cv/Desktop/archive_TestContainer1"
# 提前创建目录，避免容器启动失败
os.makedirs(host_dir, exist_ok=True)

# 使用bind类型挂载主机目录到容器
mounts = [docker.types.Mount(
    source=host_dir,
    target="/target_folder",
    type="bind"
)]

# 启动容器
ok = client.containers.run(
    image="image_name",
    detach=True,
    remove=True,
    mounts=mounts,
    name="TestContainer1"
)

关键说明 #

• type="bind"：明确告知Docker这是挂载主机本地的目录/文件，而非Docker管理的Volume
• source：必须是主机的绝对路径，不能使用相对路径
• os.makedirs(host_dir, exist_ok=True)：确保主机目录存在，否则容器启动会直接失败

原错误信息翻译 #

docker.errors.APIError: 
400 Client Error for http+docker://localhost/v1.41/containers/create?name=TestContainer1: 
请求无效（创建 /home/cv/Desktop/archive_TestContainer1："/home/cv/Desktop/archive_TestContainer1" 
包含本地卷名称的无效字符，仅允许 "[a-zA-Z0-9][a-zA-Z0-9_.-]"。
如果您想传递主机目录，请使用**绝对路径**）

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