企业官网建设流程全解析

PDFMathTranslate PDF 论文翻译网页版部署：3 步跑通，从自用到团队共享

【免费下载链接】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 是一个保留排版（公式、图表、目录不动）的开源 PDF 论文翻译工具，网页版一条命令就能起来。读完你能：

• 在自己电脑上打开网页版
• 用 Docker 部署小组共用服务
• 给服务加账号密码登录
• 排掉 3 个最常见的卡点

用 pip 在自己电脑上跑通网页版

结论：准备 Python 3.11–3.12，装一条命令、起一条命令，浏览器就能看到上传界面。

下面第一条安装 pdf2zh，第二条启动网页服务；启动成功时终端会打印 Local URL，指向 7860 端口（端口就是服务在你电脑上的"门牌号"，浏览器靠它找到这个程序）：

pip install pdf2zh pdf2zh -i

打开 http://localhost:7860 ，把一篇论文拖进去、点 Translate，完成后会下载翻译版（mono）和双语版（dual）两个 PDF。下面第一张图是网页界面演示，第二张是翻译后保留公式和排版的输出效果：

不确定自己该走哪条路，先看这张选型表：

pip 路线之外，Windows 用户也可以直接下载 Release 里的pdf2zh-version-win64.zip解压运行；界面细节见 docs/README_GUI.md。

用 Docker 一条命令部署，让小组共用一份服务

结论：不想在每台电脑装 Python，就在服务器上跑一个官方镜像，组里其他人用浏览器访问服务器 IP 就行。

镜像可以理解为打包好的运行环境，-p 7860:7860是把容器里的服务端口映射到服务器的 7860 端口（端口 = 服务的门牌号），不做这步映射，局域网里别的机器就找不到它：

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

docker ps里状态为 Up 就算起来了，组里同事在浏览器打开http://服务器IP:7860即可使用。镜像拉不动时，可改拉 GitHub Container Registry 上的同名镜像ghcr.io/byaidu/pdfmathtranslate。镜像内部装了什么可以看 Dockerfile，想搭配 Ollama 本地模型跑就用仓库里的 docker-compose.yml。

给服务加账号密码，顺手收紧可用参数

结论：服务要交给团队用之前，先用--authorized加登录，再决定别人能选哪些翻译服务。

下面这条启动带登录验证的网页版，用户文件里每行一个账号，格式是用户名,密码，例如admin,123456；还可以再传一个自定义登录页auth.html，格式细节见 docs/ADVANCED.md：

pdf2zh -i --authorized users.txt

另外两项配置写在配置文件里（默认路径~/.config/PDFMathTranslate/config.json，也可用--config指定）：ENABLED_SERVICES只允许界面中出现指定服务，HIDDEN_GRADIO_DETAILS设为 true 后网页上不再暴露服务器端的 API Key。常改的参数收在下表：

⚠️ 先排掉 3 个最常卡住的点

1. 启动报 7860 端口被占用，或打开空白页 原因：本机 7860 已经被别的程序占着 解决：pdf2zh -i --serverport 7861换个端口，浏览器也改访问 7861

2. 首次翻译长时间卡在下载模型 原因：默认从 HuggingFace 下载版面检测模型，国内网络慢 解决：启动前设置HF_ENDPOINT=https://hf-mirror.com再试

3. 自己电脑能打开，同组机器访问不到 原因：Docker 没做端口映射，或服务器防火墙没放行 7860 解决：确认启动时带了-p 7860:7860，并在云控制台或防火墙放行该端口

跑通之后想把它接进自己的工作流，HTTP 接口和 Python 封装都写在 docs/APIS.md，可以直接照做。

【免费下载链接】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