幻嵐 Minecraft 伺服器架構，10 個 Paper 分流怎麼共用 Redis 與 MySQL

幻嵐是 Java 版 Minecraft 伺服器，一台 Velocity 代理後面掛 10 個 Paper 分流，分流之間不直接連線，共用狀態全部經過一套 Redis 和一台 MySQL。

這篇寫每一層是什麼、怎麼接起來。數字都是 2026 年 10 月的狀態。

架構全貌

兩台實體機都在內網。代理主機跑 Velocity、Redis、MySQL。MC 主機只跑 10 個 Paper，不做 port forwarding。

入口：玩家怎麼連進來

玩家連的是網域，DNS 用 SRV 記錄指到上游的轉發服務，再由它連到 Velocity。轉發服務在連線開頭送 PROXY protocol 標頭，帶玩家真正的 IP，所以 Velocity 開了 haproxy-protocol。

Velocity 開 online-mode 驗正版。分流全部 online-mode=false，改用 modern forwarding：代理把玩家資料連同 HMAC 簽章送給分流，分流用共享密鑰驗證，驗不過就踢。就算有人在內網直連分流的 port 也進不去。

RCON 全關。對分流下指令用 tmux send-keys 送進主控台，用 tmux capture-pane 讀回來，走既有的 SSH。

Tab 列表、頁首頁尾、側邊記分板都畫在代理上的 TAB，分流只裝 TAB-Bridge 回報變數，玩家換分流時名單不用重畫。

10 個分流怎麼切

分流	角色
lobby_login	登入服。確認大廳活著、發材質包
lobby	主大廳，也是主分流
ads_01～03	生存
stst01～03	副本，MythicMobs 設定最重，一台七百到近千個設定檔
redstone	紅石，沒裝 MythicMobs
rpg	另一個 RPG 世界

切分的原則是把會互相拖累的負載拆開。副本分流的負擔是 MythicMobs 的怪物和技能，生存分流是玩家蓋的農場和漏斗，紅石分流整天在跑機關。放在同一個 JVM，一座農場就會讓打副本的人一起卡。

行程模型

開機分三層：

1. systemd 的 minecraft-start.service（Type=oneshot）跑一支啟動腳本。
2. 啟動腳本讀分流清單，每個分流開一個同名 tmux session 跑 start.sh。
3. start.sh 是 while true 迴圈，java 結束 5 秒後再開一次，所以主控台打 stop 就等於重啟。

不讓 systemd 直接管 java，是因為要能隨時 attach 進主控台。代價是 10 個 java 都在同一個 service 的 cgroup 裡，這個 service 被重啟，10 個分流會一起重開，自動更新的 needrestart 要把它排除。

每日重啟由 UltimateAutoRestart 觸發，錯開排程：大廳和紅石 02:00，生存三台從 04:00 起每 15 分鐘一台，副本三台從 05:00 起每 15 分鐘一台，rpg 05:45，登入服不重啟。一台開機要 200 到 245 秒，9 台同時開會互搶到每台 375 到 454 秒，所以一定錯開。

主機資源

MC 主機是 i9-13900K（32 執行緒）、96 GB 記憶體、NVMe。晚上尖峰時，10 個 JVM 合計約 88 GB RSS，平均一台約 8.8 GB，可用記憶體只剩幾 GB，CPU 還有約 80% 閒置。

瓶頸在記憶體。要多開一台分流，得先關掉或合併一台。

資料層：MySQL 和 Redis 各放什麼

MySQL 和 Redis 都在代理主機上，各一台。

MySQL 是持久資料。慣例是一個外掛開一個資料庫，現在有二十幾個。要搬走或拆掉一個外掛，只動它自己的庫。

Redis 放分流之間要共用、要快的東西：

用途	內容
餘額快取	14 種貨幣，加扣點先寫 Redis 標成 dirty，主分流每 60 秒批次寫回 MySQL
換分流	hu_redirect:<UUID> → 目標分流，10 秒過期
在線名單	玩家名 → UUID 的 Hash，加每人目前在哪台，代理每分鐘整批刷新
跨服訊息	pub/sub 頻道：跨服 TPA、全服事件廣播
佇列	要送到 Discord 的通知，由主分流消費
玩家狀態	材質包接受與否（7 天過期），各分流照這個決定送圖示版還是純文字版的訊息

餘額的加扣點用 WATCH／MULTI 做樂觀鎖。這裡一定要原子，兩個分流同時對同一人加點，「讀出來、算完、整筆寫回」會互相蓋掉。

分流之間怎麼溝通

分流之間不直接連線。跨服的事寫進 Redis 或 MySQL，由需要的那一方去拿。現在並存三種做法：

做法	用在哪	特性
寫一個有 TTL 的 key，對方輪詢	換分流	對方晚一點讀也拿得到，沒人處理的 key 自己過期
Redis pub/sub	跨服 TPA、全服事件廣播	即時，但即發即忘，訂閱者重啟期間的訊息就沒了
資料庫版本號，各分流輪詢	副本模板更新	版本號是持久的，分流重啟後自己追上；寫資料和加版本號同交易

換分流的流程：分流寫 hu_redirect:<UUID>，代理上的轉服外掛每秒把所有在線玩家的 key 用一次 MGET 讀回來，有值就送過去，再整批刪掉。延遲最多一秒。

跨服 TPA 兩種都用到：請求和同意走 pub/sub，每台都收得到，目標玩家在哪台就由那台處理；同意後寫一個 30 秒的 key 記傳送目的地，再走上面的換分流；玩家進目標分流時讀這個 key，傳送到對方身邊。

副本模板改完要讓 10 台都重讀。這裡刻意不用 pub/sub：寫模板時在同一個 MySQL 交易裡把版本號加一，各分流每 5 秒讀一次版本號，變了就重讀。

主分流

有些事全服只能做一次：全服事件的結算、餘額寫回資料庫、送 Discord 通知、每週輪替。這些都只在大廳跑。每個外掛啟動時比對設定檔裡的 MainServer 和自己的 server-name，決定要不要啟動這些排程。

其他分流判定事件任務達成時 publish 一則訊息，大廳收到先檢查事件是不是已經結束，所以重複收到也只結算一次。全服共用的等級每台都會加經驗，升級用 Lua 比對再寫，保證同一級只升一次。

登入服

登入服是 Velocity 後面的第一站，只裝一支守門外掛：

• 探大廳。每 5 秒對大廳做一次 Server List Ping，連續 3 次失敗就判定停機，擋住進大廳的指令並顯示維護中。只看 port 不夠，Paper 開 port 之後到 Done 還要約 40 秒，要真的拿到狀態 JSON 才算開好。
• 發材質包。CI 把材質包傳到物件儲存，更新一份帶檔名和 sha1 的 latest.json。登入服每 5 分鐘讀一次，在登入的 configuration 階段發給玩家。server.properties 的 resource-pack 留空。

背包同步和物品定義

背包跨分流用 HuskSync 同步。HuskSync 搬的是玩家身上的物品，MythicMobs 物品的定義卻寫在各分流自己的設定檔。物品只定義在一台，玩家帶到別台就失效。

所以共用的物品和物品技能只寫在大廳，再用 rsync 同步到其他 9 台。分流自己只放怪物、怪物技能、掉落表、生怪點。

還沒解決的

• 單一主機。10 個分流都在同一台，主機出事就是全服。
• 大廳是單點。結算、寫回、通知都在大廳，大廳重啟的那幾分鐘，別台發出的訊息沒人收。
• 記憶體快滿。下一步要嘛合併分流，要嘛加一台主機把分流拆過去。