Bind Mount 必须使用宿主机绝对路径，以/开头，不支持相对路径、~或未展开的环境变量；正确格式为docker run -v /host/path:/container/path，如-v /home/user/data:/app/data。

Docker Bind Mount 的绝对路径必须以 / 开头，且是宿主机（运行 docker 命令的机器）上的完整路径，不能用相对路径、波浪号 ~ 或环境变量（如 $HOME）。

正确写法：宿主机绝对路径 + 容器内路径

格式为：docker run -v /host/absolute/path:/container/path ...

• ✅ 正确示例：
  -v /home/user/data:/app/data（Linux/macOS）
  -v C:\Users\user\data:/app/data（Windows PowerShell/CMD，注意反斜杠需转义或改用正斜杠）
  -v /c/Users/user/data:/app/data（Windows WSL2 或 Docker Desktop for Windows，默认使用 WSL2 后端时推荐此格式）
• ❌ 错误示例：
  -v ./data:/app/data（相对路径，Docker 不识别）
  -v ~/data:/app/data（~ 不展开，会被当作字面目录名）
  -v $HOME/data:/app/data（shell 变量在 docker CLI 中默认不展开，除非用双引号+命令替换）

Windows 用户特别注意路径格式

Docker Desktop 在 Windows 上底层依赖 WSL2，因此路径处理和 Linux 更接近：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

• 如果使用 PowerShell 或 CMD：C:\Users\user\app 需写成 C:/Users/user/app 或 /c/Users/user/app
• 推荐统一用 /c/Users/user/app 格式（对应 WSL2 中的 /mnt/c/Users/user/app），兼容性更好
• 确保该目录已添加到 Docker Desktop 的 Resources → WSL Integration 或 File Sharing 列表中，否则会报错“file not found”

验证路径是否生效的小技巧

启动容器后，快速检查挂载是否成功：

• 进入容器：docker exec -it <container> sh
• 运行 ls -l /container/path，确认内容与宿主机对应目录一致
• 在宿主机修改一个文件，再进容器看是否实时同步；反之亦然（注意文件权限和用户 UID/GID 匹配问题）

补充：想用变量？可以但要小心

如果坚持用 $HOME，需用双引号 + shell 展开：

• docker run -v "$HOME/data":/app/data nginx（bash/zsh 下有效）
• PowerShell 中用 "${env:USERPROFILE}\data"，但更建议直接写绝对路径避免歧义