Comment héberger un serveur Lavalink

Ce dont Lavalink a besoin

• Java 17 ou plus récent. Lavalink recommande la dernière version LTS.
• Lavalink 4.2 ou plus récent. Depuis mars 2026, Discord n'autorise que la voix chiffrée de bout en bout (le protocole DAVE), et Lavalink 4.2.0 a été la première version à le prendre en charge. Les serveurs plus anciens ne peuvent plus lire d'audio sur Discord.
• Une bibliothèque cliente dans votre bot compatible avec cette version — les versions actuelles de lavalink-client, Shoukaku, Wavelink, lavalink.py et d'autres le sont. Le choix est expliqué dans comment créer un bot musical Discord.
• Une machine qui reste allumée, car la musique s'arrête quand Lavalink s'arrête.

Télécharger et lancer Lavalink

1. Téléchargez Lavalink.jar depuis la dernière version sur GitHub dans un dossier vide.
2. Créez application.yml dans le même dossier (section suivante).
3. Lancez-le depuis ce dossier :

java -jar Lavalink.jar

Lavalink est prêt quand le journal indique qu'il a démarré. Sur un serveur Linux, la documentation de Lavalink recommande de l'exécuter comme service systemd pour qu'il redémarre après un plantage et au redémarrage de la machine ; une image Docker est également publiée.

Configurer application.yml

Une configuration minimale de Lavalink 4 avec le 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 — changez-le. La configuration d'exemple est livrée avec youshallnotpass, qui est public ; quiconque trouve votre serveur pourrait l'utiliser avec le mot de passe par défaut.
• port — 2333 par défaut ; votre bot se connecte à ce port.
• sources.youtube: false — la source YouTube intégrée est obsolète. Le plugin la remplace, et sa documentation indique que la source intégrée doit être désactivée.
• http: true permet au bot de lire des liens directs ; l'exemple officiel précise que, sans proxy, cela peut révéler l'IP de votre serveur.

YouTube, Spotify et autres sources

Les plugins sont listés sous lavalink.plugins et téléchargés au démarrage. Deux sont à connaître :

• youtube-source (dev.lavalink.youtube:youtube-plugin) — lecture et recherche YouTube. YouTube bloque activement les accès automatisés, il peut donc cesser de fonctionner jusqu'à la mise à jour du plugin ; gardez-le à la dernière version.
• LavaSrc (com.github.topi314.lavasrc:lavasrc-plugin) — ajoute Spotify, Apple Music, Deezer et d'autres. Les liens Spotify et Apple Music servent à lire les informations du morceau, et l'audio est lu depuis une autre source.

Connecter votre bot à Lavalink

Chaque client Lavalink demande les quatre mêmes valeurs, appelées un nœud :

Par exemple, Wavelink en Python prend wavelink.Node(uri="http://your-host:2333", password="..."). Si le bot n'arrive pas à se connecter, vérifiez d'abord le mot de passe, puis que le port est joignable depuis l'endroit où tourne le bot.

Hébergement Lavalink chez HytHost

1. Choisissez Lavalink comme environnement. Sur l'hébergement de bots Discord, choisissez une offre et sélectionnez Lavalink comme langage. Le serveur installe la dernière version de Lavalink sur Java 21 avec la configuration d'exemple officielle.
2. Changez le mot de passe. Ouvrez application.yml dans le gestionnaire de fichiers et remplacez le mot de passe par défaut. Le panneau règle déjà l'adresse et le port sur le port propre à votre serveur, laissez donc ces deux valeurs telles quelles.
3. Ajoutez le plugin YouTube si vous voulez YouTube : le bloc du plugin et youtube: false de la configuration ci-dessus, puis redémarrez.
4. Connectez votre bot avec l'adresse et le port du serveur affichés dans votre panneau et le mot de passe que vous avez défini.

Lavalink tourne comme un serveur à part, séparé de votre bot. Commandez une offre pour le bot et une autre avec l'environnement Lavalink, ou, sur une offre avec plusieurs emplacements de bots, demandez-nous de passer l'un d'eux sur l'environnement Lavalink. Dans nos tests, Lavalink consomme moins de 200 MB au repos ; pour un petit bot, nous recommandons 1 GB, davantage s'il joue sur de nombreux serveurs à la fois.