Cómo alojar un servidor Lavalink

Qué necesita Lavalink

• Java 17 o superior. Lavalink recomienda la última versión LTS.
• Lavalink 4.2 o superior. Desde marzo de 2026 Discord solo permite voz con cifrado de extremo a extremo (el protocolo DAVE), y Lavalink 4.2.0 fue la primera versión compatible. Los servidores más antiguos ya no pueden reproducir audio en Discord.
• Una biblioteca cliente en tu bot compatible con esa misma versión — las actuales lavalink-client, Shoukaku, Wavelink, lavalink.py y otras lo son. Cómo elegir una se explica en cómo hacer un bot de música para Discord.
• Una máquina que permanezca encendida, porque la música se detiene cuando se detiene Lavalink.

Descargar e iniciar Lavalink

1. Descarga Lavalink.jar de la última versión publicada en GitHub en una carpeta vacía.
2. Crea application.yml en la misma carpeta (siguiente sección).
3. Inícialo desde esa carpeta:

java -jar Lavalink.jar

Lavalink está listo cuando el registro indica que se ha iniciado. En un servidor Linux, la documentación de Lavalink recomienda ejecutarlo como servicio de systemd para que se reinicie tras un fallo o un reinicio del sistema; también hay una imagen de Docker publicada.

Configurar application.yml

Una configuración mínima de Lavalink 4 con el plugin de 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 — cámbiala. La configuración de ejemplo trae youshallnotpass, que es pública; cualquiera que encuentre tu servidor podría usarlo con la predeterminada.
• port — 2333 por defecto; tu bot se conecta a este puerto.
• sources.youtube: false — la fuente de YouTube integrada está obsoleta. El plugin la sustituye, y su documentación indica que la integrada debe desactivarse.
• http: true permite al bot reproducir enlaces directos; el ejemplo oficial advierte que, sin un proxy, esto puede revelar la IP de tu servidor.

YouTube, Spotify y otras fuentes

Los plugins se indican en lavalink.plugins y se descargan al arrancar. Conviene conocer dos:

• youtube-source (dev.lavalink.youtube:youtube-plugin) — reproducción y búsqueda en YouTube. YouTube bloquea activamente el acceso automatizado, así que puede dejar de funcionar hasta que se actualice el plugin; mantenlo en la última versión.
• LavaSrc (com.github.topi314.lavasrc:lavasrc-plugin) — añade Spotify, Apple Music, Deezer y más. De los enlaces de Spotify y Apple Music se leen los datos de la pista, y el audio se reproduce desde otra fuente.

Conectar tu bot a Lavalink

Todos los clientes de Lavalink piden los mismos cuatro valores, lo que se llama un nodo:

Por ejemplo, Wavelink en Python usa wavelink.Node(uri="http://your-host:2333", password="..."). Si el bot no logra conectarse, revisa primero la contraseña y después que el puerto sea accesible desde donde se ejecuta el bot.

Hosting de Lavalink en HytHost

1. Elige Lavalink como entorno. En hosting de bots de Discord, elige un plan y selecciona Lavalink como lenguaje. El servidor instala la última versión de Lavalink sobre Java 21 con la configuración de ejemplo oficial.
2. Cambia la contraseña. Abre application.yml en el gestor de archivos y sustituye la contraseña predeterminada. El panel ya ajusta la dirección y el puerto al puerto propio de tu servidor, así que deja esos dos como están.
3. Añade el plugin de YouTube si quieres YouTube: el bloque del plugin y youtube: false de la configuración anterior, y luego reinicia.
4. Conecta tu bot con la dirección y el puerto del servidor que muestra tu panel y la contraseña que hayas definido.

Lavalink funciona como un servidor propio, separado de tu bot. Contrata un plan para el bot y otro con el entorno Lavalink o, en un plan con varias plazas de bot, pídenos que pasemos una de ellas al entorno Lavalink. En nuestras pruebas Lavalink consume menos de 200 MB en reposo; para un bot pequeño nuestra recomendación es 1 GB, y más si reproduce en muchos servidores a la vez.