Velocity boost

插件

· 作者 vysbik

Velocity 代理的防洪水 ping 缓存、健康感知负载均衡以及聊天/命令速率限制。轻量级,无外部依赖。

0 本站下载 0 关注 更新于 6 天前

最新 1.0.0 · 1.21.11 · Velocity

一键开服(送7天)

Velocity 代理的性能、防护与可观测性支持 —— 无需替换代理的核心网络模块。

VelocityBoost 是一款适用于 Velocity 3.x 的轻量级插件,用于减少滥用性的服务器列表流量,避免玩家连接至已失效的后端服务器,并提供简单的运维可见性。它被设计为即插即用式的补充组件:无外部运行时依赖,不修补 Velocity 内部实现,也不改变代理处理正常连接的方式。

功能特性 服务器列表 Ping 缓存与防洪水攻击 基于每个 IP 的令牌桶算法、可选的全局 Ping 预算、基于 TTL(生存时间)的响应缓存以及自动缓存清理。超额的 Ping 请求将接收上一次缓存的响应,而非触发新的处理工作。该插件在 API 层面进行节流和缓存;它无法在 Velocity 开始处理之前拦截 Ping 请求(详见“已知限制”)。

健康感知负载均衡 采用 P2C(两的幂次方选择)或最少连接数策略进行选择,并支持可配置故障转移。按服务器追踪玩家状态,因此负载计数器在重连和断开连接时仍能保持准确。

后端健康检查 异步 Ping 检测,支持可配置的超时时间和失败阈值。状态不佳的服务器将从选择列表中排除,并在恢复后自动重新加入。

聊天与命令速率限制 基于 UUID 和 IP 应用无锁令牌桶算法。安全处理签名聊天和签名命令,以避免在 Minecraft 1.19.1 及以上版本中导致玩家被踢出。

批处理框架 用于高频更新的合并队列 —— 作为未来开发工作的 API 构建块。

指标与管理命令 /vboost status(别名 /vb)报告缓存命中率、被节流的 Ping 请求、被拒绝的聊天/命令、追踪的键值数量、不健康的服务器数量以及队列大小。权限要求:velocityboost.admin。

极简资源占用 无外部运行时依赖;Netty 和 Velocity API 均由代理本身提供。

基准测试结果 测试环境:Velocity 3.4.0 (build 566),Java 21,回环接口(loopback),48 个并发连接,每次运行包含 2,000 次测量 Ping + 2,000 次预热 Ping。插件限制设置:每 IP 3 个 Ping/秒,全局 500 个 Ping/秒,缓存 TTL 为 3 秒。

指标 无插件 带 VelocityBoost 变化
吞吐量 12,999 ping/s 12,532 ping/s −3.5%
每 2,000 次 Ping 的服务器 CPU 耗时 805 ms 922 ms +15%
p50 延迟 2.48 ms 2.51 ms +1%
p99 延迟 9.1 ms 17.0 ms +87%
错误数 0 0 —
内存 (RSS) 315 MB 329 MB +14 MB
从缓存提供的响应数 — 10,800 —
实际处理的 Ping 数 10,800 9 −99.9%

如何解读这些数据。在此合成基准测试中,VelocityBoost 将实际的 Ping 处理量减少了 99.9%(从 10,800 降至 9),但由于代理仍需在插件响应之前执行其自身的逐请求工作,端到端的吞吐量和延迟并未得到改善 —— 反而略有下降(p99 增加 87%)。因此,更恰当的理解是将该插件视为一种流量整形和防护层,而非纯粹的吞吐量优化方案。实际表现很大程度上取决于流量构成以及滥用流量所占的比例。

令牌桶:旧版 vs 优化后的实现

场景 旧版 (2 × AtomicLong) 优化版 (单次 CAS) 加速比
1 个线程 43.3 ns/op 39.2 ns/op 1.11×
8 个线程,共享桶 149.0 ns/op 55.3 ns/op 2.70×
8 个线程,每线程独立桶 19.8 ns/op 12.5 ns/op 1.58×

兼容性 Velocity 3.x(基于 Velocity API 3.4.0 构建)

Java 17+(类目标版本:17)

Netty 4.1(由 Velocity 提供)

配置 TOML 格式配置文件,包含 general(常规)、ping-cache(Ping 缓存)、balancer(负载均衡器)、ratelimit(速率限制)、batching(批处理)、health(健康检查)、metrics(指标)和 jfr(JFR 集成)等部分。无效值将在启动时被钳制(clamp);未知键将被忽略。

已知限制 Velocity 的公开 API 无法在代理处理之前拦截服务器列表 Ping 请求,因此 Ping 模块只能对响应进行节流和缓存,而无法消除代理的逐请求工作开销。

数据包批处理和 JFR 集成仅为框架支撑;它们不会修补 Velocity 的内部实现。

未包含 HTTP 指标导出器。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源