Skip to content

Wiki zh hk

pjscruggs edited this page Nov 11, 2026 · 2 revisions

Raknetify2 · 繁體中文 (香港特別行政區)

語言

多人遊戲

透過 RakNet 連接 Minecraft 用戶端和伺服器。

下載 · GitHub

Minecraft Raknetify2 用戶端 / 伺服器
Fabric mods/raknetify2-fabric-*.jar 用戶端 / 伺服器
Forge mods/raknetify2-forge-*.jar 用戶端 / 伺服器
NeoForge mods/raknetify2-neoforge-*.jar 用戶端 / 伺服器
Spigot / Paper plugins/raknetify2-spigot-*.jar 伺服器
Velocity plugins/raknetify2-velocity-*.jar Velocity
BungeeCord plugins/raknetify2-bungee-*.jar BungeeCord

新增伺服器

  1. 多人遊戲

  2. 新增伺服器

  3. 伺服器地址

    伺服器地址
    RakNet · UDP raknet;play.example.com:25565
    TCP play.example.com:25565
  4. 完成

  5. 加入伺服器

F3 · Raknetify2

F3
RakNet · UDP 已啟用 · MTU 1400
TCP 未啟用

Velocity / BungeeCord

  1. 用戶端 · Raknetify2 → UDP → Velocity / BungeeCord · Raknetify2
  2. Velocity / BungeeCord → TCP → 伺服器
連接埠號碼 · UDP Java
Fabric / Forge / NeoForge 1–65534 -Draknetify.fabric.portOverride=25570
Spigot / Paper ≥ 0.1.0-beta.1.431 1–65535 -Draknetify.spigot.portOverride=25570
Velocity 1–65534 -Draknetify.velocity.portOverride=25570
BungeeCord 1–65534 -Draknetify.bungee.portOverride=25570

連線逾時

伺服器地址 UDP
raknet;play.example.com:25580 play.example.com:25580 → NAT → 192.0.2.10:25570
伺服器 · 192.0.2.10 25570/udp

config/raknetify2-compatibility.json

伺服器 / Velocity / BungeeCord

JSON
① ② ③ {"mode":"ordered"}
① ∥ ② ∥ ③ {"mode":"multichannel"}

Simple Voice Chat

伺服器 Raknetify2 · UDP 25565 Simple Voice Chat
Fabric / Forge / NeoForge config/raknetify2-voicechat.json · {"enabled":true} config/voicechat/voicechat-server.properties · port=-1
Spigot / Paper config/raknetify2-voicechat.json · {"enabled":true} plugins/voicechat/voicechat-server.properties · port=-1

Simple Voice Chat · Velocity / BungeeCord

PROXY protocol v2 · UDP

伺服器地址 trustedProxies RakNet
192.0.2.10 · PROXY v2 / UDP ["192.0.2.10"] ✓
192.0.2.11 · PROXY v2 / UDP ["192.0.2.10"] ✗
用戶端 → RakNet / UDP ["192.0.2.10"] ✗

config/raknetify2-proxy-protocol.json

{"trustedProxies":["192.0.2.10"]}

Minecraft ≥ 1.20.5 · /transfer

  1. 伺服器 A · Fabric / Forge / NeoForge · config/raknetify2-transfers.json

    {"destinations":[{"host":"play.example.com","tcpPort":25565,"udpPort":25570}]}
  2. 伺服器 B · play.example.com · server.properties → accepts-transfers=true

  3. 伺服器 A · /transfer play.example.com 25565 Alex → 用戶端 (Alex) → RakNet · play.example.com:25570

PacketOrdering

Minecraft
ui 選項
entity 骷髏骨
world_interaction 物品欄
effects 粒子密度
chunk 方塊

PacketOrdering.java

版本不相容!

報吿錯誤

首頁

Raknetify2

Raknetify2 讓 Minecraft 多人遊戲通過 UDP 上的 RakNet 通訊。它將數據分到多個各自保證順序的通道。某個通道丟包時,其他通道中無關的數據仍能繼續傳輸。因此,即使正在補發丟失的數據或傳輸區塊,遊戲也有機會及時回應你的操作。

Raknetify2 是 Raknetify 的一個分支,原項目由 ishland 開發。該分支獨立維護,支援更新的 Minecraft 版本,並持續維護底層傳輸、各平台的適配和兼容性測試。

入門

  1. 查看 Minecraft 版本和模組兼容性。
  2. 選擇下載檔案並安裝。
  3. 使用類似 raknet;play.example.com 的地址連接。

伺服器指南

模組作者可以用封包排序接口聲明自訂負載與 Minecraft 網絡數據之間的先後關係。

專案連結

Raknetify2 使用 MIT 許可證,並保留原有的版權聲明。其網絡實現基於 Raknetify 和 netty-raknet。

