如何快速部署 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 全文翻译服务后的样子适合个人日常使用也适合课题组内网共享。读完本文你能独立完成安装、公网接入、授权配置与故障排查。 部署选型pip、Docker 与 Windows 绿色版对比安装方式优点代价适合谁Pythonpip / uv一条命令装好报错容易定位需要自备 Python 3.11–3.12 环境开发调试、个人日常使用Docker 容器环境完整自带重启即可恢复需要先装好 Docker服务器长期运行Windows 绿色版解压后双击pdf2zh.exe即可运行仅 Windows版本略滞后于主线Windows 电脑临时用一次本文主线走 Python 安装路线准备在服务器长跑的读者直接看下一节的 Docker 替代命令块。 安装并启动网页翻译界面的最短路径前置条件只有一个Python 版本落在 3.11 到 3.12 之间。pip install pdf2zh pdf2zh -i第二条命令启动网页界面。终端打印出本地访问地址后浏览器会自动打开没有就手动访问http://localhost:7860页面左侧是文件上传框右侧是预览区Service 下拉默认 GoogleTranslate to 默认 Chinese。看到这套界面服务就算跑起来了。若下载慢或中途报错给 pip 换国内镜像源重试即可。偏好 Docker 的话等价操作只有两条命令起容器即网页服务docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh拉取镜像慢时可换用ghcr.io/byaidu/pdfmathtranslate这个同名镜像。另外首次启动若长时间没有输出多半是在下载版面检测模型处理办法见下文按需调优一节。 把服务用起来访问范围从本机到公网本地先完成一次完整翻译在上传框选一篇英文 PDF点 Translate完成后 Download 区会列出两个文件xxx-mono.pdf是纯译文版xxx-dual.pdf是双语对照版。打开译文重点看公式区和表格区数学符号应原样保留。习惯命令行也可以pdf2zh 文档.pdf的效果与网页一致译文生成在当前目录。局域网接入的两处改动地址与端口查出本机内网 IPip addr或ipconfig其他设备把地址写成http://内网IP:7860——服务默认监听0.0.0.0这一步通常不用改任何配置端口被占用时启动命令改成pdf2zh -i --serverport 8080访问地址同步换成 8080Docker 侧则把映射写为-p 8080:7860。手机连同一 Wi-Fi 能打开页面即内网共享完成。公网访问的两种做法临时外链与长期代理临时外链pdf2zh -i --shareGradio 走第三方隧道给出一条临时 URL适合一次评审、一次分享进程关闭链接即失效不适合长期挂着。长期反向代理域名解析到服务器Nginx 将 443 反代到本机 7860 并挂 SSL 证书走 HTTPS以后换机器、换端口只需改代理配置对外地址不动。无论走哪条路下一步都是先加登录再放地址。公网开放前必须先过的登录门槛users.txt 授权新建users.txt每行一个用户用户名和密码用英文逗号分隔admin,admin2026启动命令带上授权参数pdf2zh -i --authorized users.txt页面会先出现登录框想换登录页样式在参数第二个位置放一个自定义auth.html容器部署同样要带docker run -d -p 7860:7860 -v ./users.txt:/app/users.txt byaidu/pdf2zh pdf2zh -i --authorized /app/users.txt镜像没有 ENTRYPOINT镜像名后的参数会整体替换默认命令所以要重写pdf2zh -i前缀。用表内账号能登录、错误密码被拒再执行上面的公网步骤。对外长期服务还建议在配置文件中用ENABLED_SERVICES限定开放哪些翻译服务、用HIDDEN_GRADIO_DETAILS隐藏页面上的密钥信息写法见 docs/ADVANCED.md 的 public services 一节。 按需调优翻译服务、并发与配置文件换翻译服务→ 加-s deepl、-s ollama、-s openai各服务需要的环境变量如DEEPL_AUTH_KEY在 docs/ADVANCED.md 的服务对照表里逐项核对OpenAI 兼容接口的 Base URL 必须以/v1结尾。翻译太慢→-t 4提高并发默认 4 线程一般从 CPU 核心数的一半起步。固定一套配置→--config config.json指定配置文件默认路径~/.config/PDFMathTranslate/config.json同名环境变量优先于文件中的值。首次启动卡在模型下载→ 启动前执行export HF_ENDPOINThttps://hf-mirror.com版面检测模型wybxc/DocLayout-YOLO-DocStructBench-onnx下载完成即被缓存之后不再重复下载。公式、特殊字符丢了→ 加--skip-subset-fonts跳过字体子集化字体保留规则由-f/-c控制改动后按 ADVANCED.md 的 exceptions 一节核对正则。重复翻译同样内容→ 默认命中翻译缓存直接复用想强制重翻加--ignore-cache。 从症状到动作故障排查速查与延伸阅读症状最可能原因处理动作启动即报端口被占用7860 已被占用pdf2zh -i --serverport 8080Docker 改-p 8080:7860本机能开局域网打不开防火墙/安全组没放行或地址还写着 localhost云主机放行 7860地址换内网 IP首次启动长时间无响应版面检测模型下载慢设置HF_ENDPOINT镜像源后重启网页上传大文件失败走的是在线演示限 5MB 且有验证或文件本身过大用本地部署的服务或命令行pdf2zh 文件.pdf目录批量用pdf2zh --dir 目录换了翻译服务没生效环境变量拼错或未 exportOpenAI 兼容 URL 漏了/v1对照 ADVANCED.md 服务表逐项检查译文公式、特殊字符丢失字体子集化或保留规则被改动加--skip-subset-fonts核对-f/-c错误密码也能进页面启动时没带授权参数加--authorized users.txt重启并复测参数细节与排查的第一参照是 docs/ADVANCED.md完整参数、各服务环境变量、授权与自定义提示词都在这份文档里网页界面每个控件的作用见 docs/README_GUI.md。想把翻译请求走自建的 OpenAI 兼容代理docs/PROXY_CONFIGURATION.md 给了一份可直接改的配置样例需要把翻译能力接进自己的系统读 docs/APIS.md 里的 Python 与 HTTP 入口。离线内网要自己构建镜像时参考仓库根目录的 Dockerfile。【免费下载链接】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[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 全文翻译服务后的样子适合个人日常使用也适合课题组内网共享。读完本文你能独立完成安装、公网接入、授权配置与故障排查。 部署选型pip、Docker 与 Windows 绿色版对比安装方式优点代价适合谁Pythonpip / uv一条命令装好报错容易定位需要自备 Python 3.11–3.12 环境开发调试、个人日常使用Docker 容器环境完整自带重启即可恢复需要先装好 Docker服务器长期运行Windows 绿色版解压后双击pdf2zh.exe即可运行仅 Windows版本略滞后于主线Windows 电脑临时用一次本文主线走 Python 安装路线准备在服务器长跑的读者直接看下一节的 Docker 替代命令块。 安装并启动网页翻译界面的最短路径前置条件只有一个Python 版本落在 3.11 到 3.12 之间。pip install pdf2zh pdf2zh -i第二条命令启动网页界面。终端打印出本地访问地址后浏览器会自动打开没有就手动访问http://localhost:7860页面左侧是文件上传框右侧是预览区Service 下拉默认 GoogleTranslate to 默认 Chinese。看到这套界面服务就算跑起来了。若下载慢或中途报错给 pip 换国内镜像源重试即可。偏好 Docker 的话等价操作只有两条命令起容器即网页服务docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh拉取镜像慢时可换用ghcr.io/byaidu/pdfmathtranslate这个同名镜像。另外首次启动若长时间没有输出多半是在下载版面检测模型处理办法见下文按需调优一节。 把服务用起来访问范围从本机到公网本地先完成一次完整翻译在上传框选一篇英文 PDF点 Translate完成后 Download 区会列出两个文件xxx-mono.pdf是纯译文版xxx-dual.pdf是双语对照版。打开译文重点看公式区和表格区数学符号应原样保留。习惯命令行也可以pdf2zh 文档.pdf的效果与网页一致译文生成在当前目录。局域网接入的两处改动地址与端口查出本机内网 IPip addr或ipconfig其他设备把地址写成http://内网IP:7860——服务默认监听0.0.0.0这一步通常不用改任何配置端口被占用时启动命令改成pdf2zh -i --serverport 8080访问地址同步换成 8080Docker 侧则把映射写为-p 8080:7860。手机连同一 Wi-Fi 能打开页面即内网共享完成。公网访问的两种做法临时外链与长期代理临时外链pdf2zh -i --shareGradio 走第三方隧道给出一条临时 URL适合一次评审、一次分享进程关闭链接即失效不适合长期挂着。长期反向代理域名解析到服务器Nginx 将 443 反代到本机 7860 并挂 SSL 证书走 HTTPS以后换机器、换端口只需改代理配置对外地址不动。无论走哪条路下一步都是先加登录再放地址。公网开放前必须先过的登录门槛users.txt 授权新建users.txt每行一个用户用户名和密码用英文逗号分隔admin,admin2026启动命令带上授权参数pdf2zh -i --authorized users.txt页面会先出现登录框想换登录页样式在参数第二个位置放一个自定义auth.html容器部署同样要带docker run -d -p 7860:7860 -v ./users.txt:/app/users.txt byaidu/pdf2zh pdf2zh -i --authorized /app/users.txt镜像没有 ENTRYPOINT镜像名后的参数会整体替换默认命令所以要重写pdf2zh -i前缀。用表内账号能登录、错误密码被拒再执行上面的公网步骤。对外长期服务还建议在配置文件中用ENABLED_SERVICES限定开放哪些翻译服务、用HIDDEN_GRADIO_DETAILS隐藏页面上的密钥信息写法见 docs/ADVANCED.md 的 public services 一节。 按需调优翻译服务、并发与配置文件换翻译服务→ 加-s deepl、-s ollama、-s openai各服务需要的环境变量如DEEPL_AUTH_KEY在 docs/ADVANCED.md 的服务对照表里逐项核对OpenAI 兼容接口的 Base URL 必须以/v1结尾。翻译太慢→-t 4提高并发默认 4 线程一般从 CPU 核心数的一半起步。固定一套配置→--config config.json指定配置文件默认路径~/.config/PDFMathTranslate/config.json同名环境变量优先于文件中的值。首次启动卡在模型下载→ 启动前执行export HF_ENDPOINThttps://hf-mirror.com版面检测模型wybxc/DocLayout-YOLO-DocStructBench-onnx下载完成即被缓存之后不再重复下载。公式、特殊字符丢了→ 加--skip-subset-fonts跳过字体子集化字体保留规则由-f/-c控制改动后按 ADVANCED.md 的 exceptions 一节核对正则。重复翻译同样内容→ 默认命中翻译缓存直接复用想强制重翻加--ignore-cache。 从症状到动作故障排查速查与延伸阅读症状最可能原因处理动作启动即报端口被占用7860 已被占用pdf2zh -i --serverport 8080Docker 改-p 8080:7860本机能开局域网打不开防火墙/安全组没放行或地址还写着 localhost云主机放行 7860地址换内网 IP首次启动长时间无响应版面检测模型下载慢设置HF_ENDPOINT镜像源后重启网页上传大文件失败走的是在线演示限 5MB 且有验证或文件本身过大用本地部署的服务或命令行pdf2zh 文件.pdf目录批量用pdf2zh --dir 目录换了翻译服务没生效环境变量拼错或未 exportOpenAI 兼容 URL 漏了/v1对照 ADVANCED.md 服务表逐项检查译文公式、特殊字符丢失字体子集化或保留规则被改动加--skip-subset-fonts核对-f/-c错误密码也能进页面启动时没带授权参数加--authorized users.txt重启并复测参数细节与排查的第一参照是 docs/ADVANCED.md完整参数、各服务环境变量、授权与自定义提示词都在这份文档里网页界面每个控件的作用见 docs/README_GUI.md。想把翻译请求走自建的 OpenAI 兼容代理docs/PROXY_CONFIGURATION.md 给了一份可直接改的配置样例需要把翻译能力接进自己的系统读 docs/APIS.md 里的 Python 与 HTTP 入口。离线内网要自己构建镜像时参考仓库根目录的 Dockerfile。【免费下载链接】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），仅供参考
