Jellyseerr：家庭媒体管理新手指南

如果你正在使用 Jellyfin，你已经知道它是托管和流式传输你的媒体收藏的绝佳工具。不过，有些部分可能会有问题，比如管理请求。这就是 Jellyseerr 的用武之地。 

Jellyseerr 具有易用性和高级功能，能让你的媒体库更上一层楼。本指南将向你介绍如何确保与你的设置无缝集成。

目录

1. 什么是 Jellyseerr？
2. 如何安装 Jellyseerr
3. Jellyseerr 基本安装攻略
4. 高级配置
5. 优化 Jellyseer 性能
6. 常见问题的故障排除
7. 常见问题
8. 最终想法

1.什么是 Jellyseerr？

Jellyseerr 是一个开源工具，能让你更轻松地管理 Jellyfin 服务器上的媒体请求。它就像媒体服务器、自动化工具和用户之间的中间人。它主要处理请求、审批和媒体跟踪。

虽然它主要是为 Jellyfin 设计的，但 Jellyseerr 也能与其他媒体服务器协同工作，如 Plex 和 安比.不过，开发人员提醒说，某些功能在其他平台上可能会有所不同。

• 可定制的申请管理： 先进的媒体申请功能和简便的审核和批准系统。
• 自动化处理： 必要时，该程序可以触发 Radarr、Sonarr 和 Prowlarr 等常用工具。
• 通知： 实时更新每项申请的状态。 

另请阅读 

• Jellyfin Vs Plex - 媒体管理器之战
• 七大 Plex 替代品

b.安装前提条件

安装 Jellyseerr 之前，请确保以下事项：