安裝

從 GitHub Releases 下載發行版。安裝前請核對該版本要求的 Minecraft 版本與模組載入器。

安裝位置 檔案 資料夾
Fabric 客戶端或伺服器 raknetify2-fabric-*.jar mods
Forge 客戶端或伺服器 raknetify2-forge-*.jar mods
NeoForge 客戶端或伺服器 raknetify2-neoforge-*.jar mods
Spigot 或 Paper 伺服器 raknetify2-spigot-*.jar plugins
Velocity 代理 raknetify2-velocity-*.jar plugins
BungeeCord 代理 raknetify2-bungee-*.jar plugins

更換 JAR 檔案前,先關閉客戶端或停止伺服器。在同一安裝目錄中,先移除原版 Raknetify 及舊版 Raknetify2 的 JAR,再放入新檔案。

客戶端的資料夾位於你實際啟動的 Minecraft 實例或整合包內;伺服器和代理的資料夾分別位於各自的安裝目錄。如果載入器尚未創建相應資料夾,請自行創建。

直接連接伺服器

  1. 在客戶端安裝適用於你的載入器的模組。
  2. 在伺服器上安裝匹配的模組。如果是兼容 Spigot/Paper 的伺服器,則安裝相應插件。
  3. 按照防火牆與路由器設定操作,允許 UDP 連接到伺服器。
  4. 重啟客戶端和伺服器。
  5. 在「新增伺服器」中輸入地址,例如 raknet;play.example.com 或 raknet;play.example.com:25565。

地址沒有 raknet; 前綴時,連接使用 TCP。

只在客戶端安裝模組,遠程伺服器仍無法接受 RakNet 連接。伺服器管理員也要提供 RakNet 接入點。加入其他人伺服器的玩家通常無需在自己的路由器上設定入站連接埠轉發。

Velocity 與 BungeeCord

安裝配套的代理插件和客戶端模組。Velocity 與 BungeeCord 介紹了監聽設定、到後端的轉發、訪問限制以及應提供給玩家的地址。

使用單獨的 UDP 監聽連接埠

如果玩家直接連接 Minecraft 伺服器,按下表設定對應的 Java 參數。代理服管理員請參閱 Velocity 與 BungeeCord 的監聽設定。

平台 Java 參數 可用連接埠範圍
Fabric、Forge 或 NeoForge 伺服器 -Draknetify.fabric.portOverride=25570 1 到 65534
Spigot 或 Paper 伺服器 -Draknetify.spigot.portOverride=25570 1 到 65535

Forge 和 NeoForge 共用同一套監聽代碼,所以它們的屬性名也含有 fabric。請將 25570 替換為你希望使用的 UDP 連接埠。

Spigot / Paper ≥ 0.1.0-beta.1.431

在 Java 啟動命令的 -jar 前加上參數,或將其填入主機面板的 JVM 參數欄。重啟伺服器,並放行所選監聽連接埠的 UDP 流量。如果公網連接埠也是 25570,請用 raknet;play.example.com:25570 連接。如果路由器轉換了連接埠,則客戶端地址應填寫公網連接埠。TCP 連接埠沿用原值。

在 Spigot/Paper 上,UDP 使用 Minecraft TCP 監聽器綁定的本地地址。如果指定的連接埠無效或已被佔用,RakNet 將無法啟動。可在啟動日誌中核對實際綁定的 UDP 地址與連接埠。若要改回與 TCP 相同的連接埠號,移除該參數並重啟即可。

也可以在路由器或 UDP 代理上另設公網 UDP 連接埠,轉發到現有監聽連接埠,無需修改伺服器的 Java 參數。

開發版

在 GitHub Actions 中打開一次成功的 main 分支運行記錄,下載 Artifacts 中的壓縮包。下載工作流產物需要登入 GitHub。根據上方安裝表,從壓縮包中選擇合適的 JAR。

Velocity 與 BungeeCord

Velocity 和 BungeeCord 位於玩家與 Minecraft 後端伺服器之間。在代理上以及每個使用 RakNet 連接的客戶端上安裝 Raknetify2。

Raknetify2 客戶端 --UDP--> Velocity 或 BungeeCord --TCP--> 後端伺服器

這種連接方式無需在後端安裝 Raknetify2。你的網絡原本需要哪些模組、插件和轉發功能,後端仍須具備。Raknetify2 不負責 Minecraft 版本轉換,也不改變代理的帳戶驗證方式。

