Emby 反代全指南：从 Nginx 到 Caddy 的最佳实践方案

Emby 通过反向代理接入公网的结构示意

最近看到有不少朋友在求推荐好用的 Emby 反代项目。其实，与其在寻找“特定项目”上浪费时间，不如直接掌握一套成熟的反向代理配置方案。不管你是用惯了 Nginx 的老手，还是追求极致自动化的 Caddy 粉丝，给 Emby 套上一层“壳”不仅能解决公网直接暴露的安全隐患，还能配合 CDN 加速，或者解决运营商对非标准端口的屏蔽问题。

今天我们就来深入聊聊，如何给 Emby 搭建一个既稳定又高效的反代服务。

为什么要给 Emby 做反代？

在动手之前，我们明确一下反代的几个核心价值，确保你没做无用功：

1. 公网安全：直接把 Emby 的 8096 端口丢在公网上简直是“裸奔”。反代可以隐藏后端真实端口，统一走 80/443 端口，并顺便配置防火墙限制访问频率。
2. SSL 证书：自签名证书在移动端播放视频时经常各种报错，反代配合 Let's Encrypt 可以轻松搞定泛域名证书，实现全程 HTTPS 访问。
3. 路径伪装：你可以把访问路径改成 /myemby 或者 /movies 之类的，避免被扫描器一眼识别。
4. 动静分离：视频流转发和 API 接口转发其实可以分开优化，虽然 Emby 自身性能不错，但在高并发下合理的缓存策略依然能减轻 CPU 压力。

方案一：Nginx —— 稳定压倒一切

Nginx 是目前市面上最通用、资料最全的反代服务器。它的优势在于高度可定制，而且如果你宝塔面板用得溜，直接在图形界面操作也很方便。

核心配置要点

给 Emby 配 Nginx，有几个坑是新手常踩的，尤其是 WebSocket 连接和 HTTP 头配置。如果配置不对，客户端连接会频繁断开，或者无法播放。

以下是一个经过实战验证的 Nginx 配置模版（假设 Emby 运行在本地 127.0.0.1:8096）

server {
    listen 80;
    server_name your-domain.com;

# 强制跳转 HTTPS
    return 301 https://$host$request_uri;
}

![Caddy 服务器软件示意图](/media-load/019f32aa-3de6-7f20-bed7-87d56b81c2a6)

*选择 Caddy 作为自动 HTTPS 解决方案*

server {
    listen 443 ssl http2;
    server_name your-domain.com;

# SSL 证书配置（建议使用 certbot 自动申请）
    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

# 基础安全头
    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";

# 关键：增大缓冲区大小，防止视频流报错
    proxy_buffering off;
    proxy_request_buffering off;
    proxy_max_temp_file_size 0;

location / {
        proxy_pass http://127.0.0.1:8096;

# WebSocket 相关配置（必填）
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";

# 传递真实 IP
        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;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Port $server_port;

# 解决跨域问题
        add_header Access-Control-Allow-Origin *;
    }
}

Nginx 的优缺点

• 优点：生态极其成熟，遇到报错随便搜搜都有答案；性能强悍，特别是处理大量静态请求或高并发连接时。
• 缺点：配置文件手写容易出错，SSL 证书续期如果不配合 Crontab 或 certbot，很容易忘；对于完全不懂代码的小白，上手门槛稍高。

方案二：Caddy —— 极客的自动挡

如果你觉得 Nginx 配置太繁琐，Caddy 绝对是你的“真命天子”。它是用 Go 语言写的，最大的卖点就是默认开启 HTTPS，自动续期证书，配置文件极其简单。

极简配置示例

同样的需求，Caddy 只需要两行配置就能搞定。创建一个 Caddyfile：

your-domain.com {
    reverse_proxy 127.0.0.1:8096
}

你没看错，就这几行。Caddy 会自动去 Let's Encrypt 申请证书，自动配置 HTTP/2 和 HTTP/3（QUIC），甚至连 WebSocket 都会自动处理，完全不需要手写那些 Upgrade 头。

进阶技巧：负载均衡

如果你有多台 Emby 服务器（比如一台存电影，一台存动漫），或者做了主从架构，Caddy 可以一行代码实现负载均衡：

your-domain.com {
    reverse_proxy 127.0.0.1:8096 192.168.1.100:8096 {
        lb_policy least_connection # 按连接数分配
    }
}

Caddy 的优缺点

• 优点：配置极其傻瓜，全自动 HTTPS，对 HTTP/3 支持最好，部署快。
• 缺点：相比 Nginx，Caddy 的内存占用稍微高一点点（但在现在 VPS 配置下几乎可忽略）；生态和资料虽在增长，但碰到极怪异的问题时，搜解决方案不如 Nginx 多。

常见问题与避坑指南

1. 字幕和视频流 404？

如果你用了 Cloudflare 的 CDN，可能会遇到视频加载不出来。这通常是 Cloudflare 的安全级别设太高，或者它对视频流的缓冲处理有问题。建议在 Cloudflare 设置中，将 SSL/TLS 设为 Full (Strict)，并在 Page Rules 里针对视频后缀（如 .mp4, .mkv）关闭缓存，只缓存静态资源。

2. 客户端连接不上？

请务必检查你的WebSocket 头配置。如果你用 Nginx，不要漏掉 proxy_set_header Upgrade。此外，Emby 后台的“网络”设置里，记得将“本地网络”或者“已知代理”设置好，否则可能会把你的反代 IP 识别为攻击源直接封禁。

3. 性能损耗大吗？

反代在纯转发方面，CPU 损耗极低，基本可以忽略不计。主要的瓶颈在于软解转码，反代本身不负责转码，所以不用担心流量走了 Nginx/Caddy 就会变卡。

总结

如果你追求极致的稳定性和可控性，或者已经在用宝塔面板，Nginx 是不二之选，照着上面的模版配基本没问题。

如果你是懒人，或者想把 HTTPS 证书维护这事直接忘掉，强烈推荐尝试 Caddy，它的现代感会让你回不去 Nginx 的。

无论选哪个，有了反代，你的 Emby 才算真正有了“公网身份证”，安全又体面。