无需复制文件，如何从Docker容器访问主机文件并生成输出？

核心思路 #

用Docker的bind mount分别挂载主机的src和docs目录到容器内，既避免复制整个项目目录，又能实现容器与主机的文件双向同步：

• 主机project/src → 容器/code：让容器直接访问Python源码
• 主机project/docs → 容器内的/docs目录：让容器读取文档源文件（conf.py、index.rst），并将生成的index.html直接写入该挂载目录，同步回主机

1. 编写Dockerfile #

基于Python基础镜像构建，安装文档生成所需依赖（以Sphinx为例，用其他工具替换即可）：

# 选择适配项目的Python基础镜像
FROM python:3.11-slim

# 设置容器内工作目录为/code
WORKDIR /code

# 安装文档生成依赖（示例为Sphinx，按需替换）
RUN pip install sphinx sphinx-rtd-theme

# 可选：创建非root用户，避免生成文件权限冲突（推荐）
RUN useradd -m appuser
USER appuser

# 默认启动命令，可按需修改
CMD ["bash"]

2. 启动容器并执行生成命令 #

在主机的project目录下执行以下命令，通过bind mount挂载目录并运行文档生成指令：

docker run -it --rm \
  -v "$(pwd)/src:/code" \
  -v "$(pwd)/docs:/docs" \
  your-image-name \
  sphinx-build /docs /docs

• -v "$(pwd)/src:/code"：将主机当前目录下的src挂载到容器/code，容器可直接访问Python文件
• -v "$(pwd)/docs:/docs"：将主机当前目录下的docs挂载到容器/docs，容器读取源文件后，生成的index.html会直接同步回主机的project/docs
• sphinx-build /docs /docs：示例为Sphinx的文档生成命令，根据你的实际工具替换即可

3. 关键注意事项 #

• 权限问题：如果生成的文件属于root用户，主机操作会受限。解决方法：
  • 运行容器时指定主机用户的UID/GID：docker run -it --rm --user $(id -u):$(id -g) ...
  • 或者在Dockerfile中创建与主机用户UID一致的用户
• 路径正确性：必须在主机的project目录下执行docker run，否则挂载路径会出错
• 依赖适配：如果不用Sphinx，替换Dockerfile中的pip install包和容器内的执行命令即可

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