很多人的 Jellyfin，是卡在海报墙这一步的：有的电影海报缺失，有的把《星际穿越》刮削成不知名 B 级片，简介全是英文，或者整个库死活刮不出信息，重扫多少次都没用。这时候大多数人的第一反应是"刮削插件不行"，于是装 MetaShark、重启，然后发现还是不行。
问题在于，刮削失败其实分三个阶段：先是认不出，然后是连不上，最后才是选不对。三个阶段的成因、处理方式和代价完全不同，搞错阶段就是白忙。下面按成本从低到高的顺序排查一遍，最后再给一份按片库构成选数据源的建议。
第一步：查命名和分库，这是最高频的问题
Jellyfin 的识别基本靠文件名和目录结构，这一环不过关，后面插件再强也救不回来。命名公式就两条：电影用"电影名 (年份).mkv"，剧集用"剧集名 S01E01.mkv"。小红书在此基础上还有三个"不要"：不要带【】、《》、★这类多余中文符号，不要拼音英文混杂，不要加 1080P、4K 这类分辨率后缀，文件名和文件夹名保持一致，前缀部分越干净越不容易翻车。值得买社区
然后是分库。电视剧、动漫、电影的命名规则和元数据来源都不完全一样，分开管理能减少误识别。知乎电影库、剧集库、动漫库各建各的，一个库可以挂多个文件夹，不用挪原有目录。刮削错了也不用删文件重来，在影片详情里用"识别"重新搜索匹配就行。知乎
第二步：查网络连通，TMDb 在国内不好连
命名都规范了，海报还是全缺，或者插件目录一直转圈加载不出来，问题大概率在网络。Jellyfin 的主力刮削源是 TMDb（The Movie Database），而刮削是通过 TMDB 进行的，TMDB 在国内容易受到 dns 污染，导致地址解析失败。哔哩哔哩
常见路子有三条，按折腾程度排：
改 hosts：查 api.themoviedb.org 和 image.tmdb.org 对应的可用 IP，写进系统 hosts。社区里配置刮削工具的通行做法，就是需手动配置 Hosts 解决海外 API 连接超时问题。值得买社区注意一个域名可能对应多个 IP，要都加上。
给 Jellyfin 走代理：宿主机设系统代理，或 Docker 组网时把它的流量带出去，最稳，但看你的网络条件。
只是插件目录打不开：在"插件-存储库"里新建或更换仓库，填一个可用的 manifest 地址，刷新后重新加载插件列表。
第三步：现在才轮到插件和数据源
前两步都过了，再谈"用哪个刮削源"。Jellyfin 自带一批官方元数据插件，系统内置元数据插件（TMDb、AudioDB 等）仅支持禁用，不能卸载。微信公众号按你的片库构成选：
外语影剧为主：官方 TMDb + TheTVDB + Fanart 组合基本够用。TMDb 是电影、剧集的主流元数据库，社区对它的定位是国内适配最好，资源最全，主刮削源。微信公众号把首选下载语言设成 Chinese、国家地区选 China，"简介全英文"的问题也能一起解决。
中文影剧为主：TMDb 的中文库偏弱，要装 MetaShark 这类豆瓣刮削插件。装完记住一件事：要在媒体库设置里把它移到元数据下载器的首位，否则插件不生效，这是社区里最常见的"装了没用"翻车点。值得买社区
动漫为主：官方仓库的 AniDB 插件专做日系动画，季番、OVA、剧场版的季集匹配比 TMDb 精准。动漫和真人剧混放容易串季，建议动漫单独建库。
还要单独提醒一句豆瓣刮削：豆瓣接口有频率限制，批量刮削时务必开启防封禁功能，否则IP可能被封6小时。值得买社区几千部电影别一次性硬刷，分批来。
静态库、命名不规整为主：一大片不再更新的老资源，用 tinyMediaManager 在电脑端刮削、逐条确认、生成 NFO 再交给 Jellyfin 更稳。版本认准 v3.1.17 稳定版，v4 对中文剧集的支持反而是退步的。值得买社区电脑端刮削比挂在 NAS 上跑快得多，还不占 NAS 资源。
为什么建议现在就把这事定下来
最近后台有两个变化。一是 7 月中下旬 Jellyfin 三位创始人相继离开，项目尚未公布继任计划。值得买社区接下来一段时间它大概率处于交接期，第三方刮削插件跟进新版本的速度可能变慢，长期要用的插件，现在选稳定、用的人多的路线更保险。二是很多第三方插件仓库给的是转发链接，比如社区教程里示例的 MetaShark 仓库地址就是 https://ghfast.top/https://github.com/cxfksword/jellyfin-plugin-metashark/releases/download/manifest/manifest_cn.json 这种形式。微信公众号转发链接本身会失效，遇到安装失败先怀疑链接，别先怀疑插件。把验证过的 manifest 地址和插件包存下来，随时能离线装。
最后三个提醒：
全库重刮削之前，先备份 /config 目录。用户、媒体库、观看记录都在这里面，社区老手的惯例也是定期备份 /config 目录（含数据库和设置）。今日头条
跑 10.11.x 且片库是 TB 级大库的，注意合集页慢、大量文件媒体库打开慢的问题，现在更新到 jerryfin10.11.4 也还没修复。哔哩哔哩重扫分批做，别在全家人用的白天批量操作。
想观察刮削环境变好还是变坏，盯两个信号：第三方刮削插件有没有跟进你的 Jellyfin 版本，以及 TMDb 连通性是不是还需要额外手段维持。
你踩过更离谱的刮削坑又是怎么解的，评论区留给你们互相避雷。
