【Docker】搭建一个媒体服务器插件后端API服务 - MetaTube

本文最后更新于 2024-06-26，文章可能存在过时内容，如有过时内容欢迎留言或者联系我进行反馈。

前言

本教程基于群晖的NAS设备DS423+的docker功能进行搭建，DSM版本为 7.2.1-69057 Update 5。

简介

MetaTube 是一个媒体服务器插件，主要用于 Emby 和 Jellyfin 媒体服务器。它的主要功能是从互联网上抓取内容并响应 JSON 数据，然后通过预安装的 MetaTube 插件请求服务器并下载相应的元数据，以与 Jellyfin/Emby 服务器配合使用。

使用 MetaTube 的步骤大致如下：

部署后端：首先，需要部署一个名为 metatube-server 的后端 API 服务器来抓取内容。
安装插件：在媒体服务器上安装 MetaTube 插件。
配置插件：在 MetaTube 插件的配置页面中输入后端地址 URL 和需要的后端密钥 Token。在媒体库中选择电影类型，并勾选 MetaTube 作为元数据下载器与图片获取器。
使用插件：在添加完视频后，点击“扫描媒体库”按钮。使用“刷新元数据”以更新数据内容，或使用“识别”手动搜索影片或演员数据。

MetaTube 插件会自动更新，但有时需要重启 Jellyfin/Emby/Plex 服务才能使插件生效。此外，MetaTube 整合了演员提供商，可以自动搜索和识别演员。

部署

打开“Container Manager”，在“注册表”中搜索“metatube-server”选择第一个进行“下载”。
在“容器”中“新增”进行创建容器，选择刚刚下载的镜像，然后自己定义一个容器名称并且勾选“启用自动重新启动”，最后点击“下一步”。
在“端口设置”中“新增”一组端口映射前者为NAS的本地端口，可以自定义本地端口，只要不冲突即可，后者为容器的固定访问端口8080。

在“环境”中，根据实际情况进行配置，配置好以后点击“下一步”。

参数名
可选值
默认值
备注
PORT
int<0-65535>
8080
监听端口号，按需修改
TOKEN
string
无
访问密钥，按需配置，若部署在本地则没有配置的必要
DSN
string
内存模式
数据库服务地址，按需配置，小白建议使用默认值
DB_MAX_IDLE_CONNS
int
0
最大空闲数据库连接数，建议使用默认值
DB_MAX_OPEN_CONNS
int
0
最大数据库连接数，建议使用默认值
DB_PREPARED_STMT
bool
false
Prepared Statement，建议使用默认值
DB_AUTO_MIGRATE
bool
false
数据库表自动迁移，建议使用默认值
REQUEST_TIMEOUT
string
1m
请求超时时长，默认一分钟

完成以上步骤后，检查一下，确认无误后直接点击“完成”。
在浏览器中输入{IP}:{Port}，显示如下，即表示搭建成功。

参数名	可选值	默认值	备注
PORT	int<0-65535>	8080	监听端口号，按需修改
TOKEN	string	无	访问密钥，按需配置，若部署在本地则没有配置的必要
DSN	string	内存模式	数据库服务地址，按需配置，小白建议使用默认值
DB_MAX_IDLE_CONNS	int	0	最大空闲数据库连接数，建议使用默认值
DB_MAX_OPEN_CONNS	int	0	最大数据库连接数，建议使用默认值
DB_PREPARED_STMT	bool	false	Prepared Statement，建议使用默认值
DB_AUTO_MIGRATE	bool	false	数据库表自动迁移，建议使用默认值
REQUEST_TIMEOUT	string	1m	请求超时时长，默认一分钟

下载

从GitHub的releases中下载MetaTube最新插件

GitHub：https://github.com/metatube-community/jellyfin-plugin-metatube/releases

从2024.205.435.0版本开始，不再支持 Emby4.7.x版本。如果你使用的是低于4.8版本的Emby，请下载2024.205.435.0之前的MetaTube插件

使用

在Emby中使用MetaTube

将前面下载好的MetaTube.dll放入到你部署好的Emby插件目录里，插件目录默认是/config/plugins。
将插件放入Emby的插件目录后，重启一下Emby。
在web页面中的插件内找到metaTube插件，鼠标右键选择“设置”。
配置一下“Server”和“Token”。
如果你只想在本地使用该服务，可以使用本地IP，如果前面部署的matetube-server没有配置Token的话，此处可以留空。
其他的配置可以使用默认的就行，然后直接点击“Save”进行保存。
在“媒体库”中编辑一下需要刮削电影信息的媒体库，将“电影元数据下载器”和“电影的图像获取器”的MateTube选项进行勾选。
对媒体库进行一次“刷新元数据”。
“刷新元数据”后，需要一定的时间刮削电影信息，请耐心等待。
文件名称使用番号即可，多余的文字可以删除掉，以免影响刮削。