Встановлення
Виберіть варіант, який відповідає вашому хосту. Кожен шлях надає вам однакову панель.
Запуск за хвилини
Виберіть свою машину та вставте команди. Розширений режим містить усі інші способи запуску панелі з командами, переписаними для вашої власної папки та адреси.
- 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, яка запустила його демон, тому вкажіть інтерпретатор.
pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)" - 2
Збережіть список процесів та увімкніть автозапуск
pm2 startup виведе одну команду для виконання з sudo; виконайте її один раз.
pm2 save pm2 startup - 3
Віддаєте перевагу systemd?
Юніт, який запускає node src/server.js з клонованої папки з встановленим WorkingDirectory, працює так само. Панелі не потрібні додаткові прапорці.
Потім відкрийте панель
http://{{host}}:25564Перший запуск проведе вас через перевірку системи, вибір часового поясу та створення облікового запису адміністратора.
Варіант 1: Docker
Завантажити 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, для зворотного проксі з 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 (Linux) або Docker Desktop (Windows, macOS).
- Docker
- Linux
Windows- macOS
- Node.js 24 або новіша версія для встановлення з вихідного коду. Образ Docker містить власну версію.
- Node.js 24+
- Кілька гігабайт дискового простору для образів серверів та світів.
Примітки для Windows
- Docker Desktop має бути запущений перед запуском або створенням серверів.
- Надайте спільний доступ до вашого диска проекту для Docker Desktop (Налаштування, Ресурси, Спільний доступ до файлів), щоб прив'язка томів працювала.
- Образ Docker призначений для хостів Linux; на Windows та macOS запускайте панель з вихідного коду.

Приєднуйтесь до спільноти
Повідомляйте про помилки, пропонуйте функції, отримуйте допомогу від реальних людей та демонструйте свої сервери.
