NAS 与运维

EdgeOne 与 Lucky:配置回源和真实客户端 IP

  • 0 次阅读
  • 0 条评论
文章摘要

经过 EdgeOne 和 Lucky 的请求会经过多层代理。源站日志看到的地址可能是边缘节点或上一跳代理,获取真实客户端 IP 的关键是可信代理链,而不是简单把任意请求头当作访客身份。

项目介绍

EdgeOne 接入 Lucky 后,请求会经过边缘节点再回源到 NAS。下面依次介绍域名、回源、请求头和真实客户端 IP 的配置过程。排查时分别核对边缘访问、源站连接和应用日志,避免把边缘节点 IP 当成实际访客 IP。

架构概述

用户 → EO加速(emby.docker222.top) → Lucky反向代理(emby.1314111.xyz:888) → Emby服务(192.168.0.118:8098)

环境准备

服务信息

配置步骤

第一步:EO加速配置

登录EO管理后台

1. 配置加速域名

加速域名: emby.docker222.top
源站地址: emby.1314111.xyz:888

设置如图

操作步骤配图

2. 开启客户端IP传递

客户端 IP 头部: 启用
头部名称: X-Real-IP
全局站点设置: 启用

操作步骤配图

第二步:Lucky反向代理配置

  1. 登录Lucky管理后台

创建反向代理规则

基本设置:

服务类型: 反向代理
前端地址: emby.1314111.xyz
后端地址: http://192.168.0.118:8098
万事大吉: 启用
忽略后端TLS证书验证: 是
使用目标地址Host请求头: 是 ✅
记录访问日志: 启用

客户端IP获取设置:

优先从Header头部获取: 启用
信任的代理IP网段: 
192.168.0.0/24
::/0
包含客户端IP的头部字段: X-Real-IP
追加客户端IP到指定Header: 禁用
追加客户端协议头到指定Header: 禁用

自定义配置:

proxy_set_header X-Real-IP $http_x_real_ip;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

lucky配置如图

操作步骤配图

操作步骤配图

操作步骤配图

第三步:Emby服务配置

  1. 登录Emby管理后台 (192.168.0.118:8097)

进入网络设置

基本网络配置:

公网 HTTP 端口号: 8096
公网 HTTPS 端口号: 8920
外部域: emby.docker222.top ✅
读取代理标头以确定客户端 IP 地址: 是 ✅

操作步骤配图

高级配置 (可以不配置):

<!-- config/system.xml -->
<EnableRemoteAccess>true</EnableRemoteAccess>
<EnableProxy>true</EnableProxy>
<ProxyHeaderType>X-Forwarded-For</ProxyHeaderType>
<KnownProxies>192.168.0.0/24</KnownProxies>

验证测试

测试:IP显示测试

  1. 访问 https://emby.docker222.top

  2. 登录Emby账户

  3. 在Emby控制台 → 用户 → 活动会话

  4. 验证: 显示的IP应该是你的真实公网IP,不是EO或Lucky的IP

操作步骤配图

测试2:播放功能测试

  1. 选择任意视频播放

  2. 验证:

  • 播放正常,cd2无下载任务

  • 302重定向地址应为 emby.docker222.top 域名

  • 不是内网地址

故障排除

问题1:Emby显示错误IP

解决方案:

  • 检查Lucky的"包含客户端IP的头部字段"是否为 X-Real-IP

  • 确认EO已正确设置 X-Real-IP 头部

  • 验证信任的代理IP网段包含 192.168.0.0/24

问题2:302重定向到内网地址

解决方案:

  • 确认Emby的"外部域"设置为 emby.docker222.top

  • 检查Lucky的"使用目标地址Host请求头"是否开启

  • 重启Emby和Lucky服务

问题3:播放失败

解决方案:

  • 检查端口映射:8098端口是否正确映射

  • 验证网络连通性:Lucky是否能访问到Emby的8098端口

  • 检查防火墙规则

配置总结

服务

关键配置

说明

EO

X-Real-IP头部

传递用户真实IP

Lucky

X-Real-IP获取 + Host头传递

中间代理处理

Emby

外部域 + 读取代理标头

最终IP显示

注意事项

  1. 域名一致性: 确保所有配置中使用相同的EO域名

  2. 端口开放: 确保8098端口对Lucky可访问

  3. 网络隔离: 容器网络配置正确,能互相通信

  4. 证书有效: HTTPS证书配置正确(如使用HTTPS)

按照这个教程配置后,你的Emby服务将通过EO加速,并且能正确显示用户的真实IP地址。

补充:部署与使用

常见问题

  • 不使用 0.0.0.0/0 或 ::/0 作为通用可信代理范围,否则任意来源可能伪造 IP。
  • 回源 TLS 出错先核对证书名称和链路,不把关闭证书验证作为长期设置。

更新与备份

导出边缘规则、Lucky 配置与可信代理更新记录;保留原访问链路便于回退。

官方资料