NG Proxy 支持
为你的 Minecraft Forge 服务器添加 HAProxy PROXY 协议支持。
当你的服务器位于 Velocity、TCPShield、FRP、Nginx 或其他任何兼容 HAProxy 的反向代理后面时,查看真实的玩家 IP 地址。
功能特性
- HAProxy PROXY Protocol 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 |
你的代理服务器 IP(Velocity、HAProxy 等)—— 仅接受来自这些 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 版权所有
你是这个资源的作者?登录后可认领此资源。
相似资源
Woot Revived
pharuxtan
一个用于收集生物掉落物的多区块模组。
生物科技
349
玉Jade ?
Snownee
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
实用前置
339
KubeJS
Lat
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
前置实用
239
物品管理器Just Enough Items (JEI)
mezz
查看物品与配方
前置实用
239
Xaero的小地图
thexaero
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
冒险交通
239
Applied Energistics 2
shartte
AE2:一款流行的自动化与存储模组
存储科技
217
评论 0
登录后参与评分
还没有评论,来抢沙发吧