emby.wiki · 文档

Nginx-X 反代上手指南

Emby 的功能、配置与使用指南

更新于 2026年9月29日中文

🚀 Nginx-X 小白上手教程#

Nginx-X 是一个轻量化 Nginx 管理脚本，特别针对反代 Emby 线路进行了深度优化。如果你的 Emby 服务但直连速度不理想，用这个脚本在自己的 VPS 上搭建一个"中转站"是比较好的解决办法。

📥 第一步：安装脚本#

在 VPS 终端执行：

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Xiuyixx/Nginx-X/main/install.sh)"

安装完成后，输入：

nx

即可打开管理菜单。

🛠 第二步：先安装 Nginx#

第一次进入菜单后，建议先执行：

输入 1 → 安装升级 Nginx

这样脚本会自动帮你安装或检查 Nginx。

🌐 第三步：添加 Emby 反代#

打开菜单后，按下面顺序进入：

输入 2 → 配置管理
输入 2 → 外部反代

📖 情况 A：只有一个 Emby 地址#

如果商家只给了你一个地址，直接选：

输入 2 → Stream 模式

操作示例#

1) 添加配置
2) 外部反代
3) 配置列表
4) 导入已有配置
0) 返回上一级
==============================
请选择: 2

请输入域名或本机IP：你的反代入口域名
请输入监听端口：443
请输入外部上游 URL：你的 Emby 地址
选择模式：2

适合这些情况#

只有一个 Emby 地址
不想自己研究规则
没有前后端分离时直接使用

🚀 情况 B：有多个地址（访问域名 + 推流域名）#

如果商家给你多个地址，就选：

输入 5 → LilyEmby 方案

操作示例#

请输入监听端口：443
请输入外部上游 URL：https://访问域名:443
选择模式：输入 5
请输入推流节点 URL：https://推流域名:443
请输入源站公开 URL：https://访问域名:443
请输入 Referer URL（默认 https://访问域名:443/web/index.html）:

支持多推流地址（多个用英文逗号分隔）

Referer URL 这里怎么填？#

一般来说，不用你手动填，直接回车使用默认值就行。

默认一般会是：

https://访问域名:443/web/index.html

这个 Referer URL 是干什么的？#

简单理解，它就是告诉对方源站：

"这个请求像是从 Emby 网页端发出来的。"

有些源站，或者源站前面的 CDN / 防盗链系统，会检查 Referer。如果它希望请求看起来像是从 Emby Web 页面发起的，那么这个值就很有用。

所以脚本默认帮你填成：

https://访问域名:443/web/index.html

你该怎么做？#

直接回车，使用默认值 ✅

什么时候才需要改？#

只有在后面出现这些问题时，才建议你再改：

返回 403
提示防盗链
播放接口报错
出现 invalid referer 之类提示

这时候你可以尝试改成更宽松或更匹配的写法，例如：

https://访问域名/web/index.html

也就是把端口去掉。

如果对方的页面路径本来就不是 /web/index.html，那也可以改成对方实际在用的页面路径。

小白建议#

在你这个场景里，先直接回车用默认值是最稳的。先让它跑起来，只有真的遇到 403 或 Referer 报错，再回来改。

🔒 第四步：申请证书并开启 HTTPS#

如果你前面监听端口填的是 443，配置完成后，脚本通常会继续提示你是否自动申请证书并启用 HTTPS。

你可以直接输入：

常见提示大概会像这样：

是否立即自动申请证书并启用 HTTPS（80 强制跳转 443）？ [y/N]: y

📧 第五步：第一次申请证书时，需要填写邮箱#

如果这是你第一次在这台机器上用 Nginx-X 申请证书，脚本可能会提示你先设置 Acme 邮箱。

例如会看到类似提示：

[警告] 当前未设置 Acme 邮箱。请输入邮箱（将保存到 /root/.config/nginxx/email.conf）:

这时候你只需要：

输入你自己的常用邮箱

这个邮箱是干什么的？#

它主要是给证书申请工具使用的，用来保存申请信息。以后脚本会把邮箱保存下来，通常不需要你每次都重新输入。

小白怎么做最简单？#

看到提示就输入一个你自己能正常使用的邮箱，然后回车即可。

后面会自动做什么？#

邮箱填好后，脚本通常会自动继续完成下面这些事情：

保存邮箱配置
检查 DNS 和 HTTP-01 验证是否正常
如果没安装 acme.sh，会自动安装
自动申请证书
自动安装证书到 Nginx
自动启用 HTTPS
自动配置 80 跳转到 443
自动检查续期任务

也就是说，你只要把邮箱填一下，后面大多数情况下继续按提示走就行。

🔍 第六步：健康检查的使用与注意事项#

配置完成后，可以用菜单 4 → 3 健康检查 来检查站点状态。

检查内容： 入口 URL、HTTP 状态码、DNS、命中 IP、证书剩余天数、主上游状态、推流上游状态等。

⚠️ 注意： 如果健康检查中出现 403、404、异常 等提示，不一定代表配置有问题。部分 Emby / 带防盗链或 CDN 规则的上游会主动拦截脚本的 Web 探测，但实际在浏览器或客户端中可能完全正常。建议以浏览器或客户端实际访问为准，脚本结果仅作参考。

✅ 一个最常见的完整流程#

如果你是第一次配置，常见流程可以简单理解成这样：

输入 2 → 配置管理输入 2 → 外部反代

输入域名：你的反代入口域名输入端口：443 输入外部上游 URL：你的 Emby 地址选择模式：

只有一个地址 → 输入 2
有两个地址 → 输入 5

如果提示是否申请证书并启用 HTTPS → 输入 y 如果提示输入邮箱 → 输入你自己的邮箱后面如果继续提示确认，一般按 y 即可

🧠 最简单的理解#

Stream 模式#

所有请求都走同一个地址。

LilyEmby 模式#

网页访问走【访问域名】
视频播放走【推流域名】

✅ 小白怎么选#

只有一个地址：选输入 2 → Stream 模式
有多个地址：选输入 5 → LilyEmby 方案

📎 项目地址#

更多说明请查看项目主页：Xiuyixx/Nginx-X