Yamby 连接 Emby 服务器失败排查指南

连接问题的分类

Yamby 连接 Emby 服务器失败，按错误信息归类为三种：

以下是每种情况的排查步骤。

说明：Yamby 根本没连上服务器。网络层问题。

排查步骤：

1. 手机和服务器的网络连通性

最快的验证方法：用手机浏览器访问 Emby 服务器 Web 面板。浏览器能打开 → Yamby 理论上也能连上。浏览器也打不开 → 网络有问题，修网络。

2. 防火墙 / 端口检查

3. Emby 服务器是否正常运行

说明：网络通了，但账号密码不对或权限不足。

排查步骤：

1. 确认账号密码

用同样的账号密码在 Emby Web 面板（浏览器打开）登录。能登录 → 账号密码没问题；不能登录 → 先在 Web 面板找回密码。

2. 确认账号状态

Emby Web 面板 → 管理 → 用户 → 找到对应账号：

3. 特殊字符密码

密码包含特殊字符（@、#、$、% 等）时，URL 编码可能有问题。可以：

说明：Yamby 检测到服务器的 SSL 证书不被 Android 系统信任。

排查步骤：

1. 自签名证书

Emby 服务器用了自签名证书（自己生成的，不是权威 CA 颁发的）。Yamby 会弹出安全警告：

2. 证书过期

服务器的有效证书已经过期。需要在 Emby 服务器上续期或重新申请证书。

3. 域名与证书不匹配

Yamby 填的域名和证书里绑定的域名不一致。比如证书绑的是 emby.example.com，但 Yamby 填了 emby2.example.com。

4. HTTPS 改 HTTP 测试

临时把协议改成 HTTP 测试。HTTP 能连上 → 问题在 HTTPS 证书。