跳到正文
Manga Translator Wiki

简体中文

English

简体中文

English

外观

Web 启动与访问 ​

当需要把 Manga Translator 作为 Web 服务运行，并通过浏览器上传图片、配置参数和查看结果时，使用本页。正式 web 子命令在同一进程内提供用户界面（GET / 主工作区、GET /admin 管理界面和 /static/* 静态资源）和开发者 HTTP API；这里仅列出“启动服务 + 浏览器访问”这条用户路径。登录、会话、注册和语言切换的完整操作见登录、语言与会话，上传与翻译操作见上传配置与翻译，HTTP API 契约与内部 ws/shared 协议分别见开发者页面和CLI Web、WS 与 Shared 模式。

页面与接口范围 ​

  • 正式入口是 python -m manga_translator web；默认监听 0.0.0.0、默认端口 8000，可用 MT_WEB_HOST/MT_WEB_PORT 环境变量或 --host/--port 参数覆盖。manga_translator/server/args.py 里另有一套未被正式顶层解析器使用的 127.0.0.1:8000 解析器，不能据此改写正式默认值。
  • web、local、ws、shared 是并列子命令：local 是命令行批量翻译，不监听端口；ws（本地监听 127.0.0.1:5003、上游 ws://localhost:5000）和 shared（127.0.0.1:5003）是内部执行器协议，浏览器不直接访问。
  • 本页属于 Web 用户端：GET / 的普通用户界面、GET /admin 的管理界面和 static/login.html 的会话入口。所有 JSON、表单和流式端点归开发者 HTTP API 页面，即使静态前端会调用其中一部分。
  • 默认 0.0.0.0 表示监听所有网卡：本机、局域网和端口映射都能访问，也意味着服务默认暴露在网络上。

启动 Web 服务 ​

通过命令行启动 ​

在仓库根目录使用项目受管运行时：

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

该命令等价于默认值 --host 0.0.0.0 --port 8000。启动过程中：

  1. __main__.py 在解析参数前尝试导入 torch；PyTorch 缺失或 DLL 不兼容时，可能连帮助输出都会失败。
  2. 读取应用目录下的 .env（存在时加载，只打印已加载 key 的名称，不打印值）；找不到时打印警告。
  3. 初始化服务器配置和数据目录（manga_translator/server/data 下的 admin 配置、用户资源目录），然后由 Uvicorn 监听 host:port，timeout_keep_alive=1800（保持连接 30 分钟）、优雅关闭超时 30 秒。
  4. 打印 [SERVER CONFIG] 摘要和内部 nonce（用于 shared 执行器注册；不要把该值复制进公开报告）。

web 子命令选项（环境变量在进程启动时求值，优先级高于帮助文本中的基准值）。

例如只在本机监听并改用端口 8080：

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

注意：直接运行 python manga_translator/server/main.py 会导入不存在的 manga_translator.args.parse_arguments，这不是正式入口；请始终使用 python -m manga_translator web。

通过 Docker 启动 ​

packaging/docker-compose.yml 提供 CPU 与 GPU 两个服务，容器内都监听 8000，主机映射不同：

服务镜像主机映射主机访问地址
manga-translator-cpumanga-translator:cpu8000:8000http://localhost:8000
manga-translator-gpumanga-translator:gpu8001:8000http://localhost:8001

Dockerfile 声明 EXPOSE 8000，启动命令为 python -m manga_translator web --host 0.0.0.0 --port 8000。compose 为首次启动设置管理员密码环境变量（示例值，暴露到网络前必须修改，这里不展示真实值），并把 fonts、dict、result、models、logs、manga_translator/server/data、config 挂载为数据卷；.env 持久化需要显式挂载 data/app.env。镜像构建、升级与卸载见安装：Docker。

浏览器访问 ​

启动成功后，在浏览器地址栏输入：

场景地址
本机 CLIhttp://localhost:8000/ 或 http://127.0.0.1:8000/
局域网http://<服务器 IP>:8000/（0.0.0.0 监听所有网卡）
Docker CPUhttp://localhost:8000/
Docker GPUhttp://localhost:8001/

GET / 由 routes/web.py 返回 static/index.html；文件缺失时返回占位 HTML “Web UI not installed”。/static/* 由 StaticFiles 挂载，/locales/* 在 desktop_qt_ui/locales 目录存在时也会挂载；GET /admin 返回 admin-new.html（只有管理员账号才显示入口链接）。

首次访问与登录入口 ​

主脚本 script.js 在页面加载时读取 localStorage.session_token 并调用 GET /auth/check：

  • 无 token、请求失败或 valid=false：清除本地 token，跳转到 /static/login.html。
  • login.html 先调用 GET /auth/status：没有任何用户时返回 need_setup=true，页面显示“首次使用，请创建管理员账户”；已有账号且管理员开启注册时显示登录/注册页签，否则只显示登录。
  • 登录成功后 token 写入 localStorage.session_token，回到 / 进入主工作区。
flowchart LR
    A["终端或 Docker 启动 web"] --> B["uvicorn 监听 0.0.0.0:8000"]
    B --> C["浏览器访问 http://localhost:8000/"]
    C --> D{"localStorage.session_token 且 /auth/check 有效?"}
    D -->|否| E["跳转 /static/login.html"]
    E --> F["登录或首次创建管理员"]
    F --> G["回到 / 主工作区"]
    D -->|是| G
    G --> H["上传、配置、翻译（见其他页面）"]

该图只描述会话检查分支；need_setup、注册开关、强制改密和旧式密码门等状态属于登录、语言与会话，不在这里展开。

语言与界面入口 ​

主界面头部提供语言选择下拉框，选择值写入 localStorage.locale，页面从 /i18n/{locale} 拉取桌面 locale JSON 后应用翻译；加载失败时回退到 /i18n/en_US。默认语言按 localStorage.locale → 浏览器语言（en/zh/ja/ko/es 前缀）→ zh_CN 的顺序决定。页面标题和头部 H1 使用 locale key Manga Translator，i18n 加载前回退为 HTML 标题 “Manga Translator Web UI”。

端口与外部暴露 ​

场景端口文档口径
Web（正式 web 子命令）0.0.0.0:8000（MT_WEB_HOST/MT_WEB_PORT 可覆盖）用户界面与 HTTP API 共用，浏览器访问入口
Docker CPU容器监听 8000，映射 8000:8000主机入口 8000
Docker GPU容器监听 8000，映射 8001:8000主机入口 8001，不是容器内默认 8000
ws 内部本地监听 127.0.0.1:5003；上游 ws://localhost:5000内部协议，浏览器不直接访问；见 CLI 与开发者页面
shared 内部127.0.0.1:5003内部协议；见开发者页面

CORS 源码配置为 allow_origins=["*"]、allow_credentials=True 且放行全部方法和头；这是服务端配置，不代表浏览器在所有 origin/credential 组合下都会放行，真实预检行为需要在实际环境中确认。

依赖与安全注意事项 ​

  • 默认监听 0.0.0.0 意味着局域网可访问；如需仅本机使用，请用 --host 127.0.0.1。Windows 防火墙可能拦截局域网入站，需要放行对应端口。
  • Docker compose 中的管理员密码是示例值，任何暴露到网络前的部署都必须修改；这里不展示真实密钥、令牌或用户名。
  • 服务启动会读取应用目录下的 .env 和 manga_translator/server/data 下的 admin 配置；文档不读取、不展示这些真实文件内容，也不复制日志中打印的 nonce。
  • 浏览器把 session_token、locale、user_env_vars 等保存在 localStorage；它们不是服务器历史记录，清空浏览器数据会丢失本地状态（详见进度、结果与历史页）。
  • python -m manga_translator 在解析参数前导入 PyTorch；缺少 PyTorch 或 DLL 不兼容时可能无法启动，属于环境问题而非参数错误。
  • 不要用浏览器直接访问 ws/shared 端口；它们需要 nonce/secret 和内部协议。

详见参考索引：界面选项对照表。