前言
关于字幕自动查找并下载方面，我已经写过两篇文章了。Docker SubFinder 和 Bazarr 或多或少都有些，甚至可以说在中文环境下很难用。目前大家比较常用的字幕刮削器应该是SubFinder，但是SubFinder年久失修，有些字幕站的API也已经失效，急需一款替代品来解决中文字幕匹配难，下载难的问题，好在ChineseSubFinder在此时应运而生。
ChineseSubFinder介绍
其实没啥可介绍的，功能目标很明确，就是方便自动下载中文字幕，并重命名字幕，符合emby规范，可以在emby、jellyfin、plex中识别并自动挂载。
https://github.com/allanpk716/ChineseSubFinder
ChineseSubFinder针对目前国内的几大字幕站都有做适配，对电影和电视剧的刮削效果都较为不错，动画片的支持也在开发中
使用说明
群晖下的部署非常方便，在群晖docker中，下载镜像allanpk716/chinesesubfinder:latest
运行镜像，填写你的UID、GID。挂载影视文件夹的根目录，之后就可以启动容器了
不知道UID、GID的请参考EMBY那篇文章，写的很详细，如果还是不懂，那么就 PUID=0,GUID=0，使用root权限吧
敲重点
ChineseSubFinder是根据NFO信息进行刮削的，所以能够正确刮削字幕的前提是你需要生成正确的NFO信息
EMBY生成正确的NFO信息，并存在媒体位，请照下图设置
详细设置请参照群晖使用docker安装&使用EMBY全流程教程-长文，写的很详细，我就不重复赘述了
# 影视媒体的目录层级最好是这样的，所有的影视分类和下载路径都在一个大分类下（比如都在影视文件夹下） --media|--downloads|--movies|--tv|--others
挂载路径可以按照我这个模板填写；需要注意⚠️请务必挂载/app/cache文件夹 否则容器体积可能会无限膨胀，后续这个文件夹可能还会缓存 IMDB 的查询信息，以及共享字幕的信息
chinesesubfinder 0.2X 版本使用说明&教程
0.2X版本已基本完善，0.2X版本将作为本文的主要讲解对象
使用 docker-compose 部署 chinesesubfinder 0.2X版本
version: "3"services:chinesesubfinder:image: allanpk716/chinesesubfinder:latest volumes:- /volume1/docker/chinesesubfinder/config:/config- /volume1/docker/chinesesubfinder/cache:/app/cache - /volume1/Video:/mediaenvironment:- PUID=1026- PGID=100- TZ=Asia/Shanghaiports:- 19035:19035restart: unless-stopped
docker-compose up -d
启动容器后，在网页中打开chinesesubfinder NAS-IP:19035
进入到配置中心，填写电影目录和电视剧目录，根据你容器挂载的路径来来填写
进阶配置可以参考我的
其他配置不是很重要，默认即可
之后等待chinesesubfinder扫描媒体库即可，着急的话，可以配置完后勾选 程序启动立即开启扫描然后重启容器，这样扫描任务会立刻执行
0.1X版本使用说明
使用 docker-compose 部署
version: "3"services:chinesesubfinder:image: allanpk716/chinesesubfinder:latestvolumes: - /volume1/docker/chinesesubfinder:/config- /volume1/docker/chinesesubfinder/SubFixCache:/app/SubFixCache- /volume1/Video:/mediaenvironment:- PUID=1026- PGID=100- TZ=Asia/Shanghairestart: unless-stopped
启动容器后，马上关闭容器，因为这时我们还没有修改配置文件中的媒体文件地址
编辑/congfg中的config.yaml，填写你的媒体文件夹地址
UseProxy: falseHttpProxy: http://127.0.0.1:10809EveryTime: 6hThreads: 1SubTypePriority: 0SubNameFormatter: 0DebugMode: falseSaveMultiSub: trueSaveOneSeasonSub: falseRunAtStartup: trueCustomVideoExts: mpeg,flv,f4v # 这里是举例，一般来说这一项可以不填写（删除）足够满足大部分人的需求MovieFolder: /media/电影SeriesFolder: /media/连续剧FixTimeLine: true# 下面的设置非必须，可以删除不要WhenSubSupplierInvalidWebHook: abc.com
UseProxy，默认false。是否使用代理，需要配合 HttpProxy 设置HttpProxy，默认 http://127.0.0.1:10809 。http 代理这里不要留空，不适应就设置 UseProxy 为 falseEveryTime，默认 6h。每隔多久触发一次下载逻辑。怎么用参考，robfig/cron: a cron library for goThreads，并发数，最高到 20 个。看机器性能和网速来调整即可。SubTypePriority，字幕下载的优先级，0 是自动，1 是 srt 优先，2 是 ass/ssa 优先SubNameFormatter，字幕命名格式(默认不填写或者超出范围，则为 emby 格式)，0，emby 支持的的格式（AAA.chinese(简英,subhd).ass or AAA.chinese(简英,xunlei).default.ass），1常规格式（兼容性更好，AAA.zh.ass or AAA.zh.default.ass）DebugMode，默认 false。调试模式，会在每个视频的文件夹下，新建一个 subtmp 文件夹，把所有匹配到的字幕都缓存到这个目录，没啥事可以不开。开的话就可以让你手动选择一堆的字幕啦。SaveMultiSub，默认值 false。true 会在每个视频下面保存每个网站找到的最佳字幕（见《如何手动刷新 emby 加载字幕》，会举例）。false ，那么每个视频下面就一个最优字幕。CustomVideoExts，默认值是空。v0.12.x 版本出现。自定义视频扩展名，多个扩展名用英文逗号分隔SaveOneSeasonSub，默认为 false。v0.12.x 版本出现。非必须的选项。true 的时候会在每一个连续剧下面保存 Sub_S01E0 这样的缓存文件夹，里面的内容是每一季的整季字幕包的缓存，便于人工核对。注意的是下载的是整季的字幕包才会出现在这，且整季的字幕包的命名要有 S01 这样的关键词才会下载。RunAtStartup，默认值是 false，启动容器/程序时，是否开始搜索并下载。v0.16.x 开始有效。MovieFolder，填写你的电影的目录SeriesFolder，填写你的连续剧的目录FixTimeLine，字幕时间轴校正（V0.19.x 开始启用）,ChineseSubFinder/字幕时间轴校正V2WhenSubSupplierInvalidWebHook，当字幕网站失效的时候，触发的 webhook 地址，xunlei、subhd、zimuku 解析故障的通知接口，给维护人员用，可以尽快去修复解析问题。一般人员无需关心此设置。默认使用的是 bark 的通知格式。
联动Emby
可选项
这里我就直接复制作者写的readme了
获取 Emby API KEY
如下图
编写 Emby Api 配置信息
EmbyConfig:Url: http://192.168.50.x:8096ApiKey: 123456789LimitCount: 500SkipWatched: false
在原有的 ChineseSubFinder config.yaml 中新增一下配置信息
那么新增后的 ChineseSubFinder config.yaml 文件为:
UseProxy: false HttpProxy: http://127.0.0.1:10809 EveryTime: 6h Threads: 1 SubTypePriority: 0 SubNameFormatter: 0 DebugMode: false SaveMultiSub: false SaveOneSeasonSub: false RunAtStartup: true CustomVideoExts: mpeg,flv,f4v # 这里是举例，一般来说这一项可以不填写（删除）足够满足大部分人的需求 MovieFolder: /media/电影 SeriesFolder: /media/连续剧 FixTimeLine: true # 下面的设置非必须，可以删除不要 WhenSubSupplierInvalidWebHook: abc.com
EmbyConfig: Url: http://192.168.50.x:8096 ApiKey: 123456789 LimitCount: 500 SkipWatched: false
之后就可以再次启动容器了，容器启动后会自动遍历媒体文件夹，下载对应的字幕
另外，我推荐最好设置一下代理
稍等片刻就能够在自己的媒体目录下找到刚刚下载的字幕了
使用 docker 命令部署
docker create \ --name=chinesesubfinder \ -e PUID=1026 \ -e PGID=100 \ -e TZ=Asia/Shanghai \ -v $PWD/chinesesubfinder:/config \ -v $PWD/chinesesubfinder/SubFixCache:/app/SubFixCache \ -v $PWD/chinesesubfinder/video:/media \ allanpk716/chinesesubfinder:latest
使用 docker-compose 部署
version: "3"services:chinesesubfinder:image: allanpk716/chinesesubfinder:latestvolumes:- /volume1/docker/chinesesubfinder:/config- /volume1/docker/chinesesubfinder/SubFixCache:/app/SubFixCache- /volume1/Video:/mediaenvironment:- PUID=1026- PGID=100- TZ=Asia/Shanghairestart: unless-stopped
结语
目前ChineseSubFinder还在开发中，更新频率很高，最好保持在最新版，说不定某次更新就解决了你的痛点
高阶教程-追剧全流程自动化最的最大的痛点，字幕下载这块，总算是得到了一个不错解决，本文也会补充进高阶教程-追剧全流程自动化。
番外
字幕命名格式的转换
从 v0.14.x （在此之前的都是默认 Emby 的格式）开始，将支持切换字幕名称格式模式，以应对 Jellyfin 和 Plex 和其他媒体工具识别字幕的问题。
在 config.yaml 中，将新增一个字段 SubNameFormatter。
UseProxy: true HttpProxy: http:/127.0.0.1:10809 EveryTime: 12h Threads: 1 SubNameFormatter: 0
SubNameFormatter 字幕命名格式（默认不填写或者超出范围，则为 Emby 格式，为了兼容以前的版本）：
0，Emby 支持的的格式（AAA.chinese(简英,subhd).ass or AAA.chinese(简英,xunlei).default.ass）
1，常规格式（兼容性更好，AAA.zh.ass or AAA.zh.default.ass）
因为考虑到了 Plex 不支持 Default 字段
