Emby字幕最佳拍档！CSF中文字幕下载器，你的全自动追剧好帮手！群晖Docker安装保姆教程！

什么是CSF，它能为我们做什么？

（心急的童鞋可以直接跳到第2步开始搭建）~~

CSF，全称为ChineseSubfinder，望文生义，是一个纯粹的为中文字幕而生的字幕下载器。

Emby是一个非常优秀的自建流媒体服务器，但相信大家在使用它的过程中也会遇到许多痛点，首当其冲的应该就是中文字幕的下载和匹配。这个问题应该也算是影音发烧友们折腾路上难以绕过的一关。虽然因为PT站一大批为爱发电的工作组的存在，使得优质影片+特效字幕的打包资源的获取变得越来越容易，但是更海量的老资源以及冷门的未被涵盖的资源仍然存在着非常现实的字幕难题。

中文玩家事实上坐拥字幕库、射手网等诸多优质的中文字幕产出地，高质量字幕的获取理论上不算一件难事，但是正如CSF的作者（下文简称作者为716佬）所说：

@allanpk716:就现在短期观察到的字幕问题，其实归根结底还是字幕文件命名规范不统一，也没有组织去推广命名规范。当然这个问题也是有人考虑过的，不然 shooter 和 xunlei 怎么会用视频的唯一 ID 去搜索字幕呢，大概就是为了跳过这个问题吧。这个方向很好，但是问题就是你的播放器占有率如何。

在接触到PT之前，通过BT下载的无字幕资源，我通常会在字幕库尝试手动下载字幕。下一个速度正常，影片质量令我满意的资源已非易事。如果内嵌字幕还好，碰到需要手动下载的，打开字幕网站-搜索影片-挑选看起来合适的字幕文件-下载-手动改名以使播放器能够自动识别字幕，这一长串的流程更是扫兴 。 如果再碰到下载的字幕时间轴不匹配、字幕样式不喜欢更是雪上加霜，观赏影片的心情毫无例外的大受影响（简称心态崩了）。

CSF就是716佬为中文影音玩家准备的一份厚礼，希望藉它实现全自动、准确且高效的中文字幕下载与匹配。我在之前通过Sleele大佬的文章接触到Sonarr和CSF时，就立刻开始使用它作为我的字幕获取途径。早期的CSF功能较简陋，需要通过YAML配置config文档来运行。虽然对于爱折腾的玩家来说YAML配置应该是手到擒来了，但是总归存在着一定的上手难度。而V0.20版本开始，_CSF正式进入了WEB时代，集多媒体路径
、Emby API支持、多站点聚合检索及字幕时间轴自动校正等等强大功能于一体，易用性得到了极大的提升。

目前CSF的主要功能如下：

支持的视频类型

支持的字幕站点

支持的视频格式、各类优先级的说明

716佬还希望通过CSF来助力完善字幕命名规范，并开发一个字幕组元数据描述生成的辅助工具。衷心希望作者的愿景能够早日实现！

接下来进入正文，实操在群晖上安装CSF！

准备工作

1. 打开群晖的Docker，在注册表搜索ChineseSubFinder，下载latest镜像（当前最新版本为v0.21.1)
   

2. 新建一个容器使用的文件夹，下面再新建两个文件夹，config和cache。可以直接安装在群晖自带的docker共享文件夹下，由于我是另外安装在固态上因此是单独的一个文件夹。

• 前者，是配置文件的存储目录，Log 文件夹也会出现在其中

• 后者，是缓存文件夹，特别是使用时间轴自动校正功能必须映射出来
  

开始搭建

在Docker的映像中，找到刚刚下载好的镜像，选中它然后双击以启动镜像，接着点击高级设置

首先，给启用自动重启打上勾，这样Nas开机就会自动运行容器

关于存储空间映射的设置项及详细说明

由于我和作者一样，都是使用radarr和sonarr进行自动化媒体库的管理，因此我们的媒体库结构是基本一样的，所有的媒体文件夹都在一个顶级父目录下，同时所有的媒体文件都经过了刮削和整理，姑且将这类文件夹层级当作媒体整理的规范。

将前面准备的config和cache文件夹挂载到容器上，不要修改图片中的装载路径。

同时将你的媒体文件夹挂载到/media目录，如图中所示，我的媒体文件夹为18bro/Media。

如果你的媒体库分布在多个盘上，那么可以挂载多个media目录，目前支持额外挂载9个文件夹，从/media1到/media9

此处额外贴上作者关于层级的解释，以及CSF是如何工作的，理解了原理才能避免使用中出现错误：

电影的目录结构

CSF会通过刮削后子目录下的nfo等文件中影片的IMDB等元数据信息进行字幕的搜索和匹配，虽然未刮削的文件依然可以通过文件名进行搜索，但是准确率和效果不佳，因此强烈推荐对媒体库的文件进行刮削整理后再配合CSF使用。

