三行命令快速启动 PDFMathTranslate 保留排版 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组会前夜你想把刚下载的一篇英文论文转成中文分享给同事却发现普通机器翻译要么把公式打碎要么排版全乱。PDFMathTranslate 就是为学术论文 PDF 翻译设计的工具公式、图表、目录、注释原样保留只翻译文字并且提供命令行、网页界面、MCP 服务器多种用法可接 Google、DeepL、Ollama、OpenAI 等翻译服务。本文是照做即通的手把手教程按顺序走完你可以完成这几个可验证的动作在浏览器打开http://localhost:7860把第一篇 PDF 翻译成保留排版的中文版让同一局域网内的同事打开服务各自翻译自己的文件用--authorized加用户鉴权、用配置文件隐藏服务器 API Key把服务放到服务器上长期跑处理首次运行模型下载失败、Windows 版打不开等高频问题。1. 第一步本地启动 PDFMathTranslate 网页界面这一章的目标很具体浏览器打开 7860 端口翻译成功一份文档。三条路线先对号入座再动手。路线适用场景特点Pythonpip 安装本机已有 Python 环境开发调试配置最灵活参数随手加Windows 绿色版个人电脑不想装任何环境解压即用无需 PythonDocker服务器长期运行、多人共享一个镜像带齐所有依赖⚠️ Python 路线要求3.11 ≤ 版本 ≤ 3.12见 Dockerfile 同款的 3.12 基础镜像。系统只有 3.13 或更低版本时建议直接走 Docker。1.1 Python两条命令装好并启动先在当前目录安装再启动网页界面pip install pdf2zh # 安装 pdf2zh pdf2zh -i # 启动 Web 界面GUI浏览器会打开http://localhost:7860/没自动打开就手动访问把 PDF 拖进窗口、点 Translate 即可开始。如果端口被占用换端口启动pdf2zh -i --serverport 8080 # 把端口改成 8080不想要界面的话命令行直接翻产物生成在当前工作目录pdf2zh paper.pdf # 翻译 paper.pdf运行结束后你会拿到两个文件paper-mono.pdf纯中文版和paper-dual.pdf双语对照版。-i进入交互界面不加则走命令行模式--serverport指定 Web 界面端口默认 7860-o指定输出目录例如pdf2zh paper.pdf -o out1.2 Windows 绿色版解压即用从项目的 release 页面下载pdf2zh-version-win64.zip解压后双击pdf2zh.exe运行。⚠️ 若双击后无反应先安装 VC 运行库vc_redist.x64.exe再重试这是仓库文档明确提到的常见原因。1.3 Docker拉取镜像并运行容器docker pull byaidu/pdf2zh # 拉取官方镜像 docker run -d -p 7860:7860 byaidu/pdf2zh # 后台运行并映射 7860 端口-d后台运行-p 7860:7860容器端口映射到宿主机浏览器访问http://localhost:7860/仓库根目录还有一个 docker-compose.yml一次性构建自包含镜像含系统依赖安装和babeldoc --warmup预热command已写死为pdf2zh -i适合想要可控构建流程的场景。小结能在 7860 端口翻出一份文档本章就达标了。下一步把服务开放给局域网里的人。2. 第二步配置局域网与临时公网访问2.1 局域网访问两条路径Docker 路线-p 7860:7860默认绑定宿主机所有网卡同一局域网的设备直接打开http://服务器IP:7860即可不需要额外参数。Python 路线如果办公网内直连不通通常是防火墙拦了 7860 端口最快的办法是生成临时公网链接pdf2zh -i --share # 启动并生成 Gradio Share 临时公网链接拿到链接直接发给同事用完即弃适合临时协作。2.2 用户鉴权每行一个用户服务开放后建议立刻加上账号密码防止别人拿着你的 API Key 白嫖pdf2zh -i --authorized users.txtusers.txt格式每行一个用户用户名和密码用英文逗号分隔admin,123456 user1,password1第二个参数可选传一个auth.html如--authorized users.txt auth.html就能定制登录页样式详见 docs/ADVANCED.md 的 Authorization 一节。⚠️ 一旦端口对外--authorized是必选项不要依赖端口没人知道这种安全。小结验证标准是——同事设备能打开页面、且必须先登录才能翻译。3. 第三步长期稳定运行——固定配置与安全保障这一章把能跑升级成能长期跑核心是固定翻译服务、锁住密钥、微调质量。3.1 固定翻译服务默认走 Google 免费服务长期运行建议显式指定export DEEPL_AUTH_KEY你的Key # 设置 DeepL 密钥 pdf2zh -i -s deepl # 用 DeepL 启动本地离线可用 Ollama默认连接http://127.0.0.1:11434、模型gemma2加-s ollama即可。常用服务与所需环境变量对照服务开关需要的环境变量google默认无需设置无deepl-s deeplDEEPL_AUTH_KEYopenai-s openaiOPENAI_BASE_URL、OPENAI_API_KEY、OPENAI_MODELollama本地-s ollamaOLLAMA_HOST、OLLAMA_MODEL可选完整服务列表20 家及默认值见 docs/ADVANCED.md 的 Services 表格。3.2 配置文件锁住公开服务的安全面用--config config.json指定配置默认位置是~/.config/PDFMathTranslate/config.json。面向公网时仓库文档专门给出两个公开服务开关ENABLED_SERVICES只暴露白名单里的翻译服务其余选项在页面上不可见HIDDEN_GRADIO_DETAILS设为true隐藏页面上的真实 API Key防止使用方直接看到服务端密钥⚠️ 用 OpenAI 兼容接口或自定义代理时BASE_URL必须以/v1结尾否则报 404——这是仓库文档里用加粗标注的高频错误。3.3 微调翻译质量三个参数按需组合--prompt prompt.txt自定义提示词文件内可用${lang_in}、${lang_out}、${text}三个变量适合约束保留公式与术语这类风格-t翻译线程数默认 4机器强可适当调大--mode precise切换到实验性 v2 翻译内核默认fast为 v1需要 pdf2zh_next 子模块适合尝鲜小结重启服务后确认三件事——用户必须登录、页面上看不到密钥、-s指定的服务生效长期运行配置就算落地。4. 踩坑清单四个高频问题的处理方式4.1 首次启动模型下载失败或很慢首次运行会下载版面检测模型wybxc/DocLayout-YOLO-DocStructBench-onnx网络不通 Hugging Face 就会卡住或报错启动前设置镜像变量cmd 下执行set HF_ENDPOINThttps://hf-mirror.comPowerShell 下执行$env:HF_ENDPOINT https://hf-mirror.com设置后重新运行启动命令一般即可成功4.2 Windows 绿色版双击没反应安装 VC 运行库vc_redist.x64.exe后重试仓库文档明确提示仍无反应时先跑一遍pdf2zh --version确认 Python 组件是否完整4.3 中文版个别版面错位、缺字加--skip-subset-fonts跳过字体子集化兼容性更好代价是输出文件变大pdf2zh paper.pdf --skip-subset-fonts怀疑源文件本身兼容性差时加-cp--compatible先转成 PDF/A 再翻译4.4 同一篇文档反复翻译会一直消耗额度吗默认开启翻译缓存相同文本再次翻译不会再调 API确实需要强制重翻比如换了服务想对比效果时加--ignore-cache4.5 拉不到 Docker Hub 的镜像改用仓库 README 提供的 Container Registry 镜像docker pull ghcr.io/byaidu/pdfmathtranslate # 拉取 ghcr 镜像 docker run -d -p 7860:7860 ghcr.io/byaidu/pdfmathtranslate # 同样映射 7860到这里本地能翻 → 局域网能共享 → 长期安全运行 → 常见报错有解法这条线就闭环了。还想继续深入的话建议按这个顺序读中文文档总览、docs/ADVANCED.md全部高级参数、docs/README_GUI.md界面与语言支持列表、docs/APIS.md把翻译能力用 HTTP/Python API 接进自己的工作流。【免费下载链接】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），仅供参考 三行命令快速启动 PDFMathTranslate 保留排版 PDF 翻译服务
三行命令快速启动 PDFMathTranslate 保留排版 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组会前夜你想把刚下载的一篇英文论文转成中文分享给同事却发现普通机器翻译要么把公式打碎要么排版全乱。PDFMathTranslate 就是为学术论文 PDF 翻译设计的工具公式、图表、目录、注释原样保留只翻译文字并且提供命令行、网页界面、MCP 服务器多种用法可接 Google、DeepL、Ollama、OpenAI 等翻译服务。本文是照做即通的手把手教程按顺序走完你可以完成这几个可验证的动作在浏览器打开http://localhost:7860把第一篇 PDF 翻译成保留排版的中文版让同一局域网内的同事打开服务各自翻译自己的文件用--authorized加用户鉴权、用配置文件隐藏服务器 API Key把服务放到服务器上长期跑处理首次运行模型下载失败、Windows 版打不开等高频问题。1. 第一步本地启动 PDFMathTranslate 网页界面这一章的目标很具体浏览器打开 7860 端口翻译成功一份文档。三条路线先对号入座再动手。路线适用场景特点Pythonpip 安装本机已有 Python 环境开发调试配置最灵活参数随手加Windows 绿色版个人电脑不想装任何环境解压即用无需 PythonDocker服务器长期运行、多人共享一个镜像带齐所有依赖⚠️ Python 路线要求3.11 ≤ 版本 ≤ 3.12见 Dockerfile 同款的 3.12 基础镜像。系统只有 3.13 或更低版本时建议直接走 Docker。1.1 Python两条命令装好并启动先在当前目录安装再启动网页界面pip install pdf2zh # 安装 pdf2zh pdf2zh -i # 启动 Web 界面GUI浏览器会打开http://localhost:7860/没自动打开就手动访问把 PDF 拖进窗口、点 Translate 即可开始。如果端口被占用换端口启动pdf2zh -i --serverport 8080 # 把端口改成 8080不想要界面的话命令行直接翻产物生成在当前工作目录pdf2zh paper.pdf # 翻译 paper.pdf运行结束后你会拿到两个文件paper-mono.pdf纯中文版和paper-dual.pdf双语对照版。-i进入交互界面不加则走命令行模式--serverport指定 Web 界面端口默认 7860-o指定输出目录例如pdf2zh paper.pdf -o out1.2 Windows 绿色版解压即用从项目的 release 页面下载pdf2zh-version-win64.zip解压后双击pdf2zh.exe运行。⚠️ 若双击后无反应先安装 VC 运行库vc_redist.x64.exe再重试这是仓库文档明确提到的常见原因。1.3 Docker拉取镜像并运行容器docker pull byaidu/pdf2zh # 拉取官方镜像 docker run -d -p 7860:7860 byaidu/pdf2zh # 后台运行并映射 7860 端口-d后台运行-p 7860:7860容器端口映射到宿主机浏览器访问http://localhost:7860/仓库根目录还有一个 docker-compose.yml一次性构建自包含镜像含系统依赖安装和babeldoc --warmup预热command已写死为pdf2zh -i适合想要可控构建流程的场景。小结能在 7860 端口翻出一份文档本章就达标了。下一步把服务开放给局域网里的人。2. 第二步配置局域网与临时公网访问2.1 局域网访问两条路径Docker 路线-p 7860:7860默认绑定宿主机所有网卡同一局域网的设备直接打开http://服务器IP:7860即可不需要额外参数。Python 路线如果办公网内直连不通通常是防火墙拦了 7860 端口最快的办法是生成临时公网链接pdf2zh -i --share # 启动并生成 Gradio Share 临时公网链接拿到链接直接发给同事用完即弃适合临时协作。2.2 用户鉴权每行一个用户服务开放后建议立刻加上账号密码防止别人拿着你的 API Key 白嫖pdf2zh -i --authorized users.txtusers.txt格式每行一个用户用户名和密码用英文逗号分隔admin,123456 user1,password1第二个参数可选传一个auth.html如--authorized users.txt auth.html就能定制登录页样式详见 docs/ADVANCED.md 的 Authorization 一节。⚠️ 一旦端口对外--authorized是必选项不要依赖端口没人知道这种安全。小结验证标准是——同事设备能打开页面、且必须先登录才能翻译。3. 第三步长期稳定运行——固定配置与安全保障这一章把能跑升级成能长期跑核心是固定翻译服务、锁住密钥、微调质量。3.1 固定翻译服务默认走 Google 免费服务长期运行建议显式指定export DEEPL_AUTH_KEY你的Key # 设置 DeepL 密钥 pdf2zh -i -s deepl # 用 DeepL 启动本地离线可用 Ollama默认连接http://127.0.0.1:11434、模型gemma2加-s ollama即可。常用服务与所需环境变量对照服务开关需要的环境变量google默认无需设置无deepl-s deeplDEEPL_AUTH_KEYopenai-s openaiOPENAI_BASE_URL、OPENAI_API_KEY、OPENAI_MODELollama本地-s ollamaOLLAMA_HOST、OLLAMA_MODEL可选完整服务列表20 家及默认值见 docs/ADVANCED.md 的 Services 表格。3.2 配置文件锁住公开服务的安全面用--config config.json指定配置默认位置是~/.config/PDFMathTranslate/config.json。面向公网时仓库文档专门给出两个公开服务开关ENABLED_SERVICES只暴露白名单里的翻译服务其余选项在页面上不可见HIDDEN_GRADIO_DETAILS设为true隐藏页面上的真实 API Key防止使用方直接看到服务端密钥⚠️ 用 OpenAI 兼容接口或自定义代理时BASE_URL必须以/v1结尾否则报 404——这是仓库文档里用加粗标注的高频错误。3.3 微调翻译质量三个参数按需组合--prompt prompt.txt自定义提示词文件内可用${lang_in}、${lang_out}、${text}三个变量适合约束保留公式与术语这类风格-t翻译线程数默认 4机器强可适当调大--mode precise切换到实验性 v2 翻译内核默认fast为 v1需要 pdf2zh_next 子模块适合尝鲜小结重启服务后确认三件事——用户必须登录、页面上看不到密钥、-s指定的服务生效长期运行配置就算落地。4. 踩坑清单四个高频问题的处理方式4.1 首次启动模型下载失败或很慢首次运行会下载版面检测模型wybxc/DocLayout-YOLO-DocStructBench-onnx网络不通 Hugging Face 就会卡住或报错启动前设置镜像变量cmd 下执行set HF_ENDPOINThttps://hf-mirror.comPowerShell 下执行$env:HF_ENDPOINT https://hf-mirror.com设置后重新运行启动命令一般即可成功4.2 Windows 绿色版双击没反应安装 VC 运行库vc_redist.x64.exe后重试仓库文档明确提示仍无反应时先跑一遍pdf2zh --version确认 Python 组件是否完整4.3 中文版个别版面错位、缺字加--skip-subset-fonts跳过字体子集化兼容性更好代价是输出文件变大pdf2zh paper.pdf --skip-subset-fonts怀疑源文件本身兼容性差时加-cp--compatible先转成 PDF/A 再翻译4.4 同一篇文档反复翻译会一直消耗额度吗默认开启翻译缓存相同文本再次翻译不会再调 API确实需要强制重翻比如换了服务想对比效果时加--ignore-cache4.5 拉不到 Docker Hub 的镜像改用仓库 README 提供的 Container Registry 镜像docker pull ghcr.io/byaidu/pdfmathtranslate # 拉取 ghcr 镜像 docker run -d -p 7860:7860 ghcr.io/byaidu/pdfmathtranslate # 同样映射 7860到这里本地能翻 → 局域网能共享 → 长期安全运行 → 常见报错有解法这条线就闭环了。还想继续深入的话建议按这个顺序读中文文档总览、docs/ADVANCED.md全部高级参数、docs/README_GUI.md界面与语言支持列表、docs/APIS.md把翻译能力用 HTTP/Python API 接进自己的工作流。【免费下载链接】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），仅供参考