LibreTranslate项目：自托管开源机器翻译API完全指南

羿靖炼Humphrey

于 2025-06-03 09:10:38 发布

阅读量309

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00397/article/details/148393733

LibreTranslate项目：自托管开源机器翻译API完全指南

LibreTranslate Free and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup. 项目地址: https://gitcode.com/gh_mirrors/li/LibreTranslate

什么是LibreTranslate

LibreTranslate是一款完全开源且可自托管的机器翻译API解决方案，它不依赖于任何商业翻译服务（如Google或Azure翻译API）。该项目基于Argos Translate开源库构建，允许用户在自己的服务器上部署完整的机器翻译服务。

核心特性

完全开源：代码和翻译引擎均基于开源技术
自托管能力：可在本地或私有服务器上部署
多语言支持：支持众多语言互译
API接口：提供RESTful API供程序调用
Web界面：内置用户友好的翻译网页界面

API使用详解

LibreTranslate提供了简单易用的API接口，以下是几种典型使用场景：

基础翻译请求

const res = await fetch("https://libretranslate.com/translate", {
  method: "POST",
  body: JSON.stringify({
    q: "Hello!",
    source: "en",
    target: "es",
  }),
  headers: { "Content-Type": "application/json" },
});

自动语言检测

通过设置source参数为"auto"，API可自动检测输入文本的语言：

source: "auto",

HTML内容翻译

支持直接翻译HTML内容而保持标签结构：

format: "html",

获取替代翻译结果

可以请求获取同一文本的多个翻译变体：

alternatives: 3,

安装与部署

基础安装

要求Python 3.8+环境：

pip install libretranslate
libretranslate [args]

按需加载语言

为减少启动时间和资源占用，可指定只加载特定语言：

libretranslate --load-only en,es,fr

Docker部署

提供便捷的Docker运行方式：

./run.sh [args]  # Linux/macOS
run.bat [args]   # Windows

CUDA加速

对于配备NVIDIA GPU的服务器，可使用CUDA加速：

docker compose -f docker-compose.cuda.yml up -d --build

配置参数详解

LibreTranslate提供丰富的配置选项，分为两类：

运行时标志

| 参数 | 说明 | 默认值 | |------|------|--------| | --debug | 启用调试环境 | 关闭 | | --ssl | 启用SSL加密 | 关闭 | | --api-keys | 启用API密钥验证 | 关闭 | | --disable-web-ui | 禁用Web界面 | 启用 |

配置参数

| 参数 | 说明 | 默认值 | |------|------|--------| | --host | 绑定主机 | 127.0.0.1 | | --port | 绑定端口 | 5000 | | --char-limit | 字符数限制 | 无限制 | | --req-limit | 每分钟请求限制 | 无限制 | | --threads | 工作线程数 | 4 |

高级部署方案

WSGI与Gunicorn

适合生产环境部署：

pip install gunicorn
gunicorn --bind 0.0.0.0:5000 'wsgi:app'

Kubernetes部署

可使用Helm chart或直接应用k8s.yaml配置文件进行Kubernetes集群部署。

维护与更新

软件更新

pip安装方式：

pip install -U libretranslate

Docker方式：

docker pull libretranslate/libretranslate

语言模型更新

启动时添加参数：

libretranslate --update-models

性能优化建议

根据实际需求只加载必要语言
生产环境建议使用Gunicorn+WSGI
配备GPU的服务器使用CUDA加速
合理设置请求限制和字符限制
对于高负载场景考虑Kubernetes集群部署

LibreTranslate为需要自主可控翻译服务的用户提供了完美的开源解决方案，既保护了数据隐私，又避免了商业API的使用限制和费用问题。

LibreTranslate Free and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup. 项目地址: https://gitcode.com/gh_mirrors/li/LibreTranslate

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