Jellyseerr与Jellyfin集成登录问题排查指南

问题背景

在使用Jellyseerr与Jellyfin集成时，用户可能会遇到无法通过Jellyfin账号登录的问题。典型表现为：

• 登录界面长时间显示"正在登录"后失败
• 错误提示"用户名或密码不正确"
• 日志中显示用户名被错误地记录为电子邮件字段

根本原因分析

根据技术分析，这类问题通常由以下两种原因导致：

1. 网络连接问题：当Jellyseerr容器和Jellyfin容器处于不同的网络环境中（如一个在专用代理网络，一个在主机网络），会导致容器间无法正常通信。

2. 认证字段映射错误：Jellyseerr在向Jellyfin发送认证请求时，错误地将用户名字段映射到了电子邮件字段，导致认证失败。

解决方案

网络配置调整

1. 统一网络模式：确保Jellyseerr和Jellyfin使用相同的网络配置模式。如果Jellyfin使用host网络模式，建议将Jellyseerr也改为host模式。

2. 检查防火墙设置：确认Jellyfin的端口(默认8096)没有被防火墙阻挡。

3. 验证容器间连通性：可以通过在Jellyseerr容器内执行curl命令测试是否能访问Jellyfin服务。

认证问题修复

1. 检查Jellyfin用户设置：确认Jellyfin用户确实存在且密码正确。

2. 清除缓存数据：删除Jellyseerr的config目录下的缓存文件，重新启动服务。

3. 验证API端点：确保Jellyseerr中配置的Jellyfin地址正确无误，包括协议(http/https)和端口号。

配置建议

对于使用Docker Compose部署的用户，建议采用以下配置方式：

services:
  jellyseerr:
    network_mode: "host"
    # 其他配置保持不变...
  
  jellyfin:
    network_mode: "host"
    # 其他配置保持不变...

这种配置可以确保两个服务在相同的网络环境中运行，避免网络隔离导致的连接问题。

总结

Jellyseerr与Jellyfin集成登录失败通常是由于网络隔离或认证字段映射问题导致。通过统一网络配置、验证服务连通性和检查认证信息，大多数情况下可以解决这类问题。对于更复杂的环境，建议查阅相关文档或寻求社区支持。