▎统一式 Emby 前后端反代配置

建议直接用文末 v2/3 版反代配置

完成常规的参数填写工作后，在 Advanced (高级) 处填写下面的内容，修改两处 xxx.xxx 域名为 Emby 的域名即可

location ^~ /swagger {
        return 404;
}
location  / {
    proxy_pass http://xxx.xxx;
    # proxy_pass https://xxx.xxx;
    client_max_body_size 1000M;
    proxy_hide_header X-Powered-By;
    proxy_set_header Range $http_range;
    proxy_set_header If-Range $http_if_range;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host xxx.xxx;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    keepalive_timeout 36000;

    add_header 'Referrer-Policy' 'origin-when-cross-origin';
    add_header Strict-Transport-Security "max-age=15552000; preload" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $http_connection;
    }

🤖️ ChatGPT 释义：

🚫 第一部分：拦截 Swagger 路径，避免 Emby 页面出错
location ^~ /swagger {
return 404;
}
· location ^~ /swagger: 拦截访问 /swagger 路径的请求。
· return 404;: 直接返回 404，防止 Emby 自带 Swagger UI 相关路径触发错误（很多公益服都会在这个路径下挂广告或防爬脚本）。

🚀 第二部分：主反代配置
location / {
proxy_pass http://xxx.xxx;
· location /: 匹配所有请求路径。
· proxy_pass http://xxx.xxx;: 将请求反向代理到你的 VPS 上的 Emby 地址（改成你自己的公益 Emby 域名/IP 地址）。

📦 文件传输支持与请求头控制
client_max_body_size 1000M;
· 允许客户端上传最大 1000MB 文件（比如上传媒体封面或播放记录）。
proxy_hide_header X-Powered-By;
· 隐藏后端服务器的 X-Powered-By 响应头，增强安全性。
proxy_set_header Range $http_range;
proxy_set_header If-Range $http_if_range;
· 转发 HTTP Range 相关的请求头，支持断点续传功能（Emby 播放器特别依赖这个）。

🌐 设置反代时的请求头
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host xxx.xxx;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
· 把用户真实 IP、原始 Host 等请求头传给后端 Emby，以保持播放日志与用户 IP 记录的准确性。

💤 保持连接设置
keepalive_timeout 36000;
· 设置长连接保持 36000 秒（10 小时），防止频繁断开，特别适用于串流服务。

🛡 添加安全相关 HTTP 头部
add_header 'Referrer-Policy' 'origin-when-cross-origin';
add_header Strict-Transport-Security "max-age=15552000; preload" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
· 增强网页安全性，防止跨站脚本攻击、点击劫持、内容嗅探等问题。

🔄 支持 WebSocket
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $http_connection;
}
· Emby 使用 WebSocket 技术进行实时消息传递（如设备控制、播放状态同步）。
· 上述三行配置是 WebSocket 所必需的内容。

注：
- 此反代配置不适用于分离式 Emby 前后端的服务器

Via：NodeSeek


🤣 统一式 Emby 前后端反代配置 | v2 | ★ 统一式 Emby 前后端反代配置 | v3

😂 Emby 反向代理

#Emby #Nginx #NPM #NginxProxyManager #反代 #反向代理