如何在 Ubuntu 24.04 VPS 架設 Minecraft 伺服器

你要建置的內容

一台能穩定運作的 Minecraft Java Edition 伺服器：在 Ubuntu 24.04 上執行 Paper，由 systemd 以專用的 minecraft 使用者執行，啟用 Restart=on-failure，並在玩家與 JVM 之間的兩道防火牆上開放 25565 埠。備份也會以不損壞受保護世界的方式建立。伺服器本身只需要一個 jar 與一個 java 指令；一台能讓朋友持續遊玩一年的伺服器，和一台第一個週末就停止運作的伺服器之間，所有差異都在這個指令周圍，而本指南涵蓋的就是這些設定。

在花錢前，先了解兩項重要限制。第一，Minecraft 很耗用記憶體，而且大多數工作都在單一執行緒上完成：1 GB 的 VPS 無法執行可正常遊玩的伺服器，而一個高速核心比四個低速核心更重要。第二，這是Java Edition。Bedrock 玩家、遊戲主機、手機及 Windows Bedrock 應用程式都無法加入 Java 伺服器；Bedrock 需要使用不同的伺服器軟體並開放 UDP 19132 埠，或使用 Geyser 外掛，本指南不涵蓋這些內容。

你需要一台全新的 Ubuntu 24.04 KVM VPS，具備 root 或 sudo 權限，並預留約三十分钟。

硬體規模：朋友伺服器實際需要的資源

RAM 是關鍵數字，而實際需求通常低於模組包論壇所建議的數值：

• 2 GB 可在適中的視距下，讓 2–5 名玩家遊玩原版。可以運作，但沒有餘裕。
• 4 GB 是舒適的朋友伺服器規模：使用 Paper 搭配少量外掛時，可支援約 10 名同時在線的玩家，並為作業系統保留足夠資源。
• 8 GB 以上 適合模組包與 20 名以上玩家。此時也應重視單核心 CPU 速度，因為主要遊戲迴圈會在單一執行緒上執行。

玩家探索時，世界資料也會持續增加。經常探索的生存世界可能達到數 GB，因此應為世界資料及其備份預留餘裕。

原版還是 Paper？ Paper 是官方 jar 的直接替代品：使用相同的世界與用戶端，不需要用戶端模組。它會重寫最慢的伺服器處理路徑，包括區塊載入、實體 tick 與漏斗，並提供外掛 API。只有在需要完全符合原版機制的技術型 redstone 農場，而 Paper 的最佳化可能造成影響時，才有理由執行原版；對其他情況而言，Paper 能以每 GB 資源支援更多玩家。以下內容同樣適用於兩者。

安裝 Java 21

Minecraft 1.20.5 及後續所有版本（包括整個 1.21.x 系列）都需要 Java 21。Ubuntu 24.04 的預設套件庫已提供此版本，而 headless 版本會略過伺服器不會使用的桌面函式庫：

sudo apt update && sudo apt install -y openjdk-21-jre-headless
java -version

正確結果是第一行顯示 openjdk version "21.0.x"。如果顯示 17 或 11，表示系統已安裝其他 JRE，且目前優先使用該版本；請使用 sudo update-alternatives --config java 修正，並選取包含 java-21 的項目。

略過這項檢查，之後會遇到 Minecraft 伺服器最常被搜尋的錯誤。使用 Java 17 時，伺服器 jar 會立即結束：

Error: LinkageError occurred while loading main class net.minecraft.bundler.Main
	java.lang.UnsupportedClassVersionError: net/minecraft/bundler/Main has been
	compiled by a more recent version of the Java Runtime (class file version 65.0),
	this version of the Java Runtime only recognizes class file versions up to 61.0

這些數字代表版本不相容：class file version 65.0 是 Java 21，61.0 是 Java 17，60.0 是 Java 16。無論看到哪一組數字，修正方式都相同：安裝較新的 JRE，然後重新執行 update-alternatives。

