Metatube 是一个Jellyfin刮削插件，可以轻易刮削小姐姐影片，包括标题、简介、演员、标签、评分等内容。
你可以把它理解为特化版的 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配置：

複製代碼

1. version: '3.3'
2. services:
3.   api:
4.     image: ghcr.io/metatube-community/metatube-server:latest
5.     restart: always
6.     container_name: metatube
7.     #启动时加载数据库，使用sqlDB
8.     command: "-dsn /config/metatube.db"   
9.     #映射配置文件
10.     volumes:
11.     - /home/docker/metatube/config:/config   
12.     network_mode: bridge
13.     ports:
14.       - 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 作为元数据下载器，未选择电影类型

网络不好，我自己使用是可以正常刮削的，有时候会慢一点，不需要魔法代理

影片 / 演员太新了

有没有收集小红书的？我看到很多丝袜的美足的想保存下来。4431ad7b4e4大话d色


此貼由三甚三工重新編輯：2025-12-02 01:19

感谢分享

大佬厉害啊

刮削小姐姐 啥意思
难道我out了 完全不懂啥意思

小白不会玩

感谢分享

感谢分享，虽然我完全看不懂讲了个啥😥

1024

感谢分享

感谢分享

感谢分享

感谢分享

不明觉厉

高级技术

这是真技术贴啊

给你

1024

虽然看不懂，但还是要感谢

感谢分享技术大佬

感谢分享

感谢分享

感谢分享

感谢分享

感谢分享，不明觉牛逼