IT

Server di gioco

Come collegare più server Minecraft con Velocity

Collega più server Paper dietro il proxy Velocity su un VPS o server dedicato Linux: inoltro sicuro dei giocatori, porte interne chiuse e ritorno alla situazione iniziale.

10 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Velocity è un proxy Minecraft: i giocatori si connettono a un unico indirizzo, poi passano da un server all'altro senza disconnettersi. Questa guida mette il tuo server esistente dietro Velocity e gli affianca un server lobby, sulla stessa macchina.

È il seguito delle guide Creare un server Minecraft e Installare e aggiornare i plugin su Paper. Riutilizza l'utente minecraft, la cartella /opt/minecraft/server, il servizio minecraft.service e il comando mc-console.

Al termine di questa guida avrai:

  • Velocity in ascolto sulla porta pubblica 25565, quindi lo stesso indirizzo per i tuoi giocatori
  • due server Paper raggiungibili solo dalla macchina stessa
  • un inoltro sicuro dell'identità dei giocatori, con UUID e inventari conservati

Prerequisiti

  • Un server Paper, installato seguendo le due guide citate sopra, con Java 25, curl e jq
  • Accesso SSH con un utente che dispone di sudo
  • Circa 2 GB di memoria libera oltre a quella del server attuale: 1 GB per Velocity e fino a 1 GB per il lobby
  • Spazio su disco sufficiente per una copia completa della cartella del server

Velocity, BungeeCord o Waterfall?

Velocity BungeeCord Waterfall
Progetto PaperMC, sviluppo attivo SpigotMC, il proxy storico PaperMC, fine del ciclo di vita
Inoltro sicuro dell'identità Sì, firmato con un secret No No
Plugin API Velocity API BungeeCord API BungeeCord

PaperMC consiglia Velocity rispetto a BungeeCord e Waterfall, e non mantiene più Waterfall.

BungeeCord resta una scelta difendibile in un solo caso: un plugin per proxy indispensabile che non esiste per Velocity, perché Velocity non carica i plugin BungeeCord. Poiché il suo inoltro dell'identità non è firmato, la chiusura delle porte interne descritta più avanti è ancora più importante.

Capire l'installazione finale

Servizio Nome in Velocity Cartella Indirizzo di ascolto Raggiungibile da
velocity.service /opt/minecraft/velocity 0.0.0.0:25565 Internet
minecraft.service survie /opt/minecraft/server 127.0.0.1:25566 Solo dalla macchina
minecraft-lobby.service lobby /opt/minecraft/lobby 127.0.0.1:25567 Solo dalla macchina

Eseguire il backup del server

Arresta il server, poi crea un archivio completo. Il server resta arrestato fino al termine della configurazione, perché Velocity prenderà il suo posto sulla porta 25565:

Terminale
sudo systemctl stop minecraft.service
sudo mkdir -p /opt/minecraft/backups
sudo tar -czf /opt/minecraft/backups/avant-velocity-$(date +%F-%H%M).tar.gz -C /opt/minecraft server
sudo ls -lh /opt/minecraft/backups

Installare Velocity

Crea uno script che scarica l'ultima build stabile e ne controlla il checksum. Ti servirà di nuovo per gli aggiornamenti:

Terminale
sudo nano /opt/minecraft/velocity-update.sh
Terminale
#!/bin/bash
# Scarica l'ultima build stabile di Velocity e sostituisce velocity.jar
set -euo pipefail

VERSION="${1:?Indica la versione di Velocity, ad esempio 4.3.1}"
UA="mon-serveur-minecraft/1.0 (https://tuo-dominio.com)"
API="https://fill.papermc.io/v3/projects/velocity/versions/$VERSION/builds"

mkdir -p /opt/minecraft/velocity
cd /opt/minecraft/velocity

BUILD=$(curl -fsSL -H "User-Agent: $UA" "$API" | jq -c 'map(select(.channel == "STABLE")) | .[0]')
if [ "$BUILD" = "null" ]; then
    echo "Nessuna build stabile trovata per Velocity $VERSION." >&2
    exit 1
fi

URL=$(echo "$BUILD" | jq -r '.downloads."server:default".url')
SHA256=$(echo "$BUILD" | jq -r '.downloads."server:default".checksums.sha256')

curl -fL -H "User-Agent: $UA" -o velocity.jar.new "$URL"
echo "$SHA256  velocity.jar.new" | sha256sum -c -

if [ -f velocity.jar ]; then
    mv velocity.jar velocity.jar.old
fi
mv velocity.jar.new velocity.jar
echo "Velocity $VERSION, build $(echo "$BUILD" | jq -r '.id'), è stato installato."

Nella riga UA, sostituisci tuo-dominio.com con l'indirizzo del tuo sito o con un modo per contattarti. Avvia poi lo script:

Terminale
sudo chmod 755 /opt/minecraft/velocity-update.sh
sudo -u minecraft /opt/minecraft/velocity-update.sh 4.3.1

La riga velocity.jar.new: OK conferma che il file è integro.

Crea il servizio:

Terminale
sudo nano /etc/systemd/system/velocity.service
Configurazione
[Unit]
Description=Proxy Minecraft Velocity
After=network.target

[Service]
User=minecraft
WorkingDirectory=/opt/minecraft/velocity
ExecStart=/usr/bin/java -Xms1G -Xmx1G -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -XX:MaxInlineLevel=15 -jar /opt/minecraft/velocity/velocity.jar
SuccessExitStatus=130 143
Restart=on-failure
RestartSec=20
StandardInput=null

[Install]
WantedBy=multi-user.target

Queste opzioni Java sono quelle consigliate dalla documentazione di Velocity. Avvia il proxy una prima volta per generare la sua configurazione:

Terminale
sudo systemctl daemon-reload
sudo systemctl start velocity.service
sudo journalctl -u velocity.service -n 30 --no-pager

Attendi la riga Done. L'avviso Player info forwarding is disabled! è normale in questa fase. Arresta poi il proxy e proteggi la sua cartella, che contiene il secret:

Terminale
sudo systemctl stop velocity.service
sudo chmod 700 /opt/minecraft/velocity
sudo ls -l /opt/minecraft/velocity

Dovresti vedere velocity.toml e forwarding.secret.

Configurare Velocity

Terminale
sudo -u minecraft nano /opt/minecraft/velocity/velocity.toml

Verifica o modifica queste righe, all'inizio del file:

toml
bind = "0.0.0.0:25565"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

Sostituisci poi tutto il contenuto delle sezioni [servers] e [forced-hosts]:

toml
[servers]
lobby = "127.0.0.1:25567"
survie = "127.0.0.1:25566"

try = [
    "lobby",
    "survie"
]

[forced-hosts]

try indica l'ordine in cui vengono provati i server alla connessione, o quando un giocatore viene espulso da un server. La sezione [forced-hosts] resta vuota: gli esempi forniti puntano ai server factions e minigames, che da te non esistono, e Velocity si rifiuterebbe di avviarsi.

Collegare il server esistente

Metti il server in ascolto sull'interfaccia di loopback, sulla sua nuova porta, e affida l'autenticazione al proxy:

Terminale
sudo -u minecraft sed -i \
    -e 's/^server-ip=.*/server-ip=127.0.0.1/' \
    -e 's/^server-port=.*/server-port=25566/' \
    -e 's/^online-mode=.*/online-mode=false/' \
    /opt/minecraft/server/server.properties
sudo grep -E '^(server-ip|server-port|online-mode)=' /opt/minecraft/server/server.properties

Attiva poi l'inoltro moderno nella configurazione di Paper, con il secret generato da Velocity:

Terminale
SECRET=$(sudo cat /opt/minecraft/velocity/forwarding.secret)
sudo -u minecraft sed -i "/^  velocity:/,/^ \{0,2\}[a-z]/{s/^    enabled: .*/    enabled: true/;s/^    online-mode: .*/    online-mode: true/;s/^    secret: .*/    secret: '$SECRET'/;}" /opt/minecraft/server/config/paper-global.yml
unset SECRET
sudo chmod 700 /opt/minecraft/server/config

Controlla il risultato senza mostrare il secret:

Terminale
sudo grep -A3 '^  velocity:' /opt/minecraft/server/config/paper-global.yml | sed 's/secret: .*/secret: (nascosto)/'
sudo grep -qF "$(sudo cat /opt/minecraft/velocity/forwarding.secret)" /opt/minecraft/server/config/paper-global.yml && echo "Secret identico" || echo "Secret diverso"
sudo grep 'bungeecord:' /opt/minecraft/server/spigot.yml

Dovresti ottenere enabled: true, online-mode: true, Secret identico e bungeecord: false. Quest'ultima impostazione deve restare su false con l'inoltro moderno.

Creare il server lobby

Il lobby riutilizza lo stesso server.jar e la stessa configurazione globale di Paper:

Terminale
sudo -u minecraft mkdir -p /opt/minecraft/lobby/config
sudo chmod 700 /opt/minecraft/lobby/config
sudo -u minecraft cp /opt/minecraft/server/server.jar /opt/minecraft/lobby/
sudo -u minecraft cp /opt/minecraft/server/config/paper-global.yml /opt/minecraft/lobby/config/
echo "eula=true" | sudo -u minecraft tee /opt/minecraft/lobby/eula.txt

Crea le sue impostazioni, con un mondo superpiatto e senza mostri:

