Zotero PDF2zh Docker部署指南：一键搭建本地翻译服务环境

Zotero PDF2zh Docker部署指南一键搭建本地翻译服务环境【免费下载链接】zotero-pdf2zhPDF2zh for Zotero | Zotero PDF中文翻译插件项目地址: https://gitcode.com/gh_mirrors/zo/zotero-pdf2zhZotero PDF2zh是一款专为Zotero设计的PDF中文翻译插件通过Docker部署可以快速搭建稳定的本地翻译服务环境让学术研究和文献阅读更高效。本文将详细介绍如何使用Docker一键部署Zotero PDF2zh翻译服务即使是新手也能轻松完成。为什么选择Docker部署Zotero PDF2zhDocker部署方式将服务所需的一切环境和依赖打包实现一键启动无需关心复杂的环境配置是目前最简单、最稳定的部署方式。对于新手用户来说这种方式可以避免因系统环境差异导致的各种问题让你专注于翻译功能本身而不是环境搭建。第零步安装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），仅供参考