將 Minecraft Java 伺服器無損搬到新主機

搬移 Java 伺服器不是只複製地形。玩家物品、地獄與終界、權限、白名單、外掛資料庫、模組設定和啟動參數都屬於共同狀態。舊主機應保留到新主機通過私人驗收，不要一上傳完就取消服務。

先盤點完整執行環境

記錄 Minecraft、Java、伺服器核心與版本、載入器、模組、外掛、資料包、記憶體、啟動參數、連接埠、online-mode、代理和面板專屬設定。列出所有活動世界與額外維度；Paper 的特定目錄配置、多世界外掛和模組維度未必都在 world 裡。

同時記下玩家使用自有網域、主機子網域、代理或非預設連接埠。把領地、經濟、家點等實際功能列入驗收，而不是只看程序是否啟動。

建立唯一權威的停服備份

公告維護並阻止新玩家登入，必要時先儲存，再於主控台執行 stop。等程序完全結束後打包整個伺服器；若目的端要求選擇性搬移，也要一併保留世界、玩家資料、設定與依賴清單。

將壓縮檔存到兩台主機之外，記錄容量；工具支援時比對下載與上傳雜湊。雜湊只證明傳輸一致，實際可玩性仍需測試。舊主機保持停止且不要刪除。

先建好相容的新環境

安裝相符的 Java、Minecraft 核心、載入器、模組與外掛。從 Vanilla、Spigot、Paper、Fabric 或 Forge 互換時，依各專案最新搬移文件處理世界布局，不要自行假設目錄完全相同。

若面板要求首次啟動，可先建立測試檔，再徹底停服並歸檔。檢查磁碟空間、擁有者、啟動命令、連接埠與真正的伺服器根目錄，避免檔案傳到未執行的另一個個體。

世界、身分與設定要一起搬

透過官方檔案管理器、SFTP 或搬移服務上傳停服快照。確認 level-name、主世界、地獄、終界、玩家資料、進度、統計、資料包、白名單、封鎖名單、OP、權限與外掛資料庫均在正確位置。

不要在公開壓縮檔或客服單暴露資料庫密碼與 API 金鑰，外洩時應立即更換。尤其注意 online-mode 和代理身分轉送；認證模式改變可能讓老玩家得到不同 UUID，看起來像物品或權限不見。

先以私人地址驗收

不要立刻切換公開網域。用白名單、暫時地址或防火牆限制測試者，完整閱讀啟動日誌，先解決缺少依賴、版本不符、世界轉換和權限錯誤。管理員與一般帳號都要檢查出生點、地標、維度、物品、進度、領地、經濟、傳送點與關鍵指令。

做一個小變更後正常停服、重啟，確認仍載入同一世界且變更保留。成功登入一次並不能證明後續寫入與重啟安全。

切換時只留一台公開可寫伺服器

驗收後舊服繼續停機，再切換 DNS、代理或公告新地址與連接埠。兩台同時接受正式玩家會立即產生分岔進度，兩份已變動世界通常無法可靠合併。

初期觀察日誌和連線錯誤，DNS 快取可能讓少數玩家短時間仍到舊址。臨時直連地址不應成為永久、未保護的旁路。確認自動備份與一次實際重啟後，才安排舊主機退場。

失敗時做整體回復

若新主機損壞資料或無法執行依賴，先停止新服，再評估測試期間是否有必須保留的進度。最乾淨的回復是使用最後權威快照恢復舊服並切回入口，而不是在兩端零碎交換檔案。

保存錯誤日誌及未通過項目再重試。每次同時改版本、目錄和檔案範圍，只會讓根因更難追蹤。

搬移完成的判定

• 已盤點核心、Java、模組、外掛、世界與面板設定。
• 權威備份來自乾淨停服，並存於主機之外。
• 新環境相符或依照文件化搬移路徑建立。
• 世界、玩家身分、權限及設定一併搬移。
• 私人環境通過日誌、地標、維度、玩家、儲存與重啟測試。
• 切換期間只有一台公開可寫伺服器。
• 舊主機和離線備份在風險期內可回復。

真正完成不是新面板亮綠燈，而是玩家共同進度能在新主機上連續寫入，並且出事時可復原。