Terminale
sudo -u minecraft tee /opt/minecraft/lobby/server.properties > /dev/null <<'EOF'
server-ip=127.0.0.1
server-port=25567
online-mode=false
motd=Lobby
max-players=50
level-type=minecraft\:flat
generate-structures=false
gamemode=adventure
force-gamemode=true
difficulty=peaceful
allow-nether=false
view-distance=6
simulation-distance=4
EOF

Crea il suo servizio:

Terminale
sudo nano /etc/systemd/system/minecraft-lobby.service
Configurazione
[Unit]
Description=Minecraft Lobby Server
After=network.target

[Service]
User=minecraft
WorkingDirectory=/opt/minecraft/lobby
ExecStart=/usr/bin/java -Xms512M -Xmx1G -jar /opt/minecraft/lobby/server.jar nogui
ExecStop=/bin/kill -SIGINT $MAINPID
SuccessExitStatus=130 143
TimeoutStopSec=180
Restart=on-failure
RestartSec=20
StandardInput=null

[Install]
WantedBy=multi-user.target

Avviare tutto

Avvia i due server, poi segui il primo avvio del lobby fino alla riga Done:

Terminale
sudo systemctl daemon-reload
sudo systemctl start minecraft.service
sudo systemctl enable --now minecraft-lobby.service
sudo journalctl -u minecraft-lobby.service -f

Esci dalla visualizzazione dei log con Ctrl+C, poi avvia il proxy:

Terminale
sudo systemctl enable --now velocity.service
sudo journalctl -u velocity.service -n 30 --no-pager

Verificare che le porte interne siano chiuse

Terminale
sudo ss -ltnp | grep -E ':(25565|25566|25567)\b'

La porta 25565 deve essere in ascolto su tutti gli indirizzi. Le porte 25566 e 25567 devono mostrare 127.0.0.1 o [::ffff:127.0.0.1], mai 0.0.0.0, * o [::].

Il firewall non cambia: resta aperta solo la porta 25565. Con UFW, questo comando non deve mostrare nulla:

Terminale
sudo ufw status | grep -E '2556[67]'

Da un altro computer, prova poi le porte. La prima deve rispondere, la seconda deve fallire:

Terminale
nc -zv -w 5 IP_SERVER 25565
nc -zv -w 5 IP_SERVER 25566

Se un server si trova su un'altra macchina

L'interfaccia di loopback funziona solo all'interno di una singola macchina. Su una seconda macchina, metti il server in ascolto su un indirizzo privato, idealmente quello di un tunnel WireGuard, indica questo indirizzo in velocity.toml, poi autorizza solo il proxy. Su questa seconda macchina, con UFW:

Terminale
sudo ufw allow from IP_DEL_PROXY to any port 25566 proto tcp

Oppure con iptables:

Terminale
sudo iptables -A INPUT -p tcp -s IP_DEL_PROXY --dport 25566 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 25566 -j DROP

Verificare il risultato

Controlla innanzitutto i tre servizi:

Terminale
systemctl is-active velocity.service minecraft.service minecraft-lobby.service

Connettiti poi con il tuo client Minecraft, allo stesso indirizzo di prima. Dovresti arrivare nel lobby. Digita quindi:

Testo
/server
/server survie

Il primo comando elenca i server, il secondo ti trasferisce senza disconnetterti. Le tue costruzioni e il tuo inventario devono essere ancora lì. Controlla infine ciò che il server ha ricevuto:

Terminale
sudo journalctl -u minecraft.service --since "10 minutes ago" --no-pager | grep -E 'UUID of player|logged in with entity id'

Dovresti vedere il tuo indirizzo IP pubblico, e non 127.0.0.1. Il terzo blocco dell'UUID deve iniziare con 4, segno di un account autenticato.

Plugin e proxy

I plugin Paper restano nella cartella plugins di ogni server. Velocity ha i propri plugin, da mettere in /opt/minecraft/velocity/plugins e da caricare riavviando il proxy.

Se usi Geyser e Floodgate, la loro installazione cambia dietro un proxy: segui la documentazione di Floodgate per Velocity.

Eseguire il backup del proxy e del lobby

Lo script backup.sh della guida di base non copre queste cartelle. Proteggi innanzitutto la cartella degli archivi, perché conterranno il secret:

Terminale
sudo chmod 700 /opt/minecraft/backups

Aggiungi poi questa riga a /opt/minecraft/backup.sh, dopo la riga tar esistente. Il prefisso world_ fa sì che la pulizia automatica dello script tenga conto di questo archivio:

Terminale
tar -czf $BACKUP_DIR/world_proxy_$DATE.tar.gz -C /opt/minecraft velocity lobby

Aggiornare

Quando esce una nuova versione di Minecraft, aggiorna Velocity prima dei server, in modo che accetti i nuovi client. I giocatori vengono disconnessi durante l'operazione:

