Pterodactyl Control Panel¶

Այս հոդվածում

• Pterodactyl. Հիմնական հնարավորություններ
• Տեղակայման հնարավորություններ
• Սկզբնական քայլերը Pterodactyl-ի տեղակայումից հետո
• Օգտվող ստեղծելը
• Location ստեղծելը
• Node ստեղծելը
• Allocation-ների կարգավորումը
• Wings-ի տեղակայում
• Խնդիրների հայտարձակում (Troubleshooting)
• Nest և Egg ստեղծելը
• Սերվեր ստեղծելը
• Սերվերի գործարկումը և կարգավորումը
• Performans ստուգում
• Պատվիրել Pterodactyl սերվեր API-ով

Pterodactyl. Հիմնական հնարավորություններ¶

Pterodactyl-ը ժամանակակից խաղային սերվերների կառավարման լուծում է, որը համատեղում է՝

• Աջակցություն 50+ խաղերի համար: Տրամադրում է պատրաստի շաբլոններ հանրահայտ խաղային սերվերների արագ տեղակայման համար: Ավտոմատ կերպով կարգավորում է ծրագրակազմը, կախվածությունները և khởiինքի պարամետրերը, աջակցում է խաղի տարբերակի ընտրությանը և հատուկ շաբլոնների ավելացմանը:
• Ռեսուրսների հավասարաչափ կառավարում: Կառավարում է RAM-ը, CPU-ն, սկավառակի տարածքը և առաջնահերթությունների բաշխումը սերվերների միջև: Կանխում է գերբեռնվածությունը, բաշխում է ռեսուրսները սահմանաչափերով և օգտագործում է SWAP հիշողությունը՝ կայունության համար:
• Հուսալի ավտոմատ պահուստային պատճեններ (backups): Ապահովում է ճկուն պլանավորված պահուստավորում տվյալների ընտրությամբ (ամբողջ սերվերը կամ հիմնական ֆայլերը): Պահպանում է պահուստային պատճենները տեղային կամ ամպային պահոցներում (S3, FTP, GDrive)՝ գաղտնագրմամբ և ակնթարթային վերականգնման հնարավորությամբ:
• Էֆեկտիվ բազմաթիվ սերվերների աշխատանք: Յուրաքանչյուր սերվեր գործարկում է առանձնացված Docker կոնտեյներում: Ավտոմատ կերպով բաշխում է ծանրաբեռնվածությունը հանգույցների (nodes) միջև, նշանակում է պորտեր՝ առանց կոնֆլիկտների, և թույլ է տալիս խմբավորել հարակից սերվերները:
• Ճկուն բազմաօգտվող հասանելիություն: Կառավարում է թույլտվությունները դերերի վրա հիմնված մոդելով (նախնական + ստեղծված դերեր)՝ 50+ մանրամասն թույլտվություններով: Աջակցում է ժամանակավոր հասանելիություն, գործողությունների աուդիտ և երկփուլային նույնականացում:
• Ռեալ-տայմ կառավարման կոնսոլ: Տրամադրում է լիակատար հսկողություն վեբ ինտերֆեյսի միջոցով՝ ինտերակտիվ տերմինալով (SSH-ի նման): Ներառում է գունավոր ֆորմատավորում, հրամանների պատմություն, արագ գործողությունների կոճակներ և իրադարձությունների ծանուցումներ:
• Ռեալ-տայմ վիճակագրության մոնիթորինգ: Ցուցադրում է ռեսուրսների օգտագործման գրաֆիկներ (CPU, RAM, սկավառակ, ցանց) և խաղային մետրիկաներ (online խաղացողներ, TPS, ping): Թույլ է տալիս ստեղծել ստեղծված վահանակներ (dashboards), կարգավորել ծանուցումները և արտահանել տվյալները CSV ֆորմատով:
• Պարզեցված mod/plugin կառավարում: Ակնարկում է ներկառուցված խանութ՝ մոդերի ավտոմատ տեղակայման, տարբերակների և կախվածությունների կառավարման համար: Ներառում է տեսական կոնֆիգուրատոր՝ շինտաքսի ընդգծմամբ և թարմացումների մասին ծանուցումներով:
• Ավտոմատ թարմացումներ: Ապահովում է համակարգի անընդհատ աշխատանքը: Թարմացնում է խաղային սերվերները պլանով՝ թեստային ռեժիմով և սխալների դեպքում հետադարձ (rollback) հնարավորությամբ: Թարմացնում է control panel մեկ հրամանով (php artisan p:upgrade), ստուգելով համատեղելիությունը և առանց տվյալների կորստի տվյալների բազայի միգրացիան: Ավտոմատ թարմացնում է Wings daemon-ը, պահպանելով համատեղելիությունը տարբեր Linux դիստրիբուտիվների հետ:

