Zotero PDF2zh Docker部署指南：一键搭建本地翻译服务环境
Zotero PDF2zh Docker部署指南：一键搭建本地翻译服务环境
【免费下载链接】zotero-pdf2zhPDF2zh for Zotero | Zotero PDF中文翻译插件项目地址: https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh
Zotero PDF2zh是一款专为Zotero设计的PDF中文翻译插件，通过Docker部署可以快速搭建稳定的本地翻译服务环境，让学术研究和文献阅读更高效。本文将详细介绍如何使用Docker一键部署Zotero PDF2zh翻译服务，即使是新手也能轻松完成。
为什么选择Docker部署Zotero PDF2zh？
Docker部署方式将服务所需的一切环境和依赖打包，实现一键启动，无需关心复杂的环境配置，是目前最简单、最稳定的部署方式。对于新手用户来说，这种方式可以避免因系统环境差异导致的各种问题，让你专注于翻译功能本身，而不是环境搭建。
第零步：安装Docker环境
在使用Docker部署Zotero PDF2zh之前，需要先在你的操作系统上安装Docker环境。
Windows用户
- 开启WSL2：以管理员身份打开PowerShell，执行
wsl --install，然后重启电脑。 - 安装Docker Desktop：访问Docker Desktop官网下载并安装。
macOS用户
访问Docker Desktop官网下载并安装。
Linux用户
执行以下命令一键安装：
curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo usermod -aG docker $USER # 重启或重新登录以生效安装完成后，打开终端，执行docker --version和docker compose version，如果能看到版本号，说明安装成功。
第一步：获取项目文件
首先需要获取Zotero PDF2zh的Docker部署文件，执行以下命令：
# 1. 创建并进入项目文件夹 mkdir zotero-pdf2zh && cd zotero-pdf2zh # 2. 下载Docker配置文件 wget https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/main/docker2/docker-compose.yaml wget https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/main/docker2/Dockerfile # 3. 创建用于存放翻译文件的文件夹 mkdir -p zotero-pdf2zh/translated最终文件夹结构应如下：
zotero-pdf2zh/ ├── docker-compose.yaml ├── Dockerfile └── zotero-pdf2zh/ ├── translated/ └── LXGWWenKai-Regular.ttf # (可选) 将您的字体文件放在这里第二步：启动翻译服务
在确保您位于zotero-pdf2zh文件夹内后，执行以下命令启动服务：
# 首次启动或需要查看日志时，在前台启动 # 该命令会自动完成镜像构建和容器启动 docker compose up # 日常使用，在后台静默运行 docker compose up -d服务启动需要一些时间，当您在日志中看到* Running on http://0.0.0.0:8890时，代表服务已准备就绪。
第三步：配置Zotero插件
服务启动后，需要在Zotero插件中进行配置才能使用翻译功能。
在Zotero插件设置中，找到PDF2zh配置选项，将Python Server IP设置为http://localhost:8890即可开始使用。
容器管理常用命令
| 功能 | 命令 |
|---|---|
| 查看状态 | docker compose ps |
| 查看日志 | docker compose logs -f |
| 停止服务 | docker compose stop |
| 停止并删除容器 | docker compose down |
| 重启服务 | docker compose restart |
| 更新服务 | docker compose pull && docker compose up -d --build |
常见问题解决
Docker镜像下载太慢怎么办？
配置国内镜像加速器可大幅提升下载速度。推荐使用https://docker.xuanyuan.me。
Windows / macOS (Docker Desktop):
- 打开Docker Desktop设置 -> Docker Engine。
- 在JSON配置中加入以下内容后，点击"Apply & Restart"。
{ "registry-mirrors": ["https://docker.xuanyuan.me"] }Linux:执行以下命令自动配置并重启Docker。
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://docker.xuanyuan.me"] } EOF sudo systemctl daemon-reload sudo systemctl restart docker端口8890被占用了怎么办？
修改docker-compose.yaml中的端口映射，将冒号前的端口改成其他未被占用的端口，如8891。
ports: - "8891:8890" # 本地端口:容器端口同时，在Zotero插件中将服务地址改为http://localhost:8891。
如何使用自定义字体？
- 将您的字体文件（如
LXGWWenKai-Regular.ttf）放入zotero-pdf2zh/zotero-pdf2zh/文件夹。 - 修改
docker-compose.yaml，取消字体挂载的注释：
# ... volumes: - ./zotero-pdf2zh/translated:/app/server/translated # 取消下面一行的注释 - ./zotero-pdf2zh/LXGWWenKai-Regular.ttf:/app/LXGWWenKai-Regular.ttf- 重启容器：
docker compose up -d --build。
通过以上步骤，你已经成功搭建了Zotero PDF2zh的Docker翻译服务环境。现在，你可以在Zotero中愉快地使用PDF翻译功能，提升你的文献阅读效率！如果在使用过程中遇到其他问题，可以参考项目的官方文档或社区讨论获取帮助。
【免费下载链接】zotero-pdf2zhPDF2zh for Zotero | Zotero PDF中文翻译插件项目地址: https://gitcode.com/gh_mirrors/zo/zotero-pdf2zh
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考