Установка
Выберите вариант, соответствующий вашей системе. Любой из них предоставит вам одну и ту же панель управления.
Запуск за минуты
Выберите свою машину и вставьте команды. Расширенный режим предлагает все остальные способы запуска панели с командами, переписанными для вашей собственной папки и адреса.
- 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 (Настройки, Ресурсы, Общие файлы), чтобы bind mounts работали.
- Docker-образ предназначен для Linux-хостов; на Windows и macOS запускайте панель из исходного кода.

Заходите поздороваться
Сообщайте об ошибках, предлагайте новые функции, получайте помощь от реальных людей и демонстрируйте свои серверы.
