如何快速部署 Manga Translator UI Web 服务器：账号、配额与多用户权限完整指南-拓冰网站定制

如何快速部署 Manga Translator UI Web 服务器：账号、配额与多用户权限完整指南

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

Manga Translator UI 是一款开源漫画 AI 翻译桌面工具，除桌面版外还支持一键启动 Web 服务器，让团队成员通过浏览器上传图片、翻译日/韩/英漫画并在线编辑译文。本文面向新手，讲清楚 Web 服务器的部署步骤、管理员账号创建、用户注册、用户组权限和配额限制的完整配置方法，帮助你快速搭建一套多人可用的漫画翻译服务。

Web 端与桌面端共用同一套翻译引擎（OCR 检测、原文擦除、AI 翻译、图像修复、译文排版），支持 OpenAI、Gemini、Sakura 等多种翻译器。桌面端的翻译参数示例见下图，Web 管理界面中对这些参数的可见性与默认值控制，正是多用户权限管理的核心。

一键启动 Web 服务器：两种部署方式

方式一：命令行直接启动

在仓库根目录执行（需已按 doc/INSTALLATION.md 配置好运行环境）：

uv run --no-sync python -m manga_translator web

默认监听0.0.0.0:8000（所有网卡，局域网可访问）。只允许本机访问时建议：

uv run --no-sync python -m manga_translator web --host 127.0.0.1 --port 8080

启动入口与参数定义见 manga_translator/server/main.py 和 manga_translator/server/args.py。⚠️ 请始终使用python -m manga_translator web，不要直接运行server/main.py。

方式二：Docker 部署（推荐长期运行）

仓库自带 packaging/docker-compose.yml，提供 CPU 与 GPU 两个服务：

服务	端口映射	访问地址
`manga-translator-cpu`	`8000:8000`	`http://localhost:8000`
`manga-translator-gpu`	`8001:8000`	`http://localhost:8001`

git clone https://gitcode.com/gh_mirrors/man/manga-translator-ui cd manga-translator-ui/packaging && docker compose up -d manga-translator-cpu

📌 注意：GPU 版的主机入口是8001，不是容器内的 8000。数据卷挂载了models、fonts、config、server/data等目录，账号、配额与密钥配置都会持久化。Docker 部署细节见 doc/wiki/zh/install/docker.md。

首次访问：创建管理员账号与登录安全

启动成功后，浏览器打开http://localhost:8000/：

首次访问：登录页显示"首次使用，请创建管理员账户"，填写用户名（≥2 字符）和密码（≥6 字符）提交后创建第一个admin角色账号并自动登录。
日常登录：GET /主工作区需要登录；GET /admin管理界面只有管理员可见入口。
注册开关：默认关闭。管理员在"服务器配置"中开启"允许用户注册"后，登录页才会出现注册页签，新账号进入默认用户组default。
安全机制：登录按 IP（15 次/10 分钟）和用户名（8 次/10 分钟）限速；会话 60 分钟不活动自动过期；管理端可在"会话管理"中撤销他人的活跃会话。

详细流程见 doc/wiki/zh/web/launch-and-access.md 与 doc/wiki/zh/web/login-language-and-session.md。

多用户权限管理：用户组、白名单与 API 密钥策略

用管理员账号进入http://localhost:8000/admin，共 12 个模块：仪表盘、用户管理、用户组管理、配额管理、会话管理、任务监控、历史记录、系统日志、API 密钥管理、服务器配置、公告管理、清理管理。

账号与用户组

系统只有两种角色：admin与user；每个用户都属于一个用户组（默认default，管理员通常在admin组）。
"用户管理"中可创建用户、设置用户组、指定 API 密钥预设、启用/禁用或删除账号。
"用户组管理"中可批量配置该组的参数可见性（每个参数行有"启用/禁用"开关，禁用后用户端看不到该参数）、功能白名单与黑名单。

权限判定优先级（高 → 低）

用户黑名单 → 用户白名单 → 用户组黑名单 → 用户组白名单

白名单可解锁用户组禁用的能力（*表示全部允许）；黑名单始终优先。
功能权限覆盖翻译器、OCR、上色器、渲染器、工作流和具体参数键（如translator.target_lang）。
前端只是隐藏无权限的控件，服务端会对每个翻译请求再次校验，未授权请求返回403。

API 密钥策略（每个用户组的四项开关）

策略	效果
`show_env_editor`	是否允许用户在主页编辑 API Keys（.env）页签
`allow_server_keys`	是否允许回落服务器默认`.env`密钥
`require_user_keys`	无用户密钥/预设时直接拒绝翻译（403）
`save_user_keys_to_server`	是否把用户密钥写入服务器`.env`（多用户环境不建议开启）

密钥生效顺序为：用户填写 > 当前选中的 API 密钥预设 > 服务器默认。管理员可在"API 密钥管理"中创建预设并分配给用户组，预设支持按可见用户组控制。页面永远拿不到密钥明文，只返回来源元数据。

完整说明见 doc/wiki/zh/web/accounts-permissions-and-api-keys.md 与 doc/wiki/zh/web/administrator-interface.md。

配额管理：限制并发任务与每日用量

多人共用服务器时，配额是防止资源被单个用户占满的关键。配额解析顺序为：用户组配额 > 用户级配额 > 服务器默认。

配额项	默认值	说明
`max_concurrent_tasks`	普通用户 2 / 管理员 10	同时运行的任务数
`daily_quota`	普通用户 100 /`-1`无限制	每日任务量
`max_image_size_mb`	服务器配置	单张图片大小上限
`max_images_per_batch`	服务器配置	单批次图片数上限

"配额管理"模块可查看每个用户今日/本月使用量（进度条超过 80% 变红）。
服务器级默认配额、最大并发、任务超时、允许的文件格式等统一在"服务器配置"中保存。
超限请求返回429，用户端会看到限流提示而不是服务崩溃。

常见问题速查

现象	原因与处理
端口被占用	换`--port 8001`或设置`MT_WEB_PORT`环境变量
局域网无法访问	确认`--host 0.0.0.0`、防火墙放行 8000 端口、使用服务器实际局域网 IP
登录后提示"尝试过于频繁"	触发限流，按`Retry-After`等待后重试
管理界面返回 403	当前账号不是管理员，换管理员登录
GPU 容器访问不到	主机入口是 8001，不是 8000
页面反复跳回登录页	会话 60 分钟过期或本地存储被清空，重新登录即可

更多排错见 doc/wiki/zh/web/deployment-security-and-troubleshooting.md；翻译任务上传与配置见 doc/wiki/zh/web/upload-config-and-translate.md。

总结

按本文三步即可上线：

🚀启动：python -m manga_translator web或 Docker Compose（CPU/GPU 二选一）；
👤建号：首次访问创建管理员，按需开启用户注册；
⚖️分权：用用户组统一配置权限白/黑名单、API 密钥预设与每日配额，个别用户再做覆盖。

这套"用户组继承 + 用户级覆盖"的设计让你无需改一行代码，就能为翻译团队搭建安全、可控、可审计的漫画 AI 翻译 Web 服务。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

资讯详情

如何快速部署 Manga Translator UI Web 服务器：账号、配额与多用户权限完整指南