LibreTranslate 离线部署:如何最快搭好一个最小 300MB 的无外网翻译服务

发布时间:2026/9/20 8:25:09

LibreTranslate 离线部署:如何最快搭好一个最小 300MB 的无外网翻译服务 LibreTranslate 离线部署如何最快搭好一个最小 300MB 的无外网翻译服务【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslateLibreTranslate 离线部署三步跑通装环境、装语言模型、起服务全程不碰外网。中英双模型离线包最小约 300MB实测总占用 600MB 出头适合机房隔离网、出差笔记本等断网场景。离线成品长什么样这一节先给你结果装完之后服务长什么样、占多少磁盘、断网后哪些能力还在。健康检查GET /health返回{status: ok}这是验收的第一依据。语言列表GET /languages只列出你装过的语言比如 en、zh 两条多装一个模型这里就多想一项。翻译接口POST /translate提交qHello worldsourceentargetzh返回体里有translatedText字段和detectedLanguage对象。磁盘占用每个语言方向约 300MB中英双向合计约 600MB。模型默认落在~/.local/share/argos-translate/packagesWindows 为AppData\Roaming\argos-translate\packages里面是成对的.argosmodel文件加元数据。断网行为拔掉网线重启服务启动、翻译、健康检查全部照常无任何外部请求发出。选一个适合你的部署形态先花 30 秒判断你的机器属于哪种形态后面的步骤按同一套命令走。本地直跑目标机已有 Python 3.8 及以上实测 3.10 稳定。代价是手动建虚拟环境多两条命令。容器镜像目标机只保证有 Docker适合多台机器统一环境。代价是首次构建镜像较慢且构建期仍需联网拉模型。便携包把源码 虚拟环境 模型目录整体拷贝到 U 盘无 Python 的机器再带一份便携版 Python。代价是打包与同步由你手工维护。按步骤落地四个子步骤每步一句目的、一段命令、一行预期。全程按顺序执行即可。1. 拿到代码并建好隔离的 Python 环境在任意目录执行git clone https://gitcode.com/GitHub_Trending/li/LibreTranslate cd LibreTranslate python -m venv venv source venv/bin/activate pip install .预期依赖全部装完核心引擎为 argos-translate-lt 1.12.1、Web 层为 Flask 2.2.5版本已在 pyproject.toml 中锁定。2. 安装语言模型只装你用得到的方向python scripts/install_models.py --load_only_lang_codes en,zh预期日志出现Found模型数与Keep 2 models模型下载约 1~2 分钟视网速装完du -sh该目录约 600MB。语言代码对照 libretranslate/locales/ 目录名即可。3. 启动服务并确认模型加载成功python main.py --host 127.0.0..1 --port 5000预期启动日志出现Loaded support for 2 languages随后打印Running on http://127.0.0.1:5000端口 5000 开始监听。4. 容器形态把模型打进镜像再跑Docker 用户不需要跑步骤 2~3构建期装好模型运行时零联网docker build --build-arg with_modelstrue --build-arg modelsen,zh -t lt-offline -f docker/Dockerfile . docker run -d --name lt -p 5000:5000 lt-offline预期容器日志同样出现Loaded support for 2 languages两个 ARG 见 docker/Dockerfile 第 25~26 行。把离线包做小做稳进阶选读。体积和稳定性由三处决定下面逐点给出改什么、改在哪、为什么。语言裁剪最直接的减重手段。改启动参数--load-only逗号分隔的 ISO 639-1 短码或安装模型时的--load_only_lang_codes两者必须保持一致否则启动会报模型缺失。原因模型文件本身占体积大头全量安装约 4GB只留中英压到 600MB 上下再压不动。依赖离线缓存切断运行期的联网依赖。在有网机器执行pip freeze requirements_offline.txt再pip download -r requirements_offline.txt -d dependencies/ --only-binary:all:目标机用pip install --no-index --find-links./dependencies/ -r requirements_offline.txt安装。--no-index是关键它禁止 pip 回源保证安装全程离线。跨 Linux 发行版选 manylinux wheelWindows 目标机把平台参数换成--platform win_amd64。离线配置三个默认值保持不动即可。配置文件 libretranslate/default_values.py全部可用LT_前缀环境变量覆盖UPDATE_MODELS默认False保持关闭否则启动时会尝试刷新模型索引SHARED_STORAGE默认memory://内存计数即可无需 RedisAPI_KEYS_REMOTE默认空保持留空不指向任何远程端点。另外 libretranslate/init.py 的boot()会吞掉联网失败异常日志里的Cannot update models (normal if youre offline)是预期提示属正常现象。维护节奏需要刷新模型时在联网机执行python scripts/install_models.py --load_only_lang_codes en,zh --update再把 packages 目录整体打包带走离线包版本号建议用主.次.修订三段式便于区分模型变更和 bugfix。验收清单按顺序勾掉三项全绿即离线闭环成立。✅起服务后确认模型加载curl http://localhost:5000/health预期输出{status: ok}。调翻译接口curl -X POST http://localhost:5000/translate -H Content-Type: application/x-www-form-urlencoded -d qHello%20worldsourceentargetzh预期返回体含translatedText与detectedLanguage。断网复测断开网络后重启服务重跑上面两条命令预期输出不变、服务无任何外部请求报错。排障问答Q启动时报Model not foundA核对启动参数--load-only与已装模型的方向短码是否一致比如只装了 en→zh 就写en,zh再确认模型目录~/.local/share/argos-translate/packages可读。Q翻译速度偏慢 A线程数默认 4见默认值THREADS按 CPU 核数上调--threads生产环境去掉--debug调试模式会显著拖慢响应。Q离线安装依赖时和已装包冲突 A坚持--no-index --find-links走离线缓存不要与在线安装混用混用会让 pip 按在线源重新解析版本树。Q启动日志出现Cannot update models (normal if youre offline)A这是 libretranslate/init.py 里的预期提示意思是离线时跳过了模型索引刷新不影响翻译不需要处理。整条路径回顾一遍建环境、装模型、起服务、验收断网四步即得一个零外网的翻译端点延伸方向可关注 WebAssembly 纯前端离线版把体积再压一个量级。【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslate创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/9/20 8:25:09

