Come ospitare un server Lavalink 24/7

Per tenere online un server Lavalink 24/7 servono quattro cose: una macchina che non si spegne mai, Java 17 o successivo, il Lavalink.jar dalle release GitHub di Lavalink con un application.yml che imposta la tua password, e qualcosa che riavvii Lavalink dopo un crash o un riavvio della macchina. Il tuo bot si collega poi con indirizzo, porta e password del server. Per YouTube serve anche il plugin YouTube, con l’accesso fatto da un account Google di riserva; la sua versione attuale richiede qualcosa in più, vedi Come riprodurre YouTube su Lavalink 4. Un piano Lavalink PlayNHost ha tutto già installato: Lavalink 4.2.2, il plugin YouTube e una password creata per il tuo nodo. Nel nostro test sul piano da 1 GB era pronto da 11 a 13 secondi dopo l’avvio e usava circa 240 MiB di memoria a riposo.

Di cosa ha bisogno un server Lavalink 24/7

Eseguilo sul tuo server Linux

Questi sono i passaggi della documentazione di Lavalink.

1. Installa Java 17 o successivo e controllalo con java -version.
2. Crea una cartella, ad esempio /home/lavalink/lavalink, e mettici dentro Lavalink.jar, scaricato dall’ultima release su GitHub di Lavalink. Il 6 novembre 2026 è la 4.2.2.
3. Accanto, crea application.yml. Il file più semplice che serve imposta porta, indirizzo e una password tua, e disattiva la vecchia fonte YouTube integrata, che Lavalink non aggiorna più:

server:
  port: 2333
  address: 0.0.0.0
lavalink:
  server:
    password: "change-this-to-a-long-random-password"
    sources:
      youtube: false
      soundcloud: true
      http: true

4. Avvialo una volta a mano con java -jar Lavalink.jar e aspetta Lavalink is ready to accept connections.
5. Per tenerlo in esecuzione, trasformalo in un servizio systemd. La documentazione di Lavalink fornisce questa unit; salvala come /usr/lib/systemd/system/lavalink.service con il tuo utente e la tua cartella:

[Unit]
Description=Lavalink Service
After=syslog.target network.target

[Service]
User=lavalink
Group=lavalink
WorkingDirectory=/home/lavalink/lavalink
ExecStart=java -Xmx4G -jar /home/lavalink/lavalink/Lavalink.jar
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

6. Esegui sudo systemctl daemon-reload, sudo systemctl enable lavalink e sudo systemctl start lavalink. sudo journalctl -u lavalink mostra il suo log.
7. Imposta -Xmx in base alla macchina: -Xmx4G lascia crescere l’heap di Java fino a 4 GB, più di quanto abbia un piccolo server. Apri la porta nel firewall, poi provalo come al passaggio 2 qui sotto.

Da lì in poi aggiorni tu Java, Lavalink e i suoi plugin, e tieni d’occhio i crash. Per YouTube serve il plugin: Come riprodurre YouTube su Lavalink 4.

Su un piano PlayNHost: cosa prepara l’installazione

• Lavalink 4.2.2, scaricato dalla release di Lavalink su GitHub e controllato con un checksum fisso.
• Il plugin della fonte YouTube, versione 1.18.2 con correzioni PlayNHost, nella cartella plugins come youtube-plugin-1.18.2-playnhost1.jar.
• Un application.yml con una password creata apposta per il tuo nodo, e queste fonti attive: Bandcamp, Twitch, Vimeo, Niconico e link http diretti. Le fonti SoundCloud e YouTube di Lavalink sono disattivate; YouTube passa dal plugin. Tutti i filtri audio (equalizzatore, timescale, karaoke e gli altri) sono attivi.

Una reinstallazione successiva mantiene il tuo application.yml e stampa Kept your application.yml.

1. Trova indirizzo e password

1. Apri il tuo server nel pannello. Panoramica mostra il riquadro Lavalink con Nome del node, Indirizzo e Password.
2. Accanto a Indirizzo, premi l'icona di copia. Copia host:port.
3. Password dice Nel file application.yml. Premi Apri application.yml. Sotto lavalink: e server:, copia il valore di password: senza le virgolette.

Tratta la password come una chiave: chiunque abbia indirizzo e password può usare il tuo nodo. Per cambiarla, modifica password: nello stesso file, salva, riavvia il nodo e aggiorna il tuo bot.

2. Avvialo e controllalo

1. Apri Console (oppure premi Log nel riquadro) e premi Avvia.
2. Lavalink è pronto quando la console mostra:

Lavalink is ready to accept connections.

3. Per provarlo dal tuo computer, chiedi al nodo la sua versione con la tua password:

curl -H "Authorization: YOUR_PASSWORD" http://HOST:PORT/version

Risponde 4.2.2 quando funziona. 403 significa che la password è sbagliata, 401 che manca l'header Authorization; nessuna risposta significa che l'indirizzo è sbagliato o che il nodo è fermo.

