تخطي إلى المحتوى الرئيسي

سيرفر مخصص: تثبيت Pterodactyl

تم إنشاء هذا الدليل باستخدام المنتجات التالية:

(قد تختلف التفاصيل مع المنتجات من مزودين مختلفين ولكن المفاهيم الرئيسية تظل كما هي)

dedicated server

مقدمة​

لوحة Pterodactyl هي لوحة تحكم مفتوحة المصدر مصممة لإدارة وتأجير سيرفر ألعاب بسهولة. توفر واجهة مستخدم تتيح للمسؤولين تكوين وإدارة عدة سيرفرات ألعاب مركزياً.

في هذا الدليل، سنستعرض الخطوات اللازمة لإعداد نسخة Pterodactyl الخاصة بك على سيرفرك.

التحضير​

ستحتاج إلى سيرفر مخصص يعمل بنظام Linux لتثبيت لوحة Pterodactyl. يجب أن تستخدم أحد أنظمة التشغيل المتوافقة الموجودة في الجدول أدناه.

نظام التشغيلالإصدارات المتوافقة
Ubuntu20.04, 22.04
CentOS7, 8
Debian11, 12

المتطلبات​

تتطلب Pterodactyl مجموعة من المتطلبات لتتمكن من التثبيت والتشغيل بنجاح. كما تعتمد على مدير تبعيات شهير للـ PHP يُدعى Composer.

قائمة المتطلبات​

إليك قائمة مختصرة بالمتطلبات التي ستحتاجها لهذا الدليل. انتقل إلى القسم التالي الذي يشرح كيفية تثبيت هذه المتطلبات.

  • PHP 8.1 مع الإضافات التالية: cli, openssl, gd, mysql, PDO, mbstring, tokenizer, bcmath, xml أو dom, curl, zip, و fpm.
  • MariaDB
  • سيرفر ويب - في هذا الدليل سنستخدم Nginx.
  • curl
  • tar
  • unzip
  • git
  • composer v2

تثبيت المتطلبات​

أولاً، يجب تشغيل هذا الأمر الذي يسمح لك بإضافة حزم غير مضمّنة بشكل افتراضي في نظام التشغيل.

apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg

الآن يجب تثبيت المستودعات الإضافية لـ PHP و Redis و MariaDB (MySQL).

LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php

ستحتاج أيضاً لتثبيت Redis الذي يُستخدم لتخزين البيانات المؤقتة.

curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list

بالنسبة لسيرفر الويب، اخترنا استخدام Nginx لأنه موثوق ومفتوح المصدر. يجب تثبيته أو يمكنك استخدام سيرفرات ويب بديلة مثل Apache أو Caddy، لكن هذا لن يتناسب مع هذا الدليل.

sudo apt install nginx # تحميل وتثبيت Nginx
sudo ufw allow 'Nginx Full' # تعديل جدار الحماية

ننصح بزيارة http://[your_serverip]/ مع استبدال [your_serverip] بعنوان IP الخاص بسيرفرك لاختبار وضمان تشغيل Nginx. يجب أن ترى صفحة ترحيب افتراضية.

بعد ذلك، قم بتثبيت MariaDB التي ستستخدمها كقاعدة بيانات MySQL.

curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash

أخيراً، قم بتحديث قائمة المستودعات وتثبيت بقية المتطلبات.

apt update
apt -y install php8.1 php8.1-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

الآن يجب أن تكون جميع المتطلبات مثبتة ويمكنك المتابعة لتثبيت Composer.

تثبيت Composer​

بعد تثبيت المتطلبات الأساسية، يجب تثبيت Composer، وهو مدير تبعيات شهير للـ PHP. سيمكنك من تحميل وتثبيت خدمة Pterodactyl بالكامل بسهولة.

شغّل الأمر التالي:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

تحميل اللوحة​

الآن بعد أن أصبحت كل المتطلبات جاهزة، يجب تثبيت لوحة Pterodactyl.

يجب إنشاء مجلد لتخزين اللوحة باستخدام الأمر التالي.

