zotero-pdf2zh 是一个开源的 PDF 自动翻译服务，支持将英文 PDF 批量翻译为简体中文，适配 Zotero 插件，可通过浏览器或容器方式使用。 本项目基于 ayuriko/zotero-pdf2zh Docker 镜像构建，支持多翻译源（API 接入)，并内置中文字体，确保翻译结果完整美观。
1. 准备工作
请提前确保系统已安装 Docker 和 Docker Compose。 如果你使用的是 Debian 或 Ubuntu，可参考本指南进行安装： Debian&Ubuntu 安装 Docker&Docker Compose 指南
1.1 创建目录及下载必要文件
mkdir -p docker/zotero-pdf2zh/translated
cd docker
1.2 手动下载配置文件和字体
请分别手动下载以下文件并放入 docker/zotero-pdf2zh 目录：
- 配置文件 config.json 点击下载 config.json
- 字体文件 LXGWWenKai-Regular.ttf 点击下载 LXGWWenKai-Regular.ttf
1.3 确认文件结构
docker/
├── docker-compose.yaml
└── zotero-pdf2zh/
├── config.json
├── LXGWWenKai-Regular.ttf
└── translated/ # 用于存放翻译输出
2. 配置 docker-compose.yaml
编辑或新建 docker-compose.yaml，示例内容如下，使用镜像 ayuriko/zotero-pdf2zh：
version: '3.8'
services:
zotero-pdf2zh:
image: ayuriko/zotero-pdf2zh:latest
container_name: zotero-pdf2zh
restart: unless-stopped
ports:
- "8888:8888"
environment:
- TZ=Asia/Shanghai
- HF_ENDPOINT=https://hf-mirror.com
volumes:
- ./zotero-pdf2zh/translated:/app/translated
- ./zotero-pdf2zh/config.json:/app/config.json
- ./zotero-pdf2zh/LXGWWenKai-Regular.ttf:/app/LXGWWenKai-Regular.ttf
3. 启动容器
直接后台运行：
docker compose up -d
首次运行建议不加 -d 参数，观察日志是否正常：
docker compose up
4. Zotero 插件使用教程
Zotero 插件提供了便捷的浏览器端一键翻译功能，适用于已安装本地或网页版 Zotero 的用户。
插件获取
插件配置
- 插件中的「翻译服务地址」需指向你部署的
zotero-pdf2zh容器服务。
如果你是 在本机运行：
填写：
http://localhost:8888
如果你是 在远程服务器部署：
请将 localhost 替换为你服务器的 公网 IP 或域名，例如：
http://your-server-ip:8888
或：
https://translate.example.com
如果通过 HTTPS 反向代理，请确保 Nginx / Caddy 等代理已配置好证书。
若浏览器提示连接失败，请确保容器已启动，且防火墙未阻挡 8888 端口。
5. 使用说明
- 配置好服务器地址即可开始使用
- 翻译结果会输出到
docker/zotero-pdf2zh/translated文件夹。 - 配置文件
config.json中的"NOTO_FONT_PATH"应对应字体文件名：
"NOTO_FONT_PATH": "./LXGWWenKai-Regular.ttf"
- 如果翻译后字体显示异常，请确认字体文件已正确挂载且路径无误。
6. 效果参考
