NodeLane 漫译
下载插件
简体中文

本地翻译教程

本地漫画翻译教程：连接 manga-translator-ui 到 NodeLane

从启动 manga-translator-ui Web 服务、填写地址与账号，到在浏览器中翻译第一张漫画，逐步完成本地翻译设置，并排查连接、密码、等待和缓存问题。

NodeLane 漫译 编辑团队8 分钟

截图来自真实桌面插件，提供中、日、韩、英四版；漫画样张为项目原创。连接表单仅展示设置入口，不代表已连接服务。

开始前：准备插件和一个可用的翻译服务

NodeLane 漫译负责在浏览器中阅读漫画，manga-translator-ui（下文简称 MTU）负责处理图片。连接自己的 MTU 服务无需 NodeLane 账号，也不消耗官方翻译额度；所用硬件、模型或第三方 API 的费用由你自行承担。

准备桌面浏览器中的最新版插件、已经安装好依赖的 MTU，以及该服务的用户名和密码。本教程使用同一台电脑上的 http://127.0.0.1:8000 作为示例；端口以你的实际服务为准。

第一步：启动 MTU 的 Web 服务

插件需要可通过 HTTP 访问的 Web 服务。只打开 MTU 桌面窗口还不够。完成上游安装后，在 MTU 项目目录运行下面的 Web 启动命令，并保持服务运行；已通过 Docker 或其他方式启动 Web 服务的用户可以跳过这条命令。

此示例不启用 GPU；已配好受支持 GPU 环境的用户可按上游说明追加 --use-gpu。模型、驱动和硬件要求以所安装的 MTU 版本为准。

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

第二步：先在服务页面完成一次翻译

在浏览器打开 http://127.0.0.1:8000，完成 MTU 自身的账号初始化并登录。如果服务要求修改初始密码，先在服务页面修改，再连接插件。这里使用的是 MTU 账号，不是 NodeLane 账号。

在服务端配置翻译器、模型及需要的 API Key，用一张有权处理的测试图确认能得到译图。插件只指定目标语言，其余翻译参数使用服务端默认配置；请确认 Web 服务实际使用的配置已生效。API Key 不填入插件的“密码”字段。

第三步：在插件中添加翻译渠道

第三步：在插件中添加翻译渠道
第三步：在插件中添加翻译渠道查看大图 ↗

打开插件的设置页面，找到“翻译渠道”。连接成功后，插件会将密码和服务令牌保存到本机。重新连接同一服务地址和用户名时，可将密码留空以复用已保存的密码；更改服务地址或用户名，或密码已更改、失效时，需要重新输入密码。密码保存与留空密码重连需插件 0.10.2 或更新版本；更早版本每次重连都需重新输入密码。

  1. 点击“添加翻译渠道”，确认服务类型为 manga-translator-ui；可填写一个便于识别的名称，例如“我的电脑”。
  2. 在“服务地址”填入 http://127.0.0.1:8000。填写服务根地址，不要追加 /auth/login、/translate/with-form/image 或管理页面路径。
  3. 填写 MTU 的“用户名”和“密码”，点击“连接并使用”。连接不会另行申请该地址的访问权限；若浏览器已限制访问，请在扩展设置中恢复“所有网站”访问后重试。
  4. 连接完成后，检查“当前渠道”是否为刚添加的服务。可以保存多个服务配置，但每次只使用当前选中的一个。

第四步：选择翻译，读第一张译图

第四步：选择翻译，读第一张译图
第四步：选择翻译，读第一张译图查看大图 ↗

打开本地书籍、OPDS 资源或已适配网站阅读器，选择目标语言和 MTU 渠道，先测试当前图片。最新版插件的官方与 MTU 渠道均提供图片翻译。

当前图片优先，附近图片按有限阅读窗口处理，同一 MTU 渠道串行执行。可切回原图或并排对照，保持阅读位置；阅读器、网页原位与划图翻译共用当前渠道。

如果一页失败，查看该页提示并处理原因后再手动重试。关闭页面或连接中断并不代表 MTU 已停止计算，避免在服务仍忙时反复提交。

连接失败、登录失败或一直等待，怎样排查？

按下面的顺序检查，先让 MTU 自身正常工作，再返回插件重试。不要通过分享密码、令牌或完整私人漫画来排查问题。

现象检查与处理
服务地址打不开确认 Web 服务仍在运行、端口正确。127.0.0.1 指浏览器所在的电脑；服务在另一台设备时，应填写那台设备实际可达的地址。
浏览器能打开，插件连接失败检查地址是否误填了管理页面路径、是否允许插件访问该地址，以及 MTU 版本是否提供兼容的账号登录和图片翻译接口。
账号或密码错误、要求修改初始密码先在 MTU 页面登录或修改初始密码，再在插件中“重新连接”。使用 MTU 凭据，不使用 NodeLane 密码或模型 API Key。
曾经可用，现在提示登录失效在渠道设置点击“重新连接”。同一服务地址和用户名可留空密码，复用已保存的密码；旧版仅保存令牌的配置，首次重新连接时需要补填一次密码。更改地址或用户名，或密码已更改、失效时，请重新输入密码。插件不会悄悄重发上一次翻译。密码保存与留空密码重连需插件 0.10.2 或更新版本；更早版本每次重连都需重新输入密码。
连接成功但翻译一直等待查看 MTU 是否在下载模型、加载引擎或排队；在 MTU 页面测试同一配置，检查模型、API 余额和硬件资源。连接成功只证明登录可用。
中断、超时或返回的不是图片确认 MTU 任务状态、反向代理超时及返回内容；修复后对失败页手动重试。插件不从 MTU 历史任务自动恢复结果。

缓存、离线和图片去向

本地渠道的译图缓存在当前浏览器的本机存储中。清理缓存或译图缓存预算设为 0 后，关闭仍持有译图的页面可能导致结果丢失；需要时只能手动重新翻译，不能从 MTU 自动补回。

图片由插件发送到你选中的 MTU 服务。本地运行 MTU 不等于全程离线：若服务使用在线翻译器、在线 OCR 或图像模型，相关文字或图片仍可能交给其供应商处理。是否能断网翻译，取决于模型是否备齐、服务配置及原图是否已在本机。