步驟 2：使用專用使用者，絕不使用 root

伺服器會執行外掛程式碼，並解析任何能連線至該埠的來源所傳送的網路輸入。若發生問題，以 root 身分執行的入侵者就能完全控制您的 VPS；若以 minecraft 身分執行，則只能控制遊戲世界。

sudo adduser --system --group --home /opt/minecraft minecraft

--system 會建立無密碼帳號。此帳號無法透過 SSH 登入，並以 /opt/minecraft 作為家目錄與工作目錄。從現在起，所有會操作伺服器的命令都會以此使用者身分執行。

步驟 3：從官方來源下載伺服器 jar

伺服器 jar 只能從以下兩個來源取得：Vanilla 的 minecraft.net 官方伺服器下載頁面，以及 Paper 的 papermc.io 下載頁面。重新打包伺服器 jar 的第三方「下載中心」長期以來都是散播惡意軟體的管道。伺服器 jar 會在連線至網際網路的主機上 24/7 執行任意程式碼，因此必須審慎取得。

從官方頁面複製目前 build 的下載連結（URL 會隨每個版本與 build 變更，因此不應在此硬編碼），然後執行：

cd /opt/minecraft
sudo -u minecraft wget -O server.jar 'PASTE-THE-COPIED-URL-HERE'

正確結果：一個大小約為 50 MB、由 minecraft 擁有的 server.jar，並以 ls -lh /opt/minecraft/server.jar 完成確認。

步驟 4：首次執行、EULA 與取得管理員權限

在修改 systemd 之前，先以互動模式執行一次伺服器。首次執行只有兩項工作適合透過即時主控台完成。

cd /opt/minecraft
sudo -u minecraft java -Xms1G -Xmx1G -jar server.jar nogui

伺服器會在幾秒內結束。Paper 會先花費一些額外時間套用修補程式，接著日誌會以所有人都會看到的這一行結尾：

[ServerMain/INFO]: You need to agree to the EULA in order to run the server. Go to eula.txt for more info.

這不是錯誤，而是授權條件檢查。此次執行會在 jar 旁寫入 eula.txt。如果你尚未閱讀連結中的 EULA，請先閱讀，然後切換該旗標：

sudo -u minecraft sed -i 's/eula=false/eula=true/' /opt/minecraft/eula.txt

再次執行相同的 java 命令。這次伺服器會建立世界。首次啟動可能需要 1 或 2 分鐘，最後會停在：

[Server thread/INFO]: Done (9.204s)! For help, type "help"

現在你已取得即時主控台。利用它完成第二項工作：輸入 op YourMinecraftName（你在遊戲中的完整使用者名稱），伺服器會將你寫入 ops.json。如此一來，之後即使沒有連接主控台，你仍可在遊戲內執行所有管理命令。接著輸入 stop，以正常方式儲存並離開。

第 5 步：server.properties，以及為什麼 online-mode 應維持 true

第一次執行時也會寫入 server.properties。大多數預設值都可以直接使用；以下設定值得明確決定：

online-mode=true
white-list=true
enforce-whitelist=true
view-distance=8
max-players=10
motd=A private server for people I actually know

online-mode=true 會要求伺服器向 Mojang 的工作階段伺服器驗證每個加入者的使用者名稱，以確認玩家擁有該帳號。將其設為 false，也就是「cracked server」切換選項，代表伺服器會接受用戶端自行聲稱的身分：任何人都能以任意名稱加入，包括你的名稱。由於 op 與白名單都是依名稱指定，冒用者便能以你的 operator 權限進入伺服器。唯一合理的停用情境，是伺服器位於 Velocity 這類會自行驗證玩家的驗證代理後方。在一般伺服器上，這項設定應維持 true，不要更改。

view-distance 是此檔案中影響效能最大的設定。CPU 與 RAM 的成本大致會隨其平方增加。8 是合理的 VPS 預設值；10 是 vanilla 的預設值，負載會明顯較高。