BrewUI 图形化指南:让 Homebrew 包管理告别命令行繁琐操作

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/20 8:25:09

TV浏览器全屏适配实战:Firefox等五款内核的JS兼容性解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/20 9:35:18

OpenResearch:本地优先研究协议与CLI工程实践

1. OpenResearch 不是又一个 CLI 工具,而是本地优先研究工作流的底层协议OpenResearch 这个名字乍看像某个开源项目仓库名,或是某家科技公司的内部代号。但结合近期全网爆发式增长的搜索热词——尤其是CLI、orx、autoresearch、local-first这四个关键词高…

2026/9/20 9:35:18

C语言结构体内存对齐与实战应用全解析

1. 为什么结构体是C语言里最值得花时间啃透的“硬骨头”你刚学完数组,发现它只能存同类型数据;刚搞懂指针,发现它像一把万能钥匙却总打不开复杂数据的大门;写到文件读写时,一行行fscanf读整数、字符、浮点数&#xff0…

2026/9/20 9:35:18

uni-app 鸿蒙 UTS 插件开发:UTSHarmony 内置 API 完全指南

uni-app 鸿蒙 UTS 插件开发:UTSHarmony 内置 API 完全指南 【免费下载链接】uni-app A cross-platform framework using Vue.js 项目地址: https://gitcode.com/gh_mirrors/un/uni-app 导读:UTSHarmony 是 uni-app 在 HarmonyOS 平台为 UTS 插件作…

2026/9/20 9:35:18

微信小程序投票系统:三层防重+JWT权限+实时统计实战

简介:这是一套面向计算机专业本科生的微信小程序毕业设计实战项目,完整实现了一个B/S架构的投票评选系统,适用于课程设计、毕设选题与全栈开发能力训练。资源包含可直接运行的前后端源码、详细开发说明文档、MySQL数据库脚本及配套演示视频&a…

2026/9/20 9:35:18

Python开发避坑指南:常见错误与解决方案

1. 为什么Python开发者需要避坑指南刚入行那会儿,我总在深夜对着报错信息抓狂。明明照着教程写的代码,偏偏抛出各种莫名其妙的错误。后来才发现,Python虽然以易学着称,但隐藏的"坑"比想象中多得多。有些错误会直接导致程…

2026/9/20 9:30:17

百万芯片互联背后:TPU集群的系统级工程与电力瓶颈

一百万个芯片塞进一个集群,听起来像是PPT上的数字游戏,但谷歌这次把TPU互联架构推到100万芯片规模,实际上是把AI基础设施的竞争从“单卡算力赛道”拉到了“系统级工程赛道”。我做大规模训练平台这些年,最大的感受是:越…

2026/9/20 0:04:49

GAMP 5 基于风险的计算机化系统验证:软件分类与审计追踪实践

简介:《A Risk-Based Approach to Compliant GxP Computerized Systems》即业内熟知的GAMP 5指南,面向制药企业质量与IT合规人员、验证工程师及计算机化系统管理者,用于解决GxP法规环境下系统合规性难以科学落地的问题。文档以风险管理为主线…

2026/9/20 0:04:49

安全托管MSSP实战:从静态防御到人机协同的攻防运营与应急响应

简介:这份PPT围绕互联网业务安全托管服务展开,面向企业安全负责人、IT运维人员及关注MSSP/MSS选型的读者,重点回应传统安全过度依赖人工、碎片化静态防御难以对抗产业化攻击等痛点。资源共1个pptx文件,包体约30.63MB,以…

2026/9/20 0:04:49

GAMP 5 基于风险的计算机化系统验证:软件分类与审计追踪实践

简介:《A Risk-Based Approach to Compliant GxP Computerized Systems》即业内熟知的GAMP 5指南,面向制药企业质量与IT合规人员、验证工程师及计算机化系统管理者,用于解决GxP法规环境下系统合规性难以科学落地的问题。文档以风险管理为主线…

2026/9/20 0:04:49

安全托管MSSP实战:从静态防御到人机协同的攻防运营与应急响应

简介:这份PPT围绕互联网业务安全托管服务展开,面向企业安全负责人、IT运维人员及关注MSSP/MSS选型的读者,重点回应传统安全过度依赖人工、碎片化静态防御难以对抗产业化攻击等痛点。资源共1个pptx文件,包体约30.63MB,以…

2026/9/20 4:54:47

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/20 5:01:23

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/20 5:09:33

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码