
Subtitle Scout 是一个自托管的字幕自动化工具,TypeScript 编写、Docker 单容器部署,GitHub 上 142 星、AGPL-3.0 开源、最新版 v1.0.0。它会扫描你的影视目录,去 ASSRT、SubHD、Zimuku、OpenSubtitles、Jimaku 五个字幕源找候选,逐条比对作品、季、集和时间轴,只把对得上的那条装进目录;目标语言没有现成字幕时,用你自己接的大模型把外文字幕逐句翻过来。不依赖 Jellyfin、Emby、Plex。
下片子的都碰过这事:一整季二十多集,字幕要一个个站点翻,文件名对不上还得手动改;下错了更麻烦,前五分钟能对上,二十分钟后字幕越飘越远。Subtitle Scout 接的就是这段活——它做的不是「下一条字幕」,而是判断这一条到底属不属于这一集。
参数与字幕源
| 项目语言 | TypeScript |
| 开源许可 | AGPL-3.0 |
| 最新版本 | v1.0.0(2026-09) |
| GitHub 星标 | 142 |
| 部署方式 | Docker 单容器,默认端口 8099 |
| 字幕源 | ASSRT、SubHD、Zimuku(中文)、OpenSubtitles、Jimaku(日文) |
| 需要的密钥 | TMDB、ASSRT(免费申请)、大模型接口(可选) |
它到底怎么判断
- 发现:直接扫媒体目录,不装媒体服务器也能找出所有缺目标语言字幕的作品;首页海报墙上绿色状态条表示已就绪,琥珀色表示还没字幕。
- 判断:先过 TMDB 把文件名对上真正的作品、季、集,再拿实际视频校验候选字幕的身份和时间轴,排序之后才选一条;对不上的候选不会碰你的媒体库。
- 装好:选中的字幕写到视频文件旁边,按播放器都认的方式命名;源里都没有,才走大模型的翻译通道。
适合谁
- NAS 或家用服务器上存了几百部片子的人,尤其是追国产剧、日剧、美剧的。
- 不想为了配字幕去装一整套媒体服务器的人。
- 愿意自己申请一个免费 ASSRT 密钥、能配 Docker 的人。
- 语种需求偏门的人要留意:作者自己交代中文覆盖最厚,日文有专属源,其他语种走 OpenSubtitles,非中文源目前还比较少。
怎么装起来
- 找一台能跑 Docker 的机器(NAS、家用服务器、VPS 都行),新建 docker-compose 文件,镜像用项目发布的 latest,端口映射 8099。
- 把媒体目录挂进容器(官方示例是把宿主机根目录挂到 /hostroot,方便在监控页里挑目录),再挂一个 cache 目录存缓存。
- 启动容器,浏览器打开 8099,进设置向导。
- 向导里填 TMDB 密钥、ASSRT 密钥,要翻译再填自己的大模型接口;密钥存在容器里,不用写进 compose 文件。
- 扫描页选好媒体目录,先跑一次只检测不安装,看判定准不准,再开自动模式。
- 国内拉镜像慢的话,按项目文档把镜像地址前缀换成国内源,再重新拉起容器。
常见问题
问:它会动我的视频文件吗?
答:不会。只把字幕写到视频旁边,按播放器能识别的名字命名;字幕删掉片子照样能看。
问:一定要装 Jellyfin 或 Plex 吗?
答:不需要。它自己扫目录,装好的字幕 Jellyfin、Emby、Plex 都能直接读,但这几个一个都不装也能用。
问:中文字幕真的比别家全?
答:作者的说法是中文覆盖最强,靠 ASSRT、SubHD、Zimuku 三个中文源撑着。其中 ASSRT 要密钥,SubHD 和 Zimuku 免密钥但默认关闭,得自己在设置里打开。
问:翻译出来的字幕能看吗?
答:走的是你自备的大模型,逐句翻,质量取决于接的模型。免费额度的小模型翻长句会生硬,追剧建议接个稳一点的。
最后更新:2026-10-28
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。
