Installazione
Scegli l'opzione che corrisponde al tuo host. Ogni percorso ti fornisce lo stesso pannello.
Operativo in pochi minuti
Scegli la tua macchina e incolla i comandi. Avanzate offre tutti gli altri modi per eseguire il pannello, con i comandi riscritti per la tua cartella e il tuo indirizzo.
- 1
Esegui l'installer
Funziona su qualsiasi macchina Linux con un sistema operativo a 64 bit, da un VPS a un Raspberry Pi 4 o 5. Installa Docker se mancante, configura il pannello in /opt/msm e lo avvia. Eseguilo di nuovo in seguito per aggiornare.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash - 2
Apri il pannello
L'installer stampa l'indirizzo e un PIN di configurazione monouso. Apri l'indirizzo in un browser, inserisci il PIN e crea il tuo account amministratore.
http://your-server-ip:25564
- 1
Installa Docker Desktop, Node.js, Git e pnpm
Una riga ciascuno in PowerShell. Avvia Docker Desktop una volta installato e lascialo in esecuzione.
winget install Docker.DockerDesktop winget install OpenJS.NodeJS.LTS winget install Git.Git winget install pnpm.pnpm - 2
Ottieni il pannello e avvialo
Apri un nuovo terminale in modo che trovi gli strumenti appena installati.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
Apri il pannello
La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.
http://localhost:25564
- 1
Installa Docker Desktop, Node.js, Git e pnpm
Con Homebrew. Avvia Docker Desktop una volta installato e lascialo in esecuzione.
brew install --cask docker-desktop brew install node git pnpm - 2
Ottieni il pannello e avvialo
Il passaggio di installazione compila anche il pannello. Non c'è nulla da compilare.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
Apri il pannello
La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.
http://localhost:25564
Compila i due campi e ogni comando sottostante si riscrive per la tua macchina.
- 1
Crea la cartella dati
Una cartella contiene tutto ciò che possiede il pannello.
mkdir -p {{dataDir}} - 2
Scarica il file compose e puntalo a quella cartella
DATA_DIR_HOST deve essere il percorso assoluto sull'host, poiché Docker lo monta dal punto di vista dell'host.
curl -fsSLO https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml echo "DATA_DIR_HOST={{dataDir}}" > .env - 3
Avvia il pannello
L'immagine è multi-arch (amd64 e arm64) e si aggiorna ad ogni rilascio.
docker compose up -d Poi apri il pannello
http://{{host}}:25564La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.
- 1
Crea la cartella dati sull'host
Stessa regola della cartella: percorso assoluto, sulla macchina che esegue Docker.
mkdir -p {{dataDir}} - 2
Aggiungi uno stack dal file compose
Incolla il contenuto del file compose in un nuovo stack. Il file grezzo è qui:
https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml - 3
Imposta la variabile d'ambiente ed esegui il deploy
Aggiungila nella sezione ambiente dello stack, quindi esegui il deploy.
DATA_DIR_HOST={{dataDir}} Poi apri il pannello
http://{{host}}:25564La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.
- 1
Controlla i requisiti
Node.js 24 o più recente, pnpm e Docker in esecuzione (Docker Desktop su Windows e macOS).
node --version # 24 or newer docker info # daemon reachable - 2
Clona e installa
Il passaggio di installazione compila anche il CSS del pannello. Nessun modulo nativo da compilare.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install - 3
Avvia il pannello
Per impostazione predefinita ascolta solo su localhost. Imposta PANEL_HOST=0.0.0.0 per raggiungerlo da altre macchine sulla tua rete.
pnpm start Poi apri il pannello
http://localhost:25564La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.
- 1
Avvia da un'installazione da sorgente
Esegui questo dalla cartella clonata. PM2 avvia le app con la versione di Node che ha avviato il suo demone, quindi fissa l'interprete.
pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)" - 2
Salva la lista dei processi e abilita l'avvio automatico
pm2 startup stampa un comando da eseguire con sudo; eseguilo una volta.
pm2 save pm2 startup - 3
Preferisci systemd?
Un'unità che esegue node src/server.js dalla cartella clonata con WorkingDirectory impostato funziona allo stesso modo. Il pannello non necessita di flag aggiuntivi.
Poi apri il pannello
http://{{host}}:25564La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.
Opzione 1: Docker
Opzioni di installazione
L'installer per Linux accetta le sue opzioni dopo bash -s --, quindi funzionano anche tramite pipe. Eseguilo di nuovo con le stesse opzioni per aggiornare; la tua cartella dati, le modifiche a .env e compose vengono mantenute.
--port 8080Servi il pannello su un'altra porta.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --port 8080--bind 127.0.0.1Ascolta solo su 127.0.0.1, per un reverse proxy con TLS davanti.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.1Fissa un rilascio invece di seguire l'ultimo.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --tag v0.14.1--dir /srv/msmInstalla altrove rispetto a /opt/msm.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --dir /srv/msm--uninstall --yesRimuovi il pannello e mantieni i suoi dati. Tramite pipe non c'è tastiera per rispondere alla domanda, quindi aggiungi --yes; aggiungi anche --purge per eliminare la cartella dati.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --uninstall --yes--helpOgni opzione, con il suo valore predefinito.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --help
Requisiti
- Docker Engine (Linux) o Docker Desktop (Windows, macOS).
- Docker
- Linux
Windows- macOS
- Node.js 24 o versione successiva per l'installazione da sorgente. L'immagine Docker include la propria.
- Node.js 24+
- Alcuni gigabyte di spazio su disco per le immagini dei server e i mondi.
Note per Windows
- Docker Desktop deve essere in esecuzione prima di avviare o creare server.
- Condividi la tua unità di progetto con Docker Desktop (Impostazioni, Risorse, Condivisione file) in modo che i bind mount funzionino.
- L'immagine Docker è destinata ad host Linux; su Windows e macOS esegui il pannello da sorgente.

Come salutare
Segnala bug, suggerisci funzionalità, ottieni aiuto da persone reali e mostra i tuoi server.