安裝代理插件

  1. 先確認普通 TCP 連接可以通過代理正常登入,也能在後端伺服器間切換。
  2. 停止代理,然後從 GitHub Releases 下載匹配的插件。
  3. 將 raknetify2-velocity-*-all.jar 或 raknetify2-bungee-*-all.jar 放入代理的 plugins 資料夾。移除同一目錄中的舊版 Raknetify 或 Raknetify2 插件。
  4. 按照安裝指南安裝相應的 Raknetify2 客戶端模組。
  5. 檢查下方的監聽設定,重啟代理,並查看日誌中是否有 RakNet 監聽錯誤。
  6. 允許公網 UDP 流量到達代理,並依照防火牆與路由器設定限制後端遊戲連接埠的訪問。

客戶端與代理要使用相互兼容的 Raknetify2 發行版。混用版本前請查閱兼容性說明。

Velocity

velocity.toml 中的 bind 指定 Velocity 接受 Minecraft 連接的地址和 TCP 連接埠。Raknetify2 默認在相同連接埠號上監聽 UDP。[servers] 各項對應後端伺服器,應繼續填寫後端的 TCP 地址。詳見 Velocity 的設定參考。

若要單獨指定 UDP 連接埠,請在 Velocity 啟動命令的 -jar 前加入以下 JVM 參數:

-Draknetify.velocity.portOverride=25570

將 25570 換成所選連接埠。此設定只改變 RakNet 的 UDP 連接埠,Velocity 的 TCP 連接埠和後端地址仍沿用原值。修改後重啟 Velocity。

在 Velocity 和後端上都要設定玩家資料轉發。後端支援時,請使用現代轉發模式,並妥善保管轉發密鑰。按 Velocity 的玩家資料轉發指南中適用於該後端的步驟操作。啟用轉發後,仍須保留後端的防火牆限制。

BungeeCord

在 BungeeCord 的 config.yml 中,每個 listeners 項下的 host 值指定一個 Minecraft 監聽地址與 TCP 連接埠。Raknetify2 默認在同一連接埠號上增加 UDP 監聽。servers 各項保存後端 TCP 地址。詳見 BungeeCord 設定指南。

若要單獨指定 UDP 連接埠,請在 BungeeCord 啟動命令的 -jar 前加入以下 JVM 參數:

-Draknetify.bungee.portOverride=25570

這個參數對整個代理程序生效。如果設定了多個 Minecraft 監聽器,請先在啟動日誌中核對實際的 RakNet 監聽地址和連接埠,再新增防火牆規則。修改參數後重啟 BungeeCord。

保留代理上的帳戶驗證。如果後端是 Spigot,請按照 BungeeCord 的 IP 轉發指南,在代理上設定 ip_forward: true,同時在後端設定 settings.bungeecord: true。僅啟用轉發無法阻止玩家繞過代理直接連接後端。請按防火牆設定說明限制後端訪問。

確定玩家應使用的地址

兩種代理的連接埠參數都接受 1 到 65534。無效值會被忽略,所以要在啟動日誌中核對實際綁定的 UDP 連接埠。移除參數並重啟,即可恢復為 Minecraft 監聽器的連接埠號。

玩家連接代理的公網主機名與 UDP 連接埠,例如 raknet;play.example.com:25570。如果路由器轉換了連接埠,客戶端地址應填寫轉換前的公網 UDP 連接埠。省略 raknet; 前綴的地址仍使用代理的 TCP 監聽連接埠。

Query、Geyser 等其他 UDP 服務應各用單獨的 UDP 連接埠。另改 TCP 連接埠無法解決 UDP 套接字衝突。

語音聊天與額外的 UDP 轉發

在 Velocity 和 BungeeCord 上,Simple Voice Chat 使用自己的代理插件和 UDP 連接埠。請按語音聊天代理說明設定。

如果 Minecraft 代理前面還有一層 UDP 中繼,且中繼會發送 PROXY 協議 v2 標頭,請按 UDP 轉發與 PROXY 協議設定 Raknetify2。單獨使用 Velocity 或 BungeeCord 不需要這項設定。

驗證連接

在區域網絡外使用 Raknetify2 客戶端測試。通過代理加入,並在你使用的後端之間切換,確認玩家身份和權限始終正確。

  • 如果經過代理的 TCP 連接正常,但 RakNet 超時,請檢查代理的 UDP 監聽、公網連接埠、IPv4 與 IPv6 路由及防火牆規則。
  • 如果兩種傳輸方式都在代理連接後端時失敗,請檢查該後端的 TCP 地址、訪問規則及玩家資料轉發設定。
  • 如果代理報告 UDP 連接埠已佔用,請檢查是否有 Query、Geyser、語音代理或其他程序綁定了該連接埠。

報告問題時,請同時附上同一次連接嘗試的代理日誌和後端日誌。需要註明哪些版本,見故障排查。

防火牆與路由器設定

本指南面向伺服器管理員。玩家發出的 UDP 流量必須能到達接受 RakNet 連接的伺服器或代理。默認情況下,Raknetify2 使用與 Minecraft 的 TCP 監聽連接埠相同的連接埠號。

