איך מתקינים ומגדירים txAdmin לשרת FiveM בצורה נכונה
txAdmin הוא פאנל הניהול הרשמי של FXServer, ומאפשר לנהל את שרת ה־FiveM דרך הדפדפן בצורה נוחה ופשוטה.
באמצעות txAdmin ניתן:
• להפעיל ולעצור את השרת
• לבצע Restart
• לנהל שחקנים
• לבצע Ban / Kick
• לצפות בקונסול
• לנהל Resources
• לבצע Scheduled Restarts
• לצפות בביצועי השרת
• לנהל הרשאות Admin
• לנהל הגדרות שונות של השרת
חשוב לדעת:
אין צורך להתקין txAdmin בנפרד.
בגרסאות המודרניות של FXServer, txAdmin כבר מגיע מובנה בתוך FXServer.
לכן הדרך הנכונה היא להתקין FXServer ולהפעיל אותו בצורה שתפעיל גם את txAdmin.
1. עדכון השרת
במדריך הזה אנחנו משתמשים ב־Ubuntu / Debian.
התחברו לשרת באמצעות SSH והריצו:
apt update && apt upgrade -yלאחר מכן התקינו את החבילות הדרושות:
apt install wget curl git xz-utils screen -y2. יצירת תיקייה ל־FiveM
ניצור תיקייה מסודרת לשרת:
mkdir -p /home/fivem/serverנעבור אליה:
cd /home/fivem/server3. הורדת FXServer
יש להוריד את גרסת ה־Recommended העדכנית של FXServer עבור Linux.
ניתן למצוא את ה־Artifacts הרשמיים של FiveM באתר Cfx.re.
לאחר שמצאתם את גרסת ה־Recommended, העתיקו את קישור ההורדה.
לאחר מכן הריצו:
wget "ARTIFACT_URL" -O fx.tar.xzיש להחליף את:
ARTIFACT_URLבקישור שהעתקתם.
לדוגמה:
wget "https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/XXXXX/fx.tar.xz" -O fx.tar.xz4. חילוץ FXServer
לאחר שההורדה הסתיימה:
tar -xf fx.tar.xzלאחר מכן ניתן למחוק את קובץ ההתקנה:
rm fx.tar.xz5. הפעלה ראשונה של txAdmin
זה אחד השלבים החשובים ביותר במדריך.
בהפעלה הראשונה של השרת אל תריצו:
./run.sh +exec server.cfgבמקום זאת, הפעילו:
./run.shכאשר FXServer מופעל בצורה הזאת, הוא יעלה את txAdmin ויאפשר לבצע את ההגדרה הראשונית.
6. הפעלה באמצעות Screen
אם אתם רוצים שהשרת ימשיך לפעול גם לאחר שתסגרו את חלון ה־SSH, ניתן להשתמש ב־Screen.
צרו Screen חדש:
screen -S fivemעברו לתיקיית השרת:
cd /home/fivem/serverוהפעילו:
./run.shכדי לצאת מה־Screen מבלי לסגור את השרת, לחצו:
CTRL + Aולאחר מכן:
Dכדי לחזור ל־Screen:
screen -r fivemכדי לראות את כל ה־Screens הפעילים:
screen -ls7. כניסה ל־txAdmin
לאחר ההפעלה הראשונית, txAdmin יתחיל לפעול.
פורט ברירת המחדל של txAdmin הוא:
40120לכן בדפדפן יש להיכנס ל:
http://SERVER-IP:40120לדוגמה:
http://123.123.123.123:40120יש להחליף את:
SERVER-IPבכתובת ה־IP של השרת שלכם.
8. פתיחת פורטים
אם אתם משתמשים ב־UFW, יש לפתוח את הפורטים של FiveM ושל txAdmin.
פתחו את פורט txAdmin:
ufw allow 40120/tcpפתחו את פורט FiveM ב־TCP:
ufw allow 30120/tcpפתחו את פורט FiveM ב־UDP:
ufw allow 30120/udpלבדיקת החוקים:
ufw statusהפורטים העיקריים הם:
txAdmin:
40120 TCPFiveM:
30120 TCPו:
30120 UDP9. הגדרת txAdmin בפעם הראשונה
כאשר תיכנסו ל:
http://SERVER-IP:40120תתחיל ההגדרה הראשונית של txAdmin.
בהפעלה הראשונה יוצג בדרך כלל PIN בקונסול של FXServer.
הזינו את ה־PIN בממשק txAdmin.
לאחר מכן תתבקשו לבצע חיבור לחשבון Cfx.re.
לחצו על:
Link Accountהתחברו לחשבון Cfx שלכם ואשרו את החיבור.
לאחר מכן ניתן להגדיר:
• שם לשרת
• סיסמת גיבוי
• פרופיל שרת
• Recipe
• License Key
10. יצירת License Key
כדי להפעיל שרת FiveM תצטרכו Cfx.re Server License Key.
יש להיכנס ל־Cfx Portal וליצור Key חדש עבור השרת שלכם.
לאחר יצירת המפתח, העתיקו אותו והכניסו אותו במהלך ההתקנה.
חשוב מאוד:
לעולם אל תפרסמו את ה־License Key שלכם באינטרנט או תשלחו אותו לאנשים שאתם לא סומכים עליהם.
11. Recipe Deployer
אחד היתרונות הגדולים של txAdmin הוא ה־Recipe Deployer.
באמצעותו ניתן להתקין תבנית מוכנה לשרת.
כאשר תגיעו למסך:
Deployment Typeבחרו:
Popular Recipesלשרת FiveM בסיסי ניתן לבחור Recipe בסיסי של CFX.
txAdmin יוריד ויגדיר עבורכם את הקבצים הדרושים באופן אוטומטי.
12. קובץ server.cfg
לאחר ביצוע ה־Deployment, לשרת יהיה קובץ:
server.cfgבקובץ זה נמצאות ההגדרות המרכזיות של השרת.
לדוגמה:
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "My FiveM Server"
sv_maxclients 48
sv_licenseKey "YOUR_LICENSE_KEY"חשוב:
אין לפרסם בפומבי את ה־License Key שלכם.
לדוגמה, אין לחשוף:
sv_licenseKey "YOUR_LICENSE_KEY"13. הפעלת השרת
לאחר סיום ההתקנה ב־txAdmin ניתן ללחוץ:
Save & Run ServertxAdmin יפעיל את FXServer עם ההגדרות וה־Recipe שהגדרתם.
מרגע זה מומלץ לנהל את השרת מתוך txAdmin.
14. התחברות לשרת FiveM
אם השרת משתמש בפורט ברירת המחדל:
30120ניתן להתחבר אליו דרך קונסולת FiveM באמצעות:
connect SERVER-IP:30120לדוגמה:
connect 123.123.123.123:3012015. שינוי פורט txAdmin
פורט ברירת המחדל של txAdmin הוא:
40120ברוב המקרים אין צורך לשנות אותו.
אבל אם יש מספר שרתי FiveM על אותה מכונה, לכל txAdmin חייב להיות פורט שונה.
לדוגמה:
שרת 1:
40120
שרת 2:
40121
שרת 3:
40122בגרסאות החדשות ניתן להשתמש במשתנה:
TXHOST_TXA_PORTלדוגמה:
export TXHOST_TXA_PORT=40121ולאחר מכן:
./run.sh16. מספר שרתי FiveM על אותה מכונה
אם מריצים מספר שרתי FiveM על אותה מכונה, גם פורט המשחק חייב להיות שונה.
לדוגמה:
שרת ראשון:
Game:
30120
txAdmin:
40120שרת שני:
Game:
30121
txAdmin:
40121שרת שלישי:
Game:
30122
txAdmin:
40122חשוב:
לא ניתן להפעיל שני שירותים שונים על אותו IP + Port בו זמנית.
17. txAdmin עם Pterodactyl
אם שרת FiveM שלכם פועל דרך Pterodactyl, חשוב להקצות Allocation נוסף עבור txAdmin.
לדוגמה:
פורט FiveM:
30120פורט txAdmin:
40120ה־Allocation של txAdmin חייב להיות נגיש מתוך ה־Container וגם פתוח בפיירוול של השרת.
בחלק מ־FiveM Eggs ניתן להגדיר את פורט txAdmin באמצעות:
TXHOST_TXA_PORTלדוגמה:
TXHOST_TXA_PORT=4012018. GameCP / חברת אחסון
אם רכשתם שרת FiveM דרך חברת אחסון או דרך GameCP, ייתכן שהפורטים כבר מוקצים עבורכם.
לדוגמה:
Game Port:
30250
txAdmin Port:
40250במקרה כזה אין להשתמש אוטומטית ב:
30120או:
40120יש להשתמש בפורטים שהוקצו לשרת שלכם בפאנל האחסון.
19. בדיקה אם txAdmin פועל
אם txAdmin לא נפתח, ניתן לבדוק אם הוא מאזין לפורט.
הריצו:
ss -lntp | grep 40120אם txAdmin פעיל, אמורה להופיע שורה שמראה שהשרת מאזין על פורט:
4012020. בדיקת פורט FiveM
ניתן לבדוק גם את פורט FiveM:
ss -lntup | grep 30120אתם אמורים לראות שהשרת מאזין ב־TCP וב־UDP על פורט:
3012021. שגיאת Port Already In Use
אם אתם מקבלים שגיאה כגון:
Port 40120 already in useזה אומר שתהליך אחר כבר משתמש בפורט.
בדקו:
ss -lntp | grep 40120או:
lsof -i :40120לאחר מכן ניתן לזהות איזה תהליך משתמש בפורט.
22. txAdmin לא נפתח
אם הכתובת:
http://SERVER-IP:40120לא נפתחת, בדקו קודם:
ss -lntp | grep 40120לאחר מכן:
ufw statusודאו שהפורט פתוח.
אם הוא לא פתוח:
ufw allow 40120/tcpחשוב:
בחלק מספקי השרתים קיים גם Firewall חיצוני בפאנל של הספק.
במקרה כזה יש לוודא שגם שם פורט 40120 TCP פתוח.
23. השרת עובד אבל אי אפשר להתחבר אליו
בדקו שפורט המשחק פתוח גם ב־TCP וגם ב־UDP.
ufw allow 30120/tcpufw allow 30120/udpבדקו גם את הקובץ:
server.cfgאמורות להיות הגדרות דומות ל:
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"24. טעות נפוצה בהפעלת txAdmin
אחת הטעויות הנפוצות היא להפעיל את השרת בפעם הראשונה באמצעות:
./run.sh +exec server.cfgכאשר רוצים לבצע התקנה ראשונית דרך txAdmin, הפעילו במקום זאת:
./run.shולאחר מכן בצעו את הגדרת השרת דרך ממשק txAdmin.
25. לא צריך להתקין Node.js
מדריכים ישנים באינטרנט לפעמים מבקשים לבצע פעולות כמו:
git cloneאו:
npm installאו להתקין Node.js במיוחד עבור txAdmin.
בהתקנה רגילה של שרת FiveM אין צורך לעשות זאת.
txAdmin כבר מגיע כחלק מ־FXServer.
התקנת Node.js וקוד המקור של txAdmin מיועדת בעיקר למפתחים שרוצים לעבוד על txAdmin עצמו.
26. פקודות שימושיות
בדיקת תהליכי FXServer:
ps aux | grep FXServerבדיקת פורט txAdmin:
ss -lntp | grep 40120בדיקת פורט FiveM:
ss -lntup | grep 30120בדיקת Firewall:
ufw statusכניסה לתיקיית השרת:
cd /home/fivem/serverהפעלת השרת:
./run.shיצירת Screen:
screen -S fivemחזרה ל־Screen:
screen -r fivemהצגת כל ה־Screens הפעילים:
screen -ls27. אבטחה
לעולם אל תפרסמו או תשתפו בפומבי:
• Cfx License Key
• סיסמת txAdmin
• PIN של txAdmin
• פרטי Database
• MySQL Password
• Steam API Key
• Discord Bot Token
• API Keys
מומלץ להשתמש בסיסמה חזקה לחשבון Cfx ול־txAdmin.
סיכום
תהליך ההתקנה הנכון של txAdmin הוא:
1. הורדת FXServer
↓
2. חילוץ FXServer
↓
3. הפעלת FXServer
./run.sh↓
4. כניסה ל־txAdmin
http://SERVER-IP:40120↓
5. חיבור חשבון Cfx
↓
6. בחירת Recipe
↓
7. הכנסת License Key
↓
8. ביצוע Deployment
↓
9. הפעלת השרת
Save & Run Serverלאחר סיום ההתקנה, txAdmin ישמש כממשק הניהול המרכזי של שרת ה־FiveM שלכם.
מומלץ לבצע את פעולות ההפעלה, העצירה, הריסטרטים וניהול השרת ישירות דרך txAdmin.