LibreTranslate终极指南5分钟搭建免费自托管机器翻译API【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslate还在为商业翻译API的高昂费用和隐私问题而烦恼吗LibreTranslate作为一款免费开源的机器翻译API让你在5分钟内就能搭建自己的本地翻译服务支持离线部署且无使用限制。这个完整的开源翻译解决方案不仅保护你的数据隐私还让你完全掌控翻译流程无需依赖任何第三方服务。 为什么选择LibreTranslate而不是商业翻译API在决定是否使用LibreTranslate之前让我们先对比一下它与主流商业翻译服务的区别特性对比LibreTranslateGoogle Translate APIDeepL API费用完全免费按字符数收费按字符数收费隐私保护数据完全本地处理数据发送到云端数据发送到云端离线支持✅ 完全支持❌ 需要网络❌ 需要网络使用限制无限制有配额限制有配额限制定制能力完全开源可定制有限制有限制部署难度简单Docker一键部署无需部署无需部署核心优势LibreTranslate基于开源的Argos Translate引擎不依赖任何专有软件让你在享受高质量翻译的同时完全掌控自己的数据。 5分钟快速部署Docker一键启动最简单的部署方式就是使用Docker无论你是Windows、Linux还是macOS用户都能在5分钟内完成部署。第一步准备环境确保你的系统已安装Docker和Docker Compose。如果没有安装可以参考以下命令# Ubuntu/Debian系统 sudo apt update sudo apt install -y docker.io docker-compose # CentOS/RHEL系统 sudo yum install -y docker docker-compose sudo systemctl enable --now docker # 验证安装 docker --version docker-compose --version第二步获取LibreTranslate代码git clone https://gitcode.com/GitHub_Trending/li/LibreTranslate cd LibreTranslate第三步启动服务使用项目提供的docker-compose.yml文件你可以快速启动服务# 基础启动使用默认配置 docker-compose up -d # 查看服务日志 docker-compose logs -f服务启动后打开浏览器访问http://localhost:5000你将看到LibreTranslate的Web界面。第一次启动可能需要几分钟下载语言模型请耐心等待。 高级配置与定制化自定义启动参数LibreTranslate支持多种启动参数你可以根据需求进行调整# 自定义端口和请求限制 docker run -it --rm -p 8080:5000 libretranslate/libretranslate \ --port 5000 \ --host 0.0.0.0 \ --req-limit 100 \ --char-limit 5000 # 仅加载特定语言模型减少内存占用 docker run -it --rm -p 5000:5000 libretranslate/libretranslate \ --load-only en,zh,es,fr,de # 启用API密钥认证 docker run -it --rm -p 5000:5000 libretranslate/libretranslate \ --api-keys环境变量配置除了命令行参数你还可以使用环境变量进行配置环境变量说明默认值LT_HOST服务绑定的主机地址127.0.0.1LT_PORT服务监听端口5000LT_REQ_LIMIT每分钟请求限制-1无限制LT_CHAR_LIMIT字符限制-1无限制LT_API_KEYS是否启用API密钥falseLT_LOAD_ONLY仅加载指定语言空加载所有LT_THREADS工作线程数4 性能优化策略1. 模型预加载优化首次启动时LibreTranslate会下载所有语言模型这可能需要较长时间。你可以通过以下方式优化# 仅加载常用语言 docker run -d --name libretranslate \ -p 5000:5000 \ -e LT_LOAD_ONLYen,zh,es,fr,de,ja,ko \ libretranslate/libretranslate # 使用持久化存储避免重复下载 docker run -d --name libretranslate \ -p 5000:5000 \ -v lt-models:/home/libretranslate/.local \ libretranslate/libretranslate2. 系统资源配置根据你的使用场景调整资源配置使用场景推荐配置说明个人使用2核CPU / 4GB内存适合偶尔翻译需求小团队使用4核CPU / 8GB内存支持10人左右团队生产环境8核CPU / 16GB内存支持高并发请求多语言支持8核CPU / 32GB内存加载所有语言模型3. 使用GPU加速如果你的服务器有NVIDIA GPU可以使用CUDA版本的Docker镜像# 使用CUDA加速的Docker Compose配置 docker-compose -f docker-compose.cuda.yml up -d API使用指南基本API调用LibreTranslate提供RESTful API接口支持多种编程语言调用# 检测语言 curl -X POST http://localhost:5000/detect \ -H Content-Type: application/x-www-form-urlencoded \ -d qHello world # 翻译文本 curl -X POST http://localhost:5000/translate \ -H Content-Type: application/x-www-form-urlencoded \ -d qHello worldsourceentargetes # 获取支持的语言列表 curl -X GET http://localhost:5000/languagesPython客户端示例import requests def translate_text(text, source_langauto, target_langzh): 使用LibreTranslate API翻译文本 url http://localhost:5000/translate payload { q: text, source: source_lang, target: target_lang, format: text } response requests.post(url, datapayload) if response.status_code 200: return response.json()[translatedText] else: raise Exception(f翻译失败: {response.text}) # 使用示例 translated translate_text(Hello, how are you?, en, zh) print(translated) # 输出你好你好吗JavaScript客户端示例// 使用fetch API调用翻译服务 async function translateText(text, sourceLang auto, targetLang zh) { const response await fetch(http://localhost:5000/translate, { method: POST, headers: { Content-Type: application/x-www-form-urlencoded, }, body: new URLSearchParams({ q: text, source: sourceLang, target: targetLang, format: text }) }); if (response.ok) { const data await response.json(); return data.translatedText; } else { throw new Error(翻译失败); } } // 使用示例 translateText(Hello world, en, es) .then(translated console.log(translated)) .catch(error console.error(error));️ 安全配置与最佳实践1. 启用API密钥认证对于生产环境强烈建议启用API密钥认证# 启动时启用API密钥 docker run -d --name libretranslate \ -p 5000:5000 \ -e LT_API_KEYStrue \ libretranslate/libretranslate # 生成API密钥进入容器执行 docker exec -it libretranslate bash python manage.py keys add my-secret-key2. 配置HTTPS支持虽然LibreTranslate本身不支持HTTPS但你可以通过Nginx反向代理添加SSLserver { listen 443 ssl http2; server_name translate.yourdomain.com; ssl_certificate /etc/letsencrypt/live/translate.yourdomain.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/translate.yourdomain.com/privkey.pem; location / { proxy_pass http://localhost:5000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }3. 设置访问限制# 限制每分钟100个请求每次请求最多5000字符 docker run -d --name libretranslate \ -p 5000:5000 \ -e LT_REQ_LIMIT100 \ -e LT_CHAR_LIMIT5000 \ libretranslate/libretranslate 监控与维护健康检查LibreTranslate内置健康检查端点方便监控服务状态# 检查服务健康状态 curl -X GET http://localhost:5000/health # 预期响应 { status: ok, version: 1.3.11 }日志管理# 查看实时日志 docker logs -f libretranslate # 查看特定时间段的日志 docker logs --since2024-01-01T00:00:00 libretranslate # 查看错误日志 docker logs libretranslate 21 | grep -i error备份与恢复# 备份API密钥数据库 docker cp libretranslate:/app/db/api_keys.db ./backup/api_keys.db # 备份语言模型 docker cp libretranslate:/home/libretranslate/.local ./backup/models/ # 恢复数据 docker cp ./backup/api_keys.db libretranslate:/app/db/ docker cp ./backup/models/ libretranslate:/home/libretranslate/.local/ 常见问题与解决方案Q1: 服务启动后无法访问Web界面可能原因端口被占用或防火墙阻止解决方案# 检查端口占用 netstat -tlnp | grep :5000 # 如果端口被占用更换端口启动 docker run -d --name libretranslate -p 8080:5000 libretranslate/libretranslate # 检查防火墙规则 sudo ufw allow 5000/tcpQ2: 翻译速度慢可能原因首次使用需要下载模型或服务器资源不足解决方案# 1. 仅加载常用语言 docker run -d --name libretranslate \ -p 5000:5000 \ -e LT_LOAD_ONLYen,zh \ libretranslate/libretranslate # 2. 增加服务器资源 # 编辑docker-compose.yml增加资源限制 services: libretranslate: deploy: resources: limits: cpus: 4 memory: 8GQ3: API调用返回错误可能原因参数错误或服务异常解决方案# 检查服务状态 curl -X GET http://localhost:5000/health # 查看详细错误日志 docker logs libretranslate # 验证API参数 # 确保source和target参数使用正确的语言代码 # 支持的语言代码可以通过/languages端点获取 生产环境部署建议1. 使用Docker Compose生产配置创建docker-compose.prod.yml文件version: 3.8 services: libretranslate: image: libretranslate/libretranslate:latest container_name: libretranslate-prod restart: always ports: - 5000:5000 environment: - LT_HOST0.0.0.0 - LT_PORT5000 - LT_REQ_LIMIT1000 - LT_CHAR_LIMIT10000 - LT_API_KEYStrue - LT_LOAD_ONLYen,zh,es,fr,de,ja,ko,ru volumes: - libretranslate_models:/home/libretranslate/.local - libretranslate_db:/app/db deploy: resources: limits: cpus: 4.0 memory: 8G reservations: cpus: 2.0 memory: 4G volumes: libretranslate_models: libretranslate_db:2. 使用systemd管理服务创建/etc/systemd/system/libretranslate.service[Unit] DescriptionLibreTranslate Translation Service Afternetwork.target docker.service Requiresdocker.service [Service] Typesimple Restartalways RestartSec10 ExecStart/usr/bin/docker-compose -f /opt/libretranslate/docker-compose.prod.yml up ExecStop/usr/bin/docker-compose -f /opt/libretranslate/docker-compose.prod.yml down WorkingDirectory/opt/libretranslate [Install] WantedBymulti-user.target3. 监控与告警配置# 使用Prometheus监控需要配置metrics端点 # 在启动参数中添加--metrics # 使用健康检查脚本 #!/bin/bash HEALTH_CHECK$(curl -s -o /dev/null -w %{http_code} http://localhost:5000/health) if [ $HEALTH_CHECK ! 200 ]; then echo LibreTranslate服务异常正在重启... docker-compose -f /opt/libretranslate/docker-compose.prod.yml restart fi 总结与行动号召LibreTranslate作为一款免费开源的自托管机器翻译API为个人开发者、企业团队提供了完美的翻译解决方案。通过本文的指南你已经掌握了从快速部署到生产环境优化的完整流程。核心价值总结✅完全免费无使用限制无隐藏费用✅隐私安全数据完全本地处理不发送到第三方✅离线支持无需网络连接即可使用✅易于部署Docker一键部署5分钟完成✅高度可定制开源代码可按需修改立即行动克隆项目仓库git clone https://gitcode.com/GitHub_Trending/li/LibreTranslate使用Docker一键部署docker-compose up -d访问http://localhost:5000开始使用进阶学习查看官方文档docs/official.md探索核心源码libretranslate/学习API使用libretranslate/app.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），仅供参考