Տեղակայման հնարավորություններ¶

Հիմնական համակարգային բաղադրիչները.¶

Կոնֆիգուրացիայի ֆայլեր¶

Սկզբնական քայլերը Pterodactyl-ի տեղակայումից հետո¶

Ձեր պատվերը վճարելուց հետո դուք կստանաք ծանուցում՝ գրանցված էլեկտրոնային հասցեին, որը կհայտի, որ ձեր սերվերը պատրաստ է աշխատանքի: Այն կպարունակի VPS IP հասցեն, ինչպեսզիք login և password՝ միացման համար: Մեր ընկերության հաճախորդները կառավարում են սարքավորումները in the servers and API control panel — Invapi.

Ավտոձեփնթման տվյալները, որոնք կարող են հայտնվել սերվերի control panel-ի Configuration >> Tags tab-ում կամ էլեկտրոնային փոստում, կարող են լինել՝

• Link: webpanel tag-ում: Admin panel մուտք գործելու համար, հիմնական հղմանը ավելացրեք /admin;
• Login: admin;
• Password: ուղարկվում է էլեկտրոնային փոստով ձեր հասցեին, երբ սերվերը պատրաստ է աշխատանքի ծրագրակազմի տեղակայումից հետո:

Առաջին մուտքը¶

1. Բացեք վեբ բրաուզերը և անցեք ձեր Pterodactyl panel հասցեով

2. Սեղմեք Login:

   

3. Հաջող մուտքից հետո դուք կհայտնվեք հիմնական panel էջում:

4. Ադմինիստրատիվ պանել մուտք գործելու համար սեղմեք կոճակը.

   

Օգտվող ստեղծելը¶

1. Ադմինիստրատիվ պանելի ձախ մենյուում սեղմեք Users բաժնի վրա;

2. Սեղմեք Create New կոճակը վերին աջ անկյունում.

   

3. Լրացրեք պահանջվող դաշտերը.

   • Username: օգտվողի անունը;
   • Email: օգտվողի էլեկտրոնային հասցեն;
   • First Name: անուն;
   • Last Name: apellido;
   • Password: գաղտնաբառ (նվազագույնը 8 նիշ, պետք է պարունակի տարբեր ռեգիստրի տառեր և թվեր);
4. Անհրաժեշտության դեպքում ընտրեք Yes Administrator տողում՝ ադմինիստրատորի իրավունքներ տալու համար;

5. Սեղմեք Create User.

   

Location ստեղծելը¶

1. Ձախ մենյուում ընտրեք Locations;

2. Սեղմեք Create New կոճակը վերին աջ անկյունում.

   

3. Լրացրեք դաշտերը.

   • Short Code: տեղի կարճ կոդը (օրինակ՝ "US1", "EU1");
   • Description: տեղի նկարագրությունը (օրինակ՝ "Data center in the USA");

4. Սեղմեք Create.

   

Node ստեղծելը¶

Նախապատրաստում Node ստեղծելուց առաջ¶

Նախքան node ստեղծելը, համոզվեք, որ՝

• Docker-ը տեղակայված է սերվերի վրա (նախնական տեղակայված է HOSTKEY պատկերներում);
• Դուք ունեք IP հասցե կամ դոմեյն անուն node-ի համար;
• 8080 (Wings API) և 12333 (Wings/Daemon SSL կապ) պորտերը բաց կլինեն firewall-ում:

Node ստեղծելը Panel-ում¶

1. Ադմինիստրատիվ պանելի ձախ մենյուում ընտրեք Nodes;

2. Սեղմեք Create New կոճակը վերին աջ անկյունում.

   