white-list=true 加上 enforce-whitelist=true 可禁止陌生人加入伺服器，以下的安全性章節會說明這不是可選設定。以 op 身分在遊戲內使用 /whitelist add TheirName 新增玩家。

步驟 6：記憶體旗標，為什麼 -Xms 和 -Xmx 應設為相同值

JVM 會將 heap 配置在 -Xms（起始大小）與 -Xmx（上限）之間。對專用遊戲伺服器，請將兩者設為相同值：heap 最終本來就會達到上限，分階段擴增只會在遊戲進行期間增加 garbage collector 的負擔。對 4 GB VPS，適合的設定如下：

/usr/bin/java -Xms3G -Xmx3G -jar server.jar nogui

-Xmx 並不是程序使用的總記憶體。JVM 還會為 off-heap 額外配置空間，包括執行緒堆疊、JIT 快取與 direct buffer，通常至少需要約半 GB；Ubuntu 本身也需要保留記憶體。實務上的原則是：-Xmx 最多設為 VPS RAM 減去 1 GB。設定過大會導致以下其中一種錯誤。若一開始就無法完成配置，伺服器會拒絕啟動，並顯示：

Error: Could not reserve enough space for object heap

這種錯誤會立即明確出現。另一種情況更難排查：伺服器一開始能正常啟動，數小時後在負載增加、heap 填滿時停止運作。此時 kernel 的 OOM killer 會選擇主機上占用記憶體最多的程序，也就是 JVM。伺服器日誌中不會出現任何內容；證據位於 sudo dmesg | grep -i oom，其中會有類似 Out of memory: Killed process 1234 (java) 的一行。如果服務「隨機」重新啟動，請先檢查該處，並降低 -Xmx。

對 Paper 而言，專案文件提供 Aikar's flags，這是一組經過調校的 G1GC 設定（-XX:+UseG1GC -XX:MaxGCPauseMillis=200 及其他十多個旗標），可讓較大 heap 的 garbage-collection 暫停更平順。請依照 Paper 文件產生完整設定列；對 2–4 GB heap 而言，改善幅度有限，但這些旗標不會造成問題。

步驟 7：使用 Restart=on-failure 的 systemd unit

手動啟動的伺服器會隨著 SSH 工作階段結束而停止，重新開機後也不會再次啟動。建立 /etc/systemd/system/minecraft.service：

[Unit]
Description=Minecraft server (Paper)
After=network-online.target
Wants=network-online.target

[Service]
User=minecraft
Group=minecraft
WorkingDirectory=/opt/minecraft
ExecStart=/usr/bin/java -Xms3G -Xmx3G -jar server.jar nogui
Restart=on-failure
RestartSec=10
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now minecraft
systemctl status minecraft
journalctl -u minecraft -f

正確結果是：status 顯示 active (running)，而現在包含伺服器主控台輸出的 journal，會再次停在 Done 行。

這個 unit 有兩個刻意的設定。Restart=on-failure 會在伺服器當機後重新啟動，但不會在正常 stop 後重新啟動，因此仍可進行維護。TimeoutStopSec=120 的重要性也超出表面：systemctl stop 會傳送 SIGTERM，Minecraft server 會攔截該訊號，並在結束前儲存所有世界；大型世界的儲存作業需要一些時間。Systemd 的預設逾時可能會在儲存期間對 JVM 傳送 SIGKILL，這正是造成 region files 損毀的方式。請將逾時設為兩分鐘。

如果服務反覆啟停，而 journal 顯示：

[Server thread/WARN]: **** FAILED TO BIND TO PORT!
[Server thread/WARN]: The exception was: io.netty.channel.unix.Errors$NativeIoException: bind(..) failed: Address already in use
[Server thread/WARN]: Perhaps a server is already running on that port?

表示已有程序占用 25565。幾乎總是因為先前在前景執行的程序仍在另一個 SSH 工作階段中執行。使用 sudo ss -tlnp | grep 25565 找出該程序，並停止那個副本；同一個埠上不要執行兩台伺服器。

