تثبيت
اختر الخيار الذي يناسب جهازك المضيف. كل مسار يمنحك نفس لوحة التحكم.
جاهز في دقائق
اختر جهازك والصق الأوامر. الخيار المتقدم يوفر كل الطرق الأخرى لتشغيل اللوحة، مع إعادة كتابة الأوامر لمجلدك وعنوانك الخاص.
- 1
تشغيل المثبت
يعمل على أي جهاز Linux بنظام تشغيل 64 بت، من خادم افتراضي خاص (VPS) إلى Raspberry Pi 4 أو 5. يقوم بتثبيت Docker إذا كان مفقودًا، ويقوم بإعداد اللوحة في /opt/msm، ويبدأها. قم بتشغيله مرة أخرى لاحقًا للترقية.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash - 2
فتح اللوحة
يطبع المثبت العنوان ورمز PIN للإعداد لمرة واحدة. افتح العنوان في متصفح، أدخل رمز PIN، وأنشئ حساب المسؤول الخاص بك.
http://your-server-ip:25564
- 1
تثبيت Docker Desktop و Node.js و Git و pnpm
سطر واحد لكل منها في PowerShell. ابدأ Docker Desktop بمجرد تثبيته واتركه قيد التشغيل.
winget install Docker.DockerDesktop winget install OpenJS.NodeJS.LTS winget install Git.Git winget install pnpm.pnpm - 2
الحصول على اللوحة وتشغيلها
افتح طرفية جديدة حتى يتعرف على الأدوات التي قمت بتثبيتها للتو.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
فتح اللوحة
الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.
http://localhost:25564
- 1
تثبيت Docker Desktop و Node.js و Git و pnpm
باستخدام Homebrew. ابدأ Docker Desktop بمجرد تثبيته واتركه قيد التشغيل.
brew install --cask docker-desktop brew install node git pnpm - 2
الحصول على اللوحة وتشغيلها
خطوة التثبيت تقوم أيضًا ببناء اللوحة. لا يوجد شيء لتجميعه.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
فتح اللوحة
الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.
http://localhost:25564
املأ الحقلين وكل أمر أدناه يعيد كتابة نفسه لجهازك.
- 1
إنشاء مجلد البيانات
مجلد واحد يحتفظ بكل ما تملكه اللوحة.
mkdir -p {{dataDir}} - 2
تنزيل ملف compose وتوجيهه إلى هذا المجلد
يجب أن يكون DATA_DIR_HOST هو المسار المطلق على المضيف، لأن Docker يقوم بتركيبه من وجهة نظر المضيف.
curl -fsSLO https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml echo "DATA_DIR_HOST={{dataDir}}" > .env - 3
بدء اللوحة
الصورة متعددة المعمارية (amd64 و arm64) وتتحدث في كل إصدار.
docker compose up -d ثم افتح اللوحة
http://{{host}}:25564الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.
- 1
إنشاء مجلد البيانات على المضيف
نفس قاعدة المجلد: مسار مطلق، على الجهاز الذي يشغل Docker.
mkdir -p {{dataDir}} - 2
إضافة مكدس من ملف compose
الصق محتويات ملف compose في مكدس جديد. الملف الخام هنا:
https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml - 3
تعيين متغير البيئة والنشر
أضفه في قسم البيئة للمكدس، ثم انشر.
DATA_DIR_HOST={{dataDir}} ثم افتح اللوحة
http://{{host}}:25564الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.
- 1
التحقق من المتطلبات
Node.js 24 أو أحدث، pnpm، و Docker قيد التشغيل (Docker Desktop على Windows و macOS).
node --version # 24 or newer docker info # daemon reachable - 2
الاستنساخ والتثبيت
خطوة التثبيت تقوم أيضًا ببناء CSS الخاص باللوحة. لا توجد وحدات أصلية للتجميع.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install - 3
بدء اللوحة
افتراضيًا، تستمع إلى localhost فقط. قم بتعيين PANEL_HOST=0.0.0.0 للوصول إليها من أجهزة أخرى على شبكتك.
pnpm start ثم افتح اللوحة
http://localhost:25564الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.
- 1
البدء من تثبيت مصدر
قم بتشغيل هذا من المجلد المستنسخ. يقوم PM2 بتشغيل التطبيقات باستخدام إصدار Node الذي بدأ خدمة daemon الخاصة به، لذا قم بتثبيت المفسر.
pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)" - 2
حفظ قائمة العمليات وتمكين بدء التشغيل
يقوم pm2 startup بطباعة أمر واحد لتشغيله باستخدام sudo؛ قم بتشغيله مرة واحدة.
pm2 save pm2 startup - 3
تفضل systemd؟
وحدة تشغل src/server.js node من المجلد المستنسخ مع تعيين WorkingDirectory تعمل بنفس الطريقة. اللوحة لا تحتاج إلى علامات إضافية.
ثم افتح اللوحة
http://{{host}}:25564الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.
الخيار الأول: Docker
خيارات المثبت
يأخذ مثبت Linux خياراته بعد bash -s --، لذا فهي تعمل عبر الأنبوب (pipe) أيضًا. قم بتشغيله مرة أخرى بنفس الخيارات للترقية؛ يتم الاحتفاظ بمجلد البيانات الخاص بك، وملفات .env، وتعديلات compose.
--port 8080تشغيل لوحة التحكم على منفذ آخر.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --port 8080--bind 127.0.0.1الاستماع على 127.0.0.1 فقط، لـ reverse proxy مع TLS في المقدمة.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --bind 127.0.0.1--tag v0.14.1تثبيت إصدار معين بدلاً من متابعة الأحدث.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --tag v0.14.1--dir /srv/msmالتثبيت في مكان آخر غير /opt/msm.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --dir /srv/msm--uninstall --yesإزالة لوحة التحكم والاحتفاظ ببياناتها. عبر الأنبوب (pipe) لا توجد لوحة مفاتيح للإجابة على السؤال، لذا أضف --yes؛ أضف --purge أيضًا لحذف مجلد البيانات.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --uninstall --yes--helpكل خيار، مع قيمته الافتراضية.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --help
المتطلبات
- محرك Docker (Linux) أو Docker Desktop (Windows, macOS).
- Docker
- Linux
Windows- macOS
- Node.js 24 أو أحدث للتثبيت من المصدر. صورة Docker تتضمن نسختها الخاصة.
- Node.js 24+
- بضعة جيجابايت من مساحة القرص لصور الخوادم والعوالم.
ملاحظات Windows
- يجب أن يكون Docker Desktop قيد التشغيل قبل البدء أو إنشاء الخوادم.
- شارك محرك الأقراص الخاص بمشروعك مع Docker Desktop (الإعدادات، الموارد، مشاركة الملفات) حتى تعمل عمليات الربط (bind mounts).
- صورة Docker تستهدف مضيفات Linux؛ على Windows و macOS، قم بتشغيل لوحة التحكم من المصدر.

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