mkdir /var/www/pterodactyl
cd /var/www/pterodactyl

الآن، يمكنك استنساخ مستودع Pterodactyl الرسمي على GitHub لتحميل الملفات اللازمة.

curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
tar -xzvf panel.tar.gz
chmod -R 755 storage/* bootstrap/cache/

بعد الانتهاء من الاستنساخ، ستكون اللوحة محملة بنجاح. في القسم التالي، ستقوم بتكوين مجموعة واسعة من الإعدادات والخيارات لضمان تثبيت اللوحة بشكل صحيح وعملها بسلاسة.

التثبيت​

الجزء الأول من التثبيت يتضمن إعداد قاعدة بيانات MySQL التي ستخزن كل بيانات لوحة Pterodactyl الخاصة بك. إذا كان لديك قاعدة بيانات MySQL جاهزة مع مستخدم مناسب، يمكنك تخطي القسم الفرعي التالي.

إعداد قاعدة البيانات​

ستحتاج لتسجيل الدخول إلى قاعدة بيانات MySQL للبدء. إذا كانت هذه أول مرة تستخدم MySQL، يمكنك فعل ذلك ببساطة عبر:

mysql -u root -p

أما إذا كان لديك قاعدة بيانات MySQL مسبقاً، فاستخدم بيانات الدخول الخاصة بك مع -u لاسم المستخدم و -p لحقل كلمة المرور.

بعد تسجيل الدخول، يجب إنشاء مستخدم جديد ستستخدمه لنسخة Pterodactyl الخاصة بك. تأكد من استبدال [your_password] بكلمة المرور التي تريدها. يمكن فعل ذلك عبر:

CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY '[your_password]';

الآن بعد أن أصبح المستخدم جاهزاً، يجب إنشاء قاعدة بيانات لنسخة Pterodactyl. كما يجب منح صلاحيات للمستخدم الجديد ليتمكن من تنفيذ العمليات على القاعدة. ببساطة شغّل:

CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;

لقد أنشأت بنجاح مستخدم وقاعدة بيانات MySQL لنسخة Pterodactyl، يمكنك الآن متابعة التثبيت. اكتب exit للخروج من إدارة MySQL.

متابعة الإعداد​

للمتابعة، يجب نسخ ملف البيئة الافتراضي حيث ستخزن الرموز السرية.

cp .env.example .env

بعد ذلك، يمكنك استخدام Composer لتثبيت كل الحزم اللازمة تلقائياً عبر:

composer install --no-dev --optimize-autoloader

يجب أيضاً توليد مفتاح تشفير ستستخدمه لتطبيقك، ويتم ذلك عبر:

php artisan key:generate --force

تكوين البيئة​

الآن ستقوم بإعداد نسخة Pterodactyl الخاصة بك. يتم ذلك ببساطة عبر تشغيل الأوامر التالية. كل أمر سيأخذك خلال إعداد تفاعلي يغطي مجموعة واسعة من الإعدادات مثل الجلسات، البريد الإلكتروني، التخزين المؤقت والمزيد.

php artisan p:environment:setup # الأمر الأول
php artisan p:environment:database # الأمر الثاني

إعداد قاعدة البيانات​

الخطوة التالية هي إعداد البيانات الأساسية اللازمة لتشغيل اللوحة، والتي تستخدم قاعدة البيانات التي أنشأتها سابقاً. مرة أخرى، يتم ذلك ببساطة عبر تشغيل الأمر التالي.

معلومات

يرجى العلم أن هذه العملية قد تستغرق عدة دقائق. لا تغلق العملية وإلا قد تتسبب في مشاكل. تحلَّ بالصبر :)

php artisan migrate --seed --force

إنشاء مستخدم مسؤول​

الآن بعد أن أصبحت قاعدة البيانات جاهزة، يجب إنشاء أول مستخدم مسؤول لتتمكن من تسجيل الدخول إلى لوحة Pterodactyl الخاصة بك. يتم ذلك ببساطة عبر تشغيل الأمر التالي.

php artisan p:user:make

إعداد الصلاحيات​

الخطوة التالية في تثبيت اللوحة هي ضبط الصلاحيات اللازمة للملفات الموجودة في لوحة pterodactyl حتى تتمكن النسخة من القراءة والكتابة بدون مشاكل.

يمكنك ضبط الصلاحيات عبر تشغيل الأمر التالي:

chown -R www-data:www-data /var/www/pterodactyl/*

بعد الانتهاء، يجب أن تتمكن من الوصول إلى لوحة Pterodactyl عبر الرابط التالي مع استبدال your_ipaddress بعنوان IP الخاص بجهازك.

http://[your_ipaddress]/

عمال الطابور (Queue Workers)​

الخطوة الأخيرة في تثبيت اللوحة تتضمن إعداد مهمة مجدولة (cronjob) تعمل بفواصل منتظمة مع عامل طابور مسؤول عن العديد من المهام الخلفية.

أولاً، افتح crontab عبر تشغيل sudo crontab -e في الكونسول. بعد الفتح، شغّل الأمر التالي الذي ينشئ مهمة مجدولة تعمل كل دقيقة للوحة Pterodactyl.

* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

الآن بعد الانتهاء، تحتاج لإنشاء عامل طابور باستخدام systemd الذي يحافظ على تشغيل عملية الطابور في الخلفية.

أنشئ ملفاً جديداً للعامل عبر تشغيل الأمر التالي الذي يفتح محرر nano.

nano /etc/systemd/system/pteroq.service

انسخ والصق المحتوى التالي:

# ملف عامل طابور Pterodactyl
# ----------------------------------

[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service

[Service]
# في بعض الأنظمة قد يكون المستخدم والمجموعة مختلفين.
# بعض الأنظمة تستخدم `apache` أو `nginx` كمستخدم ومجموعة.
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
ملاحظة

إذا كنت تستخدم CentOS، يجب استبدال redis-server.service بـ redis.service في الملف أعلاه.

عند الانتهاء، احفظ الملف بالضغط على CTRL + X ثم Y لتأكيد الحفظ.

أخيراً، يجب تفعيل خدمة redis والخدمة التي أنشأتها لتعمل عند إقلاع النظام عبر تشغيل الأوامر التالية.

sudo systemctl enable --now redis-server
sudo systemctl enable --now pteroq.service

لقد قمت بتثبيت Pterodactyl بنجاح على سيرفرك. يجب أن تتمكن من الوصول إلى اللوحة عبر الرابط التالي مع استبدال [your_serverip] بعنوان IP الخاص بسيرفرك.

http://[your_serverip]

اختياري: تكوين سيرفر الويب​

كميزة إضافية، قد ترغب في تكوين سيرفر الويب الخاص بك. في هذا الدليل استخدمنا Nginx، لذا سيشرح هذا القسم كيفية تعديل الإعدادات له.

فوائد تكوين سيرفر الويب بشكل إضافي هي أنك ستتمكن من إعداد اللوحة على نطاقك الخاص ويمكنك إعداد شهادة SSL لموقع اللوحة.

سجل DNS للنطاق​

لكي يكون سيرفرك متاحاً عبر نطاقك، يجب إعداد سجل DNS من نوع A لذلك النطاق. هذا يعتمد بشكل كبير على مزود الخدمة الذي تستخدمه، لكن يجب أن يكون متاحاً عبر لوحة تحكم DNS عند إدارة نطاقك. يجب أن يحتوي السجل على عنوان IP الهدف لسيرفرك.

إزالة الإعداد الافتراضي​

ابدأ بحذف إعداد Nginx الافتراضي. يتم ذلك ببساطة عبر حذف الملف.

rm /etc/nginx/sites-enabled/default

الآن، استخدم المحتويات أدناه لإنشاء ملف إعداد جديد لموقع لوحة pterodactyl. يجب أن تقرر ما إذا كنت تريد استخدام SSL أم لا في هذه المرحلة، حيث تختلف محتويات الإعداد والخطوات قليلاً حسب الخيار.

إعداد Certbot​

لكي يحصل موقعك على شهادة SSL، يجب إعداد نظام يدير ويجدد الشهادات تلقائياً. في هذه الحالة، ستستخدم Certbot وهو مفتوح المصدر.

أولاً، ثبت Certbot على سيرفرك. بالنسبة لـ Nginx، تحتاج أيضاً لتثبيت حزمة python3-certbot-nginx.

sudo apt update
sudo apt install -y certbot
sudo apt install -y python3-certbot-nginx

بعدها، يجب إعداد التحقق للسماح بإنشاء الشهادة. في هذه الحالة، ستستخدم تحدي DNS لأنه أكثر أماناً مقارنة بتحدي HTTP.

يجب إنشاء سجل DNS من نوع TXT للنطاق الذي تريد استخدامه. هذا يعتمد على مزود الخدمة، لكن يجب أن يكون متاحاً عبر لوحة تحكم DNS عند إدارة نطاقك.

شغّل الأمر التالي الذي سيعطيك محتوى سجل TXT الخاص بك. استبدل [your_domain] بالنطاق الذي تريد استخدامه.

certbot -d [your_domain] --manual --preferred-challenges dns certonly

بعد إعداد سجل DNS، يجب إعداد التجديد التلقائي عبر مهمة مجدولة (cronjob). أولاً، افتح crontab عبر sudo crontab -e وعند الفتح، شغّل الأمر التالي ليجعل الشهادة تتجدد يومياً عند الساعة 23:00 بتوقيت النظام.

0 23 * * * certbot renew --quiet --deploy-hook "systemctl restart nginx"

إنشاء ملف الإعداد​

الآن بعد أن أصبحت شهادة SSL جاهزة، يمكنك البدء بإنشاء ملف الإعداد.

شغّل الأمر التالي لفتح محرر nano في المجلد المستهدف وباسم الملف المحدد.

nano /etc/nginx/sites-enabled/pterodactyl.conf

انسخ ملف الإعداد التالي داخل المحرر. تأكد من استبدال [your_domain] بالنطاق الذي أعددت له سجلات DNS في الخطوات السابقة.

تحذير

تأكد من إعداد شهادة SSL، وإلا سيفشل سيرفر الويب في البدء بنجاح.

server_tokens off;

server {
    listen 80;
    server_name [your_domain];
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name [your_domain];

    root /var/www/pterodactyl/public;
    index index.php;

    access_log /var/log/nginx/pterodactyl.app-access.log;
    error_log  /var/log/nginx/pterodactyl.app-error.log error;

    client_max_body_size 100m;
    client_body_timeout 120s;

    sendfile off;

    ssl_certificate /etc/letsencrypt/live/[your_domain]/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/[your_domain]/privkey.pem;
    ssl_session_cache shared:SSL:10m;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384";
    ssl_prefer_server_ciphers on;

    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Robots-Tag none;
    add_header Content-Security-Policy "frame-ancestors 'self'";
    add_header X-Frame-Options DENY;
    add_header Referrer-Policy same-origin;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTP_PROXY "";
        fastcgi_intercept_errors off;
        fastcgi_buffer_size 16k;
        fastcgi_buffers 4 16k;
        fastcgi_connect_timeout 300;
        fastcgi_send_timeout 300;
        fastcgi_read_timeout 300;
        include /etc/nginx/fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

تطبيق الإعداد​

الآن بعد أن أجريت التعديلات على الإعداد، يجب تفعيله عبر تشغيل الأمر التالي.

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf # غير مطلوب في CentOS

sudo systemctl restart nginx # إعادة تشغيل Nginx

مع إتمام كل شيء بنجاح، يجب أن تتمكن الآن من الوصول بسهولة إلى لوحة Pterodactyl باستخدام النطاق الذي أعددته في هذا القسم.

لقد قمت بتكوين سيرفر الويب بنجاح لتمكين استخدام نطاقك وإضافة شهادة SSL لموقعك.

إعدادات الكوكيز