手动管理是很痛苦的一件事，TMM等工具虽然可以很好的实现刮削和整理的效果，但是反复的操作是很消磨耐心的。Radarr和Sonarr虽然初期配置较为繁琐，但是后续的使用确实非常省心啦！最近还涌现了诸如MovieRobot、Nastools等国产开发者的优秀项目，感觉以后影音爱好者的折腾会越来越轻松。

剧集的目录结构

剧集与电影不同，电影是推荐使用规范的目录结构，但剧集如果不遵守此规范是直接无法使用字幕下载功能的。

连续剧字幕自动下载的功能严重依赖于 IMDB ID，所以会自动去每个剧集的目录中找 tvshow.nfo这个文件，这个文件是 emby 或者 sonarr 自动生成的。

同时CSF只会处理一级目录的搜索，拿上面我挂载的目录为例：

剧集目录为

• SeriesFolder: /Media/TV

则CSF会对以下目录进行搜索

• /Media/TV/All of Us Are Dead (2022)

• /Media/TV/D.P：逃兵追缉令 (2021)

• /Media/TV/Dopesick

但不会对二级目录进行搜索，举个例子，有些人可能会将一些同类的片子置于一个文件夹下

• /Media/TV/犯罪/成瘾剂量

• /Media/TV/犯罪/不死法医

这种情况下，CSF是无法读取“犯罪”这个文件夹下的剧集信息的。即剧集文件夹不能嵌套，剧集文件夹必须为剧集目录的一级子目录，且它的下一级必须包含tvshow.nfo文件。

具体的操作其实可以参考我的上一篇文章，媒体库的设置照着做一定不会出问题了！

Emby正传 篇二：万剑归宗之刮削大法！史上最全从Emby命名规则到刮削设置一条龙图文教程！NAS存储什么值得买

端口设置

设置端口19035，也可以使用你想用的端口。

其他的网络、链接和环境不需要改动，直接点击应用即可运行容器。

完事后在浏览器输入你的群晖ip地址+19035进入CSF的WEB设置界面，进行下一步的设置。

WEB引导页设置

首先创建你的管理账号

设置对应的媒体库目录，根据刚刚挂载的路径进行填写即可。

716佬:每填写完成一个路径后，使当前的输入框丢失焦点即可触发路径是否存在的检测逻辑，如果不对，你需要理一理你在之前配置映射的 Docker 目录是否对。

点击+号可以创建多条目录

选择媒体服务器，以Emby为例

填写Emby的内网地址和apikey，apikey需要前往Emby生成一个，打开Emby右上角的设置，左边的功能栏拉到底部，点开API密钥，生成一个新的密钥即可。

接下来需要填写Emby的目录映射，这里是比较容易出错的点。以我为例，我是群晖DSM 7的官方套件版，打开Emby-设置-媒体库，根据上一步挂载的路径找到对应的媒体库，复制该媒体库下方的路径使其能够一一对应即可。如果填错了，会提示你检测错误，检查后再填写正确的路径即可。

填写完毕，点击完成即可。

运行CSF并配置

登录刚刚设置的账户

先不要运行任务！点开配置中心，如果需要程序启动的时候就立即开始扫描字幕，那么可以打开第二项的开关。

这里需要特别注意！如果这个开关关闭，那么在任务栏点击立即运行时程序并不会立刻开始扫描字幕，而是会提示你将在等待设置的时间间隔后（默认6H）开始第一次运行，因此建议打开此开关。

点到进阶配置内，推荐打开保存整季的缓存字幕和保存多字幕。缓存会将该剧集扫描到的字幕加入缓存，保存多字幕可以在Emby上自由选择多个匹配的字幕。

其他的设置如无必要推荐不作修改，直接返回到任务页面，点击立即运行程序就跑起来啦！

关于自动校正字幕时间轴功能

目前作者已经开发到了V2版本，根据716佬的介绍，他为了尽可能实现独立运行，使用golang重写了一个很棒的时间轴校正项目ffsubsync！我们在开局的时候配置挂载的cache目录，就是为了避免每次更新CSF后重复导出之前已经生成的缓存。

修正字幕的效果如下，CSF会对外置下载的字幕进行时间轴和内置音频校正，完成后原有的字幕会加一个后缀名（.csf-bk)进行备份存储。 如果你发现自动校正的有问题，可以手动还原回去。

由于此功能仍处于开发阶段，可能存在一些问题，且第一次使用由于需要将视频文件加入缓存，耗时较长，根据自己需求来选择是否需要打开即可！

关于作者

我觉得作者是一个非常有温度的开发者， 不管是项目Readme上超级详细的引导文档（毫不夸张的说，大佬写的readme是我见过的中文项目中最详细最小白化考虑最周全的），issue中的认真回复抑或是最重要的CSF软件整体设计的效果（为了照顾到更多用户，摒弃了以前的YAML配置转而联合其他开发者支持了WEB化），可以看出他是一个非常纯粹的为爱发电的技术大佬！

作为一个技术白痴和爱折腾的普通人，由衷感谢所有参与到CSF项目中的技术大佬们，正是有你们的存在，科技改变生活才显得不是一句空话！

完结撒花！如果有帮到你，麻烦动动小手给我来个三连吧！

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～