Como alojar 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 encriptação ponto a ponto (o protocolo DAVE), e o Lavalink 4.2.0 foi a primeira versão a suportá-la. Os servidores mais antigos já não conseguem reproduzir á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. A escolha de uma é explicada em como criar um bot de música para o Discord.
• Uma máquina que fique ligada, porque a música para quando o Lavalink para.

Transferir e iniciar o Lavalink

1. Transfira o Lavalink.jar da versão mais recente no GitHub para uma pasta vazia.
2. Crie o application.yml na mesma pasta (secção seguinte).
3. Inicie-o a partir dessa pasta:

java -jar Lavalink.jar

O Lavalink está pronto quando o registo indica que arrancou. Num servidor Linux, a documentação do Lavalink recomenda executá-lo como serviço systemd para que reinicie após uma falha e após um reinício do sistema; também existe 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 — altere-a. A configuração de exemplo vem com youshallnotpass, que é pública; qualquer pessoa que encontre o seu servidor poderia usá-lo com a predefinida.
• port — 2333 por predefinição; o seu bot liga-se a esta porta.
• sources.youtube: false — a fonte do YouTube integrada está obsoleta. O plugin substitui-a, e a documentação dele diz que a integrada tem de ser desativada.
• http: true permite ao bot reproduzir ligações diretas; o exemplo oficial avisa que, sem um proxy, isto pode revelar o IP do seu servidor.

YouTube, Spotify e outras fontes

Os plugins são indicados em lavalink.plugins e transferidos no arranque. Vale a pena conhecer dois:

• youtube-source (dev.lavalink.youtube:youtube-plugin) — reprodução e pesquisa no YouTube. O YouTube bloqueia ativamente o acesso automatizado, por isso pode deixar 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. Das ligações do Spotify e do Apple Music são lidos os detalhes da faixa, e o áudio é reproduzido a partir de outra fonte.

Ligar o seu bot ao Lavalink

Todos os clientes Lavalink pedem os mesmos quatro valores, a que se chama um nó:

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

Alojamento Lavalink na HytHost

1. Escolha Lavalink como ambiente. Em alojamento de bots do Discord, escolha um plano e selecione Lavalink como linguagem. O servidor instala a versão mais recente do Lavalink sobre Java 21 com a configuração de exemplo oficial.
2. Altere a palavra-passe. Abra o application.yml no gestor de ficheiros e substitua a palavra-passe predefinida. O painel já define o endereço e a porta para a porta do seu servidor, por isso 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, e depois reinicie.
4. Ligue o seu bot com o endereço e a porta do servidor mostrados no painel e a palavra-passe que definiu.

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