同一區域網絡內的玩家應使用伺服器的內網地址,並在伺服器主機防火牆中放行 UDP。外網流量需要經過路由器的 IPv4 NAT 時,才需要在路由器上設定連接埠轉發。

確定目標地址與連接埠

直連伺服器

將公網 UDP 流量轉發到運行 Minecraft 伺服器並已安裝 Raknetify2 的主機,目標連接埠為這台伺服器的 RakNet UDP 監聽連接埠。在主機防火牆中放行該連接埠,並保留現有 TCP 路由供普通 Minecraft 連接使用。

例如,若 Raknetify2 在 UDP 25570 上監聽,就將公網 UDP 連接埠轉發到伺服器內網地址的 25570 連接埠。伺服器的 TCP 連接埠可以保留為 25565。如需另選 UDP 連接埠,請參閱直連伺服器的監聽設定。

Velocity 或 BungeeCord

將公網 UDP 流量轉發到運行 Velocity 或 BungeeCord 並已安裝 Raknetify2 插件的主機。轉發目標應為代理的 RakNet UDP 監聽連接埠。保留代理原有的公網 TCP 路由,供普通 Minecraft 連接使用。

代理通過 TCP 連接 Minecraft 後端伺服器。在代理上安裝 Raknetify2,無需向玩家開放後端的遊戲 UDP 連接埠。

連接方向 應允許的訪問
玩家到代理 允許公網 UDP 到達 RakNet 監聽連接埠,並保留現有的公網 TCP 監聽連接埠
代理到後端伺服器 後端 Minecraft TCP 連接埠僅對指定的代理主機開放
玩家直接訪問後端遊戲連接埠 保持阻止,包括 IPv6 訪問

如果代理與後端直接運行在你管理的同一台專用機器上,後端可以只監聽迴環地址,並在代理上填寫這個地址。跨主機部署時,使用防火牆或隔離的專用網絡,使後端 TCP 連接埠僅對代理主機開放。容器和託管主機也應根據網絡佈局設定等效的訪問限制。可參考 Velocity 後端安全指南和 BungeeCord 防火牆指南。

玩家資料轉發與防火牆限制需要配合使用。允許直接訪問後端可能讓人繞過代理的登入檢查。插件安裝、轉發設定與 UDP 連接埠參數見 Velocity 與 BungeeCord。

公網與本地連接埠號

路由器可以轉換連接埠,因此公網連接埠號和監聽連接埠號可能不同:

設定項 應填連接埠
客戶端填寫的伺服器地址 公網 UDP 連接埠
路由器轉發規則的外部連接埠 公網 UDP 連接埠
路由器轉發規則的內部連接埠 RakNet 監聽的 UDP 連接埠
主機防火牆規則的本地連接埠 RakNet 監聽的 UDP 連接埠

IPv4 連接埠轉發

在 IPv4 路由器後架設伺服器時:

  1. 找到接受 RakNet 連接的那台機器的區域網絡 IPv4 地址。使用 DHCP 地址保留或合適的靜態地址,以免日後地址變動導致轉發到其他機器。
  2. 為玩家使用的公網連接埠新增 UDP 轉發規則。
  3. 將規則的目標設為該主機的內網地址,以及 RakNet 正在監聽的 UDP 連接埠。
  4. 在主機防火牆上允許 UDP 流量進入監聽連接埠。

例如,伺服器在 UDP 25565 上監聽,可以設定公網連接埠 25565、目標地址 192.168.1.100、目標連接埠 25565。請將例子地址換成你伺服器實際的內網地址。

保留現有的 TCP 規則以供普通 Minecraft 連接使用。僅有 TCP 轉發規則無法轉發 UDP。

轉發後仍然無法連接

檢查流量到達你的路由器之前,是否已經過另一台路由器或運營商的 NAT。如果兩台路由器都由你管理,兩台都要設定轉發。如果運營商使用運營商級 NAT,可詢問能否分配公網 IPv4 地址,也可使用支援入站 UDP 的託管服務或隧道。本機路由器上的轉發規則無法更改運營商的 NAT 設定。公網 WAN 地址的要求見 TP-Link 連接埠轉發說明。

IPv6 防火牆規則

在路由器的 IPv6 防火牆和主機防火牆上都放行所選 UDP 連接埠。規則應指向接受 RakNet 連接的主機的 IPv6 地址。

檢查主機名對應的 IPv6 地址確實指向該主機。如果機器的 IPv6 地址發生變化,應更新 DNS 記錄以及引用該地址的防火牆規則。

同時發佈 IPv4 和 IPv6 地址的主機名,兩個地址都要有可用路由。如果有的玩家能連接,有的不能,請檢查兩套規則。

如果 IPv4 轉發時更改了連接埠號,要確認玩家填寫的連接埠通過 IPv6 也能到達監聽器。IPv4 的連接埠轉換不會自動設定 IPv6 路由。

