HAProxyDetectorPaper

插件

· 作者 TendoArisu

HAProxyDetector for Paper and Velocity

0 本站下载 0 关注 更新于 1 个月前

最新 1.5 · 26.3 · Bukkit / Folia

一键开服(送7天)

HAProxyDetector

一款轻量级插件,旨在 Paper/Folia 和 Velocity 上同时支持原生 HAProxy/Proxy Protocol 以及直连玩家连接。

主要特性

  • 混合连接支持:同时处理真实的 HAProxy/frp 代理流量与直接玩家连接。
  • 原生解析器兼容性:按连接探测协议;直接连接会绕过原生 HAProxy 解码器。
  • 域名 / IP / CIDR 白名单:whitelist 支持单个 IP、CIDR 子网和域名。

支持的平台

  • Paper / Folia:理论上支持任何具备原生 HAProxy/Proxy Protocol 功能的版本。
  • Velocity:针对 3.3.0+ 设计,兼容 Velocity 4.x 当前的连接初始化架构。

配置

Paper 和 Velocity 共用相同的 config.yml 结构:

language: # 检测并保存操作系统/JVM语言;或设置为 en_US / zh_CN
enable-whitelist: true
whitelist:
  - 127.0.0.1
  - "::1"
  - frps.example.com
  - 203.0.113.0/24

白名单规则

  • IP:精确匹配。
  • CIDR:子网匹配,例如 203.0.113.0/24。
  • 域名:在插件加载配置时自动解析为 IP 地址以参与匹配。

域名白名单注意事项

  • 域名仅在插件加载或重载配置时进行解析,而非在每个连接时动态解析。
  • 如果后续 DNS 解析发生变化,需要重启服务器或重载插件以刷新缓存的 IP。
  • 如果某个域名暂时无法解析,插件不会启动失败。

日志行为

拦截日志字段说明:

  • frps:上游代理服务器的真实源 IP。
  • client:HAProxy 头部中携带的客户端源 IP。

示例:

[HAProxyDetectorPaper] Blocked non-whitelisted frps connection: frps=91.78.69.13, client=91.78.69.13

使用方法

  1. 配置平台:
    • Paper / Folia:在 config/paper-global.yml(新版本)或 paper.yml(旧版本)中将 proxy-protocol 设置为 true。
    • Velocity:在 velocity.toml 的 [advanced] 下将 haproxy-protocol 设置为 true。该插件复用 Velocity 的原生 HAProxy 解码器。
  2. 安装插件:将插件 JAR 文件放入相应平台的 plugins 文件夹中。
  3. 配置白名单(可选):如果仅希望允许特定的 frps 来源,请在 config.yml 中配置 whitelist。
  4. 重启服务器/代理。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源