
NG HaProxy 支持
为Forge服务器添加HAProxy协议支持。可查看Velocity、TCPShield、FRP和Nginx代理后方的真实玩家IP。具备配置热重载、状态命令和连接日志功能。
NG Proxy Support
为你的 Minecraft Forge 服务器添加 HAProxy PROXY 协议支持。
当你的服务器位于 Velocity、TCPShield、FRP、Nginx 或任何其他兼容 HAProxy 的反向代理之后时,可查看真实玩家 IP 地址。
功能特性
- HAProxy PROXY 协议 v1/v2 —— 完整支持两种协议版本
- 真实 IP 解析 —— 通过代理连接的玩家将在服务器日志、封禁和插件中显示其真实 IP
- 混合模式 —— 同时支持代理连接和直连
- 故障关闭式安全 —— 来自未知 IP 的连接会被自动拒绝,防止代理绕过攻击
- CIDR 表示法 —— 可将整个子网加入白名单(例如
192.168.0.0/16) - TCPShield 集成 —— 自动获取 TCPShield 服务器 IP 并将其加入白名单
- 配置热重载 —— 无需重启服务器即可重载配置
- 状态命令 —— 在游戏内查看当前配置和连接统计
- 连接日志 —— 将真实玩家 IP 和代理 IP 记录到专用日志文件
命令
| 命令 | 权限 | 描述 |
|---|---|---|
/proxyprotocol reload |
OP 等级 4 | 无需重启即可重载配置 |
/proxyprotocol status |
OP 等级 4 | 查看当前配置和生效规则 |
配置
配置文件:config/proxy_protocol_support.json
{
"enableProxyProtocol": true,
"proxyServerIPs": ["127.0.0.1"],
"directAccessIPs": ["127.0.0.1", "192.168.0.0/16"],
"whitelistTCPShieldServers": false,
"logConnections": true
}
| 选项 | 描述 |
|---|---|
enableProxyProtocol |
完全启用/禁用该模组 |
proxyServerIPs |
你的代理服务器(Velocity、HAProxy 等)的 IP —— 仅接受来自这些 IP 的 PROXY 头 |
directAccessIPs |
允许在无 PROXY 头的情况下直连的 IP |
whitelistTCPShieldServers |
自动获取 TCPShield IP 并将其添加到代理白名单 |
logConnections |
将真实 IP 和代理 IP 记录到 logs/proxy_connections.log |
工作原理
玩家 → 代理(Velocity/HAProxy/FRP) → Forge 服务器(装有 NG Proxy Support)
↓
读取 PROXY 头
提取真实 IP
设置玩家地址
- 你的代理发送带有真实客户端 IP 的 PROXY 协议头
- NG Proxy Support 拦截传入连接并读取该头
- 玩家地址被设置为其真实 IP,而不是代理 IP
- 所有服务器日志、封禁系统和插件都能看到正确的 IP
安全模型
NG Proxy Support 采用故障关闭模型:
- ✅ 来自
proxyServerIPs的连接 → 读取 PROXY 头,提取真实 IP - ✅ 来自
directAccessIPs的连接 → 允许在无 PROXY 头的情况下连接 - ❌ 来自任何其他 IP 的连接 → 自动拒绝
这可防止玩家绕过你的代理直接连接并伪造其 IP。
安装指南
配合 Velocity
- 在你的 Forge 服务器上安装 NG Proxy Support
- 在 Velocity 的
velocity.toml中启用 PROXY 协议:
[advanced]
haproxy-protocol = true
- 将你的 Velocity 服务器 IP 添加到模组配置中的
proxyServerIPs - 重启两个服务器
配合 HAProxy / Nginx / FRP
- 配置你的反向代理以发送 PROXY 协议头
- 将代理 IP 添加到
proxyServerIPs - 重启 Forge 服务器
环境要求
- Minecraft 1.20.1
- Forge 47.x
- Java 17+
- 仅服务端(无需客户端模组)
鸣谢
作者 xylos | © 2024-2026 保留所有权利
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。