LibreTranslate 离线翻译部署指南最小 600MB全程零联网【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslate本文面向断网、内网环境需要落地翻译服务的团队。LibreTranslate 是开源自托管翻译引擎离线翻译依赖 Argos 模型装好模型后翻译全程不碰外网只配中英一对总体积约 600MB。为什么需要断网也能翻译 LibreTranslate 的翻译能力不依赖外部 API而靠 Argos 离线模型——可离线加载的语言对文件包每个语言对由成对的.argosmodel文件加元数据构成。文件落到本地磁盘后服务处理每次请求都只读本地文件因此气隙机房、内网隔离、数据合规场景与联网环境用同一套方式部署。本文要解决两件事把模型和依赖搬进无网机器再证明它断网也能正常干活。部署形态三选一先对比再动手 ⚡把服务搬到目标机器有三条路按环境挑适合谁启动方式是否联网开发测试LT_MODEL_PATH指向模型目录跑python main.py仅首次安装联网生产环境用 docker/Dockerfile 构建模型烧进镜像仅构建期联网无 Python 的机器源码venv模型依赖整包拷 U 盘全程不联网本地方式把模型目录与--load-only启动参数对齐最稳Docker 方式构建期装好模型、运行时零联网便携版是前两者的打包形态目标机没有 Python 就再带一份 Portable Python。分形态安装步骤断网环境怎么装离线翻译本地直跑从建环境到起服务建环境、装依赖。以 Python 3.10 为例git clone https://gitcode.com/GitHub_Trending/li/LibreTranslate cd LibreTranslate python -m venv venv source venv/bin/activate pip install .pip install .按 pyproject.toml 拉齐依赖装完无报错即可继续。翻译核心是argos-translate-lt1.12.1Web 层是Flask2.2.5。接着只装中英模型并起服务监听 5000 端口python scripts/install_models.py --load_only_lang_codes en,zh python main.py --host 127.0.0.1 --port 5000模型默认落在~/.local/share/argos-translate/packagesWindows 在AppData\Roaming\argos-translate\packages中英两个模型约 600MB。启动日志出现Loaded support for 2 languages即为加载成功。⚠️ 日志里Cannot update models (normal if youre offline)是断网时跳过索引刷新的正常提示别当错误处理。Docker把模型烧进镜像构建机能联网时最省事的做法是构建期直接把模型装进镜像docker build --build-arg with_modelstrue --build-arg modelsen,zh,fr -f docker/Dockerfile .构建完成无报错即成功运行该镜像并暴露 5000 端口即可。docker/Dockerfile 中with_models/models两个 ARG 控制构建期模型安装构建完即断网运行。便携 U 盘把翻译服务搬过去无需额外命令。把本地装好的整套——源码目录、venv、模型目录、离线依赖——整体拷贝进 U 盘目标机用对应解释器起服务模型放在盘上时用LT_MODEL_PATH指向 U 盘中的位置。目标机没有 Python 就带一份 Portable Python起服务后按验收一节核对。瘦身清单离线包怎么压到最小体积 只装用得上的语言对。--load_only_lang_codes用 ISO 639-1 短码、逗号分隔全量约 4GB只留中英压到 600MB 上下再少受限于模型本身体积短码可对照 libretranslate/locales 目录名。依赖提前下成离线缓存。有网机器取 wheel目标机用--no-index安装杜绝运行期联网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安装无报错即缓存可用。跨 Linux 发行版迁移选 manylinux wheel跨发行版通用的预编译包Windows 目标机加--platform win_amd64。三处配置保持离线默认。libretranslate/default_values.py 的条目均可用LT_前缀环境变量控制UPDATE_MODELS保持默认False不自动更新模型、SHARED_STORAGE保持memory://内存计数、不依赖 Redis、API_KEYS_REMOTE留空。模型刷新在联网机做。执行python scripts/install_models.py --load_only_lang_codes en,zh --update把~/.local/share/argos-translate/packages目录打包带走版本号建议主.次.修订三段式方便区分模型变更与 bugfix。验收与避坑三连验证证明离线闭环 ✅先走 health 与 translatecurl http://localhost:5000/health curl -X POST http://localhost:5000/translate \ -H Content-Type: application/x-www-form-urlencoded \ -d qHello%20worldsourceentargetzhhealth 正常返回、translate 接口返回{translatedText:你好世界,...,detectedLanguage:{...}}即通过。最后拔掉网络重放同样请求依然正常返回离线闭环成立。高频问题速查问题原因处理报Model not found--load-only或--load_only_lang_codes短码与已装模型不符或模型目录不可读核对短码与目录检查读权限翻译慢--threads仍是默认 4--debug没关线程数按 CPU 核数调生产关闭 debug依赖冲突在线装包与离线缓存混用坚持离线缓存加--no-index不混装后续想继续压体积有两个方向值得跟进一是模型量化直接缩小单个模型的体积二是纯前端 WebAssembly 离线版浏览器内直接完成翻译连 Python 环境都不用带。【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