3. Լրացրեք basic settings-ը.

   • Name: նոդի եզակի անունը (օրինակ՝ hostkey-us-node1);
   • Location: ընտրեք նախապես ստեղծված location-ը;
   • Public: նշեք վանդակը, եթե նոդը պետք է տեսանելի լինի օգտվողների համար;
   • FQDN: նշեք panel-ի դոմեյն անունը (օրինակ՝ pterodactyl50514.hostkey.in) կամ IP հասցեն;
   • Communicate Over SSL: նշեք վանդակը, եթկե Panel-ը օգտագործում է HTTPS;
   • Behind Proxy: թողեք անջատված, եթե նոդը proxy-ի հետևում չէ:

4. Կարգավորեք resource settings-ը.

   • Daemon Server File Directory: /var/lib/pterodactyl/volumes (չփոփոխել);
   • Total Memory: նշեք հասանելի RAM-ը MB-ով (օրինակ՝ 4608 6GB սերվերի համար՝ հաշվառելով պահուստը);
   • Memory Over-Allocation: նշեք 0 (over-allocation չկա);
   • Total Disk Space: նշեք հասանելի սկավառակի տարածքը MB-ով (օրինակ՝ 102400 120GB սկավառակի համար՝ հաշվառելով պահուստը);
   • Disk Over-Allocation: նշեք 0 (over-allocation չկա);
   • Daemon Port: 8080 (թողեք լռելին);
   • Daemon SFTP Port: 2022 (թողեք լռելին).

   

5. Սեղմեք Create Node կոճակը.

    Name: hostkey-us-node1
    Location: US1
    Public: ☑
    FQDN: pterodactyl50514.hostkey.in
    Communicate Over SSL: ☑
    Behind Proxy: ☐

    Total Memory: 4608 MB (թողած 1.5GB համակարգի համար)
    Memory Over-Allocation: 0
    Total Disk Space: 102400 MB (թողած 20GB համակարգի համար)
    Disk Over-Allocation: 0

Allocation-ների կարգավորումը¶

Node ստեղծելուց հետո պետք է կարգավորեք allocation-ները. դրանք IP հասցեների և պորտերի համակցություններ են, որոնք հասանելի կլինեն խաղային սերվերներին նշանակելու համար:

1. Node ստեղծելուց հետո նրա էջը կբացվի ավտոմատ: Անցեք Allocation tab-ին.

2. Assign New Allocations բաժնում (աջ կողմում) լրացրեք դաշտերը.

   • IP Address: մուտքագրեք սերվերի IP հասցեն;
   • IP Alias: նշեք նկարագրություն (օրինակ՝ Main IP) կամ թողեք դատարկ;
   • Ports: նշեք պորտերի շրջանակ (օրինակ՝ 25565-25570 Minecraft սերվերների համար):

3.Սեղմեք կանաչ Submit կոճակը.

![](./images/pterodactyl_9.png)

1. Ստեղծված allocation-ները կհայտնվեն Existing Allocations աղյուսակում (ձախ կողմում): Յուրաքանչյուր տող ներկայացնում է առանձին IP:port համակցություն, որը կարող է նշանակվել խաղային սերվերին:

   

Wings-ի տեղակայում¶

Մուտք գործեք սերվեր, SSH-ի միջոցով և գործարկեք հետևյալ հրամանները.

Ստեղծեք թղթապանակ կոնֆիգուրացիայի համար.

mkdir -p /etc/pterodactyl

curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64"

chmod u+x /usr/local/bin/wings

wings version

Wings-ի տարբերակը պետք է հայտնվի (օրինակ՝ wings vv1.12.1):

Wings-ի կարգավորումը Auto-Deploy-ի միջոցով (Խորհուրդ է տրվում)¶

1. Ադմինիստրատիվ պանելում գնացեք ստեղծված նոդի Configuration tab-ին.

2. Auto-Deploy բաժնում (աջ կողմում) սեղմեք Generate Token կոճակը.

   

3.Պատճենեք գեներացված հրամանը. Այն պետք է ունենա այսպիսի տեսք.

    cd /etc/pterodactyl && wings configure --panel-url https://your-domain.com --token TOKEN --node 1

1. Գործարկեք պատճենված հրամանը սերվերի վրա.

       cd /etc/pterodactyl && wings configure --panel-url https://pterodactyl50514.hostkey.in --token TOKEN --node 1
   

   Պետք է հայտնվի հաղորդագրություն՝ Successfully configured wings.

