PDFMathTranslate 部署与公网访问教程从本机运行到团队共享【免费下载链接】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 论文翻译工具在本机跑起来并配置成可供团队访问的网页服务个人从零到能用大约 10 分钟配置公网访问再加 20 分钟左右。30 秒自测先回答三个问题再往下读你的机器是什么系统Windows / 有 Python 的电脑 / 有 Docker 的服务器只自己用还是要给同事用试一两次就停还是打算长期挂着答案对号入座自己试 → 去对应路线小节给别人用 → 先跑起来再看“局域网分享与公网访问”一节。一、如何选部署方式先看对比表选路线前先看这张表前提是每种方式对环境的不同要求方式适合谁最省心的场景常见坑Python 安装3.11–3.12 环境想随时改参数个人电脑试一两篇装依赖和下载模型都要网络顺畅Docker 容器服务器或长期服务团队共用一个地址7860 端口可能被占用拉镜像偶尔慢Windows 绿色版不想装任何环境的 Windows 用户解压双击就走缺 VC 运行库时 exe 打不开三种方式最终得到的是同一个东西一个跑在 7860 端口的网页翻译界面所以后面的“验证”和“调优”内容对谁都适用。二、Python 环境安装后一条命令起网页前提Python 3.11 或 3.12。这条路适合要改翻译参数、排查问题的场景。安装并直接启动网页界面一条命令搞定pip install uv uv tool install --python 3.12 pdf2zh pdf2zh -i✅ 验证浏览器打开http://localhost:7860/看到上传框和参数面板即算成功把 PDF 拖进去点 Translate产物单语版example-mono.pdf、双语版example-dual.pdf生成在当前目录。⚠️ 出错时安装报依赖错误九成是 Python 版本不在 3.11–3.12首次翻译卡住或报错是在下载排版检测模型网络不佳时设置HF_ENDPOINThttps://hf-mirror.com再试详见 docs/ADVANCED.md。三、Docker 容器拉镜像、映射 7860 端口前提装好 Docker。镜像自带全部依赖不用碰 Python适合服务器长期运行。docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh✅ 验证同样打开http://localhost:7860/。⚠️ 出错时curl localhost:7860无响应先看docker logs里容器有没有在拉模型7860:7860提示端口被占就改成-p 8080:7860改用 8080 访问。镜像构建逻辑见 Dockerfile想配合其他本地模型跑可以研究 docker-compose.yml。四、Windows 绿色版解压双击就能跑前提Windows 10/11。从仓库 Release 页下载pdf2zh-version-win64.zip解压后双击pdf2zh.exe会自动打开浏览器进入本地 7860 端口的界面✅ 验证标准与其他路线相同。⚠️ 最大的坑双击没反应或闪退通常是缺 VC 运行库vc_redist.x64装上再试。首次翻译同样要下载排版模型慢就设置HF_ENDPOINThttps://hf-mirror.com。五、局域网分享与公网访问怎么配置临时分享只加一个--share参数启动时会多打印一条 Gradio 公网链接直接发给同事适合演示pdf2zh -i --share链接是临时的、会过期不适合长期对外。长期对外服务器上用 Docker 跑映射写成-p 0.0.0.0:7860:7860让外部可达再用 Nginx 反代加域名和 HTTPS 证书把 443 指向本机 7860。反代配置有三个要点转发 Host 和真实 IP 两个请求头加 WebSocket 升级头Gradio 界面靠它实时刷新client_max_body_size放大到 100M 以上PDF 上传体积不小。多用户鉴权--authorized users.txt即可文件每行一个用户名,密码可选第二个参数传入自定义登录页。对外服务建议同时在配置里设置HIDDEN_GRADIO_DETAILS隐藏服务端 API Key详见 高级配置文档。六、按症状调优慢、异常、质量不达标症状怎么调翻译慢加-t线程数默认 4确认没在重复翻译相同片段相同内容换了引擎却结果不变加了缓存--ignore-cache强制重翻公式字体被当正文翻乱了用-f正则把这些字体排除出翻译范围输出 PDF 打开渲染异常--skip-subset-fonts跳过字体子集化文件会变大译文风格不合预期写prompt.txt用--prompt prompt.txt加载自定义提示词文件里可用${lang_in}、${lang_out}、${text}三个占位符写清“保留公式和术语”这类要求即可格式细节见 docs/ADVANCED.md。翻译引擎方面默认 Google 无需配置国内网络友好一点的优先试三个DeepLX设DEEPLX_ENDPOINT指向自建代理、Ollama纯本地设OLLAMA_HOST、OLLAMA_MODEL、阿里云百炼qwen-mt设ALI_API_KEY、ALI_MODEL启动时-s指定。其余二十多种引擎及环境变量都在 高级配置文档 的表格里。七、踩坑速查现象到处理现象先检查什么怎么办局域网其他电脑打不开服务是不是绑在 127.0.0.1防火墙Docker 映射用 0.0.0.0放行 7860首次启动卡住不动是否在下载排版检测模型设HF_ENDPOINThttps://hf-mirror.com端口 7860 被占用换端口--serverport 8080Python或-p 8080:7860Docker鉴权后登录失败users.txt 格式每行用户名,密码不能多空格、不能漏逗号浏览器能开、上传报错反代上传体积限制调大 Nginxclient_max_body_size八、回顾与进阶资源三条路线Python、Docker、Windows 绿色版跑通后你拿到的都是同一个 7860 端口的网页翻译界面对外分享用--share临时链接或“域名 证书 反代”两条路之后的调优都是对照症状改参数。想继续深入高级配置缓存、字体、配置示例Python / HTTP API 文档GUI 使用说明Docker 镜像配置【免费下载链接】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），仅供参考 
长河君 · 2026/9/1 21:20:24 · 阅读 1.2k PDFMathTranslate 部署与公网访问教程：从本机运行到团队共享
PDFMathTranslate 部署与公网访问教程从本机运行到团队共享【免费下载链接】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 论文翻译工具在本机跑起来并配置成可供团队访问的网页服务个人从零到能用大约 10 分钟配置公网访问再加 20 分钟左右。30 秒自测先回答三个问题再往下读你的机器是什么系统Windows / 有 Python 的电脑 / 有 Docker 的服务器只自己用还是要给同事用试一两次就停还是打算长期挂着答案对号入座自己试 → 去对应路线小节给别人用 → 先跑起来再看“局域网分享与公网访问”一节。一、如何选部署方式先看对比表选路线前先看这张表前提是每种方式对环境的不同要求方式适合谁最省心的场景常见坑Python 安装3.11–3.12 环境想随时改参数个人电脑试一两篇装依赖和下载模型都要网络顺畅Docker 容器服务器或长期服务团队共用一个地址7860 端口可能被占用拉镜像偶尔慢Windows 绿色版不想装任何环境的 Windows 用户解压双击就走缺 VC 运行库时 exe 打不开三种方式最终得到的是同一个东西一个跑在 7860 端口的网页翻译界面所以后面的“验证”和“调优”内容对谁都适用。二、Python 环境安装后一条命令起网页前提Python 3.11 或 3.12。这条路适合要改翻译参数、排查问题的场景。安装并直接启动网页界面一条命令搞定pip install uv uv tool install --python 3.12 pdf2zh pdf2zh -i✅ 验证浏览器打开http://localhost:7860/看到上传框和参数面板即算成功把 PDF 拖进去点 Translate产物单语版example-mono.pdf、双语版example-dual.pdf生成在当前目录。⚠️ 出错时安装报依赖错误九成是 Python 版本不在 3.11–3.12首次翻译卡住或报错是在下载排版检测模型网络不佳时设置HF_ENDPOINThttps://hf-mirror.com再试详见 docs/ADVANCED.md。三、Docker 容器拉镜像、映射 7860 端口前提装好 Docker。镜像自带全部依赖不用碰 Python适合服务器长期运行。docker pull byaidu/pdf2zh docker run -d -p 7860:7860 byaidu/pdf2zh✅ 验证同样打开http://localhost:7860/。⚠️ 出错时curl localhost:7860无响应先看docker logs里容器有没有在拉模型7860:7860提示端口被占就改成-p 8080:7860改用 8080 访问。镜像构建逻辑见 Dockerfile想配合其他本地模型跑可以研究 docker-compose.yml。四、Windows 绿色版解压双击就能跑前提Windows 10/11。从仓库 Release 页下载pdf2zh-version-win64.zip解压后双击pdf2zh.exe会自动打开浏览器进入本地 7860 端口的界面✅ 验证标准与其他路线相同。⚠️ 最大的坑双击没反应或闪退通常是缺 VC 运行库vc_redist.x64装上再试。首次翻译同样要下载排版模型慢就设置HF_ENDPOINThttps://hf-mirror.com。五、局域网分享与公网访问怎么配置临时分享只加一个--share参数启动时会多打印一条 Gradio 公网链接直接发给同事适合演示pdf2zh -i --share链接是临时的、会过期不适合长期对外。长期对外服务器上用 Docker 跑映射写成-p 0.0.0.0:7860:7860让外部可达再用 Nginx 反代加域名和 HTTPS 证书把 443 指向本机 7860。反代配置有三个要点转发 Host 和真实 IP 两个请求头加 WebSocket 升级头Gradio 界面靠它实时刷新client_max_body_size放大到 100M 以上PDF 上传体积不小。多用户鉴权--authorized users.txt即可文件每行一个用户名,密码可选第二个参数传入自定义登录页。对外服务建议同时在配置里设置HIDDEN_GRADIO_DETAILS隐藏服务端 API Key详见 高级配置文档。六、按症状调优慢、异常、质量不达标症状怎么调翻译慢加-t线程数默认 4确认没在重复翻译相同片段相同内容换了引擎却结果不变加了缓存--ignore-cache强制重翻公式字体被当正文翻乱了用-f正则把这些字体排除出翻译范围输出 PDF 打开渲染异常--skip-subset-fonts跳过字体子集化文件会变大译文风格不合预期写prompt.txt用--prompt prompt.txt加载自定义提示词文件里可用${lang_in}、${lang_out}、${text}三个占位符写清“保留公式和术语”这类要求即可格式细节见 docs/ADVANCED.md。翻译引擎方面默认 Google 无需配置国内网络友好一点的优先试三个DeepLX设DEEPLX_ENDPOINT指向自建代理、Ollama纯本地设OLLAMA_HOST、OLLAMA_MODEL、阿里云百炼qwen-mt设ALI_API_KEY、ALI_MODEL启动时-s指定。其余二十多种引擎及环境变量都在 高级配置文档 的表格里。七、踩坑速查现象到处理现象先检查什么怎么办局域网其他电脑打不开服务是不是绑在 127.0.0.1防火墙Docker 映射用 0.0.0.0放行 7860首次启动卡住不动是否在下载排版检测模型设HF_ENDPOINThttps://hf-mirror.com端口 7860 被占用换端口--serverport 8080Python或-p 8080:7860Docker鉴权后登录失败users.txt 格式每行用户名,密码不能多空格、不能漏逗号浏览器能开、上传报错反代上传体积限制调大 Nginxclient_max_body_size八、回顾与进阶资源三条路线Python、Docker、Windows 绿色版跑通后你拿到的都是同一个 7860 端口的网页翻译界面对外分享用--share临时链接或“域名 证书 反代”两条路之后的调优都是对照症状改参数。想继续深入高级配置缓存、字体、配置示例Python / HTTP API 文档GUI 使用说明Docker 镜像配置【免费下载链接】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），仅供参考