Como hospedar um servidor Lavalink 24/7

Para manter um servidor Lavalink online 24/7, você precisa de quatro coisas: uma máquina que nunca desliga, Java 17 ou mais novo, o Lavalink.jar das versões do GitHub do Lavalink com um application.yml que define a sua própria senha, e algo que inicie o Lavalink de novo depois de uma queda ou de uma reinicialização. Seu bot então se conecta com o endereço, a porta e a senha do servidor. Para o YouTube, você também precisa do plugin do YouTube, com login feito em uma conta Google reserva; a versão atual dele exige mais do que isso, veja Como tocar YouTube no Lavalink 4. Um plano Lavalink da PlayNHost já vem com tudo isso instalado: Lavalink 4.2.2, o plugin do YouTube e uma senha criada para o seu node. No nosso teste no plano de 1 GB, ele ficou pronto de 11 a 13 segundos depois de iniciar e usou cerca de 240 MiB de memória em repouso.

O que um servidor Lavalink 24/7 precisa

Rode no seu próprio servidor Linux

Estes são os passos da própria documentação do Lavalink.

1. Instale o Java 17 ou mais novo e confira com java -version.
2. Crie uma pasta, por exemplo /home/lavalink/lavalink, e coloque nela o Lavalink.jar, baixado da versão mais recente no GitHub do Lavalink. Em 6 de novembro de 2026, é a 4.2.2.
3. Ao lado dele, crie o application.yml. O menor que serve define a porta, o endereço e uma senha sua, e desliga a antiga fonte de YouTube embutida, que o Lavalink não atualiza mais:

server:
  port: 2333
  address: 0.0.0.0
lavalink:
  server:
    password: "change-this-to-a-long-random-password"
    sources:
      youtube: false
      soundcloud: true
      http: true

4. Inicie uma vez na mão com java -jar Lavalink.jar e espere por Lavalink is ready to accept connections.
5. Para mantê-lo rodando, transforme-o em um serviço systemd. A documentação do Lavalink traz esta unit; salve-a como /usr/lib/systemd/system/lavalink.service com o seu usuário e a sua pasta:

[Unit]
Description=Lavalink Service
After=syslog.target network.target

[Service]
User=lavalink
Group=lavalink
WorkingDirectory=/home/lavalink/lavalink
ExecStart=java -Xmx4G -jar /home/lavalink/lavalink/Lavalink.jar
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

6. Rode sudo systemctl daemon-reload, sudo systemctl enable lavalink e sudo systemctl start lavalink. sudo journalctl -u lavalink mostra o log dele.
7. Ajuste o -Xmx à máquina: -Xmx4G deixa o heap do Java crescer até 4 GB, mais do que um servidor pequeno tem. Abra a porta no seu firewall e teste como no passo 2 abaixo.

Daí em diante, você mesmo atualiza o Java, o Lavalink e os plugins, e fica de olho nas quedas. O YouTube precisa do plugin: Como tocar YouTube no Lavalink 4.

Em um plano PlayNHost: o que a instalação configura

• Lavalink 4.2.2, baixado da release do Lavalink no GitHub e conferido com um checksum fixo.
• O plugin de fonte do YouTube, versão 1.18.2 com correções da PlayNHost, na pasta plugins como youtube-plugin-1.18.2-playnhost1.jar.
• Um application.yml com uma senha criada só para o seu node e estas fontes ligadas: Bandcamp, Twitch, Vimeo, Niconico e links http diretos. As fontes próprias do Lavalink para SoundCloud e YouTube ficam desligadas; o YouTube passa pelo plugin. Todos os filtros de áudio (equalizador, timescale, karaokê e os demais) ficam ligados.

Uma reinstalação posterior mantém seu application.yml e imprime Kept your application.yml.

1. Encontre o endereço e a senha

1. Abra seu servidor no painel. A Visão geral mostra o card do Lavalink com Nome do node, Endereço e Senha.
2. Ao lado de Endereço, clique no ícone de copiar. Ele copia host:port.
3. Senha diz No application.yml. Clique em Abrir o application.yml. Em lavalink: e server:, copie o valor de password: sem as aspas.

Trate a senha como uma chave: qualquer pessoa com o endereço e a senha pode usar seu node. Para mudá-la, edite password: no mesmo arquivo, salve, reinicie o node e atualize seu bot.

2. Inicie e confira

1. Abra o Console (ou clique em Logs no card) e clique em Iniciar.
2. O Lavalink está pronto quando o console mostra:

Lavalink is ready to accept connections.

3. Para testar a partir do seu computador, peça a versão ao node com a sua senha:

curl -H "Authorization: YOUR_PASSWORD" http://HOST:PORT/version

