Emby 客户端连不上服务器 — 从网络到权限逐层排查
排查顺序（按概率从高到低）
连不上的原因按出现频率排序：
- Server 没在运行 / Server 防火墙拦了
- 客户端和 Server 不在同一网段（远程访问），但没配端口转发 / Emby Connect
- 路由器 CGNAT（运营商的内网，没有真正的公网 IP）
- Emby Connect 没连上云服务
- 用户名密码错了
- 用户被禁用了（Dashboard → Users → 这个用户是不是 Disabled）
- 服务器 IP 变了（路由器 DHCP 重新分配）
按这个顺序查，通常前 3 条就能解决。
第一步：确认 Server 在跑
最基础也是最常见的原因——Server 没启动或者崩溃了。
内网另一台设备验证
拿同一 Wi-Fi / 有线网络下的另一台设备（比如你自己的笔记本），浏览器打开：
服务器内网IP:8096Server 内网 IP 查看方式：
- Windows Server：cmd →
ipconfig→ 找有 Emby Server 的那块网卡，IPv4 地址 - Docker：
docker inspect emby | grep IPAddress - Linux/NAS：
ifconfig或ip addr
能打开 Emby 登录页面 = Server 在线，继续往下。打不开 = Server 有问题。
Server 不在线时
| 平台 | 检查方式 |
|---|---|
| Windows | 任务管理器 → 有没有 EmbyServer.exe 进程；或服务管理里 Emby Server 服务是不是 Running |
| Docker | docker ps 看 emby 容器是不是 Up 状态 |
| Linux systemd | systemctl status emby-server |
| 群晖 DSM | 套件中心 → Emby → 运行状态 |
进程没在跑就启动它。启动了又立刻崩 → 看 Emby 日志（Dashboard → Help → Logs）。
第二步：内网能连，客户端同网段连不上
Server 能在浏览器打开，客户端（比如 Android TV 盒子、手机）就在同一 Wi-Fi 下但 Emby App 连不上：
检查点 1：客户端和 Server 的 IP 前三段相同吗
Server IP 192.168.1.10，客户端 IP 192.168.1.20 → ✅ 同一网段Server IP 192.168.1.10，客户端 IP 192.168.3.5 → ❌ 不在同一网段（可能连了 Guest Wi-Fi 或不同的 AP）
如果客户端连了 Guest Wi-Fi，路由器通常会隔离 Guest 网络和主网络——Guest 设备无法访问主网络的 Server。让客户端连主 Wi-Fi。
检查点 2：手动填 Server 地址
客户端自动发现功能有时不稳定（路由器的 mDNS / SSDP 广播问题）。手动填：
协议: HTTP
地址: Server的内网IP（比如 192.168.1.10）
端口: 8096检查点 3：Windows 防火墙
如果 Server 是 Windows：
- Windows 开始菜单搜 "Windows Defender 防火墙"
- 左侧 "允许应用或功能通过 Windows Defender 防火墙"
- 列表里找 "Emby Server"，勾上"专用"和"公用"两列的复选框
- 没找到就手动添加 → "允许其他应用" → 浏览到 EmbyServer.exe → 添加
检查点 4：路由器 AP 隔离
某些高级路由器有"AP 隔离"或"客户端隔离"功能——开启后同一 Wi-Fi 下的设备互相看不到。检查路由器后台：
- ASUS：Wireless → Wireless MAC Filter / AP Isolation → 关闭
- TP-Link：如果有"AP隔离"或"客户端隔离" → 关闭
- OpenWrt：Network → Wireless → 每个 SSID 的 "Isolate clients" 关掉
第三步：远程访问连不上
手机关掉 Wi-Fi 开 4G 用 Emby App 连不上：
检查点 1：公网 IP 是什么
访问 公网 IP 查询工具，看公网 IP 是不是私有地址（以下范围就是运营商 CGNAT）：
| IP 段 | 含义 |
|---|---|
100.64.0.0 ~ 100.127.255.255 | ⚠️ CGNAT，运营商内网 |
10.0.0.0 ~ 10.255.255.255 | ⚠️ 私有地址，同样 CGNAT |
172.16.0.0 ~ 172.31.255.255 | ⚠️ 私有地址 |
192.168.0.0 ~ 192.168.255.255 | ⚠️ 私有地址 |
| 其他 | ✅ 真正的公网 IP |
如果是 CGNAT：端口转发完全没用。三个解决方案：
- 换宽带：打电话给运营商申请公网 IP（有的免费给，有的要加钱）
- Emby Connect：Emby Connect 能穿透大部分 NAT（除了对称 NAT Type 3）
- Tailscale / ZeroTier：P2P 组网，完全绕过 NAT 问题
检查点 2：端口转发是否正确配了
如果有真正的公网 IP，按照 手动端口转发 配置两条规则：
- TCP 8096 → Server内网IP:8096
- TCP 8920 → Server内网IP:8920
配完用手机 4G 访问 公网IP:8096 验证。
检查点 3：Emby Connect 状态
Dashboard → Advanced → Emby Connect：
- 显示 Connected ✅ → Connect 云服务连得上
- 显示 Disconnected / Failed ❌ → Server 连不上 Emby 云服务
Connect 连不上时：检查防火墙出站规则、代理设置、Server 系统时间。
检查点 4：Server 的 Allow Remote Connections 有没有开
Dashboard → Advanced → Host → Networking → 勾上 Enable remote connections to this Emby Server。没勾的话所有远程请求被拒绝。
第四步：用户名密码问题
密码错了
客户端提示用户名密码错误：
- Dashboard → Users → 这个用户 → 点进去 → Password → 重置密码
- 重置后给对方新密码
这个用户被禁用了
Dashboard → Users → 列表里找这个用户 → 有没有显示 Disabled 状态。Disabling 会终止所有现有会话且不允许新登录。
用户没有远程访问权限
Dashboard → Users → 这个用户 → Feature Access → 确认勾了 Allow remote access。
用户被限制了设备
Dashboard → Users → 这个用户 → Device Access：
- 列出了所有登录过这个账号的设备
- 如果"Allow only these devices"开关打开了，而客户端的设备不在列表里 → 加进去
- 或者关掉这个限制
第五步：IPv6 方案
如果以上都搞不定（CGNAT 运营商不给公网 IP、Connect 也连不上），试试 IPv6：
- 确认运营商给了 IPv6 公网地址（在路由器后台或
test-ipv6.com测试） - Emby Server 默认监听 IPv6（8096 端口）
- 客户端手动添加 Server → 填 IPv6 地址 + 8096
IPv6 没有 NAT，不需要端口转发就能公网访问。