步驟 8：在兩層防火牆上開放 25565

Minecraft Java 僅使用 TCP 25565（UDP 只是選用的查詢協定，預設未啟用）。在 VPS 上執行：

sudo ufw allow OpenSSH
sudo ufw allow 25565/tcp
sudo ufw enable

這是第一層防火牆。大多數 VPS 供應商會在控制面板中提供第二層網路防火牆，這正是最容易遺漏的部分。也要在該防火牆上開放 TCP 25565。只開放其中一層時，症狀通常很難判斷：用戶端會停在「正在連線到伺服器……」，接著以 Connection timed out: no further information 失敗，沒有拒絕連線、沒有伺服器錯誤，journal 中也沒有任何記錄，因為封包根本沒有抵達。請從 VPS 外部的機器使用 nc -vz your.server.ip 25565 驗證；succeeded 表示兩層防火牆都已開放，若連線停滯，表示至少有一層尚未開放。

在 ufw 中進行設定時，請注意同一台主機也會透過公開 IP 執行 SSH。通常幾小時內就會開始出現大量暴力破解日誌。請在忘記之前，先在 Ubuntu 24.04 為 SSH 設定 Fail2ban。

現在連線：Multiplayer、Direct Connection，然後輸入伺服器 IP。由於你已在步驟 4 將自己的帳號設為 op，遊戲內指令會立即生效；每位玩家使用 /whitelist add FriendName，若這是你的規劃，則使用 /gamemode creative。

步驟 9：設定白名單，因為網際網路會搜尋 25565 埠

讓 Minecraft 伺服器直接暴露在網際網路上並非理論上的風險：大量掃描器會持續掃描整個 IPv4 位址空間中的 25565 埠，業餘惡作劇專案也曾藉此建立數十萬台開放伺服器的清單，而未設定白名單的伺服器通常在數天內、有時甚至數小時內，就會有未受邀請的訪客進入。步驟 5 的白名單就是解決方案：online-mode=true 可驗證身分，白名單則將進入權限限制在你指定的身分。這兩項構成完整的安全模型，對朋友使用的伺服器而言已經足夠。

若要在不啟動遊戲的情況下存取主控台、執行指令碼備份或使用 cron 工作，請在 server.properties 中啟用 RCON（enable-rcon=true、強式 rcon.password、25575 埠），並直接在 VPS 上從其 GitHub 原始碼建置小型 mcrcon 用戶端；Ubuntu 的套件庫中沒有此程式。請勿在任何防火牆中開放 25575：RCON 會以明文傳送密碼，因此只能繫結至 loopback。

步驟 10：不會破壞世界的備份

唯一的規則是：絕對不要在伺服器寫入世界目錄時複製該目錄。 遊玩期間會持續改寫區域檔案；如果 tar 與寫入作業同時進行，會產生包含未完整寫入區塊的封存檔。日後還原時，偏偏在備份必須正常運作的時刻，日誌會充滿區塊載入錯誤，地形也會出現缺口。遵守以下兩種方式即可避免問題。

停止－複製－啟動是最簡單的方法，但會造成約 1 分鐘的停機：

sudo systemctl stop minecraft
sudo mkdir -p /opt/backups
sudo tar czf /opt/backups/world-$(date +%F-%H%M).tgz \
  -C /opt/minecraft world world_nether world_the_end
sudo systemctl start minecraft

（Paper 會將維度分為 world、world_nether 和 world_the_end；原版伺服器會將所有內容保存在 world，因此將另外兩個維度放到該處。）

Save-off 可在伺服器運作期間進行備份：透過 RCON 執行 save-off（停止自動儲存），接著執行 save-all flush（強制將所有資料寫入磁碟並等待），建立 tar 封存檔，最後執行 save-on。這是適合放入 cron、在凌晨 5 點執行的版本。

無論採用哪種方式，存放在與伺服器相同 VPS 上的備份都不算備份。請 scp 或 rclone 將封存檔移出該伺服器，並保留多份備份。由於發生故障時你不會一直盯著主控台，也應在外部監控連接埠：使用另一台伺服器上的 Uptime Kuma對 25565 執行 TCP 檢查，便能在玩家發現前得知伺服器已停止運作。

外掛與升級

對 Paper 而言，外掛就是放入 /opt/minecraft/plugins/ 的 jar 檔，然後重新啟動；安裝流程就這麼簡單。外掛只能從官方專案頁面（Hangar、Modrinth、SpigotMC）取得，理由與伺服器 jar 相同：每個外掛都是以 minecraft 使用者身分執行的任意程式碼。

升級伺服器的流程是：停止服務、建立備份、將 server.jar 替換為支援新 Minecraft 版本的 build，然後啟動。請注意兩點。世界升級是單向的；使用較新版本開啟過的世界，無法再由較舊版本開啟，這也是備份的用途之一。外掛通常會比新的 Minecraft 版本晚數天或數週提供支援，因此在第一天追著安裝新版本前，請先確認相容性。

如果您希望以容器管理所有這些項目，可以將版本固定、EULA 同意設定及記憶體旗標設為環境變數。廣泛使用的 itzg/minecraft-server image 會在 VPS 上透過 Docker Compose 管理 VPS 上的服務 執行相同的 Paper 伺服器，並沿用相同的防火牆與備份規範。

FAQ

Minecraft 伺服器需要多少 RAM？

2 GB 可供 2–5 名玩家執行原版伺服器；4 GB 足以讓約 10 名朋友在 Paper 上使用含少量 plugins 的伺服器；modpacks 與 20 名以上玩家則需要 8 GB 或更多。無論 VPS 的大小為何，請將 -Xmx 設為不超過總 RAM 減去 1 GB。JVM 會在 heap 之外使用記憶體，設定過高最終會導致 Error: Could not reserve enough space for object heap 或靜默的 OOM kill。

為什麼朋友無法連線到我的 Minecraft 伺服器？

用戶端卡住並以 Connection timed out: no further information 結束，幾乎總是表示防火牆問題，而且這裡有兩層防火牆：VPS 上的 ufw，以及供應商控制面板中的網路防火牆。TCP 25565 必須在兩者中都開放。先在伺服器上使用 sudo ss -tlnp | grep 25565 確認服務確實正在監聽，再從外部使用 nc -vz your.server.ip 25565 測試。

我應該在 server.properties 中設定 online-mode=false 嗎？

不應該。使用 online-mode=false 時，伺服器會完全略過 Mojang 驗證，因此任何人都能以任意使用者名稱加入，包括冒用 op 的名稱並繼承其權限；skins 與穩定的 UUID 也會失效。唯一合理的用途，是放在會自行驗證玩家身分的 Velocity 等驗證 proxy 後方。一般伺服器應維持 true。

Paper 比原版 Minecraft 伺服器好嗎？

對幾乎所有人而言，是的。Paper 是可直接替換的 jar，可載入原版世界、接受未修改的用戶端、更有效率地處理 entities 與載入 chunks，並提供 plugin 生態系。例外是需要位元級原版行為的 technical-redstone 社群，因為部分 Paper 最佳化會改變這些行為。在小型 VPS 上，Paper 的效率等同於免費增加可用的 RAM。

如何在不損壞 Minecraft 世界的情況下進行備份？

伺服器寫入世界目錄時，絕對不要同時封存該目錄。複製作業若與 region-file 寫入競速，會產生損壞的 chunks，而這些問題通常要到還原時才會發現。你可以停止伺服器、使用 tar 封存世界目錄，再重新啟動；或使用 save-off、save-all flush、tar，以及透過 RCON 的 save-on，在伺服器持續運作時完成備份。接著將封存檔移出 VPS。