Ele responde 4.2.2 quando funciona. 403 significa que a senha está errada, 401 que falta o cabeçalho Authorization; nenhuma resposta significa que o endereço está errado ou que o node está parado.

Depois, conecte seu bot: Como conectar seu bot do Discord ao Lavalink. O node usa http e ws simples, então deixe desligada a opção de conexão segura ou SSL no seu cliente. Seu cliente precisa ser uma versão que suporte a criptografia de voz DAVE do Discord; o guia de conexão lista as versões.

3. Faça o login no YouTube uma vez

Na primeira inicialização, o console pede que você faça o login do plugin do YouTube em uma conta Google, com uma linha como:

OAUTH INTEGRATION: To give youtube-source access to your account, go to https://www.google.com/device and enter code XXXX-XXXX

Use uma conta Google reserva criada para isso, nunca a sua: os autores do plugin avisam que a conta pode ser encerrada. No nosso teste de 6 de novembro de 2026 (um teste de início de 15 segundos por música, sem canal de voz), o node não conseguiu iniciar nenhuma das 12 músicas do YouTube antes do login e iniciou sem erro todos os 10 testes concluídos depois dele. Se o YouTube entrega ou não uma música a um servidor é decisão do YouTube, e não podemos prometer isso. Os passos, e como manter o login depois de uma reinicialização: Como tocar YouTube no Lavalink 4.

O que o painel reescreve a cada inicialização

Dois valores do application.yml são definidos pelo painel toda vez que o node inicia. Mudanças neles são desfeitas:

• server.port: a porta do seu servidor, a única aberta para a internet. O 2333 escrito na instalação é substituído.
• plugins.youtube.remoteCipher.url: um serviço da PlayNHost que o plugin do YouTube usa, acessível só a partir dos nossos servidores.

Versão

A aba Configurações, em Configurações do jogo, tem um campo Versão definido como 4.2.2, a versão que testamos e damos suporte. Em 6 de novembro de 2026, ela também é a versão mais recente do Lavalink. Outras versões são baixadas sem checksum e não têm suporte. O valor é lido só enquanto o servidor é instalado, então vale quando você reinstala.

Reinstalar

Uma reinstalação baixa o Lavalink e os plugins dele de novo, o que também repara um Lavalink.jar ou um arquivo de plugin danificado ou apagado. Seu application.yml, com a senha e as suas mudanças, continua.

1. Abra a aba Configurações e clique em Detalhes de inicialização.
2. No card Reinstalar ("Baixa o Lavalink e os plugins dele de novo, nas versões que a PlayNHost testou. Seu application.yml continua."), clique em Reinstalar.
3. Confirme em Reinstalar este servidor? clicando em Reinstalar. O node para enquanto a instalação roda.
4. Quando terminar, clique em Iniciar no Console.

Plugins que você mesmo enviou continuam na pasta plugins. A instalação substitui só o arquivo do plugin do YouTube que ela traz.

Quanta memória um node Lavalink usa

O heap do Java do Lavalink nos nossos planos é limitado a três quartos do limite de memória do servidor. Iniciamos o node instalado três ou quatro vezes em cada tamanho de plano em 6 de novembro de 2026, com os mesmos limites de memória e CPU, a mesma imagem e o mesmo comando de inicialização que o painel usa, em um dos nossos nodes de produção ocupados, e lemos a memória dele 60 segundos depois de ficar pronto, sem nenhum bot conectado:

Um node ocioso usou quase a mesma memória em todos os planos, mais ou menos um quarto do plano de 1 GB. Os planos maiores dão ao heap espaço para crescer e, com mais CPU, iniciaram mais rápido no nosso teste. Cada player que transmite soma a isso. Ainda não medimos quantos players cada plano atende, então não damos um número. Observe o card Uso na Visão geral depois de um dia de uso real: Como ler os gráficos de uso do seu servidor.

Você precisa de um node Lavalink próprio?

Um node público gratuito serve para testar ou para um bot particular bem pequeno. Um bot de que as pessoas dependem fica melhor em um node que você controla, porque você escolhe os plugins, as fontes e a senha.

Antes de depender de um node público, confira se a versão principal do Lavalink dele é a mesma do seu cliente: um cliente da versão 3 não funciona com um node da versão 4. Passar depois para um node próprio é trocar três valores no seu bot: host, porta e senha. Planos: Hospedagem Lavalink.

Em seguida

• Conecte seu bot: Como conectar seu bot do Discord ao Lavalink.
• Toque YouTube: Como tocar YouTube no Lavalink 4.
• Adicione fontes e recursos: Como adicionar plugins ao Lavalink.
• Algo falhou: Erros do Lavalink e o que significam.