zotero-pdf2zh Docker 免构建部署教程

zotero-pdf2zh 是一个开源的 PDF 自动翻译服务，支持将英文 PDF 批量翻译为简体中文，适配 Zotero 插件，可通过浏览器或容器方式使用。本项目基于 ayuriko/zotero-pdf2zh Docker 镜像构建，支持多翻译源（API 接入)，并内置中文字体，确保翻译结果完整美观。

1. 准备工作#

请提前确保系统已安装 Docker 和 Docker Compose。

1.1 创建目录及下载必要文件#

1
mkdir -p docker/zotero-pdf2zh/translated
2
cd docker

1.2 手动下载配置文件和字体#

请分别手动下载以下文件并放入 docker/zotero-pdf2zh 目录：

配置文件 config.json
字体文件 LXGWWenKai-Regular.ttf

1.3 确认文件结构#

1
docker/
2
├── docker-compose.yaml
3
└── zotero-pdf2zh/
4
    ├── config.json
5
    ├── LXGWWenKai-Regular.ttf
6
    └── translated/   # 用于存放翻译输出

2. 配置 docker-compose.yaml#

编辑或新建 docker-compose.yaml，示例内容如下，使用镜像 ayuriko/zotero-pdf2zh：

1
version: '3.8'
2

3
services:
4
  zotero-pdf2zh:
5
    image: ayuriko/zotero-pdf2zh:latest
6
    container_name: zotero-pdf2zh
7
    restart: unless-stopped
8
    ports:
9
      - "8888:8888"
10
    environment:
11
      - TZ=Asia/Shanghai
12
      - HF_ENDPOINT=https://hf-mirror.com
13
    volumes:
14
      - ./zotero-pdf2zh/translated:/app/translated
15
      - ./zotero-pdf2zh/config.json:/app/config.json
16
      - ./zotero-pdf2zh/LXGWWenKai-Regular.ttf:/app/LXGWWenKai-Regular.ttf

3. 启动容器#

直接后台运行：

1
docker compose up -d

首次运行建议不加 -d 参数，观察日志是否正常：

1
docker compose up

4. Zotero 插件使用教程#

Zotero 插件提供了便捷的浏览器端一键翻译功能，适用于已安装本地或网页版 Zotero 的用户。

插件获取#

插件配置#

插件中的「翻译服务地址」需指向你部署的 zotero-pdf2zh 容器服务。

如果你是在本机运行：#

填写：

1
http://localhost:8888

如果你是在远程服务器部署：#

请将 localhost 替换为你服务器的 公网 IP 或域名，例如：

1
http://your-server-ip:8888

或：

1
https://translate.example.com

如果通过 HTTPS 反向代理，请确保 Nginx / Caddy 等代理已配置好证书。

若浏览器提示连接失败，请确保容器已启动，且防火墙未阻挡 8888 端口。

5. 使用说明#

配置好服务器地址即可开始使用
翻译结果会输出到 docker/zotero-pdf2zh/translated 文件夹。
配置文件 config.json 中的 "NOTO_FONT_PATH" 应对应字体文件名：

1
"NOTO_FONT_PATH": "./LXGWWenKai-Regular.ttf"

如果翻译后字体显示异常，请确认字体文件已正确挂载且路径无误。