2. Ստուգեք ստեղծված կոնֆիգուրացիան.

       cat /etc/pterodactyl/config.yml
   

systemd Ծառայության ստեղծումը¶

Ստեղծեք systemd ծառայություն Wings-ի ավտոմատ khởiինքի համար.

cat > /etc/systemd/system/wings.service <<'EOF'
[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service

[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
EOF

Wings-ի գործարկումը¶

Reload systemd կոնֆիգուրացիան.

systemctl daemon-reload

systemctl enable --now wings

systemctl status wings

Կարգավիճակը պետք է ցույց տա Active: active (running).

Գործողության ստուգում¶

Ստուգեք Wings-ի լոգերը.

journalctl -u wings -n 50

Լոգերը պետք է պարունակեն հետևյալ հաղորդագրությունները.

• fetching list of servers from API - Wings-ը միացել է Panel-ին.
• configuring internal webserver - Wings-ի վեբ սերվերը գործարկվել է.
• sftp server listening for connections - SFTP սերվերը աշխատում է:

Ստուգեք սերվերի թղթապանակի ստեղծումը.

ls -la /var/lib/pterodactyl/volumes/

Կարգավիճակի ստուգում Admin Panel-ում¶

1. Բացեք ադմինիստրատիվ պանելը՝ https://your-domain.com/admin;
2. Անցեք՝ Admin > Nodes > ձեր նոդը;
3. Թարմացրեք էջը (F5);
4. Վերին աջ անկյունում պետք է հայտնվի կանաչ Online կարգավիճակի ինդիկատորը;
5. About tab-ում պետք է հայտնվեն ռեսուրսների մասին տեղեկությունները (CPU, RAM, Disk):

Խնդիրների հայտարձակում (Troubleshooting)¶

Նոդը ցույց է տալիս Offline կարգավիճակ¶

Ստուգեք Wings-ի կարգավիճակը.

systemctl status wings

Եթե Wings-ը չի աշխատում, գործարկեք այն.

systemctl start wings

Ստուգեք լոգերը սխալների համար.

journalctl -u wings -n 100

Ընդհանուր խնդիրներ.

1. Wings-ը չի կարողանում միանալ Panel-ին.
   • Ստուգեք panel URL-ը կոնֆիգուրացիայում՝ cat /etc/pterodactyl/config.yml | grep remote;
   • Համոզվեք, որ Panel-ը հասանելի է՝ curl -I https://your-domain.com.

2.Պորտ 8080-ը արգելակված է firewall-ի կողմից. - Ստուգեք պորտը՝ netstat -tulpn | grep 8080; - Բացեք պորտը՝ ufw allow 8080/tcp.

1. SSL խնդիրներ.
   • Եթե Panel-ը օգտագործում է HTTPS, ապա Wings-ը նույնպես պետք է աշխատի SSL-ով.
   • Ստուգեք SSL կարգավորումները /etc/pterodactyl/config.yml ֆայլում:

Ձեռքով կարգավորում (Այլընտրանքային մեթոդ)¶

Եթե Auto-Deploy-ը չի աշխատում, կարող եք կարգավորել Wings-ը ձեռքով.

1. Ադմինիստրատիվ պանելում գնացեք նոդի Configuration tab-ին.
2. Պատճենեք կոնֆիգուրացիայի ֆայլի պարունակությունը ձախ տեքստային դաշտից.

3. Սերվերի վրա ստեղցրեք կոնֆիգուրացիայի ֆայլը.

   nano /etc/pterodactyl/config.yml
   

4. Տեղադրեք պատճենված կոնֆիգուրացիան և պահպանեք (Ctrl+X, ապա Y, ապա Enter);

5. Վերագործարկեք Wings-ը՝ systemctl restart wings;
6. Ստուգեք կարգավիճակը՝ systemctl status wings.

Nest և Egg ստեղծելը¶

Nest ստեղծելը¶

1. Ձախ մենյուում ընտրեք Nests բաժինը.

2. Սեղմեք Create New կոճակը վերին աջ անկյունում.

3. Լրացրեք դաշտերը.

   • Name: nest-ի անունը (օրինակ՝ "Minecraft");
   • Description: nest-ի նկարագրությունը;

4. Սեղմեք Save.

   

Ներբեռնեք պատրաստի Egg¶

1. Բացեք https://pelican-eggs.github.io/ կայքը.

2. Գտեք ցանկալի խաղը.

   • Game Eggs բաժնում ընտրեք կատեգորիա (օրինակ՝ Minecraft);
   • Գտեք ցանկալի սերվերի տեսակը (օրինակ՝ Paper, Vanilla, Forge);

3. Սեղմեք սերվերի անվան վրա՝ GitHub էջը բացելու համար.

4. Գտեք egg-name.json ֆայլը (օրինակ՝ egg-paper.json);

5. Սեղմեք ֆայլի վրա, ապա Raw կոճակը վերին աջ անկյունում.

6. Պահպանեք ֆայլը (Ctrl+S կամ right-click > Save as).

Ներբեռնեք Egg-ը Panel-ում¶

1. Ադմինիստրատիվ պանելում գնացեք Nests բաժին.

2. Սեղմեք Import Egg կոճակը վերին աջ անկյունում.

   

3. Սեղմեք Choose File և ընտրեք ներբեռնված .json ֆայլը.

4. Սեղմեք Import.

   

Egg-ը կներբեռնվի իր բոլոր կարգավորումներով, Docker images-ներով և փոփոխականներով:

Ներցված Egg-ի ստուգումը¶

1. Egg-երի ցանկում գտեք ներբեռնվածը (օրինակ՝ Paper);

2. Սեղմեք դրա վրա՝ կարգավորումները տեսնելու համար;

3. Համոզվեք, որ հետևյալները լրացված են.

   • Docker Images: հասանելի images-ների ցանկ;
   • Install Script: սերվերի տեղակայման սկրիպտ;
   • Variables: շրջակա միջավայրի փոփոխականներ (տարբերակ, կարգավորումներ).

   

   

Սերվեր ստեղծելը¶

1. Ձախ մենյուում ընտրեք Servers;

2. Սեղմեք Create New կոճակը վերին աջ անկյունում.

   

3. Լրացրեք ստեղծման ձևաթերթը.

Core Details:

• Server Name: սերվերի անունը (օրինակ՝ Test Minecraft Server);
• Server Owner: ընտրեք սերվերի սեփականատու օգտվողին ցանկից;
• Server Description: նկարագրություն (կամընտրանք);
• Start Server when Installed: թողեք նշված վանդակը.

Allocation Management:

• Node: ընտրեք ստեղծված նոդը;
• Default Allocation: ընտրեք IP հասցե:պորտը ցանկից;
• Additional Allocations: թողեք դատարկ.

Application Feature Limits:

• Database Limit: 0;
• Allocation Limit: 0;
• Backup Limit: 0.

Resource Management:

• CPU Limit: 0 (առանց սահմանափակումների);
• Memory: 2048 MiB (2GB սկզբի համար);
• Swap: 0 MiB;
• Disk Space: 5120 MiB (5GB);
• Block IO Weight: 500;
• Enable OOM Killer: թողեք անջատված.

Nest Configuration:

• Nest: Minecraft;
• Egg: Paper (ոչ թե Sponge!);
• Docker Image: Java 21;

• Service Variables: թողեք լռելիներով.

• Սեղմեք Create Server էջի ներքևում.

• Սպասեք տեղակայման ավարտին (կարգավիճակը Installing կփոխվի Offline):

Սերվերի գործարկումը և կարգավորումը¶

1. Տեղակայումից հետո բացեք սերվերը ցանկից (Admin > Servers):

   

2. Գնացեք օգտվողի պանել (առանց /admin-ի), մուտք գործեք որպես սերվերի սեփականատու.

3. Սեղմեք Start կոճակը.

   

4. Առաջին գործարկման ժամանակ կհայտնվի լիցենզիայի ընդունման պատուճան.

   

5. Սեղմեք I Accept՝ Minecraft EULA-ն ընդունելու համար.

6. Սպասեք սերվերի գործարկմանը (կարգավիճակը կփոխվի Running):

   

Performans ստուգում¶

Բացեք ձեր բրաուզերում (փոխարինեք IP-ն ձեր IP-ով).

https://api.mcsrvstat.us/3/<IP address>:25565

Կապման հասցեն:

<IP address>:25565

Պատվիրել Pterodactyl սերվեր API-ով¶

Այս ծրագրակազմը API-ի միջոցով տեղակայելու համար հետևեք այս հրահանգներին.