管理伺服器

用 Saba-chan 經營遊戲伺服器的日常工作流程,從新增、啟動、監控伺服器,到備份、排程、邀請朋友以及 Discord 整合。

管理伺服器

本文件 從使用者的角度 說明如何使用 Saba-chan。即使不碰模組程式碼、不自己寫擴充功能,光靠這一頁就足以為朋友經營一兩台遊戲伺服器。

安裝請見 開始使用,機器人配對請見 Discord 機器人 & 雲端中繼。本頁假設你已完成安裝,聚焦於 GUI 開著時該按什麼、要看什麼。


1. 整體概念:GUI 是遙控器,常駐程式負責執行伺服器

請先記住:關閉 GUI 視窗並不會關閉你的遊戲伺服器。

  • saba-chan-gui(視窗):向常駐程式發送指令並繪製畫面的遙控器。CLI(saba-chan-cli)扮演相同的角色。
  • saba-core(常駐程式):在背景運作、負責啟動與監督遊戲伺服器的核心程序。執行中的伺服器、備份、排程工作以及 Discord 連線,全都由常駐程式處理。
  • 遊戲伺服器程序:由常駐程式啟動的實際伺服器(java、PalServer.exe 等)。

因此,你的日常操作會是這樣:

  1. 啟動 GUI,常駐程式會隨之啟動(若已在執行,GUI 會連接到它)。
  2. 朋友快要上線時,在伺服器畫面按下 啟動。
  3. 遊玩期間可以將視窗最小化或關閉。關閉時,你可以選擇 僅關閉介面(常駐程式繼續執行)或 全部結束(常駐程式也會停止)。若要讓伺服器繼續運作,請選擇 僅關閉介面。
  4. 玩完之後,再次開啟 GUI 並按下 停止。

關閉電腦也會關閉你的遊戲伺服器。常駐程式只在你自己的電腦上執行。若想要 24/7 全天候運作,請使用專用主機。


2. 建立第一個伺服器(快速摘要)

完整步驟請見 開始使用。簡而言之:

  1. 在 伺服器 畫面按下 新增伺服器。
  2. 選擇 作為新伺服器新增。若你已有伺服器資料夾,遷移現有伺服器 會改為連結它(檔案保留在原處)。
  3. 選擇遊戲(Minecraft / Palworld / Project Zomboid / Terraria 等),然後設定伺服器名稱與建議預設。
  4. 若遊戲有需要同意的條款,請在此同意。例如 Minecraft 需要先同意 Minecraft EULA 才能啟動伺服器(§3.7)。
  5. 按下 新增伺服器。伺服器檔案會自動下載,進度會顯示在伺服器畫面上。
  6. 安裝完成後,伺服器就會出現在清單中。

你可以隨意為 伺服器 命名,例如「和朋友的 Minecraft」、「週末 Zomboid」等等。在 Discord 指令中,可以用伺服器名稱或遊戲名稱(別名)指稱伺服器。伺服器停止時,可以用名稱旁的鉛筆按鈕重新命名。


3. 日常工作流程

選擇伺服器後,右側會開啟其畫面。上方是 啟動/停止 按鈕與狀態,下方是各分頁。出現哪些分頁取決於遊戲。

分頁內容
主控台伺服器輸出與指令輸入(僅限有主控台的遊戲)
命令遊戲定義的指令(例如 Palworld 公告、玩家清單)
設定遊戲設定(連接埠、最大人數、密碼等)
Saba-chanSaba-chan 管理伺服器的設定:自動重新啟動、記憶體上限、停止等待時間、啟動參數預覽、遊戲聊天轉送
備份與排程建立與還原備份、排程工作
紀錄誰在何時啟動、停止或傳送指令
Discord在 Discord 稱呼此伺服器與其指令的詞
資訊連接埠、版本、運作時間、最近的結束紀錄、伺服器檢查、開啟伺服器資料夾、刪除伺服器

