BungeeCord 轉發
Pumpkin 原生支援 BungeeCord 和 Waterfall 代理網路,包括 BungeeGuard 身分驗證令牌驗證。
實現位於 crates/pumpkin/src/net/proxy/bungeecord.rs。
BungeeCord 轉發的工作方式
與使用自訂登入通道的現代協定不同,BungeeCord 透過將用戶端元資料直接編碼到初始 SHandshake 封包的 server_address 欄位中來工作。
該字串使用空字元(\0)作為分隔符:
text
[original_host]\0[player_ip:port]\0[player_uuid]\0[properties_json]original_host:玩家最初在用戶端中輸入的域名。player_ip:port:用戶端真實的 IP 位址和臨時源埠。player_uuid:玩家的 Mojang UUID(不帶連字元的 32 個十六進位制字元,或帶連字元的 36 個字元)。properties_json:包含皮膚紋理、披風紋理和 Mojang 加密簽名的 JSON 陣列。
安全風險:繞過代理
由於 BungeeCord 的握手字串是未經驗證的明文,攻擊者可以直接連線到暴露的後端埠,注入任意 UUID 和管理員使用者名稱,從而完全控制伺服器。
傳統上,這需要嚴格的 Linux 防火牆規則(iptables / ufw),將埠存取權限僅限制給代理 IP。
BungeeGuard 防護
為了在不完全依賴網路防火牆的情況下杜絕繞過代理,Pumpkin 集成了 BungeeGuard 令牌驗證:
- BungeeCord 代理以
bungeeguard-token為鍵,將共享金鑰注入玩家的檔案屬性中。 - 當 Pumpkin 在
bungeecord_login中處理握手時:- 檢查
pumpkin.toml中是否設定了secret。 - 檢查轉發的屬性中是否存在
bungeeguard-token。 - 如果令牌匹配,Pumpkin 會從玩家檔案中移除該金鑰屬性(使其他插件無法讀取它),然後完成登入。
- 如果令牌缺失或不正確,Pumpkin 會以
BungeeCordError::MissingToken或BungeeCordError::InvalidToken拒絕連線。
- 檢查
rust
// 位於 crates/pumpkin/src/net/proxy/bungeecord.rs
if !secret.is_empty() {
let Some(token_index) = properties.iter().position(|p| p.name == BUNGEEGUARD_TOKEN_PROPERTY) else {
return Err(BungeeCordError::MissingToken);
};
if properties[token_index].value != secret {
return Err(BungeeCordError::InvalidToken);
}
properties.remove(token_index);
}在 pumpkin.toml 中設定
啟用帶 BungeeGuard 的 BungeeCord 轉發:
toml
[networking.proxy]
enabled = true
[networking.proxy.bungeecord]
enabled = true
# 可選:設定 BungeeGuard 共享金鑰以阻止直接連線
secret = "YOUR_BUNGEEGUARD_SECRET_HERE"