نصب
گزینهای را انتخاب کنید که با میزبان شما مطابقت دارد. هر مسیری همان پنل را به شما میدهد.
در عرض چند دقیقه راهاندازی کنید
ماشین خود را انتخاب کنید و دستورات را کپی کنید. حالت پیشرفته شامل تمام روشهای دیگر اجرای پنل است، با دستوراتی که برای پوشه و آدرس خودتان بازنویسی شدهاند.
- 1
نصبکننده را اجرا کنید
روی هر ماشین لینوکسی با سیستمعامل ۶۴ بیتی، از 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
پنل را باز کنید
نصبکننده آدرس و یک پین راهاندازی یکبار مصرف را چاپ میکند. آدرس را در مرورگر باز کنید، پین را وارد کنید و حساب مدیر خود را ایجاد کنید.
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 آن را از دیدگاه هاست mount میکند.
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 در ویندوز و 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 که دیمن خود را شروع کرده است اجرا میکند، بنابراین مفسر را پین کنید.
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 را از پوشه کلون شده با WorkingDirectory تنظیم شده اجرا میکند، به همان روش کار میکند. پنل به پرچمهای اضافی نیاز ندارد.
سپس پنل را باز کنید
http://{{host}}:25564اولین اجرا شما را از طریق بررسی سیستم، منطقه زمانی و ایجاد حساب مدیر راهنمایی میکند.
گزینه ۱: Docker
گزینههای نصب
نصبکننده لینوکس گزینههای خود را بعد از 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 Engine (لینوکس) یا Docker Desktop (ویندوز، مکاواس).
- Docker
- Linux
Windows- macOS
- Node.js نسخه ۲۴ یا جدیدتر برای نصب از سورس. ایمیج Docker ایمیج مخصوص خود را دارد.
- Node.js 24+
- چند گیگابایت فضا برای ایمیجهای سرور و دنیاها.
نکات ویندوز
- Docker Desktop باید قبل از شروع یا ایجاد سرورها در حال اجرا باشد.
- درایو پروژه خود را با Docker Desktop به اشتراک بگذارید (Settings, Resources, File sharing) تا bind mount ها کار کنند.
- ایمیج Docker برای میزبانهای لینوکس هدفگذاری شده است؛ در ویندوز و مکاواس، پنل را از سورس اجرا کنید.

سلامی بگویید
اشکالات را گزارش دهید، ویژگیها را پیشنهاد دهید، از انسانهای واقعی کمک بگیرید و سرورهای خود را به نمایش بگذارید.