託管服務與隧道

託管商或隧道服務必須在提供給玩家的公網接入點上支援 UDP。除伺服器自己的防火牆外,也要檢查服務商分配的連接埠和網絡防火牆規則。

如果前面還有一層 UDP 代理,用 PROXY 協議 v2 轉發客戶端地址,請遵循 UDP 轉發與 PROXY 協議的說明,並將接收端的 UDP 監聽連接埠限制為僅允許受信任的代理訪問。

驗證連接

從伺服器區域網絡以外的網絡,用更新後的 Raknetify2 客戶端連接,例如 raknet;play.example.com:25565。這個地址要填寫公網 UDP 連接埠。

用真正的 RakNet 連接驗證路由。正常工作的 UDP 服務也可能丟棄無法識別的探測包,因此 UDP 掃描沒有收到回應時,結果並不確定。詳見 Nmap 的 UDP 掃描文檔。

TCP 連接成功只能說明 TCP 路由正常。如果 RakNet 超時,請按故障排查指南檢查監聽器、轉發目標、UDP 連接埠和防火牆規則。

兼容性

請按你要下載的具體發行版核對兼容性。開發分支上已經支援的版本或功能,可能尚未包含在發行版中。

Minecraft 與 Java 版本

Minecraft 與 Java 版本 · English

Raknetify2 聲明的是它所需的最低 Java 版本。Minecraft 或載入器可能要求更高的版本。請選擇能同時滿足三方要求的 Java 版本。

客戶端與伺服器版本

客戶端和接受連接的伺服器或代理,請儘量使用同一 Raknetify2 發行版。混用前先閱讀發行說明。RakNet 加密連接要求兩端都支援認證加密協議。原版 Raknetify,以及在引入該協議之前發佈的 Raknetify2,均無法通過這種加密方式與新版連接。

Raknetify2 承載 Minecraft 現有的遊戲協議。不同 Minecraft 版本之間要互聯,仍需配備兼容的協議轉換方案。

其他模組

其他模組 · English

如果大型整合包出錯,請按故障排查指南操作,報告中附上完整的模組版本資料。

有序模式

有序模式

默認情況下,某個通道等待補包時,Raknetify2 允許其他獨立通道繼續傳輸。有序模式將所有 Minecraft 封包放在同一通道中。一個包丟失後,該方向後續的所有包都會等待重傳完成。這能保持某些反作弊軟件要求的順序,但在等待期間,無關的遊戲數據也無法繼續傳輸。

啟用有序模式

  1. 在接受 RakNet 連接的伺服器或代理上,以及每個 RakNet 客戶端上,安裝支援有序模式的 Raknetify2 版本。

  2. 在該伺服器或代理的工作目錄下創建 config/raknetify2-compatibility.json。如果沒有 config 目錄,請先創建。

  3. 寫入以下內容:

    {"mode": "ordered"}
  4. 重啟伺服器或代理。

客戶端會自動採用伺服器的設定。玩家無需創建設定檔案,也無需修改原有的 RakNet 伺服器地址。

兩個方向各使用一個可靠有序通道傳輸全部 Minecraft 封包,包括包組分隔標記與切換世界時的封包。

代理設定

玩家通過 Velocity 或 BungeeCord 連接時,有序模式應在代理上設定,即使反作弊軟件運行在後端伺服器上也是如此。

切換後端後,此設定仍然生效。在有序模式下,後端發來的保活請求會由代理轉發給真正的客戶端,代理不會就地代答。

檢查設定是否生效

首次建立 RakNet 連接時,控制台會顯示:

Raknetify2 compatibility: ordered (updated clients required, genuine acknowledgements)

兼容性協商成功時,日誌還會出現 ordered compatibility negotiated,後面是對端地址。

保持反作弊檢查開啟,並在你實際使用的設定上驗證。

舊版客戶端

不支援有序模式的 RakNet 客戶端無法加入強制使用該模式的伺服器。請更新客戶端的 Raknetify2,或者使用伺服器或代理正常的 TCP 地址與連接埠連接,地址開頭不要加 raknet;。

恢復多通道模式

將檔案內容改為:

{"mode": "multichannel"}

然後重啟伺服器或代理。也可以刪除設定檔案,重啟後同樣會恢復多通道模式。

設定問題

檔案中只能有一項名為 mode 的設定。它的值必須是 "ordered" 或 "multichannel",區分大小寫。

如果設定無效或檔案無法讀取,RakNet 連接將被拒絕。更正檔案後重啟相應程序。

如果控制台仍顯示 multichannel,請檢查檔案是否位於實際接受 RakNet 連接的伺服器或代理的工作目錄中,然後重啟對應程序。

自動轉服

