NG HaProxy 支持

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
                                   设置玩家地址
  1. 你的代理发送带有真实客户端 IP 的 PROXY 协议头
  2. NG Proxy Support 拦截传入连接并读取该头
  3. 玩家地址被设置为其真实 IP,而不是代理 IP
  4. 所有服务器日志、封禁系统和插件都能看到正确的 IP

安全模型

NG Proxy Support 采用故障关闭模型:

  • ✅ 来自 proxyServerIPs 的连接 → 读取 PROXY 头,提取真实 IP
  • ✅ 来自 directAccessIPs 的连接 → 允许在无 PROXY 头的情况下连接
  • ❌ 来自任何其他 IP 的连接 → 自动拒绝

这可防止玩家绕过你的代理直接连接并伪造其 IP。

安装指南

配合 Velocity

  1. 在你的 Forge 服务器上安装 NG Proxy Support
  2. 在 Velocity 的 velocity.toml 中启用 PROXY 协议:
   [advanced]
   haproxy-protocol = true
  1. 将你的 Velocity 服务器 IP 添加到模组配置中的 proxyServerIPs
  2. 重启两个服务器

配合 HAProxy / Nginx / FRP

  1. 配置你的反向代理以发送 PROXY 协议头
  2. 将代理 IP 添加到 proxyServerIPs
  3. 重启 Forge 服务器

环境要求

  • Minecraft 1.20.1
  • Forge 47.x
  • Java 17+
  • 仅服务端(无需客户端模组)

鸣谢

作者 xylos | © 2024-2026 保留所有权利