LibreTranslate 自建部署完整指南一条命令跑起私有机器翻译 API【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslate不想把业务文本发给第三方翻译接口LibreTranslate 是一个基于开源 Argos Translate 引擎、可自建部署的机器翻译 API支持离线运行与文件翻译。本文给出一条可照做的部署主线从安装到验证再到生产加固全程只用标准命令行。 项目速览LibreTranslate 面向开发者与中小团队它把机器翻译做成本地服务你只调用自己的http://localhost:5000文本不出服务器。核心能力一览能力说明离线运行模型下载一次后即可断网使用数十种语言中、英、法、德、日等语言互译/languages可查文件翻译/translate_file接口支持文档格式翻译限流与鉴权请求数限制、API 密钥、Prometheus 指标✅ 部署前准备服务器 2GB 内存起步默认线程数 4磁盘预留 1GB 存放语言模型Docker 与 Docker Compose首次启动需联网下载模型确认 5000 端口未被占用默认端口翻译质量依赖 Argos Translate 模型CPU 即可运行 一条主线装起来主推 Docker Compose。项目根目录自带 compose 文件见 docker-compose.yml 与 docker/Dockerfilegit clone https://gitcode.com/GitHub_Trending/li/LibreTranslate cd LibreTranslate克隆项目源码到本机。docker compose up -d后台启动官方镜像容器名libretranslate映射 5000 端口。首次启动要下载语言模型耗时几分钟日志出现Running on http://0.0.0.0:5000且健康检查通过即就绪。备选方式pip install libretranslate后运行libretranslate适合体验pip install -e .装源码适合改代码。 启动并验证浏览器访问http://localhost:5000/应出现 Web 界面交互文档在/docs。再用两条命令确认接口curl http://localhost:5000/health返回{status: ok}即服务可用。curl -X POST http://localhost:5000/translate \ -H Content-Type: application/json \ -d {q: Hello world, source: en, target: zh}返回translatedText字段即最小调用成功。 生产环境加固清单配置项作用一条示例命令API 鉴权按密钥区分用户并单独限流docker exec libretranslate ltmanage keys add 60 --char-limit 200TLS 加密对外启用 HTTPS反向代理Nginx/Caddy终止证书或libretranslate --ssl数据持久化密钥库不随容器重建丢失挂载卷-v lt_db:/app/db请求限流防滥用按分钟限流--req-limit 60 --req-flood-threshold 10线程/资源提升并发吞吐--threads 8容器内对应 gunicorn workers开启鉴权时设置环境变量LT_API_KEYStrue随后可用ltmanage keys add 60 --char-limit 200生成密钥客户端在请求体或查询参数里传api_key。只翻译少数语言可加--load-only zh,en缩短启动时间--metrics暴露/metrics供 Prometheus 抓取。 排障速查现象/health拒绝连接 → 原因模型还在下载、进程未就绪 → 解法docker logs -f libretranslate等待Running on http://0.0.0.0:5000出现现象首条翻译请求很慢 → 原因语言模型首次加载进内存 → 解法属正常现象后续请求恢复毫秒级现象启动报端口占用 → 原因5000 已被其他服务使用 → 解法compose 里改为8080:5000现象本机正常、别的机器访问不到 → 原因默认绑定回环地址 → 解法外部端口映射或设LT_HOST0.0.0.0现象返回 403 Invalid API key → 原因密钥不在密钥库中 → 解法docker exec libretranslate ltmanage keys add 60重新生成并更新客户端现象返回 429 → 原因超过每分钟请求上限 → 解法调大--req-limit或为该密钥单独放宽额度 下一步LibreTranslate 给你的是一个私有、离线可用、无调用计费的翻译端点。下一步对照 libretranslate/main.py 里的参数清单逐项核对你的生产配置有功能需求可参与官方社区讨论。【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考