搞定 Emby 反代与播放报错：一份避坑指南

最近折腾家庭影音服务，发现很多小伙伴在给 Emby 搭配 Nginx 或 Caddy 做反向代理时，经常会遇到一些玄学问题：明明网页能打开，但一点播放就转圈、黑屏，或者直接报错。今天就来把这个问题揉碎了讲讲，顺便给点干货配置，希望能帮大家省点踩坑的时间。

为什么要做反代？

简单说，为了好看和安全。http://your-ip:8096 这种地址既不美观，也不方便上 HTTPS 证书。挂一层反代，不仅能用域名访问，还能顺便解决一部分跨域和网络运营商屏蔽的问题。但这就引入了新的坑：流媒体传输对代理的配置要求比普通网页高得多。

常见的视频播放卡顿或缓冲慢状态

常见的播放故障与原因

在解决问题前，我们先看看症状通常有哪些：

1. 网页UI正常，视频无法播放：通常是 WebSocket 连接没穿透过去，导致播放器无法接收指令或流数据。
2. 播放卡顿/缓冲慢：可能是 Buffer 设置过小，或者没有正确处理大文件流传输。
3. 直连能播，反代播不了：这是最典型的，说明 Header 头部信息丢失，客户端识别不到服务器能力。
4. 转码失效：代理层把必要的 MIME 类型或路径搞错了，服务器收不到转码请求。

核心解决方案

Nginx 配置详解

Nginx 反向代理关键配置参数示例

Nginx 是最常用的选择，但默认配置往往不够。要在 location 块里加几个关键参数：

首先，必须正确转发 WebSocket，这是现代播放器的基石：

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

其次，加大缓冲区，防止大视频流传输被截断：

proxy_buffering off;
proxy_request_buffering off;
proxy_buffer_size 4k;
proxy_buffers 8 4k;
proxy_busy_buffers_size 8k;

最后，别忘了传递真实的客户端 IP 和 Host，这在多设备认证时很重要：

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;

Caddy 配置思路

如果你是 Caddy 党，配置会简单很多，它自动处理了 HTTPS 和基本的 HTTP/2 支持。不过为了 Emby 顺畅播放，还是建议显式指定一些头部：

emby.yourdomain.com {
    reverse_proxy 127.0.0.1:8096
    header_up Host {host}
    header_up X-Real-IP {remote}
    header_up X-Forwarded-For {remote}
    header_up X-Forwarded-Proto {scheme}
}

Caddy 2 的默认设置对流媒体已经比较友好，通常不需要手动像 Nginx 那样去调 Buffer，除非你在极低带宽的环境下。

排查技巧

如果加了配置还是不行，别急着改配置，先排查：

1. 检查日志：Nginx 的 error.log 和 Emby 的服务器日志是根本，里面通常会明确写出是 404、502 还是超时。
2. 抓包分析：用浏览器 F12 看网络请求，特别是 m3u8 或 mp4 文件的请求状态码。如果是 400 或 403，多半是 Header 丢失；如果是 502，说明后端 Emby 连不上。
3. 测试直连：先绕过 Nginx 直接访问 IP:Port 确认 Emby 本身没坏，再回到反代配置身上找原因。

结语

搭建家庭媒体中心是个细致活，反向代理这一步虽然繁琐，但配置好了之后体验提升巨大。希望上面的配置片段能直接解决你的燃眉之急。如果你有更特殊的网络环境，或者遇到了文中没提到的奇葩报错，欢迎在评论区交流，我们一起看看怎么搞定。