如何从零部署 PDFMathTranslate2 条命令跑通 PDF 翻译网页服务并开放公网【免费下载链接】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/PDFMathTranslatePDFMathTranslate 是一款基于 AI 的 PDF 翻译工具能把学术论文全文翻译成中文的同时完整保留公式、图表、目录和批注的原有排版。跟着这篇指南操作完你会在自己的机器上跑起一个浏览器里直接能用的 PDF 翻译网页服务既能个人使用也能开放给局域网甚至公网共享。它适合想快速部署一个排版不跑样的 PDF 翻译服务、又不想折腾复杂环境的开发者如果你只是要命令行批量处理、完全不需要网页界面直接看命令行用法即可。环境准备2 条命令启动 PDF 翻译网页服务选型一句话个人试水、开发调试用 Python 安装报错好定位服务器上长期跑、要重启即恢复直接用 Docker 容器。Python 方式要求环境是 Python 3.11–3.12。先装命令行工具装完看到Successfully installed pdf2zh即成功pip install pdf2zh # 安装 pdf2zh 命令行工具接着启动网页版界面命令行出现Running on local URL: http://0.0.0.0:7860之类的提示就说明启动成功pdf2zh -i # 启动网页版界面浏览器打开http://localhost:7860页面出现文件上传框就说明服务已经跑起来了。服务器长期跑的话Docker 就两条命令容器起来后浏览器打开同一地址即可docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh # 后台运行并映射 7860 端口✅ 镜像里默认执行pdf2zh -i所以容器一启动就是网页服务。由内到外让 PDF 翻译服务被更多人访问本机自测先完成一次完整 PDF 翻译并核对公式排版这一步要确认工具链本身没问题——排版最容易坏的地方就是公式区和表格区。在网页里上传一篇英文论文 PDF翻译服务默认用 Google也可以选 DeepL、Ollama 等如果习惯命令行装好后直接pdf2zh 文档.pdf也行译文会生成在当前目录。翻译完成后你会得到两个文件纯译文版文档名-mono.pdf和双语对照版文档名-dual.pdf。打开译文重点看公式和表格——公式应保持原样、表格没有错位、目录还能正常跳转这三点都过关就说明没坏。同一局域网把地址里的 localhost 换成局域网 IP这一步要达成同一网络下的其他电脑、手机也能打开这个翻译服务。其实服务默认就绑定在0.0.0.0本来就允许外部访问你只需要把访问地址里的localhost换成这台机器的局域网 IPhttp://192.168.1.10:7860 # 换成你机器的实际局域网 IP如果 7860 端口被占用导致起不来就换个端口再启动后面所有访问地址也要跟着改端口pdf2zh -i --serverport 8080 # 改用 8080 端口启动用另一台连同一 Wi-Fi 的设备打开上面的 IP 地址能打开页面就说明局域网访问通了。公网访问临时隧道或反向代理二选一这一步要把服务开放到外网。两条路按需求选。临时演示启动时加--share会自动生成一个临时公网链接发给别人就能用。pdf2zh -i --share # 生成临时公网隧道链接它走的是第三方隧道适合一次性演示不适合长期挂着。验证在一台和你不同网段、或断开 Wi-Fi 的设备上打开该临时链接能打开即成功。长期服务推荐用 Nginx 这类反向代理把域名指到本机 7860 端口再配上 SSL 证书。这样链接稳定、能控制访问来源配合下一节的登录授权才是安全的团队共享方案。验证用外网设备通过你的域名访问能打开页面即成功。部署方式怎么选方式优点局限适合谁Python 安装一条命令装好、方便调试定位需要自备 Python 环境开发测试、个人使用Docker 容器环境自带、重启即恢复需要装 Docker服务器长期运行Windows 绿色版不用装环境解压双击即用仅限 Windows 平台个人电脑、临时使用高频问题速查PDF 翻译部署踩坑怎么办本机浏览器能打开局域网别的设备却打不开通常是这台机器的系统防火墙或云服务器安全组没放行 7860 端口或是地址里还写着localhost。把防火墙/安全组放行 7860 端口、确认访问地址用的是局域网 IP 而不是localhost多网卡机器再确认 IP 取的是同一网络下那个即可。第一次运行长时间卡住日志指向模型下载程序首次运行要下载版面检测模型wybxc/DocLayout-YOLO-DocStructBench-onnx部分地区访问源站很慢会一直卡住。启动前设置镜像环境变量即可下载成功后模型会被缓存之后启动不再卡这步export HF_ENDPOINThttps://hf-mirror.com # 指定模型镜像源译文里公式或特殊字符丢了、乱了最常见的原因是字体子集化font subsetting导致某些字符渲染异常。优先加--skip-subset-fonts跳过字体子集化如果改过保留规则-f/-c按 docs/ADVANCED.md 的 exceptions 一节核对正则必要时换一篇结构简单的 PDF 复测先排除源文件本身的问题。换了翻译服务没生效或接口报 404指定了-s的服务如果环境变量没 export、变量名拼错就会静默回退或报错。对照 docs/ADVANCED.md 的服务列表逐项检查环境变量用 OpenAI 兼容接口时Base URL 必须以/v1结尾漏掉会直接报 404。把配置写进 config.json 再启动能避免临时设的环境变量忘了带这类问题。服务上了公网谁都能用怎么加登录门槛⚠️ 网页版默认没有登录门槛一旦上公网任何知道地址的人都能用翻译额度和机器资源全被消耗。准备一个 users.txt每行用户名,密码启动时加上--authorized users.txt访问页面就会先弹登录框还能把第二个参数换成自定义的 auth.html 改登录页样式。用 users.txt 里的账号能登录、错误密码被拒绝即验证通过。深入与延伸阅读PDF 翻译进阶入口docs/ADVANCED.md全部翻译服务与环境变量对照、自定义提示词--prompt、配置文件详解解决换服务怎么配。docs/README_GUI.md网页界面的完整功能说明解决网页里每个控件能干什么。docs/APIS.mdPython API 与 HTTP API把 PDF 翻译能力集成进你自己的系统适合想把它二次开发接入的人。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
