代理协议支持

代理协议支持

为Fabric服务器提供Proxy Protocol支持

杂项

Proxy Protocol 支持

Proxy Protocol 支持是一个 Fabric 和 Quilt 模组,为你的 Minecraft 服务器添加对 Proxy Protocol (HAProxy) 的支持。它允许同时接受代理连接和直接连接。

例如,你可以使用 TCPShield 或其他软件(Nginx、FRP)来转发流量,并隐藏服务器的 IP 地址。如果没有 Proxy Protocol,你的控制台只会显示代理的 IP 地址。通过读取 Proxy Protocol 数据包,此模组可以显示玩家的真实 IP 地址。

这是一个仅服务端模组;安装在客户端上不会产生任何作用。

支持 Minecraft 1.14-1.21.10 版本,可能也支持更高版本(未经测试)。


安全混合模式

此模组允许你的 Minecraft 服务器同时接受来自受信任代理(使用 PROXY protocol)和受信任直连 IP 的连接。这非常适合你希望将服务器 IP 隐藏在代理之后,同时仍允许管理员或本地玩家直接连接的场景。

该模组基于安全的**“默认拒绝”原则运行。如果传入连接的 IP 地址未在下方列表之一中明确列入白名单,它将被拒绝**。这可以防止未经授权的用户绕过你的代理并直接连接到服务器的真实 IP 地址。


配置

配置在 config/proxy_protocol_support.json 中处理。

enableProxyProtocol

设置为 true 以启用模组功能。

  • 默认值:true

proxyServerIPs

受信任代理服务器的 IP 地址列表。来自这些 IP 的连接必须发送 PROXY Protocol 头。

  • 默认值:["127.0.0.1"]

directAccessIPs

允许不带 PROXY Protocol 头直接连接的 IP 或 CIDR 范围列表。这非常适合管理员、局域网玩家和服务端工具。

  • 默认值:["127.0.0.1", "192.168.0.0/16"]

whitelistTCPShieldServers

当设为 true 时,模组会自动获取 TCPShield 的官方代理 IP,并将它们添加到受信任的 proxyServerIPs 列表中。

  • 默认值:false

示例场景

场景 1:服务器位于同一台机器上的 FRP 之后

你在与 Minecraft 服务器相同的机器上运行 frpc。来自互联网的玩家通过代理连接。你希望从同一局域网中你的游戏 PC(192.168.1.100)直接连接。

proxyServerIPs = ["127.0.0.1"]
directAccessIPs = ["127.0.0.1", "192.168.1.100"]

场景 2:服务器由远程代理服务保护

你的服务器在家中,你使用 IP 为 203.0.113.10 的 VPS 作为代理。你希望你的整个家庭网络(192.168.0.0/24)拥有直接访问权限。

proxyServerIPs = ["203.0.113.10"]
directAccessIPs = ["127.0.0.1", "192.168.0.0/24"]

场景 3:最高安全性(仅代理)

你只希望允许通过代理的连接,不允许其他任何连接(甚至不允许来自本地机器的连接)。

proxyServerIPs = ["1.2.3.4", "5.6.7.8"] # Your proxy IPs
directAccessIPs = [] # Leave empty

正在寻找 Minecraft 服务器?访问 BedrockHost.pl