你可以把它理解为特化版的 TMDB，区别就是 TMDB 有官方的 API 服务，而 Metatube API服务需要你自行部署。
本文面向的是 Jellyfin 新手，没有安装插件以及部署服务的经验。前提是你已经安装好最新版本的 Jellyfin。
本文大概分为三个步骤：安装插件、部署后端服务、配置使用插件
插件安装
进入 Jellyfin 控制台 > 插件 > 存储库，点击添加
新版 Jellyfin 控制台 > 插件 > 目录 > 设置图标 > 点击加号图标
输入存储库名称：MetaTube
输入存储库URL：https://raw.githubusercontent.com/metatube-community/jellyfin-plugin-metatube/dist/manifest.json
在插件目录元数据类别下找到 MetaTube，点击安装
重启 Jellyfin
进入控制台 -> 我的插件，确认 Metatube 插件的状态为 Active，点击进入设置界面
适用于墙内的存储库URL：https://cdn.jsdelivr.net/gh/metatube-community/jellyfin-plugin-metatube@dist/manifest.json
注意：这一步在打开插件目录界面时有可能因为网络问题一直加载不出来，多等待一会儿或多打开几次，第一个无法使用的可用第二个储存库URL
后端服务安装
为什么需要安装 Metatube 后端服务？
因为 jellyfin 需要通过后端来刮削数据，metatube 作为刮削源，jellyfin 把影片名称等信息交给 metatube后端去刮削，metatube后端根据代号去不同的数据站获取数据，jellyfin 拿到元数据后保存到本地或者影片文件夹中。
后端部署比较方便，有多种方式。有一定动手能力的可以选择自己部署，也可以选择部署免费的云服务。本文主要讲一下在Nas中的部署。
使用Docker命令部署
SSH连接Nas在命令行输入以下命令部署
複製代码
docker run -d -p 8080:8080 -v $PWD/config:/config --name metatube ghcr.io/metatube-community/metatube-server:latest -dsn /config/metatube.d
更新后端需要先运行以下命令再重新跑一遍上述命令，初次安装请跳过
複製代码
docker stop metatube
複製代码
docker rm metatube
通过Docker-Compose部署
以下是docker-compose.yaml配置：
複製代码
- version: '3.3'
- services:
- api:
- image: ghcr.io/metatube-community/metatube-server:latest
- restart: always
- container_name: metatube
- #启动时加载数据库，使用sqlDB
- command: "-dsn /config/metatube.db"
- #映射配置文件
- volumes:
- - /home/docker/metatube/config:/config
- network_mode: bridge
- ports:
- - 8080:8080
複製代码
- /home/docker/metatube/config:/config 这行代码很重要，因为不映射配置文件的话，这个 matetube.db 是保存在 docker 容器内的，映射后方便储存和备份。修改 /home/docker/metatube/config 为你要保存 sqlite 数据库文件的路径，也可以使用相对路径 ./config。
使用免费的云服务部署
这里给出一个其他大佬在huggingface 搭建的免费后端地址，不需要 token，不需要代理
https://metatube-server.hf.space/
也欢迎大家分享自己部署的后端服务地址在评论区
配置插件
安装好插件和后端服务后，进入插件设置界面，配置服务端地址 和 Token，比如上一步配置的后端端口是 8080，则服务端地址为：http://localhost:8080，如果访问失败，可以考虑使用实际的内部ip地址。Token 相当于密钥，如果在部署的时候配置了 Token，在插件里一定要配置 Token，否则会因为校验失败无法使用。
如果你是用的别人的服务或者云服务，这里填写的是公网链接，一般是 https://开头的链接，如果是自己部署的服务在内网就是 http://开头的内网链接。
其他的配置可以使用默认配置，包括开启预告片、真实名字、自定义标题等设置自行修改
安装后的设置界面
如何使用
上述操作完成后，就可以来刮削影片了。
创建媒体库，选择电影类型，选择影片所在文件夹。
配置媒体库，勾选 Metatube 作为元数据下载器 (电影)， 注意只勾选这一个即可。
图片获取程序也只选择 Metatube，然后勾选 “将媒体图像保存到媒体所在文件夹”
扫描媒体库 - 刷新元数据，即可开始刮削，不出意外，刮削完成后会自动显示封面和影片信息。
可以设置成 “启用实时监控”，不需要手动刷新，有的实在扫描不出来的可以手动选择识别，填写影片号码后查找。
常见问题
metatube 插件状态不是 active，有可能是 jellyfin 版本和 metatube 版本不匹配，更新 jellyfin 或者更新 metatube 版本，在插件目录可以安装历史版本
metatube 无法刮削。有可能是后端服务没正确启动或者配置的后端url地址错误，检查ip，端口号，后端服务是否正常，在浏览器访问后端地址测试连通性
metatube 刮削失败。有可能是网络问题，必要时可以使用魔法。也有可能是影片命名规范的问题，尽可能保证只有影片名称，不要带那些网站的链接
可以查看 jellyfin 和 metatube后端 的日志，确认是在哪一步出现问题，比如 metatube 没有日志，有可能是地址填错了或者没有设置正确的刮削源，再去看jellyfin日志，会提示网络错误或者插件错误
注意事项
有一些行为可能导致刮削失败
影片命名不规范，尽可能只有影片代号，去掉那些奇奇怪怪的网站和广告
未使用 Metatube 作为元数据下载器，未选择电影类型
网络不好，我自己使用是可以正常刮削的，有时候会慢一点，不需要魔法代理
影片 / 演员太新了