3.1 啟動 / 停止 / 重新啟動

  • 啟動:常駐程式會先確認條款同意狀態並執行模組的檢查,然後啟動伺服器。若檢查發現嚴重問題,伺服器不會啟動,並會顯示原因。
  • 停止:傳送遊戲的正常停止指令(例如 Minecraft stop、Zomboid quit)並等待。若伺服器在停止等待時間內(預設 30 秒,依遊戲而異,可在 Saba-chan 分頁中變更)未結束,就會被強制終止。
  • 重新啟動:一次完成停止 → 啟動。已連線的玩家會短暫斷線。

3.2 查看主控台 / 傳送指令

  • 主控台 分頁會即時顯示遊戲伺服器的輸出。
  • 輸入指令並按下 Enter,即可將它送到 伺服器主控台(stdin)。Minecraft 範例:say hi!、op FriendNick。按 ↑ 可叫出先前的指令。
  • 指令依 stdin → REST → RCON 的順序傳送。沒有主控台的遊戲(例如只能透過 REST API 控制的 Palworld)則透過 命令 分頁中預先定義的指令操作。只有沒有其他路徑的遊戲才會使用 RCON,使用常駐程式為每個執行個體指派的連接埠與隨機密碼,且只透過迴路位址(127.0.0.1)連線。
  • 主控台可以彈出成獨立視窗,在 Windows 上 在終端機中開啟 會開啟 CLI 主控台。
  • 常駐程式會在記憶體中為每個伺服器保留最近的主控台行(最多 10,000 行),並同時寫入伺服器資料夾 logs/ 下的檔案。

3.3 同時執行多個伺服器

  • 你可以建立同一款遊戲的多個伺服器(例如「原版 MC」和「模組包 MC」),也可以同時執行不同的遊戲。
  • 每個伺服器的 連接埠(遊戲用來接受玩家連線的編號)不能重疊。建立新伺服器時,Saba-chan 會調整預設連接埠,避免與其他伺服器衝突;若連接埠確實重疊,伺服器畫面上會出現警告。你可以在 設定 分頁變更連接埠。
  • 每多一個伺服器,都會多使用電腦的記憶體和 CPU。新增前請先確認電腦的規格。

3.4 當機偵測與自動重新啟動

  • 伺服器結束時,常駐程式會判斷原因:手動停止、遊戲內停止、當機 或 原因不明。判定結果會記錄在 資訊 分頁的 最近的結束紀錄 中。
  • 若判定為 當機,預設會自動重新啟動伺服器。第一次重新啟動在 5 秒後進行,之後每次重新啟動的等待時間加倍。若 10 分鐘內重新啟動超過 3 次,就會停止重新啟動,需要你自己啟動伺服器。
  • 你可以在 Saba-chan 分頁的 自動重新啟動 中變更這些設定。
    • 當機後重新啟動:明確因錯誤而結束時(預設開啟)。
    • 原因不明時也重新啟動:也涵蓋無法判斷的情況,例如從工作管理員終止程序(預設關閉)。
  • 你自己從 Saba-chan 或在遊戲內停止的伺服器不會被重新啟動。

3.5 記憶體上限(Windows)

  • 在 Saba-chan 分頁的 記憶體上限 中,可以限制伺服器及其子程序合計可使用的記憶體(MB)。若超過上限,伺服器會被停止。
  • 留空表示不限制。對於 Java 伺服器,請設定為比 -Xmx 高 1–2 GB。
  • 僅限 Windows;在伺服器重新啟動後生效。

3.6 啟動參數預覽

  • 對於使用啟動參數的遊戲,Saba-chan 分頁的 啟動參數預覽 會顯示在目前設定下伺服器將以什麼命令列啟動,而不會實際啟動伺服器。
  • 在 額外參數 中輸入、但設定畫面上沒有的參數(例如 -players=16 -useperfthreads),會在啟動時原樣傳遞。格式錯誤的值會直接在預覽中標示。
  • 密碼等值會被遮蔽為 ***。

