无法从 Docker Hub 拉取 PDFMathTranslate 镜像时如何改用 GHCR 镜像-迪斯科星球

无法从 Docker Hub 拉取 PDFMathTranslate 镜像时如何改用 GHCR 镜像

【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate

PDFMathTranslate（pdf2zh）是 EMNLP 2025 Demo 收录的 PDF 科学论文翻译工具，支持在保留排版的前提下做全文双语翻译。用 Docker 部署时，官方默认从 Docker Hub 拉取byaidu/pdf2zh镜像并暴露 7860 端口的 Web 界面。如果你的网络环境无法访问 Docker Hub、docker pull一直失败，项目官方文档给出了替代路径：改用 GitHub Container Registry（GHCR）上的镜像ghcr.io/byaidu/pdfmathtranslate。本文只覆盖这一个场景：Docker Hub 拉不下来时如何切换到 GHCR 镜像，并验证 Web 界面可以正常打开。

先确认走的是标准 Docker Hub 路径

官方 README（README.md 与 docs/README_zh-CN.md）中 Docker 部署的标准步骤是：

docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh

然后浏览器打开：

http://localhost:7860/

如果第一步docker pull byaidu/pdf2zh在你的环境中拉取失败（文档给出的判断条件就是“无法访问 Docker Hub”），再执行下面的 GHCR 替代步骤。两个镜像来源的镜像名不同：Docker Hub 上叫byaidu/pdf2zh，GHCR 上叫ghcr.io/byaidu/pdfmathtranslate，拉取和运行命令中的镜像名要跟着一起换，不要把两个名字混用。

改用 GHCR 镜像拉取并运行

官方文档在 Docker 部署小节给出的替代命令是：

docker pull ghcr.io/byaidu/pdfmathtranslate docker run -d -p 7860:7860 ghcr.io/byaidu/pdfmathtranslate

说明：

docker pull从 GHCR 拉取镜像，替代原先的 Docker Hub 拉取；
docker run -d -p 7860:7860与标准路径的端口映射完全一致，容器内 7860 端口映射到宿主机 7860 端口。仓库内的 Dockerfile 也声明了EXPOSE 7860，容器默认执行pdf2zh -i启动图形界面，所以 Web 界面就服务在 7860 端口上。

如果本地 7860 端口已被占用，需要先停掉占用该端口的进程或改用其他端口映射（文档未给出 Docker 场景的自定义端口示例，此处按 Docker 常规处理）。

验证 Web 界面是否可用

GHCR 路径的运行命令与 Docker Hub 路径一致，验证方式也和官方文档相同：在浏览器中打开

http://localhost:7860/

能看到 PDFMathTranslate 的 Gradio 图形界面即表示部署成功，界面效果参考文档配图：

与其他网络问题的区分

文档中还有一个容易混淆的网络问题：程序工作前需要下载 AI 布局模型（wybxc/DocLayout-YOLO-DocStructBench-onnx），部分用户因网络问题下载失败。官方针对模型下载给出的是环境变量方案（HF_ENDPOINT=https://hf-mirror.com），与镜像拉取无关。如果你卡住的环节是拉取镜像而不是模型加载，用本文的 GHCR 镜像即可；反过来，如果镜像拉取成功、只是模型下载失败，再按 README 中的HF_ENDPOINT方案处理。

如果 GHCR 也拉取失败，项目文档没有给出进一步的替代镜像源，文档仅明确了 Docker Hub 与 GHCR 两种拉取来源。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析