x

docker/README.md

@@ -163,6 +163,7 @@ cp env.example .env
 # 方式一：docker build（直接指定 ARCH）
 docker build \
     --build-arg ARCH=gfx1201 \
+    --build-arg GIT_PROXY= \
     -t mineru-rocm:7.2.1 \
     -f Dockerfile .
 
@@ -186,6 +187,7 @@ docker compose build
 | `PYTHON_VER` | `3.12` | Python 版本 |
 | `VENV` | `/opt/mineru_venv` | 虚拟环境路径 |
 | `TORCH_INDEX` | `https://download.pytorch.org/whl/rocm7.2` | PyTorch wheel 源 |
+| `GIT_PROXY` | 空 | 仅构建时访问 GitHub 用；例如 `http://host.docker.internal:8118` |
 
 ---
 
@@ -446,6 +448,21 @@ docker compose restart gradio
 
 内存不足。将 Dockerfile 中 `ninja -j4` 改为 `ninja -j2` 或 `ninja -j1`，或给 Docker 分配更多内存。
 
+**Q: 构建在 CMake 下载阶段失败（`wget/curl exit code 4`）**
+
+这通常是构建容器无法访问 GitHub，或把 `GIT_PROXY` 设成了容器内不可达地址（例如 `127.0.0.1:8118` 在多数 Docker 场景下指向容器自己，不是宿主机代理）。建议：
+
+1. 不需要代理时，显式传空：`--build-arg GIT_PROXY=`
+2. 需要宿主机代理时，优先用：`http://host.docker.internal:8118`
+3. 先单独测试下载连通性，再完整构建
+
+```bash
+docker build --build-arg GIT_PROXY= -t mineru-rocm:7.2.1 -f Dockerfile .
+
+# 或（宿主机代理）
+docker build --build-arg GIT_PROXY=http://host.docker.internal:8118 -t mineru-rocm:7.2.1 -f Dockerfile .
+```
+
 **Q: 构建时 cmake 报 `Failed to find ROCm root directory`**
 
 `/opt/rocm/bin` 不在 PATH 中。检查 Dockerfile 中 `ENV PATH` 是否正确设置。