Salta al contenuto
MSM

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. 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. 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. 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. 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. 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. 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. 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. 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. 1

    Crea la cartella dati

    Una cartella contiene tutto ciò che possiede il pannello.

    mkdir -p {{dataDir}}
  2. 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. 3

    Avvia il pannello

    L'immagine è multi-arch (amd64 e arm64) e si aggiorna ad ogni rilascio.

    docker compose up -d
  4. Poi apri il pannello

    http://{{host}}:25564

    La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.

  1. 1

    Crea la cartella dati sull'host

    Stessa regola della cartella: percorso assoluto, sulla macchina che esegue Docker.

    mkdir -p {{dataDir}}
  2. 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. 3

    Imposta la variabile d'ambiente ed esegui il deploy

    Aggiungila nella sezione ambiente dello stack, quindi esegui il deploy.

    DATA_DIR_HOST={{dataDir}}
  4. Poi apri il pannello

    http://{{host}}:25564

    La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.

  1. 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. 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. 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
  4. Poi apri il pannello

    http://localhost:25564

    La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.

  1. 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. 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. 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.

  4. Poi apri il pannello

    http://{{host}}:25564

    La prima esecuzione ti guida attraverso un controllo di sistema, il tuo fuso orario e la creazione dell'account amministratore.

Opzione 1: Docker

Il pannello controlla il demone Docker dell'host tramite il socket montato, che è equivalente a root sull'host. Tratta il login admin di conseguenza e non esporre mai il pannello direttamente su Internet.

Scarica docker-compose.ymlLeggi la guida introduttiva

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

Note per Windows

Come salutare

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