Cinetry 连接 Jellyfin 或 Emby 失败排查
连接失败的常见表现
添加 Jellyfin / Emby 资源库后测试连接失败，可能的表现有：
- 连接超时：等了很久没有响应
- 401 认证失败：账号密码不对
- SSL / HTTPS 错误：证书验证失败
- 404 / 500：服务器地址或服务状态有问题
排查步骤一：网络能不能通
先确认最基础的网络连接：
- 用手机浏览器（手机端）或电脑浏览器（桌面端）打开你填的服务器地址
- 浏览器能不能打开 Jellyfin / Emby 的登录页？
- 如果打不开，问题在网络层（IP 错了、端口没开、路由器没做端口映射、VPN 开着干扰等），跟 Cinetry 无关
排查步骤二：端口和协议
- Jellyfin 默认 8096（HTTP）或 8920（HTTPS）
- Emby 默认 8096（HTTP）或 8920（HTTPS）
- 连接地址必须带协议头（
http://或https://），不能只写IP:端口 - 端口号后面不要加斜杠
正确示例：http://192.168.1.100:8096错误示例：192.168.1.100:8096/
排查步骤三：账号密码
确认用的是 Jellyfin / Emby 的登录账号，不是 API Key。很多人搞混了——Cinetry 需要的是能登录 Web UI 的那个账号。
排查步骤四：HTTPS 证书
如果用的是 HTTPS + 自签名证书：
- 在全局设置里关闭「HTTPS 证书验证开关」
- 或者给服务器装上正规证书（Let's Encrypt 免费版）
排查步骤五：局域网还是公网
| 场景 | 注意事项 |
|---|---|
| 局域网访问 | 手机和服务器必须在同一个 Wi-Fi（同一个网段） |
| 公网访问 | 路由器需要做端口转发，服务器防火墙需要放行对应端口 |
| Tailscale / Zerotier | 确保虚拟网卡地址和端口正确 |
还不行？
实在找不到原因，可以：
- 在服务器上临时关掉 HTTPS 强制，改用纯 HTTP 试试
- 换个客户端（比如官方 Jellyfin 客户端）看看能不能连上——如果官方客户端也连不上，说明是服务器问题
- 检查 Cinetry 版本是否最新，老版本可能有已知 bug
上一组：导入他人分享的资源库
下一篇：IPTV 列表无法加载