Terminale
sudo systemctl stop velocity.service
sudo tar -czf /opt/minecraft/backups/velocity-$(date +%F-%H%M).tar.gz -C /opt/minecraft velocity
sudo -u minecraft /opt/minecraft/velocity-update.sh 4.3.1
sudo systemctl start velocity.service

Aggiorna poi il server survie come indicato nella guida Paper, quindi copia il suo file nel lobby:

Terminale
sudo systemctl stop minecraft-lobby.service
sudo tar -czf /opt/minecraft/backups/lobby-$(date +%F-%H%M).tar.gz -C /opt/minecraft lobby
sudo -u minecraft cp /opt/minecraft/server/server.jar /opt/minecraft/lobby/server.jar
sudo systemctl start minecraft-lobby.service

Tornare indietro

Per tornare a un unico server sulla porta 25565, senza perdere ciò che è stato giocato nel frattempo:

Terminale
sudo systemctl disable --now velocity.service minecraft-lobby.service
sudo systemctl stop minecraft.service
sudo -u minecraft sed -i \
    -e 's/^server-ip=.*/server-ip=/' \
    -e 's/^server-port=.*/server-port=25565/' \
    -e 's/^online-mode=.*/online-mode=true/' \
    /opt/minecraft/server/server.properties
sudo -u minecraft sed -i "/^  velocity:/,/^ \{0,2\}[a-z]/{s/^    enabled: .*/    enabled: false/;s/^    secret: .*/    secret: ''/;}" /opt/minecraft/server/config/paper-global.yml
sudo systemctl start minecraft.service

Le cartelle velocity e lobby restano al loro posto. In caso di problemi più gravi, ripristina l'archivio avant-velocity-… come descritto nella sezione Ripristinare il backup della guida Paper.

In caso di problemi

Inizia dai log del proxy e del server interessato:

Terminale
sudo journalctl -u velocity.service -n 100 --no-pager
sudo journalctl -u minecraft.service -n 100 --no-pager
sudo journalctl -u minecraft-lobby.service -n 100 --no-pager

« Unable to connect you to lobby. Please try again later. »

Velocity non riesce a raggiungere questo server. Verifica che sia avviato e che abbia terminato il caricamento, poi che la porta in velocity.toml corrisponda a server-port. Il comando ss visto sopra mostra le porte effettivamente aperte.

« There are no available servers to connect you to. »

Nessun server dell'elenco try ha accettato il giocatore. Controlla questo elenco e avvia almeno uno di questi server.

« Your server did not send a forwarding request to the proxy »

L'inoltro moderno non è attivo sul server Paper. Verifica enabled: true in config/paper-global.yml, poi riavvia il server. Se i suoi log mostrano Velocity is enabled, but no secret key was specified, il secret è vuoto: riprendi la sezione Collegare il server esistente.

« Unable to verify player details »

Il secret di Paper non corrisponde a forwarding.secret. Esegui di nuovo il comando di copia del secret sul server interessato, poi riavvialo. Per il lobby, usa il percorso /opt/minecraft/lobby/config/paper-global.yml.

« This server requires you to connect with Velocity. »

Il giocatore raggiunge il server Paper senza passare dal proxy, oppure Velocity non usa la modalità modern. Verifica player-info-forwarding-mode e l'indirizzo usato dal giocatore. Se ha potuto raggiungere la porta 25566 da Internet, richiudila immediatamente.

« This server is only compatible with Minecraft 1.13 and above. »

L'inoltro moderno rifiuta i client precedenti alla 1.13. Questi giocatori devono passare a una versione più recente.

Velocity non si avvia

Messaggio nei log Causa Soluzione
Can't bind to …:25565 La porta è già occupata, spesso da un server Minecraft Verifica server-port e usa sudo ss -ltnp
Server 'factions' for forced host '…' does not exist È rimasto un esempio in [forced-hosts] Svuota la sezione
Fallback server … is not registered in your configuration! Un nome di try non è presente in [servers] Correggi il nome
You don't have a forwarding secret set Il file del secret è vuoto o non viene trovato Verifica forwarding.secret
UnsupportedClassVersionError Java è troppo vecchio Installa Java 25

« FAILED TO BIND TO PORT » su un server Paper

Due servizi usano la stessa porta. Verifica server-port in ogni server.properties: 25566 per survie, 25567 per il lobby.

I giocatori hanno perso il loro inventario

Il server ha assegnato loro un altro UUID, in genere perché l'inoltro non era attivo o perché proxies.velocity.online-mode non corrisponde a online-mode di Velocity. Arresta il server, correggi queste impostazioni e riavvialo: i dati originali restano nel mondo, sotto il vecchio UUID.

Per approfondire, consulta la documentazione ufficiale di Velocity, in particolare le pagine sull'inoltro dei giocatori e sulla sicurezza.