Lingarr是什么？开源AI字幕翻译工具完全解析：如何用10分钟让影视字幕说中文-尧图网络科技

Lingarr是什么？开源AI字幕翻译工具完全解析：如何用10分钟让影视字幕说中文

【免费下载链接】lingarrLingarr is an application that supports both local and SaaS translation services to translate subtitle files into a specified target language. With automated translation options, Lingarr simplifies translating subtitles.项目地址: https://gitcode.com/gh_mirrors/li/lingarr

Lingarr 是一款开源的字幕翻译工具，能够借助 AI 与机器翻译服务，把 SRT、SSA 等字幕文件自动翻译成你想要的目标语言，支持中文、英文、日语等常见语种。无论你是想给自己下载的影视剧配上中文字幕，还是批量处理收藏库里的外语字幕，Lingarr 都能帮你一键搞定。本文将从零开始，带你 10 分钟完成部署，并学会用 AI 字幕翻译功能让影视字幕"开口说中文"。

🎯 为什么你需要一款字幕翻译工具？

很多影迷都有这样的痛点：下载了高质量的国外影视资源，却没有中文字幕；网上找的字幕要么错译连篇，要么时间轴对不上；手动翻译一部电影的几百行字幕，耗时又费力。而传统的机翻字幕，往往丢失了上下文语境，读起来生硬难懂。

Lingarr 的定位，正是为了解决这一系列问题：它把字幕解析、批量翻译、上下文优化、格式写入全部自动化，你只需要点击几下鼠标，剩下的事情交给它处理。

🧠 Lingarr 核心功能盘点

1. 支持 13+ 翻译服务，AI 与机器翻译全覆盖

Lingarr 最大的亮点是"服务自由"，你既可以用大模型 AI 服务，也可以用传统机器翻译：

AI 服务：OpenAI（GPT）、Anthropic（Claude）、Gemini、DeepSeek、Mistral、xAI（Grok），以及通过 Ollama 运行的 LocalAI 本地模型
机器翻译：LibreTranslate、DeepL、Google、Bing、Microsoft、Yandex

每个服务的接入方式大同小异：选择服务 → 填入 API Key → 选择模型即可，详见官方文档 ai-services.md 和 machine-translation.md。

2. 自动化翻译：接入 Radarr / Sonarr 影视库

如果你在用 Radarr（电影管理）或 Sonarr（剧集管理），Lingarr 可以直接对接这两个系统，自动扫描影视文件、匹配字幕并翻译。配合定时任务，新入库的影视剧甚至能"全自动"完成字幕翻译，相关配置项见 Settings.MD。

3. 智能上下文翻译与校对

普通机翻是逐句翻译，Lingarr 的 AI 翻译则支持上下文提示词，把前后台词一起发给模型，让翻译更贴合语境。翻译完成后，还可以运行**校对（Proofreading）**功能，让 AI 重新检查错译、人名、语法和标点，进一步打磨质量。提示词模板支持{lineToTranslate}、{contextBefore}等占位符，定制方式见 configuration.md。

4. 字幕格式全兼容

内置 SRT、SSA 字幕的解析与写入器（实现代码见 SrtParser.cs 和 SsaParser.cs），翻译完成后会保留原有时间轴与格式，生成的字幕可直接播放使用。

5. 插件机制：可无限扩展

Lingarr 支持通过插件 API 接入任意自定义翻译服务，开发者只需实现 ITranslationService.cs 接口，参考示例 CloudflarePlugin 即可。详细说明见 plugins.md。

🚀 10 分钟快速部署：用 Docker 一键安装

Lingarr 以 Docker 容器方式分发，支持 AMD64 和 ARM64 双架构，安装非常简单。下面是最快的配置方法：

第一步：准备 docker-compose.yml

官方推荐 MySQL，同时也支持 PostgreSQL 和 SQLite。为了 10 分钟内跑起来，这里给出最精简的 SQLite 方案（只需一个容器）：

services: lingarr: image: lingarr/lingarr:latest container_name: lingarr restart: unless-stopped environment: - ASPNETCORE_URLS=http://+:9876 - DB_CONNECTION=sqlite ports: - "9876:9876" volumes: - /path/to/media/movies:/movies - /path/to/media/tv:/tv - /path/to/config:/app/config

第二步：启动并访问

docker compose up -d

等待约 1 分钟后，浏览器访问http://你的服务器IP:9876，完成初始账号创建即可进入主界面。完整的 Docker Compose 与 CLI 安装教程见 installation.md。

第三步：选择翻译服务

进入设置 → 服务页面（前端页面定义见 ServicesPage.vue）：

在主服务下拉框中选择你的 AI 服务（如 OpenAI、DeepSeek 或 Gemini）
点击齿轮图标，填入 API Key 并选择模型
在页面底部设置源语言（如 English）和目标语言（如 Chinese）
可点击"添加备用服务"，配置失败时的自动降级服务

🎬 字幕翻译实操：三步让字幕说中文

部署完成后，实际的翻译流程简单到超出预期：

导入字幕：在影视页面找到对应的剧集或电影，选择需要翻译的字幕文件
发起翻译：点击翻译按钮，选择目标语言"Chinese"，Lingarr 会自动解析字幕并分批发送给 AI 服务
查看结果：翻译完成后可在翻译列表页查看进度与状态（状态机实现在 TranslationStatus.cs），不满意可以逐行校对或一键重试

翻译任务由后台调度器管理，支持并发控制，相关任务实现在 TranslationJob.cs 中。

💡 进阶技巧：让字幕翻译质量更上一层楼

自定义提示词：在服务的"请求设置"中修改AI_PROMPT（系统提示词），让模型以更地道的口吻翻译，比如指定"使用口语化的中文表达，符合字幕长度限制"
开启上下文翻译：用户提示词中加入{contextBefore}和{contextAfter}占位符，AI 就能参考前后剧情，翻译不再"断章取义"
翻译后必做校对：整篇翻译完成后，在翻译列表点击 Proofread，让 AI 全面检查一遍错译与标点问题
本地免费方案：不想花 API 费用？用 Ollama 部署本地模型，然后把LOCAL_AI_ENDPOINT指向http://ollama:11434/v1/chat/completions，即可实现完全本地化的免费 AI 字幕翻译

❓ 常见问题解答

Q：Lingarr 支持中文翻译吗？当然支持，中文是最常用的目标语言之一，且 AI 服务的翻译质量远优于传统机翻。

Q：没有 API Key 能用吗？可以，LibreTranslate 支持自部署且完全免费，Google、Bing、Microsoft 翻译服务甚至无需任何 Key 配置即可使用。

Q：翻译速度如何？速度取决于所选服务与字幕行数，AI 服务单次可批量处理多行字幕，一部 2 小时电影通常几分钟内即可完成。

Q：数据安全吗？Lingarr 是开源软件（AGPL-3.0 协议），可完全自托管，字幕文件都保存在你自己的服务器上。

📦 如何获取 Lingarr

想自己部署：直接使用lingarr/lingarr:latestDocker 镜像即可
想查看源码或二次开发：通过git clone https://gitcode.com/gh_mirrors/li/lingarr克隆仓库，后端入口在 Program.cs，前端入口在 main.ts
想贡献代码：阅读 CONTRIBUTING.md，Lingarr 欢迎任何形式的贡献