Fabric、Forge 和 NeoForge 伺服器可以按設定將支援此功能的客戶端通過 RakNet 轉移到目標伺服器。此功能依賴 Minecraft 從 Java 版 1.20.5 起提供的原生轉服機制。請核對 Raknetify2 發行版是否支援兩端的 Minecraft 版本與載入器。

在發起轉服的伺服器與客戶端上安裝 Raknetify2。目標端必須提供兼容的 RakNet 監聽連接埠,並接受 Minecraft 轉入請求。

此設定僅作用於上述三個模組載入器發起的轉服。Spigot/Paper、Velocity 和 BungeeCord 插件不會讀取這份轉服設定檔案。

設定發起轉服的伺服器

在發起轉服的伺服器目錄下創建 config/raknetify2-transfers.json:

{
  "destinations": [
    {
      "host": "play.example.com",
      "tcpPort": 25565,
      "udpPort": 25570
    }
  ]
}

將例子中的主機名與連接埠替換為實際的目標值,再重啟發起轉服的伺服器。其他目標也新增在同一個數組內。

欄位 含義
host 目標主機名或 IP 地址,不含傳輸協議前綴和連接埠號
tcpPort 原始轉服請求指定的目標連接埠
udpPort 轉入的客戶端應連接的公網 RakNet 連接埠

TCP 和 UDP 可以使用同一連接埠號。如果路由器轉換了 UDP 連接埠,此檔案中應填公網連接埠。連接埠號用 JSON 數字表示。

發起轉服時,目標仍填寫普通主機名和 TCP 連接埠。Raknetify2 會檢查客戶端是否聲明支援自動轉服。如果客戶端支援且目標匹配,則改用設定的 UDP 連接埠。其他客戶端或未匹配的目標繼續使用原始轉服地址。

匹配依據是轉服請求中的主機名和 TCP 連接埠。比較前會統一主機名大小寫、末尾的 DNS 點號以及 IPv6 的等價寫法。不通過 DNS 查詢進行匹配,因此即使兩個不同的主機名解析到同一地址,也需分別設定。不能使用通配符。

設定目標伺服器

如果目標使用 Minecraft 的 server.properties,請設定 accepts-transfers=true 並重啟。目標若為代理,可能有單獨的轉服設定。Minecraft 默認拒絕轉入,即使玩家能正常直連該服。

必須先設定好目標端的 RakNet 監聽、公網 UDP 轉發和主機防火牆。發起轉服一方的設定檔案只決定發送給客戶端的地址。

如果目標主機名同時發佈 IPv4 和 IPv6 地址,請檢查兩條路由。排查自動轉服前,先試一次到目標端的普通 RakNet 直連。

保留目標端原有的登入與連線權限檢查。此設定不會授予玩家訪問權限,也不能替代伺服器身份驗證。

設定錯誤與停用方法

欄位缺失、欄位名未知、連接埠無效或目標重複,都會在初始化時報設定錯誤。請根據伺服器日誌定位錯誤,修正 JSON 後重啟。

要關閉自動選擇,請移除設定檔案或將內容改成 {"destinations": []},然後重啟發起轉服的伺服器。此後轉服請求將保留原始地址。

UDP 轉發與 PROXY 協議

UDP 代理可以轉發 RakNet 流量,並通過 PROXY 協議 v2 保留客戶端的原始地址。只有上游 UDP 代理會向監聽器發送此類標頭時,才應啟用本功能。普通路由器連接埠轉發無需啟用。

在接收轉發 UDP 流量的伺服器或 Minecraft 代理上創建 config/raknetify2-proxy-protocol.json:

{
  "trustedProxies": ["192.0.2.10"]
}

將例子替換為 UDP 代理的實際來源 IP 地址,或你能控制的 CIDR 網段。若中途經過 NAT,以接收端實際看到的來源地址為準。可以直接填寫 IPv4 或 IPv6 地址,不能填寫 DNS 主機名。設定後重啟接收端的伺服器或代理。

將轉發代理設定為給 UDP 流量新增 PROXY 協議 v2 標頭。Raknetify2 僅接受來自所列來源的轉發客戶端地址。啟用本設定時,沒有此類標頭的 RakNet 直連會被拒絕。TCP 監聽器繼續使用原有設定。

信任與訪問控制

列出的每個代理都受信任,可以聲明客戶端的地址。在後端的防火牆中限制 UDP 連接埠,只允許指定的代理訪問。在網絡條件允許的範圍內,儘量縮小信任網段。

檔案中只能有 trustedProxies 一項,且必須至少包含一個條目。空數組會報錯。如果檔案無效,RakNet 監聽器將無法啟動。

要恢復 UDP 直連,請移除該檔案並重啟監聽器,同時按新的連接路徑更新上游代理的轉發方式和防火牆規則。

