Como hospedar um servidor Lavalink

Do que o Lavalink precisa

• Java 17 ou mais recente. O Lavalink recomenda a versão LTS mais recente.
• Lavalink 4.2 ou mais recente. Desde março de 2026 o Discord só permite voz com criptografia de ponta a ponta (o protocolo DAVE), e o Lavalink 4.2.0 foi a primeira versão com suporte a ela. Servidores mais antigos não conseguem mais tocar áudio no Discord.
• Uma biblioteca cliente no seu bot que suporte a mesma versão — as atuais lavalink-client, Shoukaku, Wavelink, lavalink.py e outras suportam. Como escolher uma está explicado em como criar um bot de música para Discord.
• Uma máquina que fique ligada, porque a música para quando o Lavalink para.

Baixar e iniciar o Lavalink

1. Baixe o Lavalink.jar da versão mais recente no GitHub para uma pasta vazia.
2. Crie o application.yml na mesma pasta (próxima seção).
3. Inicie a partir dessa pasta:

java -jar Lavalink.jar

O Lavalink está pronto quando o log mostra que ele iniciou. Em um servidor Linux, a documentação do Lavalink recomenda rodá-lo como serviço do systemd para que reinicie após uma falha e após um reboot; também há uma imagem Docker publicada.

Configurar o application.yml

Uma configuração mínima do Lavalink 4 com o plugin do 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 — troque. A configuração de exemplo vem com youshallnotpass, que é pública; qualquer pessoa que encontrar seu servidor poderia usá-lo com a senha padrão.
• port — 2333 por padrão; seu bot se conecta a essa porta.
• sources.youtube: false — a fonte do YouTube embutida está obsoleta. O plugin a substitui, e a documentação dele diz que a embutida precisa ser desativada.
• http: true permite que o bot toque links diretos; o exemplo oficial avisa que, sem um proxy, isso pode revelar o IP do seu servidor.

YouTube, Spotify e outras fontes

Os plugins são listados em lavalink.plugins e baixados na inicialização. Vale a pena conhecer dois:

• youtube-source (dev.lavalink.youtube:youtube-plugin) — reprodução e busca no YouTube. O YouTube bloqueia ativamente o acesso automatizado, então ele pode parar de funcionar até o plugin ser atualizado; mantenha-o na versão mais recente.
• LavaSrc (com.github.topi314.lavasrc:lavasrc-plugin) — adiciona Spotify, Apple Music, Deezer e mais. Dos links do Spotify e do Apple Music são lidos os dados da faixa, e o áudio é tocado a partir de outra fonte.

Conectar seu bot ao Lavalink

Todo cliente Lavalink pede os mesmos quatro valores, chamados de nó:

Por exemplo, o Wavelink em Python recebe wavelink.Node(uri="http://your-host:2333", password="..."). Se o bot não conseguir conectar, confira primeiro a senha e depois se a porta está acessível de onde o bot roda.

Hospedagem Lavalink na HytHost

1. Escolha Lavalink como runtime. Em hospedagem de bots do Discord, escolha um plano e selecione Lavalink como linguagem. O servidor instala a versão mais recente do Lavalink no Java 21 com a configuração de exemplo oficial.
2. Troque a senha. Abra o application.yml no gerenciador de arquivos e substitua a senha padrão. O painel já define o endereço e a porta para a porta do seu servidor, então deixe esses dois como estão.
3. Adicione o plugin do YouTube se quiser YouTube: o bloco do plugin e youtube: false da configuração acima, depois reinicie.
4. Conecte seu bot com o endereço e a porta do servidor mostrados no painel e a senha que você definiu.

O Lavalink roda como um servidor próprio, separado do seu bot. Contrate um plano para o bot e outro com o runtime Lavalink ou, em um plano com vários slots de bot, peça para movermos um deles para o runtime Lavalink. Nos nossos testes o Lavalink usa menos de 200 MB em repouso; para um bot pequeno nossa recomendação é 1 GB, e mais se ele tocar em muitos servidores ao mesmo tempo.