wenyi文译Web工作台Docker部署：10分钟从命令行搭建可视化翻译平台-育师

wenyi文译Web工作台Docker部署：10分钟从命令行搭建可视化翻译平台

【免费下载链接】wenyi将被语言阻隔的作品，带到读者的语言中。Bringing literature into your language.项目地址: https://gitcode.com/gh_mirrors/we/wenyi

wenyi文译是一个专为书籍与长文本设计的 AI 翻译平台，支持整书理解、术语一致性与证据化审校。本文带你用 Docker 一行命令完成 wenyi 文译 Web 工作台的部署，10 分钟即可在浏览器中创建翻译项目、实时查看进度、人工校对段落并导出双语 EPUB。

为什么选择 wenyi 文译 Web 工作台

普通的 AI 翻译工具逐段翻译、互不知晓上下文，而 wenyi 文译面向整本书设计：

整书预扫描：翻译前生成全书概要与各章摘要，注入每个翻译批次
实时术语表：翻译过程中自动抽取人名、术语，并检测冲突译法
多阶段质量流程：翻译 → 润色 → 基于证据的全书 AI 审校
断点续传：按批次保存检查点，中断后重跑同一命令即可继续
可视化工作台：实时进度、Token 用量、逐段人工校对、一键导出

Web 工作台由 React 前端、FastAPI 后端、两个 Arq 工作进程、PostgreSQL 与 Redis 组成，所有组件通过 Docker Compose 一键拉起，详见 docs/web.md。

部署前准备：环境要求与源码获取

检查 Docker 环境

只需要两个东西：Docker和Compose v2插件。

docker --version docker compose version

克隆 wenyi 文译仓库

git clone https://gitcode.com/gh_mirrors/we/wenyi cd wenyi

10分钟搭建：wenyi 文译 Docker 部署步骤

第 1 步：配置 API 密钥（1 分钟）

把根目录的环境变量模板复制到deploy/目录，并填入你实际使用的模型服务商密钥：

cp .env.example deploy/.env

打开deploy/.env，至少填写一个提供商，例如：

DEEPSEEK_API_KEY=sk-...

说明：

只需填写config.yaml中实际路由用到的提供商密钥，未使用的可以留空
若使用 MinerU 解析 PDF 书籍，再补上MINERU_API_KEY
国内网络可在该文件中取消DEBIAN_MIRROR、UV_DEFAULT_INDEX、NPM_REGISTRY的注释以使用镜像源，加速构建

默认模型配置见根目录 config.yaml，llm.preset默认为deepseek，语言方向由language.source/language.target控制。

第 2 步：一条命令启动全部服务（约 8 分钟）

cd deploy docker compose up -d --build

这条命令会构建并启动 6 个服务：API、Web、工作流 Worker、导出 Worker、PostgreSQL 16 和 Redis 7，完整编排定义在 deploy/docker-compose.yml。首次构建需要拉取基础镜像并安装依赖，请耐心等待；API 与 Worker 镜像基于 docker/Dockerfile.api，默认包含 WeasyPrint、Noto CJK 字体，开箱即支持 PDF 导出。

访问与验证 wenyi 文译翻译工作台

服务就绪后，打开浏览器访问：

服务	地址
🌐 Web 工作台	`http://localhost:8080`
🔌 API / OpenAPI 文档	`http://localhost:8000/docs`
数据库 / 缓存	默认仅容器内网，不暴露端口

看到登录后的项目列表页，即表示 Docker 部署成功。接下来在网页中：

进入创建项目，选择源/目标语言，拖入 EPUB、DOCX、TXT、Markdown、HTML、PDF 或 SRT 文件
上传后自动解析并展示章节预览，点击创建
在翻译总览页实时查看 Token 用量、缓存命中率与运行耗时
翻译完成后进入人工校阅，原文与译文左右对照，右键即可编辑、查看修改记录
在导出页选择单语/双语版本，独立导出 Worker 会基于快照生成成品文件

常用 Docker 管理命令与故障排查

在deploy/目录下执行：

docker compose logs -f # 跟踪日志，定位任务失败原因 docker compose down # 停止服务（数据卷保留，数据不丢） docker compose up -d --build # 修改配置后重建并重启

常见问题速查：

任务一直排队：确认worker与export-worker已启动，且与 API 共享同一 Redis
缺少模型凭证：检查deploy/.env中对应提供商变量是否已填写，改完后重建容器
PDF 解析失败：核对 MinerU 密钥与解析后端配置
数据在哪：书籍原件、解析缓存与导出成品保存在 Compose 的data卷（容器内/data），数据库状态在pgdata卷，down不会删除它们