Come ospitare un server Lavalink

Cosa serve a Lavalink

• Java 17 o successivo. Lavalink consiglia l'ultima versione LTS.
• Lavalink 4.2 o successivo. Da marzo 2026 Discord consente solo voce con crittografia end-to-end (il protocollo DAVE), e Lavalink 4.2.0 è stata la prima versione a supportarla. I server più vecchi non riescono più a riprodurre audio su Discord.
• Una libreria client nel tuo bot che supporti la stessa versione — le attuali lavalink-client, Shoukaku, Wavelink, lavalink.py e altre lo fanno. Come sceglierne una è spiegato in come creare un bot musicale per Discord.
• Una macchina sempre accesa, perché la musica si ferma quando si ferma Lavalink.

Scaricare e avviare Lavalink

1. Scarica Lavalink.jar dall'ultima release su GitHub in una cartella vuota.
2. Crea application.yml nella stessa cartella (sezione successiva).
3. Avvialo da quella cartella:

java -jar Lavalink.jar

Lavalink è pronto quando il log indica che si è avviato. Su un server Linux, la documentazione di Lavalink consiglia di eseguirlo come servizio systemd, così si riavvia dopo un crash e dopo un riavvio del sistema; è disponibile anche un'immagine Docker.

Configurare application.yml

Una configurazione minima di Lavalink 4 con il plugin YouTube:

server:
  port: 2333
  address: 0.0.0.0
lavalink:
  plugins:
    - dependency: "dev.lavalink.youtube:youtube-plugin:1.18.2"
      snapshot: false
  server:
    password: "a-long-random-password"
    sources:
      youtube: false
      soundcloud: true
      bandcamp: true
      twitch: true
      vimeo: true
      http: true
      local: false
plugins:
  youtube:
    enabled: true
    allowSearch: true

• password — cambiala. La configurazione di esempio usa youshallnotpass, che è pubblica; chiunque trovi il tuo server potrebbe usarlo con quella predefinita.
• port — 2333 per impostazione predefinita; il tuo bot si collega a questa porta.
• sources.youtube: false — la sorgente YouTube integrata è deprecata. Il plugin la sostituisce, e la sua documentazione dice che quella integrata va disattivata.
• http: true permette al bot di riprodurre link diretti; l'esempio ufficiale avverte che senza un proxy questo può rivelare l'IP del tuo server.

YouTube, Spotify e altre sorgenti

I plugin si elencano sotto lavalink.plugins e vengono scaricati all'avvio. Due vale la pena conoscerli:

• youtube-source (dev.lavalink.youtube:youtube-plugin) — riproduzione e ricerca su YouTube. YouTube blocca attivamente l'accesso automatizzato, quindi può smettere di funzionare finché il plugin non viene aggiornato; tienilo all'ultima versione.
• LavaSrc (com.github.topi314.lavasrc:lavasrc-plugin) — aggiunge Spotify, Apple Music, Deezer e altro. Dai link di Spotify e Apple Music si leggono i dettagli del brano, e l'audio viene riprodotto da un'altra sorgente.

Collegare il bot a Lavalink

Ogni client Lavalink chiede gli stessi quattro valori, che formano un nodo:

Ad esempio, Wavelink in Python accetta wavelink.Node(uri="http://your-host:2333", password="..."). Se il bot non riesce a collegarsi, controlla prima la password, poi che la porta sia raggiungibile da dove gira il bot.

Hosting Lavalink su HytHost

1. Scegli Lavalink come runtime. Su hosting per bot Discord, scegli un piano e seleziona Lavalink come linguaggio. Il server installa l'ultima versione di Lavalink su Java 21 con la configurazione di esempio ufficiale.
2. Cambia la password. Apri application.yml nel file manager e sostituisci la password predefinita. Il pannello imposta già l'indirizzo e la porta sulla porta del tuo server, quindi lascia questi due come sono.
3. Aggiungi il plugin YouTube se vuoi YouTube: il blocco del plugin e youtube: false dalla configurazione sopra, poi riavvia.
4. Collega il bot con l'indirizzo e la porta del server mostrati nel pannello e la password che hai impostato.

Lavalink gira come server a sé, separato dal tuo bot. Ordina un piano per il bot e uno con il runtime Lavalink oppure, su un piano con più slot per bot, chiedici di spostarne uno sul runtime Lavalink. Nei nostri test Lavalink a riposo usa meno di 200 MB; per un bot piccolo il nostro consiglio è 1 GB, di più se suona in molti server contemporaneamente.