📋 官方信息
| 项目名称 | LibreTranslate |
| 仓库地址 | https://github.com/LibreTranslate/LibreTranslate |
| 官方网站 | https://libretranslate.com |
| 最新更新 | 2026年10月 |
| 项目定位 | 免费开源的机器翻译API，可自托管替代Google翻译 |
🎯 项目背景
LibreTranslate 是一个免费开源的机器翻译 API 服务，由 LibreApps 团队开发。它基于 Argos Translate 项目构建，使用开源的神经机器翻译模型，不需要调用任何第三方翻译服务，完全运行在你自己的服务器上。这意味着你的翻译数据不会经过 Google、DeepL 等公司的服务器，隐私性极强。
与 Google Translate API 按字数收费不同，LibreTranslate 完全免费、无限制。它提供了与 Google Translate API 兼容的 REST 接口，你可以把任何使用 Google 翻译 API 的应用无缝切换到自己的 LibreTranslate 实例。项目支持 80+ 种语言互译，虽然翻译质量略逊于商业 API，但对于个人使用、开发测试、隐私敏感场景来说已经足够。Docker 镜像一键部署，非常方便。
✨ 核心特性
- 完全开源免费：无 API 调用次数限制，无字数限制
- 自托管隐私：所有翻译在本地完成，数据不外泄
- REST API：与 Google Translate API 接口兼容，易于集成
- 80+ 语言：支持全球主要语言互译
- Web 界面：内置网页版翻译界面，浏览器直接使用
- API Key 管理：支持多用户和 API 密钥管理
- Docker 部署：一键启动，无需配置 Python 环境
- 离线可用：模型下载后完全离线运行
💻 环境要求
- Docker 部署：Docker 20.10+，内存 2GB 以上（全语言模型约需 4GB）
- Python 部署：Python 3.10+，支持 C 编译器（编译翻译模型）
- 磁盘空间：仅英中翻译约 2GB，全语言模型约 10GB
- 网络：首次启动需下载翻译模型
🚀 详细部署步骤
方式一：Docker 一键部署（推荐）
# 快速启动（自动下载默认语言模型）
docker run -d \
--name libretranslate \
--restart unless-stopped \
-p 5000:5000 \
libretranslate/libretranslate:latest首次启动会自动下载翻译模型，可能需要几分钟。启动后访问 http://localhost:5000 即可使用网页翻译界面。
方式二：Docker 指定语言（节省空间）
如果你只需要中英互译，可以指定只加载需要的语言模型：
docker run -d \
--name libretranslate \
--restart unless-stopped \
-p 5000:5000 \
-v ~/libretranslate-data:/home/libretranslate/.local \
libretranslate/libretranslate:latest \
--load-only en,zh,es,fr,de,ja,ko这样只会下载指定语言的模型，大幅节省磁盘空间和内存。
方式三：Docker Compose 部署
创建 docker-compose.yml：
services:
libretranslate:
image: libretranslate/libretranslate:latest
container_name: libretranslate
restart: unless-stopped
ports:
- "5000:5000"
volumes:
- ./data:/home/libretranslate/.local:cached
command:
# 只加载常用语言，节省资源
- --load-only=zh,en,ja,ko,fr,de,es
# 允许无限制翻译
- --char-limit=-1
# 启用API密钥（取消注释后需要密钥才能调用）
# - --api-keys
# 禁用文件翻译
- --disable-web-ui=false
environment:
- LT_UPDATE_MODELS=true启动：
docker compose up -d方式四：Python 源码部署
# 1. 创建虚拟环境
python -m venv lt-env
source lt-env/bin/activate # Linux/macOS
# Windows: lt-env\Scripts\activate
# 2. 安装
pip install libretranslate
# 3. 启动
libretranslate --host 0.0.0.0 --port 5000🔧 常用命令行参数
--load-only en,zh # 只加载指定语言
--char-limit 5000 # 单次翻译最大字符数，-1为无限制
--api-keys # 启用API密钥认证
--require-api-secret # 强制要求API密钥
--ssl # 启用HTTPS（需要证书文件）
--frontend-language-source zh # 网页界面默认源语言
--frontend-language-target en # 网页界面默认目标语言📡 API 使用示例
# 翻译 API 调用
curl -X POST "http://localhost:5000/translate" \
-H "Content-Type: application/json" \
-d '{
"q": "Hello, world!",
"source": "en",
"target": "zh",
"format": "text"
}'
# 返回示例：
# {
# "translatedText": "你好，世界！"
# }
# 支持的语言列表
curl "http://localhost:5000/languages"
# 批量翻译
curl -X POST "http://localhost:5000/translate" \
-H "Content-Type: application/json" \
-d '{
"q": ["Hello", "Goodbye"],
"source": "en",
"target": "zh"
}'✅ 启动验证
- 等待容器启动完成（首次需要下载模型，看日志：
docker logs -f libretranslate） - 浏览器访问
http://服务器IP:5000 - 在网页界面输入英文，选择翻译成中文
- 确认返回正确翻译结果
- 用 curl 测试 API 接口
📖 使用方法
网页翻译
打开 http://localhost:5000，在左侧输入原文，右侧自动显示翻译结果。支持自动检测源语言。
API 集成
在你的应用中调用 /translate 接口即可。与 Google Translate API 格式兼容，修改 API 地址就能切换。
接入沉浸式翻译
在沉浸式翻译扩展的设置中，添加自定义翻译服务，填入你的 LibreTranslate API 地址，即可用自己的翻译服务。
❓ 常见问题
Q1: 翻译质量和 Google 比怎么样？
A: LibreTranslate 使用开源翻译模型，质量略低于 Google/DeepL，但对于日常阅读和开发使用完全够用。优势是免费、隐私、无限制。
Q2: 首次启动很慢？
A: 首次需要下载翻译模型（约几百MB到几GB）。可以用 --load-only 参数减少加载的语言数量。
Q3: 内存占用很高？
A: 加载的语言越多内存占用越大。只加载需要的语言可以大幅降低内存。建议至少 2GB 内存。
Q4: 如何添加更多语言？
A: 修改 --load-only 参数添加语言代码，重启容器即可自动下载对应模型。
Q5: 支持 GPU 加速吗？
A: 官方 Docker 镜像默认 CPU 运行。需要 GPU 加速需要自行编译安装 CUDA 版本。
🔗 跳转链接
- GitHub 仓库：https://github.com/LibreTranslate/LibreTranslate
- 官方网站：https://libretranslate.com
- Docker 镜像：Docker Hub
- API 文档：https://libretranslate.com/docs