تخطي إلى المحتوى
MSM

تثبيت

اختر الخيار الذي يناسب جهازك المضيف. كل مسار يمنحك نفس لوحة التحكم.

جاهز في دقائق

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

  1. 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. 2

    فتح اللوحة

    يطبع المثبت العنوان ورمز PIN للإعداد لمرة واحدة. افتح العنوان في متصفح، أدخل رمز PIN، وأنشئ حساب المسؤول الخاص بك.

    http://your-server-ip:25564
  1. 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. 2

    الحصول على اللوحة وتشغيلها

    افتح طرفية جديدة حتى يتعرف على الأدوات التي قمت بتثبيتها للتو.

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
    pnpm start
  3. 3

    فتح اللوحة

    الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.

    http://localhost:25564
  1. 1

    تثبيت Docker Desktop و Node.js و Git و pnpm

    باستخدام Homebrew. ابدأ Docker Desktop بمجرد تثبيته واتركه قيد التشغيل.

    brew install --cask docker-desktop
    brew install node git pnpm
  2. 2

    الحصول على اللوحة وتشغيلها

    خطوة التثبيت تقوم أيضًا ببناء اللوحة. لا يوجد شيء لتجميعه.

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
    pnpm start
  3. 3

    فتح اللوحة

    الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.

    http://localhost:25564

املأ الحقلين وكل أمر أدناه يعيد كتابة نفسه لجهازك.

  1. 1

    إنشاء مجلد البيانات

    مجلد واحد يحتفظ بكل ما تملكه اللوحة.

    mkdir -p {{dataDir}}
  2. 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. 3

    بدء اللوحة

    الصورة متعددة المعمارية (amd64 و arm64) وتتحدث في كل إصدار.

    docker compose up -d
  4. ثم افتح اللوحة

    http://{{host}}:25564

    الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.

  1. 1

    إنشاء مجلد البيانات على المضيف

    نفس قاعدة المجلد: مسار مطلق، على الجهاز الذي يشغل Docker.

    mkdir -p {{dataDir}}
  2. 2

    إضافة مكدس من ملف compose

    الصق محتويات ملف compose في مكدس جديد. الملف الخام هنا:

    https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml
  3. 3

    تعيين متغير البيئة والنشر

    أضفه في قسم البيئة للمكدس، ثم انشر.

    DATA_DIR_HOST={{dataDir}}
  4. ثم افتح اللوحة

    http://{{host}}:25564

    الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.

  1. 1

    التحقق من المتطلبات

    Node.js 24 أو أحدث، pnpm، و Docker قيد التشغيل (Docker Desktop على Windows و macOS).

    node --version   # 24 or newer
    docker info      # daemon reachable
  2. 2

    الاستنساخ والتثبيت

    خطوة التثبيت تقوم أيضًا ببناء CSS الخاص باللوحة. لا توجد وحدات أصلية للتجميع.

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
  3. 3

    بدء اللوحة

    افتراضيًا، تستمع إلى localhost فقط. قم بتعيين PANEL_HOST=0.0.0.0 للوصول إليها من أجهزة أخرى على شبكتك.

    pnpm start
  4. ثم افتح اللوحة

    http://localhost:25564

    الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.

  1. 1

    البدء من تثبيت مصدر

    قم بتشغيل هذا من المجلد المستنسخ. يقوم PM2 بتشغيل التطبيقات باستخدام إصدار Node الذي بدأ خدمة daemon الخاصة به، لذا قم بتثبيت المفسر.

    pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)"
  2. 2

    حفظ قائمة العمليات وتمكين بدء التشغيل

    يقوم pm2 startup بطباعة أمر واحد لتشغيله باستخدام sudo؛ قم بتشغيله مرة واحدة.

    pm2 save
    pm2 startup
  3. 3

    تفضل systemd؟

    وحدة تشغل src/server.js node من المجلد المستنسخ مع تعيين WorkingDirectory تعمل بنفس الطريقة. اللوحة لا تحتاج إلى علامات إضافية.

  4. ثم افتح اللوحة

    http://{{host}}:25564

    الجولة الأولى تقوم بإرشادك خلال فحص النظام، منطقتك الزمنية، وإنشاء حساب المسؤول.

الخيار الأول: Docker

تقوم لوحة التحكم بقيادة خادم Docker الخاص بالجهاز المضيف عبر المقبس (socket) المُركب، وهو ما يعادل صلاحيات الجذر (root) على الجهاز المضيف. تعامل مع تسجيل الدخول الإداري وفقًا لذلك ولا تعرض لوحة التحكم مباشرة للإنترنت أبدًا.

تنزيل docker-compose.ymlاقرأ دليل البدء السريع

خيارات المثبت

يأخذ مثبت 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

المتطلبات

ملاحظات Windows

تعال وقل مرحبًا

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