3.7 同意條款(Minecraft EULA 等)

  • 若遊戲伺服器有需要同意的條款,建立伺服器或第一次啟動時會出現 需要同意條款 對話框。請閱讀原文、勾選核取方塊,然後按下 同意並啟動。
  • 只能從這台電腦上的 GUI 或 CLI 給予同意。若有人在條款被同意前嘗試從 Discord 啟動伺服器,請先在電腦上同意條款。

4. 備份與排程工作

這些功能位於 備份與排程 分頁。排程工作在所有伺服器都能使用,備份清單與備份工作只有支援備份的遊戲才會出現。

4.1 備份

  • 立即備份 會壓縮世界與存檔。要儲存哪些內容由遊戲模組決定(Minecraft 是世界資料夾)。若伺服器正在執行,會先向遊戲傳送存檔指令(Minecraft save-all 等)。
  • 備份清單會顯示每個備份的種類:手動、排程、更新前、還原前。
  • 還原 只能在伺服器停止時使用。還原前會再備份一次目前狀態,因此即使選錯備份也能復原。
  • 手動備份不會被自動清理。其他備份(排程、更新前、還原前)最多保留 排程備份保留數量(預設 10 個),從最舊的開始刪除。
  • 備份檔案儲存在伺服器(實例)資料夾內。刪除伺服器也會刪除其備份,因此請將重要的備份複製到其他地方。

4.2 排程工作

使用 新增工作,可以依固定間隔(每 N 分鐘)或每天的指定時間(HH:MM,電腦的時區)自動執行下列工作。

工作作用
備份在伺服器執行時進行備份
重新啟動若伺服器正在執行則重新啟動
公告若伺服器正在執行,在遊戲內傳送訊息
更新檢查遊戲伺服器更新,若有則套用(若伺服器原本在執行則會重新啟動)
  • 重新啟動與更新工作可以事先在遊戲內 警告玩家(例如提前 10, 5, 1 分鐘)。公告與警告只在遊戲支援公告指令時可用。
  • 常駐程式重新啟動時,間隔型工作會從那時重新開始計時。常駐程式關閉期間錯過時間的工作,事後不會一併執行。

5. 讓朋友連線

如果你已架好遊戲伺服器,但朋友連不進來,幾乎都是以下三種情況之一。

5.1 在同一個 Wi-Fi(區域網路)的朋友

不需要額外設定。只要使用伺服器電腦的 私人 IP(例如 192.168.0.10)與連接埠連線即可。

5.2 外部的朋友:路由器支援連接埠轉發

連接埠轉發是路由器的一項設定,用來把外部的連線轉交給伺服器電腦。

  1. 在路由器的管理頁面,將遊戲連接埠轉發到伺服器電腦的私人 IP。
  2. 把位址 <公用 IP>:<連接埠> 告訴朋友。你可以在 whatismyip.com 等網站查詢你的公用 IP。
  3. 在 Windows 防火牆中,允許該連接埠的輸入流量(從外部進來的連線)。

5.3 外部的朋友:無法做連接埠轉發

學校或公司網路、ISP 的 CGNAT 之後以及訪客 Wi-Fi 上,連接埠轉發常常被封鎖。即使在這些網路上,你也可以透過 雲端中繼 從 Discord 啟動與停止伺服器。

  • 在 GUI 的 Discord 畫面,使用 連線 Discord 伺服器 取得代碼,然後在你的 Discord 伺服器中以 /saba connect 斜線指令輸入。
  • 之後,你的朋友就能從 Discord 啟動、停止伺服器或查看其狀態。
  • 詳細流程請見 Discord 機器人 & 雲端中繼。

雲端中繼只轉送 控制指令(啟動/停止/狀態等),不轉送遊戲流量。如果你的朋友無法直接連線到遊戲伺服器,可能還需要其他解決方案(例如 ZeroTier、Tailscale)。


