企业官网建设流程全解析

Manga Translator UI Docker部署教程：容器化运行与GPU加速的完整步骤

【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理，集成OpenAl、Gemini等多翻译引擎；实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路，自带可视化编辑器，支持自定义文本样式，一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui

Manga Translator UI 是一款基于 manga-image-translator 的开源漫画AI翻译桌面与Web工具，支持日、韩、英文漫画的自动处理，集成 OpenAI、Gemini 等翻译引擎，覆盖 OCR 文字检测、原文擦除、AI翻译、图像修复、译文排版的完整链路。本文以Manga Translator UI Docker部署为主线，带你从零完成容器化运行与 GPU 加速配置，一条命令即可启动开箱即用的漫画AI翻译Web服务。

为什么选择 Docker 部署 Manga Translator UI

手动安装依赖（Python、CUDA、ONNX Runtime、模型权重）繁琐且容易版本冲突。Manga Translator 官方提供了 Docker 镜像，把整套漫画AI翻译环境封装在容器里：

• 开箱即用：镜像内置 Web 界面 + HTTP API，启动后浏览器即可上传漫画开始翻译；
• CPU / GPU 双版本：CPU 版基于python:3.12-slim，GPU 版基于nvidia/cuda:12.1.0运行时，按机器条件二选一；
• 数据持久化：模型、配置、日志、翻译结果全部通过卷挂载到宿主机，重建容器不丢失数据。

💡 小提示：Docker 镜像提供的是Web 服务（界面 + API），不包含桌面 Qt 工作区；如果你需要本地可视化编辑器，请使用桌面版安装。

最快启动方法：一条命令体验 CPU 版

先装好 Docker（含 Docker Compose），然后用发布镜像直接运行，无需构建：

docker run -d --name manga-translator -p 8000:8000 hgmzhn/manga-translator:latest-cpu

启动完成后打开：

• 用户界面：http://localhost:8000
• 管理界面：http://localhost:8000/admin

首次访问登录页时，按页面提示创建第一个管理员账号即可开始翻译。镜像同时发布在 Docker Hub 与 GHCR 两个仓库，网络不佳的地区可任选其一拉取。

GPU 加速部署：NVIDIA 显卡的完整配置

有 NVIDIA 显卡的机器推荐使用 GPU 版，OCR 检测与图像修复速度会有显著提升。GPU 部署需要满足 3 个前提：

1. 宿主机安装NVIDIA 驱动；
2. 安装NVIDIA Container Toolkit，让容器能访问显卡；
3. 使用 GPU 镜像并把MT_USE_GPU设为true。

# GPU 版快速启动（宿主机 8001 端口映射到容器 8000 端口） docker run -d --name manga-translator-gpu --gpus all -p 8001:8000 \ -e MT_USE_GPU=true hgmzhn/manga-translator:latest-gpu

启动后访问http://localhost:8001。注意容器内部始终监听8000，宿主端口8001只是外部入口，可随时改成其他空闲端口。

Docker Compose 持久化部署步骤（长期使用推荐）

项目仓库内置了完整的 Compose 编排文件 packaging/docker-compose.yml，同时定义了manga-translator-cpu和manga-translator-gpu两个服务。注意：两个服务只启动一个，否则会占用两个 Web 端口和两份模型内存。

在packaging/目录下执行：

# CPU 版 docker compose up -d manga-translator-cpu # 或 GPU 版 docker compose up -d manga-translator-gpu

长期运行的关键是把数据目录挂载出来，官方 Compose 已配置好全部 7 个持久化卷：

🔁自动初始化机制：镜像内的启动脚本 packaging/docker-entrypoint.sh 会在每次启动时检查这些挂载目录——目录为空时自动从镜像备份恢复默认配置、字体、词典，所以你即使挂载空目录也能直接跑起来。

另外，若希望 Web 管理界面里保存的服务器 API Key 在重建容器后保留，先创建空文件packaging/data/app.env，再取消 Compose 中./data/app.env:/app/.env这行注释即可。

常用环境变量与内存限制参考

Compose 中通过环境变量覆盖运行时行为，常用项如下：

内存方面，官方 Compose 给出的参考值为：CPU 服务上限8G（预留 2G），GPU 服务上限16G（预留 4G），请根据服务器实际配置调整 packaging/docker-compose.yml。模型首次启用时会下载权重并占用较多磁盘/内存，属于正常现象。

健康检查与故障排查

镜像内置了健康检查：启动后每 30 秒用curl http://localhost:8000/探测一次，60 秒宽限期内连续失败 3 次会被标记为unhealthy。排查时按顺序执行：

docker logs -f manga-translator # 查看启动日志 docker ps # 确认 STATUS 列健康状态 docker exec -it manga-translator curl -f http://localhost:8000/

常见问题：

• 端口被占用：把宿主机端口8000:8000改成8080:8000等空闲端口即可；
• GPU 版启动报显存/驱动错误：先确认nvidia-smi在宿主机正常，且已安装 NVIDIA Container Toolkit；
• 局域网访问不通：0.0.0.0只是监听所有接口，实际访问还受防火墙与路由影响，需自行放行端口。

部署完成后的下一步

服务跑起来之后，就可以体验完整的漫画AI翻译链路了：上传日漫章节 → 自动检测文字区域 → 擦除原文 → 调用 AI 翻译 → 智能排版回写。桌面版则提供完整的可视化编辑器，支持蒙版编辑、笔刷修复与自定义文本样式，编辑器源码位于 desktop_qt_ui/editor/，翻译引擎实现位于 manga_translator/translators/，可进一步阅读。

更多细节可参考官方文档：Docker 部署指南（中文）、Docker 部署指南（英文）。

📌最后三条安全提醒：

1. 公开部署前，务必把示例管理员密码替换为随机长密码；
2. 不要把.env、账号数据、API Key 等敏感内容提交到 Git；
3. 定期备份data/server与data/result，它们包含你的账号与翻译成果。

【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理，集成OpenAl、Gemini等多翻译引擎；实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路，自带可视化编辑器，支持自定义文本样式，一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui