הקמת שרת Minecraft על Ubuntu 24.04: מדריך מלא

מה אתם בונים

שרת Minecraft Java Edition יציב: Paper על גבי Ubuntu 24.04, שרץ כמשתמש minecraft ייעודי תחת systemd עם Restart=on-failure, רשימת לבנים (whitelist) פעילה, פורט 25565 פתוח בשני ה-firewalls שבין השחקנים לבין ה-JVM, וגיבויים שמתבצעים באופן שאינו משחית את עולם המשחק שהם נועדו להגן עליו. השרת עצמו מורכב מקובץ jar אחד ופקודת java אחת; כל מה שמבדיל בין שרת שחברים משחקים בו במשך שנה לבין שרת שקורס בסוף השבוע הראשון סובב סביב הפקודה הזו, וזה בדיוק מה שמדריך זה מכסה.

שתי אזהרות כנות לפני שאתם מוציאים כסף. ראשית, Minecraft צורך זיכרון רב ומתבסס בעיקר על ליבה בודדת: שרת VPS עם 1 GB זיכרון לא יריץ שרת שניתן לשחק בו, וליבה אחת מהירה עדיפה על ארבע איטיות. שנית, מדובר ב-Java Edition. שחקני Bedrock, קונסולות, טלפונים ואפליקציית ה-Bedrock של Windows לא יכולים להתחבר לשרת Java; גרסת Bedrock דורשת תוכנת שרת שונה על פורט UDP 19132, או את התוסף Geyser, שאינם נכללים במדריך זה.

אתם זקוקים לשרת VPS מסוג KVM עם Ubuntu 24.04 טרייה, גישת root או sudo, וכשלושים דקות פנויות.

גודל השרת: מה ששרת לחברים באמת צריך

זיכרון RAM הוא הנתון הקריטי, והמספרים הריאליים נמוכים מאלו שפורומים של modpacks נוטים להציע:

• 2 GB יריצו שרת vanilla עבור 2–5 שחקנים עם מרחק תצוגה צנוע. זה שחיק, אך ללא מרווח נשימה.
• 4 GB הוא הגודל הנוח לשרת חברים: כעשרה שחקנים בו-זמנית על Paper עם מספר תוספים, ודי והותר משאבים עבור מערכת ההפעלה.
• 8 GB ומעלה מיועדים ל-modpacks ולמעל 20 שחקנים. כאן יש לתת דגש גם על מהירות ליבה בודדת של ה-CPU, כיוון שלולאת המשחק הראשית רצה על thread אחד בלבד.

עולם המשחק גדל על הדיסק ככל שהשחקנים חוקרים אותו; עולם הישרדות פעיל יכול להגיע לנפח של כמה גיגה-בייטים, לכן יש להשאיר מרווח נשימה עבור העולם ועבור הגיבויים שלו.

Vanilla או Paper?
Paper הוא תחליף ישיר ל-jar הרשמי: אותם עולמות, אותם לקוחות, ואין צורך ב-mods בצד הלקוח. הוא משכתב את הנתיבים האיטיים ביותר בשרת, כגון טעינת chunks, חישובי ישויות (entity ticking) ו-hoppers, ומוסיף API לתוספים. הסיבה היחידה להריץ vanilla היא אם אתם זקוקים למכניקה מדויקת של המשחק עבור חוות redstone טכניות, שכן האופטימיזציות של Paper עשויות לשנות אותן; עבור כל השאר, Paper מאפשר יותר שחקנים לכל גיגה-בייט. כל מה שמתואר להלן עובד עבור שניהם.

שלב 1: התקנת 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 מספר 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 של שרת: דף ההורדות הרשמי ב-minecraft.net עבור גרסת ה-vanilla, ודף ההורדות ב-papermc.io עבור Paper. "מרכזי הורדות" צד-שלישי האורזים מחדש קובצי שרת הם ערוץ הפצה ותיק לתוכנות זדוניות; קובץ jar של שרת הוא קוד שרירותי שאתם עומדים להריץ 24/7 על שרת החשוף לאינטרנט.

העתיקו את קישור ההורדה של הגרסה העדכנית מהאתר הרשמי (ה-URL משתנה בכל גרסה ובכל build, לכן קיבוע שלו כאן יוביל לקישור שבור), ולאחר מכן:

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

תוצאה תקינה: קובץ server.jar בגודל של כ-50 MB בבעלות minecraft, מאומת באמצעות 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.

זו אינה שגיאה; זהו מחסום רישוי. ההרצה יצרה את הקובץ eula.txt לצד קובץ ה-jar. קראו את ה-EULA המקושר אם טרם עשיתם זאת, ולאחר מכן שנו את הדגל:

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

הריצו שוב את אותה פקודת java. הפעם השרת ייצור את העולם – תהליך של דקה או שתיים בהפעלה הראשונה – ויעצור בשורה:

[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 גורם לשרת לאמת כל שם משתמש שמתחבר מול שרתי ה-session של Mojang, ובכך מוכיח שהשחקן הוא אכן בעל החשבון. הגדרתו ל-false, המכונה "שרת פרוץ" (cracked server), משמעותה שהשרת מקבל את הצהרת הלקוח לגבי זהותו: כל אחד יכול להתחבר בכל שם, כולל השם שלך. מכיוון שהרשאות מנהל (ops) ורשימות לבנות (whitelists) מבוססות על שמות, מתחזה יכול להיכנס עם הרשאות הניהול שלך. הסיבה הלגיטימית היחידה להגדיר זאת כ-false היא מאחורי proxy מאמת כמו Velocity, שמבצע אימות שחקנים בעצמו. בשרת רגיל, הערך נשאר true, נקודה.

view-distance הוא הגורם המשפיע ביותר על הביצועים בקובץ; צריכת ה-CPU וה-RAM גדלה בערך לפי ריבוע הערך הזה. 8 הוא ערך ברירת מחדל סביר ל-VPS; 10 הוא ערך ברירת המחדל של המשחק המקורי והוא כבד יותר באופן מורגש.

white-list=true יחד עם enforce-whitelist=true חוסמים את השרת בפני זרים, צעד שסעיף האבטחה להלן מבהיר שאינו אופציונלי. הוסיפו שחקנים באמצעות /whitelist add TheirName בתוך המשחק כ-op.

שלב 6: דגלי זיכרון, מדוע -Xms ו- -Xmx צריכים להיות זהים

ה-JVM מקצה את ה-heap שלו בין -Xms (גודל התחלתי) לבין -Xmx (תקרה). בשרת משחק ייעודי, הגדירו אותם לאותו ערך: ה-heap יגיע לתקרה בכל מקרה, והגדלה שלו בשלבים רק מוסיפה עומס מיותר של garbage collector במהלך המשחק. בשרת VPS עם 4 GB, הזוג הנכון הוא:

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

-Xmx הוא לא סך הזיכרון שהתהליך צורך. ה-JVM מוסיף תקורה מחוץ ל-heap (off-heap), מחסניות thread, מטמוני JIT, ו-buffers ישירים, בערך של חצי ג'יגה-בייט או יותר, וגם Ubuntu עצמה זקוקה למקום. כלל האצבע: -Xmx לכל היותר הוא זיכרון ה-VPS פחות 1 GB. חריגה מהגבול הזה תוביל לאחד משני כשלים. אם ההקצאה נכשלת מראש, השרת יסרב לעלות עם השגיאה:

Error: Could not reserve enough space for object heap

שגיאה זו היא ישירה וברורה. הגרסה הבעייתית יותר מתחילה לעבוד כרגיל וקורסת שעות לאחר מכן, כאשר ה-heap מתמלא תחת עומס וה-OOM killer של ה-kernel בוחר בתהליך הגדול ביותר במערכת, ה-JVM. שום דבר לא יופיע בלוג של השרת; העדות נמצאת ב-sudo dmesg | grep -i oom, שורה כמו Out of memory: Killed process 1234 (java). אם השירות שלכם מבצע restart "באופן אקראי", בדקו שם תחילה, והנמיכו את -Xmx.

עבור Paper, הפרויקט מתעד את Aikar's flags, סט של הגדרות G1GC מכוונות (-XX:+UseG1GC -XX:MaxGCPauseMillis=200 ועוד תריסר דגלים נלווים) שמחליק את השהיות ה-garbage-collection ב-heap גדולים. צרו את שורת הפקודה המלאה מתוך התיעוד של Paper; ב-heap של 2–4 GB השיפור צנוע, אך הדגלים אינם מזיקים.

שלב 7: יחידת systemd עם Restart=on-failure

שרת שמופעל ידנית נסגר עם סיום סשן ה-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.

ישנן שתי בחירות מכוונות ביחידה זו. Restart=on-failure מחזיר את השרת לפעולה לאחר קריסה, אך לא לאחר stop יזום, כך שתחזוקה נשארת אפשרית. ו-TimeoutStopSec=120 חשוב יותר ממה שנראה: systemctl stop שולח SIGTERM, שרת ה-Minecraft קולט אותו ושומר את כל העולמות לפני היציאה; בעולם גדול, שמירה זו אורכת זמן. ה-timeout המוגדר כברירת מחדל ב-systemd עלול לשלוח SIGKILL ל-JVM באמצע השמירה, וזו בדיוק הדרך שבה קובצי region נפגמים. הקצו לכך שתי דקות.

אם השירות קורס שוב ושוב (flapping) וה-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 בשני ה-firewalls

Minecraft Java משתמש ב-TCP 25565 בלבד (UDP הוא פרוטוקול שאילתות אופציונלי, המושבת כברירת מחדל). ב-VPS:

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

זהו ה-firewall הראשון. רוב ספקי ה-VPS מפעילים firewall נוסף ברמת הרשת בלוח הבקרה, וזהו הרכיב שאנשים נוטים לשכוח. פתחו את TCP 25565 גם שם. התסמין של פתיחת פורט באחד בלבד הוא מתסכל ולא ספציפי: ה-client נתקע על "Connecting to the server..." ונכשל עם Connection timed out: no further information, ללא סירוב, ללא שגיאת שרת, וללא כל רישום ב-journal, כיוון שהחבילות מעולם לא הגיעו. בצעו אימות ממכונה מחוץ ל-VPS באמצעות nc -vz your.server.ip 25565; התוצאה succeeded מעידה על כך ששני ה-firewalls פתוחים, בעוד תקיעה מעידה על כך שלפחות אחד מהם חסום.

בזמן שאתם ב-ufw, זכרו שהשרת מריץ SSH על כתובת IP ציבורית, ורעש ה-log מניסיונות brute-force יתחיל בתוך שעות ספורות. הגדירו Fail2ban עבור SSH ב-Ubuntu 24.04 לפני שתשכחו.

כעת התחברו: Multiplayer, Direct Connection, והזינו את כתובת ה-IP של השרת. מכיוון שהענקתם לעצמכם הרשאות op בשלב 4, פקודות בתוך המשחק יעבדו מיד; השתמשו ב-/whitelist add FriendName עבור כל שחקן, או ב-/gamemode creative אם זהו התכנון.

שלב 9: רשימת מורשים (whitelist), כי האינטרנט סורק את פורט 25565

השארת שרת Minecraft חשוף לאינטרנט אינה סיכון תיאורטי: סורקים המוניים בוחנים ללא הרף את כל מרחב ה-IPv4 בחיפוש אחר פורט 25565. פרויקטים של משתמשים המבצעים "griefing" מיפו בדרך זו מאות אלפי שרתים פתוחים, ושרת ללא רשימת מורשים ימשוך מבקרים לא קרואים תוך ימים, ולעיתים תוך שעות. רשימת המורשים מהשלב ה-5 היא הפתרון: online-mode=true מוכיח את הזהות, ורשימת המורשים מגבילה את הכניסה לזהויות שבחרתם. שילוב זה מהווה את מודל האבטחה המלא, והוא מספיק עבור שרת המיועד לחברים.

לצורך גישה לקונסולה ללא הפעלת המשחק, ביצוע גיבויים מתוסרטים או הגדרת cron job, יש להפעיל RCON בתוך server.properties (השתמשו ב-enable-rcon=true, ב-rcon.password חזק, ובפורט 25575) ולבנות את הלקוח הקטן mcrcon מתוך קוד המקור שלו ב-GitHub ישירות על ה-VPS; הוא אינו זמין במאגרים של Ubuntu. אין לפתוח את פורט 25575 באף firewall: פרוטוקול RCON שולח את הסיסמה בטקסט גלוי (cleartext), לכן עליו להישאר מוגבל ל-loopback בלבד.

שלב 10: גיבויים שלא משחיתים את העולם

הכלל היחיד: לעולם אל תעתיקו ספריית עולם בזמן שהשרת כותב אליה. קובצי ה-region נכתבים מחדש ללא הרף במהלך המשחק; פעולת tar שמתבצעת במקביל לכתיבה מייצרת ארכיון עם "צ'אנקים" (chunks) חלקיים. כאשר תשחזרו את הגיבוי ברגע האמת, הלוג יתמלא בשגיאות טעינת צ'אנקים והשטח יכיל חורים. שתי שיטות מונעות זאת.

עצירה-העתקה-הפעלה היא הדרך הפשוטה, במחיר של דקת השבתה:

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; שרת vanilla שומר הכל ב-world, לכן השמיטו את השניים האחרים במקרה כזה.)

Save-off מאפשר גיבוי בזמן אמת: דרך RCON, הריצו את הפקודה save-off (עצירת השמירה האוטומטית), לאחר מכן save-all flush (כתיבת כל הנתונים לדיסק והמתנה לסיום), בצעו את ה-tar, ולבסוף save-on. זו הגרסה שמומלץ להוסיף ל-cron בשעה 5 בבוקר.

כך או כך, גיבוי שנמצא על אותו ה-VPS של השרת אינו נחשב לגיבוי. השתמשו ב-scp או ב-rclone כדי להוציא את הארכיונים מהשרת, ושמרו יותר מעותק אחד. ומכיוון שלא תמיד תסתכלו על הקונסולה כשמשהו משתבש, הגדירו בדיקה חיצונית לפורט: Uptime Kuma על שרת אחר שמבצע בדיקת TCP מול 25565 יתריע שהשרת למטה עוד לפני שהשחקנים שלכם יבחינו בכך.

תוספים ושדרוגים

ב-Paper, תוסף הוא קובץ jar שמועבר ל-/opt/minecraft/plugins/ ולאחריו נדרש אתחול; זהו כל תהליך ההתקנה. יש להוריד תוספים אך ורק מדפי הפרויקט הרשמיים שלהם (Hangar, Modrinth, SpigotMC), מאותה סיבה שחלה על קובץ ה-server jar: כל אחד מהם הוא קוד שרירותי המורץ תחת המשתמש minecraft.

שדרוג השרת מתבצע כך: עצירה, גיבוי, החלפת server.jar בגרסה המיועדת לגרסת ה-Minecraft החדשה, והפעלה מחדש. יש לשים לב לשני דגשים. שדרוגי עולם הם חד-כיווניים; עולם שנפתח בגרסה חדשה לא ייפתח בגרסה ישנה, וזו סיבה נוספת לחשיבות הגיבויים. כמו כן, תוספים נוטים לפגר אחרי שחרור גרסה חדשה של Minecraft בימים או בשבועות, לכן יש לבדוק תאימות לפני שממהרים לשדרג ביום השחרור.

אם אתם מעדיפים לנהל את כל זה בתוך מכולה, עם קיבוע גרסאות, אישור EULA והגדרת דגלי זיכרון כמשתני סביבה, התמונה itzg/minecraft-server הנפוצה מריצה את אותו שרת Paper תחת Docker Compose ב-VPS שלכם עם אותה משמעת של firewall וגיבויים.

FAQ

כמה זיכרון RAM דרוש לשרת Minecraft?

עבור גרסת vanilla, נפח של 2 GB יספיק ל-2–5 שחקנים; נפח של 4 GB יאפשר עבודה נוחה לשרת חברים של כעשרה שחקנים המריץ 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 מעידה כמעט תמיד על בעיית firewall, וישנם שניים כאלו: ufw ב-VPS ו-firewall הרשת של ספק השרת בלוח הבקרה. יש לפתוח את פורט TCP 25565 בשניהם. ודאו שהשרת אכן מאזין באמצעות sudo ss -tlnp | grep 25565 על השרת, ולאחר מכן בצעו בדיקה מבחוץ בעזרת nc -vz your.server.ip 25565.

האם עליי להגדיר online-mode=false בקובץ server.properties?

לא. עם online-mode=false השרת מדלג לחלוטין על אימות מול Mojang, כך שכל אחד יכול להצטרף תחת כל שם משתמש, כולל שם של op, ובכך לרשת את ההרשאות שלו; בנוסף, סקינים ו-UUIDs יציבים יפסיקו לעבוד. השימוש הלגיטימי היחיד הוא מאחורי proxy מאמת כמו Velocity שמבצע את אימות השחקנים בעצמו. עבור שרת רגיל, יש להשאיר את ההגדרה כ-true.

האם Paper עדיף על שרת ה-Minecraft בגרסת ה-vanilla?

עבור כמעט כולם, כן: Paper הוא קובץ jar חלופי הטוען עולמות vanilla, מקבל לקוחות ללא שינוי, מבצע חישובי ישויות וטעינת chunks ביעילות רבה יותר, ומוסיף את מערכת התוספים. היוצא מן הכלל הוא קהילות redstone טכניות הזקוקות להתנהגות vanilla מדויקת ברמת הביט, שחלק מהאופטימיזציות של Paper משנות. ב-VPS קטן, היעילות של Paper שקולה לתוספת RAM בחינם.

כיצד אוכל לגבות עולם Minecraft מבלי להשחית אותו?

לעולם אל תבצעו ארכיון לתיקיית העולם בזמן שהשרת כותב אליה; העתקה המתחרה עם כתיבה לקובץ region יוצרת chunks מושחתים שתגלו רק בעת השחזור. עליכם לעצור את השרת, לבצע tar לתיקיות העולם ולהפעיל אותו מחדש, או להשאיר אותו פעיל בעזרת save-off, save-all flush, tar, ו-save-on דרך RCON. לאחר מכן, העבירו את הארכיון מחוץ ל-VPS.