6. 使用 Discord 機器人:一頁摘要

機器人配對完成後,許多日常操作都可以在 Discord 中完成,不必開啟 GUI。訊息指令的形式為 <前綴> <伺服器> <指令>,預設前綴是 Saba-chan(可在機器人設定中變更)。<伺服器> 請使用伺服器名稱或遊戲名稱(別名)。

情境在 Discord 中輸入(預設前綴)
「今天來開 MC 吧」Saba-chan minecraft start
「伺服器現在有開嗎?」Saba-chan minecraft status
「關掉吧」Saba-chan minecraft stop
「有哪些伺服器?」Saba-chan list
「我可以輸入什麼?」Saba-chan help

每個伺服器也會有自己的 /<伺服器名稱> 斜線指令。完整指令清單與別名註冊方法請見 指令 文件。

機器人本身的 設定、配對與中繼運作原理 請參見 Discord 機器人 & 雲端中繼。


7. 更新與清理

7.1 更新 Saba-chan

  • Saba-chan 會定期檢查已簽章的發行版清單,有新版本時會在 GUI 中顯示 有可用更新 通知。
  • 在 設定 → Saba 儲存 的 元件 分頁中,可以依元件(核心、模組、擴充功能等)下載並套用更新。對於必須替換執行中檔案的元件(例如核心),安裝程式(saba-chan-installer)會短暫停止常駐程式、替換檔案,然後只重新啟動有變更的部分。如果只有常駐程式有變更,應用程式視窗會保持原樣,只重新啟動常駐程式。
  • 由於常駐程式會重新啟動,建議在沒人使用的時段套用更新。

7.2 更新遊戲伺服器

  • 有新版本的遊戲伺服器可用時,伺服器畫面上會出現 更新 按鈕。可在伺服器停止時套用。
  • 會先自動建立 更新前 備份(適用於支援備份的遊戲)。
  • 你也可以使用 更新 排程工作(§4.2)在指定時間自動套用更新。

7.3 刪除伺服器

  • 在 資訊 分頁使用 刪除伺服器 刪除。伺服器必須停止後才能刪除。
  • 對於由 Saba-chan 下載並建立的伺服器,伺服器資料夾(包含遊戲伺服器檔案與備份)會被 完全刪除。請先複製你需要的世界或備份。
  • 對於以 遷移現有伺服器 連結的伺服器,原始資料夾中的遊戲檔案會保留在原處。

7.4 解除安裝 Saba-chan

  • 從 Windows 的 設定 → 應用程式 → 已安裝的應用程式 解除安裝 Saba-chan。
  • 解除安裝程式會先正常停止執行中的伺服器,然後移除安裝資料夾、資料資料夾(%APPDATA%\saba-chan\)與捷徑。由 Saba-chan 建立的伺服器檔案與備份預設也位於此資料資料夾中,因此請在解除安裝前複製你想保留的世界。勾選 Keep game servers 會保留伺服器檔案、世界、備份與各伺服器設定,勾選 Keep settings 會保留應用程式設定與 Discord 連線,重新安裝後可直接接續使用。若另一個 Saba-chan 安裝仍在使用資料資料夾,則不會刪除它。

8. 發生問題時

  • 如果主控台出現紅色的行,請先搜尋那則訊息本身。Saba-chan 會原樣顯示遊戲伺服器自身的輸出,不做任何修改。
  • 資訊 分頁的 檢查伺服器 與 診斷日誌 會檢查設定問題以及最近記錄中的已知錯誤。
  • 若仍無法解決,疑難排解 頁面整理了常見情境與處理方式。
  • 若遇到新問題,請連同主控台輸出一起到 GitHub Issues 回報。GUI 記錄儲存在 %APPDATA%\saba-chan\logs\,點擊上方的常駐程式狀態後出現的視窗中,可以用 開啟記錄資料夾 開啟該資料夾。附上這些檔案能讓診斷快很多。