MTranServer最新版

如果你需要一个完全离线、响应极快、资源占用极低的本地翻译服务，MTranServer 正是你在找的工具。

它是一个轻量级翻译模型服务器，单请求平均响应时间仅 50 毫秒，运行时几乎不占用内存，无需独立显卡，在普通笔记本甚至树莓派上都能流畅运行。支持全球主要语言互译，启动后即可通过 HTTP 接口提供翻译服务。

更重要的是：它是完全本地运行的，不依赖任何云端 API，因此可以实现“无限免费翻译”——只要你愿意接受略低于大模型的翻译质量。

注意：MTranServer 的目标不是取代 DeepL 或 Google Translate 的语言质量，而是提供一个稳定、快速、可私有部署的本地替代方案。对翻译精度要求极高的场景，仍建议使用在线大模型 API。

核心设计目标

• 离线优先：所有翻译在本地完成，无网络请求，无隐私泄露风险
• 极致轻量：v4 版本进一步优化内存占用，启动快、运行稳
• 跨平台部署：支持 Windows、Linux、macOS，提供 Docker 镜像
• 即插即用：兼容主流浏览器翻译插件，开箱即用
• 免费无限：无调用次数限制，无账户体系，无遥测

快速上手

1. 下载与启动

前往 GitHub Releases 下载对应平台的二进制文件，直接在终端运行：

./mtranserver --host 127.0.0.1 --port 8080

程序启动后，会自动输出两个地址：

• 一个简易 Web UI（用于手动测试翻译）
• 一份在线调试文档（含 API 示例）

2. 首次使用说明

首次翻译某语言对（如“中文→英文”）时，服务器会自动下载对应的小型翻译模型（约几十 MB）。这个过程需要几秒到几十秒（取决于网络），之后所有请求都将进入毫秒级响应。

建议在正式使用前，先手动发起一次翻译请求，让模型预加载完成。

若你希望完全离线运行（例如内网环境），可启动时加上 --offline 参数，但需提前手动将所需模型放入模型目录（默认 ~/.config/mtran/models）。

Docker 一键部署

在任意目录创建 compose.yml：

services:
  mtranserver:
    image: xxnuo/mtranserver:latest
    container_name: mtranserver
    restart: unless-stopped
    ports:
      - "8989:8989"
    environment:
      - MT_HOST=0.0.0.0
      - MT_PORT=8989
      - MT_ENABLE_UI=true
    volumes:
      - ./models:/app/models

然后执行：

docker compose up -d

模型会持久化保存在本地 ./models 目录，升级或重启容器不会丢失。

兼容主流翻译插件

MTranServer 不仅提供标准 REST API，还原生兼容多种浏览器翻译插件的接口协议，让你无缝替换现有在线服务：

插件配置建议

• 沉浸式翻译：在开发者模式中启用 Beta 功能，将“每秒最大请求数”调至 100 以上（如 512），充分发挥本地服务器低延迟优势。
• 简约翻译：在 Custom 接口设置中，可将“最大并发数”设为 100，请求间隔设为 1 毫秒。

所有接口均支持通过 MT_API_TOKEN 环境变量或 URL 参数（如 ?token=xxx）添加简易认证，保护本地服务不被滥用。

命令行选项一览

-version, -v          显示版本
-log-level            日志级别（debug/info/warn/error）
-config-dir           配置目录（默认 ~/.config/mtran/server）
-model-dir            模型目录（默认 ~/.config/mtran/models）
-host                 监听地址（默认 0.0.0.0）
-port                 端口（默认 8989）
-ui                   启用 Web UI（默认开启）
-offline              禁用自动下载模型
-worker-idle-timeout  Worker 空闲超时（秒，默认 300）