• 媒体服务器： Jellyfin 已安装并运行。
• 自动化工具： Radarr、Sonarr 和 Prowlarr（用于索引器）。
• 数据库： SQLite (您也可以使用 PostgreSQL）
• 托管环境： NAS / Home Server / Seedbox

2.如何安装 Jellyseerr

Jellyseerr 可以在所有支持 Jellfin 的平台上运行。虽然组合非常广泛，但我们将主要关注那些支持 Docker 因为这是管理设置的最可靠方法。 

如果您不熟悉 Docker，请阅读 RapidSeedbox Docker 入门指南.

a.方案 1：适用于 NAS 用户

访问 NAS 上的 Docker 容器，提取 Jellyseerr 镜像。您可以导航到 "注册表 "选项卡，搜索 Jellyseer 并下载映像。

接下来，创建一个容器：

转到 "容器"，点击 "创建 "开始一个新的 Jellyseer 容器。

• 设置以下参数： 

体积映射：

• 端口映射：

将本地端口（如 3000）映射到容器端口 3000。

• 环境变量：

• 启动容器。

现在，您可以打开浏览器，进入 http://:3000 访问 Jellyseerr。

另请阅读 最适合多媒体和文件同步的 8 款 Synology NAS

b.方案 2：用于 Seedbox / Linux 家庭服务器

确保你的种子箱支持 Docker（大多数提供商都支持），并使用 SSH 登录。接下来，使用以下命令运行 Jellyseerr 容器：

注意： 将 /path/to/config 替换为您的种子箱存储目录。

现在，您可以使用种子箱的域名或 IP 和端口（例如 http://:3000）访问 Jellyseerr。 

如果你运行的是 Windows 家庭服务器，也可以使用同样的命令集。只有 Docker 的安装过程会有所改变。

另请阅读

• 您应该使用种子箱吗？
• 种子箱有什么作用？

立即试用 RapidSeedbox！

3.Jellyseerr 基本安装攻略

要充分利用 Jellyseerr，请将它链接到你的 Jellyfin 服务器。这样，Jellyseerr 就能管理媒体请求，并将批准的内容直接添加到你的资料库中。

打开浏览器并导航至 http://:3000（或您平台的相应 URL）。使用设置时创建的默认管理员凭据。如果出现提示，请为管理员账户创建一个强大的密码。

进入设置页面：

• 登录后，点击 Jellyseerr 界面中的设置齿轮图标。
• 导航至媒体服务器部分。

添加 Jellyfin 详情：

• 主机/IP： 输入 Jellyfin 服务器的 IP 地址或域名（如 192.168.1.100 或 https://myjellyfinserver.com）。
• 端口：使用默认端口（HTTP 为 8096，HTTPS 为 8920）。
• API 密钥:从 Jellyfin 获取，方法是登录 Jellyfin，进入用户设置 > API 密钥，为 Jellyseerr 创建一个新密钥。
• 单击保存应用设置。

测试连接：

Jellyseerr 提供了一个 "测试连接 "按钮，以确认集成是否成功。点击它来验证服务器是否可访问。

a.添加 Radarr、Sonarr 和 Prowlarr

Jellyseerr 与 Radarr、Sonarr 和 Prowlarr 等自动化工具集成，处理请求媒体的下载和组织。在 Jellyseerr 设置中，找到并打开 "集成 "选项卡。

添加 Radarr，并提供以下详细信息：

• Host/IP： Radarr 服务器的 IP 地址或域（如 http://localhost:7878 或 http://192.168.1.100:7878）。
• API 密钥：从 Radarr 的 "设置">"常规">"安全 "中获取。
• 单击保存并测试连接，以确保设置正确。

添加 Sonarr：

重复上述过程，但要使用各自的端口（默认：8989）和 "设置">"常规">"安全 "中的 API 密钥。

添加 Prowlarr（可选）：

如果使用 Prowlarr 管理索引器，请单击添加集成并选择 Prowlarr。

在 Prowlarr 的 "设置">"常规">"安全 "中输入 IP、端口（默认：9696）和 API 密钥。

另请阅读

• Radarr 完整指南 - 如何安装、使用及更多信息
• Sonarr 指南 - 设置、如何使用及更多信息
• Prowlarr 指南：如何安装、设置和使用它

4.高级配置

一旦 Jellyseerr 与 Jellyfin 和你的自动化工具集成，你就可以根据自己的喜好自定义设置。

a.设置用户角色和权限

• 进入设置中的用户管理。
• 为提出申请或管理审批的个人创建用户账户。
• 分配角色

b.设置默认质量首选项

在 "集成 "部分，配置 Radarr 和 Sonarr 以优先考虑特定质量。例如，您可以将 Radarr 设置为下载 4K 格式的电影，或将 Sonarr 设置为优先下载 HDTV-1080p 格式的电视节目。

c.启用标记和过滤

使用标签来组织或优先处理特定请求。例如，为儿童内容指定 "Kids "标签，为高质量电影指定 "4K "标签。最好配置过滤器，自动优先处理带有特定标签的请求。

d.确保设置安全（重要）

如果您的服务器或 Jellyseerr 可从互联网访问，请启用 HTTPS 以确保其安全。

使用 Nginx 或 Traefik 等反向代理处理 SSL 证书，并提供自定义域（如 https://jellyseer.mydomain.com）。

另请阅读 

• Nginx 代理管理器：如何设置和使用
• 特拉菲克与 NGINX：设计与用途比较

5.优化 Jellyseerr 性能

虽然 Jellyseerr 相对轻量级，但我们通常在资源较少的环境中运行它。因此，它可能会变得缓慢或反应迟钝，在使用量大的情况下崩溃，或无法有效处理请求。

根本原因往往在于系统资源限制或数据库效率低下。以下是如何优化数据库以最大限度地提高性能的方法：

a.确定资源限制

有限的 CPU、内存或存储空间会导致延迟或崩溃。通过增加 Docker 容器的 CPU 和内存限制，为 Jellyseerr 分配额外的系统资源：

b.优化数据库

Jellyseerr 默认使用 SQLite，这在小型设置中运行良好，但随着媒体库和用户群的增长，可能会成为瓶颈。为了缓解这一问题，你可以迁移到 PostgreSQL，它更强大，可扩展性更强。

• 在服务器上安装 PostgreSQL 或使用基于云的 PostgreSQL 服务。
• 更新 Jellyseerr 的配置，通过设置 DB_TYPE=postgresql 和提供连接详情来使用 PostgreSQL。
• 使用迁移工具或 Jellyseerr 的文档将现有数据从 SQLite 迁移到 PostgreSQL。

c.定期重启 Docker 容器

随着时间的推移，Docker 容器内的临时资源使用量会不断累积，导致性能下降。解决这个问题的办法是定期重启 Jellyseerr Docker 容器，清除临时资源使用：

docker restart jellyseerr

为确保定期维护，您可以使用 cron 作业或 Windows 任务调度程序将此过程自动化。

d.优化通知和更新

频繁的通知或状态更新会给服务器带来不必要的负载，尤其是在多用户环境中。

• 在 Jellyseerr 设置中减少状态更新频率。
• 将通知限制在重要事件（如申请批准或媒体添加），以避免过多的后台活动。

e.尽量减少不必要的插件或功能

运行附加插件或启用未使用的功能会给 Jellyseerr 的性能造成不必要的压力。

• 禁用不常用的功能或集成。
• 审核你的 Jellyseerr 设置和集成，以简化工作流程。

6.常见问题的故障排除

即使设置良好，您在使用 Jellyseerr 时也可能会遇到问题。以下是常见问题、潜在原因和详细解决方案，可帮助你有效解决这些问题。

a.Jellyseerr 无法连接到 Jellyfin

如果 Jellyseerr 无法连接到您的 Jellyfin 服务器，您可能会发现请求无法处理或媒体详细信息无法检索。 

这个问题通常是由于在 Jellyseerr 中输入了不正确的服务器详细信息造成的，例如无效的 IP 地址、端口号或 API 密钥。网络限制（如防火墙阻止了 Jellyseerr 和 Jellyfin 之间的通信）也可能是罪魁祸首。

可能的解决方案：

• 在 Jellyseerr 的设置中仔细检查 Jellyfin 的 IP 地址或域、端口（HTTP 为 8096，HTTPS 为 8920）和 API 密钥。
• 如有需要，在 Jellyfin 的用户设置 > API 密钥下重新生成 API 密钥。
• 确保没有防火墙规则阻止访问。您可以使用以下命令测试连接：

b.未在拉达尔/索纳尔出现的请求

如果已批准的请求没有出现在 Radarr 或 Sonarr 中，通常是因为 Jellyseerr 中的集成设置不正确。这可能包括无效的 URL、错误的端口或不匹配的 API 密钥。 

另一个常见原因是，由于网络限制或配置错误，Jellyseerr 服务器无法连接到 Radarr 或 Sonarr。

可能的解决方案：

• 在 Jellyseerr 设置中确认 Radarr 和 Sonarr 的 URL。例如，使用 http://:7878 或 http://:8989。
• 从 Radarr 和 Sonarr 的 "设置">"常规">"安全 "中获取 API 密钥，确认 API 密钥。
• 在 Jellyseerr 的集成选项卡中测试连接，确保一切设置正确。

c.媒体无法下载

如果已批准的请求出现在 Radarr 或 Sonarr 中，但下载却没有开始，问题往往出在下载客户端或索引器的配置上。配置错误的下载客户端（如 qBittorrent 或 Transmission）可能无法正常连接。 

另外，Radarr 或 Sonarr 中缺少索引器或索引器配置不当也可能导致无法找到请求的内容。

可能的解决方案：

• 确保下载客户端已正确添加到 Radarr/Sonarr，并带有正确的 IP 地址、端口和 API 密钥。
• 在 Radarr 或 Sonarr 中测试索引器，手动搜索请求的内容。
• 检查 Radarr 或 Sonarr 中的日志，查看与下载或索引器连接有关的任何错误。

d.媒体未在 Jellyfin 中显示

如果下载的内容没有出现在 Jellyfin 库中，通常是由于库路径不正确或库扫描延迟造成的。Jellyfin 中的库路径可能与 Radarr 或 Sonarr 的下载位置不匹配，或者 Jellyfin 扫描库的频率不够高。 

元数据不匹配也会导致内容无法正确显示。

可能的解决方案：

• 验证 Jellyfin 的库路径配置是否正确，以匹配 Radarr 和 Sonarr 使用的下载目录。
• 在 Jellyfin 中手动触发库扫描，方法是导航至仪表板 > 库并选择扫描库文件。
• 使用 Jellyfin 的元数据管理器来验证和更新缺失媒体的元数据。

e.Jellyseerr 网络界面无法加载

如果无法访问 Jellyseerr 网页界面，容器可能没有运行，或者 Docker 设置中的端口映射可能不正确。如果反向代理配置错误，或为 HTTPS 访问设置的 SSL 证书不正确，也可能出现这个问题。

可能的解决方案：

• 使用命令检查 Jellyseerr Docker 容器的状态： 

• 如果容器停止运行，则重新启动：

docker restart jellyseerr

• 确保您的 Docker 或 NAS 配置映射了正确的端口（默认值：3000）。
• 如果使用反向代理的 HTTPS，请验证 SSL 证书和代理设置。

f.通知不起作用

当用户没有收到请求更新的通知时，通常是因为没有配置 Jellyseerr 中的通知设置，或者错误配置了所选的通知服务（如电子邮件或推送）。 

如果通知服务缺乏适当的凭据或连接设置，也会出现这种情况。

可能的解决方案：

• 进入 Jellyseerr 的 "设置">"通知"，配置通知服务（如电子邮件或推送通知服务）。
• 通过触发请求更新来测试通知系统。
• 检查日志中与通知服务配置相关的错误。

7.常见问题

8.最后的思考

如果您还没有这样做，现在是时候建立 Jellyseerr 并亲身体验它的好处了。简化你的媒体管理，增强你的 Jellyfin 体验，用这个终极媒体请求工具让你的用户满意。

刚开始管理媒体收藏的人应该尽早开始学习使用 Jellyseerr。你不会相信，你的收藏会增长得如此之快，以至于失控。 

立即获取 RapidSeedbox！