Instalação
Escolha a opção que corresponde ao seu host. Todos os caminhos fornecem o mesmo painel.
Pronto em minutos
Escolha sua máquina e cole os comandos. O modo Avançado tem todas as outras formas de executar o painel, com os comandos reescritos para sua própria pasta e endereço.
- 1
Execute o instalador
Funciona em qualquer máquina Linux com um sistema operacional de 64 bits, de um VPS a um Raspberry Pi 4 ou 5. Ele instala o Docker se estiver faltando, configura o painel em /opt/msm e o inicia. Execute-o novamente mais tarde para atualizar.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash - 2
Abra o painel
O instalador exibe o endereço e um PIN de configuração único. Abra o endereço em um navegador, insira o PIN e crie sua conta de administrador.
http://your-server-ip:25564
- 1
Instale Docker Desktop, Node.js, Git e pnpm
Uma linha para cada um no PowerShell. Inicie o Docker Desktop assim que ele for instalado e deixe-o em execução.
winget install Docker.DockerDesktop winget install OpenJS.NodeJS.LTS winget install Git.Git winget install pnpm.pnpm - 2
Obtenha o painel e inicie-o
Abra um novo terminal para que ele encontre as ferramentas que você acabou de instalar.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
Abra o painel
A primeira execução o guiará por uma verificação do sistema, seu fuso horário e a criação da conta de administrador.
http://localhost:25564
- 1
Instale Docker Desktop, Node.js, Git e pnpm
Com o Homebrew. Inicie o Docker Desktop assim que ele for instalado e deixe-o em execução.
brew install --cask docker-desktop brew install node git pnpm - 2
Obtenha o painel e inicie-o
A etapa de instalação também compila o painel. Não há nada para compilar.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
Abra o painel
A primeira execução o guiará por uma verificação do sistema, seu fuso horário e a criação da conta de administrador.
http://localhost:25564
Preencha os dois campos e cada comando abaixo se reescreverá para sua máquina.
- 1
Crie a pasta de dados
Uma pasta contém tudo o que o painel possui.
mkdir -p {{dataDir}} - 2
Baixe o arquivo compose e aponte-o para essa pasta
DATA_DIR_HOST deve ser o caminho absoluto no host, pois o Docker o monta do ponto de vista do host.
curl -fsSLO https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml echo "DATA_DIR_HOST={{dataDir}}" > .env - 3
Inicie o painel
A imagem é multi-arquitetura (amd64 e arm64) e atualiza a cada lançamento.
docker compose up -d Em seguida, abra o painel
http://{{host}}:25564A primeira execução o guiará por uma verificação do sistema, seu fuso horário e a criação da conta de administrador.
- 1
Crie a pasta de dados no host
Mesma regra de pasta: caminho absoluto, na máquina que executa o Docker.
mkdir -p {{dataDir}} - 2
Adicione uma stack a partir do arquivo compose
Cole o conteúdo do arquivo compose em uma nova stack. O arquivo bruto está aqui:
https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml - 3
Defina a variável de ambiente e implante
Adicione-a na seção de ambiente da stack e, em seguida, implante.
DATA_DIR_HOST={{dataDir}} Em seguida, abra o painel
http://{{host}}:25564A primeira execução o guiará por uma verificação do sistema, seu fuso horário e a criação da conta de administrador.
- 1
Verifique os requisitos
Node.js 24 ou mais recente, pnpm e Docker em execução (Docker Desktop no Windows e macOS).
node --version # 24 or newer docker info # daemon reachable - 2
Clone e instale
A etapa de instalação também compila o CSS do painel. Nenhum módulo nativo para compilar.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install - 3
Inicie o painel
Por padrão, ele escuta apenas no localhost. Defina PANEL_HOST=0.0.0.0 para acessá-lo de outras máquinas em sua rede.
pnpm start Em seguida, abra o painel
http://localhost:25564A primeira execução o guiará por uma verificação do sistema, seu fuso horário e a criação da conta de administrador.
- 1
Inicie a partir de uma instalação de código fonte
Execute isso a partir da pasta clonada. O PM2 inicia aplicativos com a versão do Node que iniciou seu daemon, portanto, fixe o interpretador.
pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)" - 2
Salve a lista de processos e habilite a inicialização
O pm2 startup exibe um comando para executar com sudo; execute-o uma vez.
pm2 save pm2 startup - 3
Prefere systemd?
Uma unidade que executa node src/server.js da pasta clonada com WorkingDirectory definido funciona da mesma maneira. O painel não precisa de sinalizadores extras.
Em seguida, abra o painel
http://{{host}}:25564A primeira execução o guiará por uma verificação do sistema, seu fuso horário e a criação da conta de administrador.
Opção 1: Docker
Opções do Instalador
O instalador do Linux recebe suas opções após bash -s --, então elas funcionam através do pipe também. Execute-o novamente com as mesmas opções para atualizar; sua pasta de dados, .env e edições do compose são mantidas.
--port 8080Servir o painel em outra porta.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --port 8080--bind 127.0.0.1Ouvir apenas em 127.0.0.1, para um proxy reverso com TLS na frente.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.1Fixar um lançamento em vez de seguir o mais recente.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --tag v0.14.1--dir /srv/msmInstalar em outro local que não seja /opt/msm.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --dir /srv/msm--uninstall --yesRemover o painel e manter seus dados. Através de um pipe não há teclado para responder à pergunta, então adicione --yes; adicione --purge também para excluir a pasta de dados.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --uninstall --yes--helpCada opção, com seu padrão.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --help
Requisitos
- Docker Engine (Linux) ou Docker Desktop (Windows, macOS).
- Docker
- Linux
Windows- macOS
- Node.js 24 ou mais recente para a instalação a partir do código-fonte. A imagem Docker já inclui o seu próprio.
- Node.js 24+
- Alguns gigabytes de disco para imagens de servidor e mundos.
Observações para Windows
- O Docker Desktop deve estar em execução antes de iniciar ou criar servidores.
- Compartilhe sua unidade de projeto com o Docker Desktop (Configurações, Recursos, Compartilhamento de arquivos) para que os bind mounts funcionem.
- A imagem Docker é voltada para hosts Linux; no Windows e macOS, execute o painel a partir do código-fonte.

Venha dizer olá
Reporte bugs, sugira recursos, peça ajuda a pessoas reais e mostre seus servidores.