啟用後若無法連接,請檢查後端看到的代理實際來源地址、設定的受信任網段,以及代理是否為 UDP 發出了 PROXY 協議 v2 標頭。

Minecraft 代理的安裝與後端設定見 Velocity 與 BungeeCord。

Simple Voice Chat

在 Fabric、Forge、NeoForge、Spigot 和 Paper 上,Raknetify2 可以和 Simple Voice Chat 共用伺服器的 UDP 監聽連接埠。

在伺服器和所有需要語音聊天的客戶端上安裝 Simple Voice Chat。其餘語音設定請參閱該模組的伺服器設定指南。

Raknetify2 的設定檔案放在伺服器頂層的 config 目錄,Spigot/Paper 也一樣。Simple Voice Chat 自己的設定檔案沿用下述各平台的位置。

共用遊戲連接埠

  1. 在伺服器目錄下創建 config/raknetify2-voicechat.json,寫入以下內容:

    {"enabled": true}
  2. 在 Simple Voice Chat 的伺服器設定中設定 port=-1。模組伺服器的檔案是 config/voicechat/voicechat-server.properties;Spigot/Paper 上是 plugins/voicechat/voicechat-server.properties。

  3. 如果只有一個匹配的 RakNet 監聽器,讓 bind_address 保持空白。如果伺服器在該 UDP 連接埠上有多個監聽器,將它設為你希望共用的那個監聽器的本地地址。

  4. 重啟伺服器,然後對一名已連接的玩家運行 /voicechat test <PLAYERNAME>。

如果 RakNet 監聽器與 Minecraft 使用不同的連接埠,請將語音 port 明確設為本地 RakNet UDP 連接埠,不要使用 -1。例如,若本地 RakNet UDP 連接埠為 25570,應設定 port=25570。

如果客戶端需要使用不同的公網地址或連接埠,請設定 voice_host。例如路由器將公網 UDP 25580 轉發到本地 UDP 25570,則設定 port=25570 和 voice_host=play.example.com:25580。公網地址應填在 voice_host 中,bind_address 則用於選擇本地監聽器。

Raknetify2 通過 Simple Voice Chat 的 API 提供共用的 UDP 套接字。語音身份驗證與加密仍由 Simple Voice Chat 處理。無論遊戲連接走 TCP 還是 RakNet,玩家都可以使用語音聊天。

其他 UDP 服務與代理

Query 和 Geyser 仍需使用不同的 UDP 連接埠。共用套接字的集成僅支援 Simple Voice Chat。

此功能不能在 Velocity 或 BungeeCord 上共用語音代理的套接字。請按 Simple Voice Chat 的代理設定指南為語音代理分配獨立的 UDP 連接埠。如果使用官方語音代理插件,要指定公網 voice_host,須在代理的語音設定中設定。該插件會忽略後端伺服器上的 voice_host。

使用通用 UDP 隧道時,將 voice_host 設為實際向本伺服器轉發的公網主機名與 UDP 連接埠。

關閉連接埠共用或解決套接字衝突

如果日誌顯示 No RakNet listener matches the voice bind address and port,請確認 RakNet 已啟動,並核對語音設定的連接埠與綁定地址是否和本地 RakNet 監聽器一致。

如果顯示 Multiple RakNet listeners match the voice bind address,在 bind_address 中明確指定一個匹配的本地地址,然後重啟。

只能由一個 Simple Voice Chat 插件提供它的 UDP 套接字。如果啟動時提示已有其他插件提供套接字,請從這些集成中選擇一個使用。

要關閉 Raknetify2 的語音集成,請在它的語音設定中設定 {"enabled": false},或刪除這份檔案。為 Simple Voice Chat 分配單獨的 UDP 連接埠,更新相應的防火牆或轉發規則,然後重啟伺服器。

故障排查

TCP 連接正常,但 RakNet 超時

按以下順序檢查:

  1. 客戶端安裝了適用於其載入器與 Minecraft 版本的 Raknetify2 模組。
  2. 接受連接的伺服器或代理已安裝 Raknetify2,且啟動時沒有監聽錯誤。
  3. 地址以 raknet; 開頭,填寫的是公網 UDP 連接埠。
  4. 託管服務商、路由器及主機防火牆都允許通過該連接埠的 UDP 流量。
  5. 主機名的 IPv4 和 IPv6 地址都指向預期的主機,且相應的防火牆規則有效。

TCP 連接成功只能說明 TCP 路由可用。按防火牆與路由器設定檢查 UDP 轉發與 IPv6 訪問。如果啟用了 PROXY 協議,客戶端必須經設定中受信任的代理才能到達監聽端。

地址已被佔用

檢查是否有其他程序佔用該 UDP 連接埠。Query、Geyser 等 UDP 服務都需要自己的連接埠。Simple Voice Chat 可使用共用連接埠功能。