Poi collega il tuo bot: Come collegare il tuo bot Discord a Lavalink. Il nodo usa http e ws semplici, quindi lascia disattivata l'opzione sicura o SSL nel tuo client. Il tuo client deve essere una release che supporta la cifratura vocale DAVE di Discord; la guida alla connessione elenca le versioni.

3. Accedi a YouTube una volta sola

Al primo avvio la console ti chiede di far accedere il plugin YouTube a un account Google, con una riga come:

OAUTH INTEGRATION: To give youtube-source access to your account, go to https://www.google.com/device and enter code XXXX-XXXX

Usa un account Google di riserva creato per questo, mai il tuo: gli autori del plugin avvertono che l’account può essere chiuso. Nel nostro test del 6 novembre 2026 (un test di avvio di 15 secondi per brano, senza canale vocale), il nodo non è riuscito ad avviare nessuno di 12 brani YouTube prima dell’accesso, e ha avviato senza errori tutti i 10 test completati dopo. Se YouTube serva o no un brano a un server lo decide YouTube, e non possiamo prometterlo. I passaggi, e come mantenere l’accesso dopo un riavvio: Come riprodurre YouTube su Lavalink 4.

Cosa riscrive il pannello a ogni avvio

Due valori in application.yml vengono impostati dal pannello a ogni avvio del nodo. Le modifiche a questi valori vengono rimesse com'erano:

• server.port: la porta del tuo server, l'unica aperta verso internet. Il 2333 scritto all'installazione viene sostituito.
• plugins.youtube.remoteCipher.url: un servizio PlayNHost usato dal plugin YouTube, raggiungibile solo dai nostri server.

Versione

Il riquadro Impostazioni, Impostazioni di gioco, ha un campo Versione impostato su 4.2.2, la versione che testiamo e supportiamo. Il 6 novembre 2026 è anche l’ultima release di Lavalink. Le altre versioni vengono scaricate senza checksum e non sono supportate. Il valore viene letto solo durante l'installazione del server, quindi si applica quando reinstalli.

Reinstalla

Una reinstallazione scarica di nuovo Lavalink e i suoi plugin, e ripara anche un Lavalink.jar o un file di plugin danneggiato o eliminato. Il tuo application.yml, con la sua password e le tue modifiche, resta.

1. Apri il riquadro Impostazioni e clicca su Dettagli di avvio.
2. Nel riquadro Reinstalla ("Scarica di nuovo Lavalink e i suoi plugin, alle versioni testate da PlayNHost. Il tuo application.yml resta."), premi Reinstalla.
3. Conferma in Reinstallare questo server? premendo Reinstalla. Il nodo si ferma mentre l'installazione è in corso.
4. Quando ha finito, premi Avvia in Console.

I plugin che hai caricato tu restano nella cartella plugins. L'installazione sostituisce solo il file del plugin YouTube che fornisce.

Quanta memoria usa un nodo Lavalink

Sui nostri piani l’heap Java di Lavalink è limitato a tre quarti del limite di memoria del server. Il 6 novembre 2026 abbiamo avviato il nodo installato tre o quattro volte per ogni dimensione di piano, con gli stessi limiti di memoria e CPU, la stessa immagine e lo stesso comando di avvio del pannello, su uno dei nostri nodi di produzione carichi, e letto la sua memoria 60 secondi dopo che era pronto, senza bot collegati:

Un nodo inattivo ha usato più o meno la stessa memoria su ogni piano, circa un quarto del piano da 1 GB. I piani più grandi lasciano all’heap spazio per crescere e, con più CPU, nel nostro test sono partiti più in fretta. Ogni player che trasmette si aggiunge a questo. Non abbiamo ancora misurato quanti player regge ogni piano, quindi non diamo numeri. Guarda il riquadro Utilizzo in Panoramica dopo un giorno di uso reale: Come leggere i grafici di utilizzo del tuo server.

Ti serve un nodo Lavalink tutto tuo?

Un nodo pubblico gratuito va bene per fare prove o per un piccolo bot privato. Un bot su cui la gente conta sta meglio su un nodo che controlli tu, perché scegli plugin, fonti e password.

Prima di affidarti a un nodo pubblico, controlla che la versione principale di Lavalink corrisponda al tuo client: un client per la versione 3 non funziona con un nodo versione 4. Passare più avanti a un nodo tutto tuo significa cambiare tre valori nel tuo bot: host, porta e password. Piani: Hosting Lavalink.

Poi

• Collega il tuo bot: Come collegare il tuo bot Discord a Lavalink.
• Riproduci YouTube: Come riprodurre YouTube su Lavalink 4.
• Aggiungi fonti e funzioni: Come aggiungere plugin a Lavalink.
• Qualcosa non funziona: Errori Lavalink e cosa significano.