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.
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,
curlejq - 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:
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/backupsInstallare Velocity
Crea uno script che scarica l'ultima build stabile e ne controlla il checksum. Ti servirà di nuovo per gli aggiornamenti:
sudo nano /opt/minecraft/velocity-update.sh#!/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:
sudo chmod 755 /opt/minecraft/velocity-update.sh
sudo -u minecraft /opt/minecraft/velocity-update.sh 4.3.1La riga velocity.jar.new: OK conferma che il file è integro.
Crea il servizio:
sudo nano /etc/systemd/system/velocity.service[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.targetQueste opzioni Java sono quelle consigliate dalla documentazione di Velocity. Avvia il proxy una prima volta per generare la sua configurazione:
sudo systemctl daemon-reload
sudo systemctl start velocity.service
sudo journalctl -u velocity.service -n 30 --no-pagerAttendi 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:
sudo systemctl stop velocity.service
sudo chmod 700 /opt/minecraft/velocity
sudo ls -l /opt/minecraft/velocityDovresti vedere velocity.toml e forwarding.secret.
Configurare Velocity
sudo -u minecraft nano /opt/minecraft/velocity/velocity.tomlVerifica o modifica queste righe, all'inizio del file:
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]:
[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:
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.propertiesAttiva poi l'inoltro moderno nella configurazione di Paper, con il secret generato da Velocity:
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/configControlla il risultato senza mostrare il secret:
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.ymlDovresti 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:
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.txtCrea le sue impostazioni, con un mondo superpiatto e senza mostri:
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
EOFCrea il suo servizio:
sudo nano /etc/systemd/system/minecraft-lobby.service[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.targetAvviare tutto
Avvia i due server, poi segui il primo avvio del lobby fino alla riga Done:
sudo systemctl daemon-reload
sudo systemctl start minecraft.service
sudo systemctl enable --now minecraft-lobby.service
sudo journalctl -u minecraft-lobby.service -fEsci dalla visualizzazione dei log con Ctrl+C, poi avvia il proxy:
sudo systemctl enable --now velocity.service
sudo journalctl -u velocity.service -n 30 --no-pagerVerificare che le porte interne siano chiuse
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:
sudo ufw status | grep -E '2556[67]'Da un altro computer, prova poi le porte. La prima deve rispondere, la seconda deve fallire:
nc -zv -w 5 IP_SERVER 25565
nc -zv -w 5 IP_SERVER 25566Se 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:
sudo ufw allow from IP_DEL_PROXY to any port 25566 proto tcpOppure con iptables:
sudo iptables -A INPUT -p tcp -s IP_DEL_PROXY --dport 25566 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 25566 -j DROPVerificare il risultato
Controlla innanzitutto i tre servizi:
systemctl is-active velocity.service minecraft.service minecraft-lobby.serviceConnettiti poi con il tuo client Minecraft, allo stesso indirizzo di prima. Dovresti arrivare nel lobby. Digita quindi:
/server
/server survieIl 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:
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:
sudo chmod 700 /opt/minecraft/backupsAggiungi 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:
tar -czf $BACKUP_DIR/world_proxy_$DATE.tar.gz -C /opt/minecraft velocity lobbyAggiornare
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:
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.serviceAggiorna poi il server survie come indicato nella guida Paper, quindi copia il suo file nel lobby:
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.serviceTornare indietro
Per tornare a un unico server sulla porta 25565, senza perdere ciò che è stato giocato nel frattempo:
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.serviceLe 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:
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.