可以按直連伺服器監聽設定或 Velocity 與 BungeeCord 設定另選本地 UDP 連接埠。請核對 Spigot/Paper 對此設定的版本要求。只修改路由器的公網連接埠,無法解決本地套接字衝突。

能加入伺服器,但轉服失敗

使用目標的 raknet; 地址嘗試直連。如果直連失敗,請先修復目標監聽器或網絡路由。

如果能直連,請檢查目標端是否接受轉服。使用 server.properties 的 Minecraft 伺服器需要設定 accepts-transfers=true。普通直連不會驗證該設定。

將轉服請求中的主機名和 TCP 連接埠,與發起轉服一方的 config/raknetify2-transfers.json 對照。確認重啟後已加載此檔案,且客戶端支援 RakNet 自動轉服。詳見自動轉服。

加密或協議錯誤

核對連接兩端的 Raknetify2 版本。如果發行版更改了加密協議,應同時更新客戶端與接受連接的伺服器或代理。排查期間請保留伺服器原有的身份驗證設定。

特定模組引發的問題

記錄觸發問題的具體操作,例如打開物品欄、接收資源包、切換世界或生成實體。條件允許時,在獨立的測試環境中分別通過 TCP 和 RakNet 執行同一操作並對比結果。

某些自訂負載依賴原版封包的順序。模組作者可以通過封包排序接口聲明這些依賴。

報告問題

請在 Raknetify2 問題跟蹤頁新建問題,並附上:

  • 兩端的 Minecraft、Java、載入器和 Raknetify2 版本。
  • 伺服器與代理軟件版本,包括所有 UDP 轉發代理。
  • 安裝的其他模組及其版本。
  • 復現問題的步驟,以及你預期看到的結果。
  • 通過 TCP 執行相同步驟是否正常。
  • 同一次嘗試所產生的客戶端、伺服器及代理日誌相關片段。

上傳日誌前請移除存取權杖、密碼及其他私隱資料。保留診斷所需的例外訊息和堆疊追蹤。

模組集成

Raknetify2 允許模組聲明,哪些 Minecraft 數據需要與其自訂負載按順序傳輸。如果處理負載前必須由先到的封包建立實體、區塊、物品欄或其他狀態,就應使用此接口。

排序組

分組 相關流量
ui 不依賴世界狀態的菜單與交互
entity 實體生成、移除與移動
world_interaction 物品欄以及其他依賴世界狀態的交互
effects 聲音和粒子
chunk 地形、方塊與光照更新

每個組在自己的通道內都保持可靠、有序傳輸。不同組之間的封包抵達時,相對順序可能與發出時不同。請按負載實際依賴的數據選擇分組。

可選的 Fabric 集成

在模組的 fabric.mod.json 中,為 raknetify:packet_channels 入口新增提供者。提供者使用 JDK 類型實現 Consumer<BiConsumer<String, String>>。它收到的註冊函數接受自訂負載識別碼與排序組兩個參數。

將下列條目合併到已有的元資料中,並將類名替換為提供者類的完全限定名:

{
  "entrypoints": {
    "raknetify:packet_channels": [
      "com.example.mod.OrderingProvider"
    ]
  }
}

這裏展示的是元資料檔案的一個片段。請保留 fabric.mod.json 中的其餘內容,包括原有入口。

例如,擴展實體移動的模組可將 example:entity_path 註冊到 entity 組。提供者實現例子見 PacketOrdering API 文檔。

未安裝 Raknetify2 時,Fabric 不會調用此入口。提供者應在初始化階段聲明識別碼與分組,不應假設其他模組已經完成初始化。

註冊行為

Raknetify2 可用時,Forge、NeoForge 模組以及伺服器或代理插件可在初始化階段調用 PacketOrdering.register(identifier, group)。類名是 com.ishland.raknetify.api.PacketOrdering。請在接受玩家連接前註冊。對於可選集成,確保缺少 Raknetify2 依賴時不會加載其類。

聲明對新連接生效。已建立的連接繼續使用建立時收到的規則。允許重複提交相同的聲明;同一識別碼對應衝突分組的聲明會被拒絕。

負載識別碼必須使用有效的自訂命名空間。minecraft 為保留命名空間。每個端點總計最多 128 條聲明,其中包括內置規則和其他模組的註冊。識別碼遵循 API 的帶命名空間語法,最長為 255 個 ASCII 字符。

新版 RakNet 兩端在建立連接時交換聲明。伺服器或代理若沒有某個負載的本地規則,可採用對端的聲明。本地規則優先;對端聲明的作用範圍僅限於當前連接。

UDP 代理

UDP 中繼及客戶端地址轉發見 UDP 轉發與 PROXY 協議。

Minecraft 代理的設定見 Velocity 與 BungeeCord。

English (US)

Clone this wiki locally