centos jellyfin为何登录失败

在 CentOS 上 Jellyfin 登录失败，常见原因和排查思路如下（按出现频率排序）：

一、最常见原因

1. 用户名/密码错误

• Jellyfin 区分大小写
• 默认第一个用户是安装时创建的，不是 admin / 123456
• 若忘记密码：

sudo systemctl stop jellyfin

然后：

sudo sqlite3 /var/lib/jellyfin/jellyfin.db \
"UPDATE Users SET Password='' WHERE Username='你的用户名';"

再启动：

sudo systemctl start jellyfin

2. Jellyfin 服务没起来（最常见）

检查状态：

systemctl status jellyfin

若失败：

journalctl -u jellyfin -n 50

常见错误：

• 端口被占用（8096）
• 权限问题（/var/lib/jellyfin）

3. SELinux 导致无法访问（CentOS 特有）

CentOS 默认开启 SELinux，可能导致：

• 页面能开但登录无反应
• API 被拦截

临时关闭测试：

sudo setenforce 0

若登录正常，说明是 SELinux 问题，可放行：

sudo setsebool -P httpd_can_network_connect 1

4. 防火墙没放行端口

sudo firewall-cmd --add-port=8096/tcp --permanent
sudo firewall-cmd --reload

5. 反向代理配置错误（Nginx / Apache）

如果你用 Nginx：

• 必须配置 websocket
• 否则能打开页面但登录失败

Nginx 示例关键配置：

location / {
    proxy_pass http://127.0.0.1:8096;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

6. 浏览器缓存 / Cookie 问题

• 换浏览器
• 或无痕模式
• 清除 localhost:8096 的 Cookie

7. 数据库损坏

症状：

• 能打开页面
• 登录一直转圈

检查：

ls -l /var/lib/jellyfin/jellyfin.db

必要时备份后重建（会丢失用户）。

二、快速自查清单 ✅

三、如果你是这些情况之一

你可以直接告诉我：

1. CentOS 版本（7 / 8 / Stream）
2. Jellyfin 安装方式（rpm / docker）
3. 错误表现（转圈 / 报错 / 白屏）
4. 是否有 Nginx

我可以直接给你精确解决方案。