如何添加 Emby 服务器到 Yamby

添加服务器的入口

打开 Yamby 后，添加服务器有两种方式：

• 首页右下角的 + 号按钮（最直接）
• 设置页面 → 管理服务器 → 新增

进入添加服务器界面后依次填写以下信息。

必填项逐项说明

服务器 IP 地址

支持两种格式：

• 局域网 IP：如 192.168.1.100（同 Wi-Fi 下连接最快、最稳定）
• 公网域名：如 emby.example.com（外网访问需要 Emby 服务器已配置好端口映射和 HTTPS 证书）

不要填 localhost 或 127.0.0.1——那指向手机自己，不是服务器。

端口号

Emby 默认 HTTP 端口是 8096，HTTPS 端口是 8920。如果服务器改过端口，按实际填写。可以在 Emby 服务器 Web 管理面板 → 网络设置里确认当前端口。

协议选择

• HTTP：局域网内推荐，速度最快。无需证书。
• HTTPS：公网访问推荐，传输加密。需要 Emby 服务器已配置有效 SSL 证书。如果服务器用的是自签名证书，Yamby 会弹出安全警告，需要手动确认信任。

账号密码

Emby 管理员账号或普通用户账号均可。管理员账号可以在 Yamby 里使用手机端管理员功能（库扫描、元数据编辑等）；普通用户账号只能浏览和播放。

添加流程

填写 IP → 填端口 → 选协议 → 填账号密码 → 测试连接 → 保存

Yamby 会在保存前自动测试连接。如果连接失败，按以下排查：

1. 手机和服务器是否在同一网络（局域网场景）
2. 服务器 IP 和端口是否正确
3. Emby 服务器是否正常运行（用浏览器访问确认 Web 面板能打开）
4. 防火墙是否拦截了端口

免费版与 Pro 版的服务器数量

• 免费版：最多保存 3 台服务器
• Pro 版：无数量限制

添加完成后，服务器会出现在媒体库页面的侧边栏顶栏，点击头像或服务器名称可以快速切换。

服务器切换

Yamby 支持多服务器快速切换——在首页顶部下拉或侧边栏点击服务器名称即可在已保存的服务器之间跳转。切换后当前正在播放的影片进度会被保存，下次回到同一服务器时可以继续观看。

隐藏指定媒体库

连接成功后，Yamby 会显示该服务器上配置的所有媒体库。如果某些库不想在手机端看到（比如内部测试库、成人内容库），可以在服务器设置里勾选「隐藏此库」。隐藏操作只影响 Yamby 客户端显示，不会改动 Emby 服务器端的实际库配置。