Artigos sobre: Aplicações & Bots
Este artigo também está disponível em:

Como criar um bot de música(Lavalink)

Como Hospedar um Bot de Música com Lavalink na Square Cloud


Se você já tentou criar ou hospedar um bot de música para o Discord recentemente, sabe que processar áudio diretamente na mesma aplicação do bot pode consumir muita CPU e gerar engasgos na reprodução. A solução profissional para isso é o Lavalink, um servidor de áudio standalone baseado em Java, otimizado especificamente para o Discord.


Neste tutorial, você aprenderá o passo a passo para hospedar tanto o servidor Lavalink quanto o seu bot de música na Square Cloud, garantindo estabilidade e áudio de alta qualidade 24/7.



🛠️ Arquitetura da Solução


Para que o sistema funcione, dividiremos o projeto em duas aplicações independentes dentro da Square Cloud:


  1. O Servidor Lavalink: Responsável por se conectar ao YouTube/Spotify/SoundCloud, baixar o áudio, decodificar e transmitir.
  2. O Bot Discord: Responsável por receber os comandos dos usuários (!play, !skip) e gerenciar a fila, enviando as instruções de reprodução para o Lavalink.



O Lavalink precisa de um arquivo de configuração chamado application.yml e do arquivo executável .jar.


Crie uma pasta no seu computador chamada lavalink-server com os seguintes arquivos:


  • lavalink.jar (Baixe a versão mais recente do repositório oficial do Lavalink no GitHub)
  • application.yml


2. Configurando o application.yml

Este é o arquivo que define a porta e a senha que o seu bot usará para se conectar. Use a configuração base abaixo:


server:
  port: 80
  address: 0.0.0.0
lavalink:
  server:
    password: "SUA_SENHA_SUPER_SEGURA"
    sources:
      youtube: true
      bandcamp: true
      soundcloud: true
      twitch: true
      vimeo: true
      mixer: false
      http: true
      local: false
    filters:
      volume: true
      equalizer: true
    bufferDurationMs: 400
    youtubePlaylistLoadLimit: 6 // Limite de páginas de playlist
    playerUpdateInterval: 5
    youtubeSearchEnabled: true
    soundcloudSearchEnabled: true
    gc-warnings: true

⚠️ Nota sobre Memória: O Lavalink roda sobre a JVM (Java Virtual Machine), que costuma ser exigente. Recomendamos alocar no mínimo 512MB de RAM para evitar travamentos durante o carregamento de músicas pesadas.


3. Envio para a Square Cloud

  1. Compacte os três arquivos (lavalink.jar, application.yml) em um arquivo .zip.
  2. Vá para o Dashboard da Square Cloud, clique em Nova aplicação, anexe o zip e selecione arquivo principal o jar e marque publicar na web.
  3. Assim que enviar, vá na aba Configurações do seu Lavalink na Square Cloud e copie na aba de Network o Domínio Público (ex: seu-lavalink.squareweb.app).



Passo 2: Configurando o Bot de Música


Agora que o servidor de áudio está online, você pode escolher a linguagem de programação de sua preferência para construir o bot. Abaixo estão os exemplos em Node.js e Python.



Para projetos em Python, a biblioteca wavelink é a integração mais robusta e moderna com o Lavalink.


1. Arquivos necessários:


2. Dependências (requirements.txt):

discord.py
wavelink


3. Código do Bot (main.py):

import discord
from discord.ext import commands
import wavelink

class MusicBot(commands.Bot):
    def __init__(self):
        intents = discord.Intents.default()
        intents.message_content = True
        super().__init__(command_prefix="!", intents=intents)

    async def setup_hook(self):
        # Configura o nó do Lavalink apontando para a Square Cloud
        node = wavelink.Node(
            uri="[https://seu-lavalink.squareweb.app:443](https://seu-lavalink.squareweb.app:443)", # Domínio gerado com a porta 443 (SSL)
            password="SUA_SENHA_SUPER_SEGURA"
        )
        await wavelink.Pool.connect(nodes=[node], client=self)

bot = MusicBot()

@bot.event
async def on_ready():
    print(f"Bot logado como {bot.user}")

@bot.event
async def on_wavelink_node_ready(payload: wavelink.NodeReadyEventPayload):
    print(f"Nó Lavalink \"{payload.node.identifier}\" está conectado e pronto!")

@bot.command()
async def play(ctx: commands.Context, *, search: str):
    if not ctx.author.voice:
        return await ctx.send("Você precisa estar em um canal de voz!")

    # Conecta ao canal de voz se não estiver conectado
    if not ctx.voice_client:
        vc: wavelink.Player = await ctx.author.voice.channel.connect(cls=wavelink.Player)
    else:
        vc: wavelink.Player = ctx.voice_client

    # Busca a música
    tracks = await wavelink.Tracks.search(search)
    if not tracks:
        return await ctx.send("Nenhuma música encontrada.")

    track = tracks[0]
    await vc.play(track)
    await ctx.send(f"Tocando agora: **{track.title}**")

bot.run("SEU_DISCORD_BOT_TOKEN")



Opção B: Implementação em Node.js (usando erela.js)


Se preferir JavaScript/TypeScript, você pode usar a estrutura abaixo.


1. Arquivos necessários:

  • index.js
  • package.json


2. Dependências (package.json):

{
  "dependencies": {
    "discord.js": "^14.x",
    "erela.js": "^2.x"
  }
}


3. Código do Bot (index.js):

const { Client, GatewayIntentBits } = require("discord.js");
const { Manager } = require("erela.js");

const client = new Client({
    intents: [
        GatewayIntentBits.Guilds,
        GatewayIntentBits.GuildMessages,
        GatewayIntentBits.MessageContent,
        GatewayIntentBits.GuildVoiceStates
    ]
});

client.manager = new Manager({
    nodes: [
        {
            host: "seu-lavalink.squareweb.app", // Domínio fornecido pela Square Cloud
            port: 443, // Porta padrão segura para HTTPS/WSS
            password: "SUA_SENHA_SUPER_SEGURA",
            secure: true // Força o uso de SSL/TLS da Square Cloud
        }
    ],
    send(id, payload) {
        const guild = client.guilds.cache.get(id);
        if (guild) guild.shard.send(payload);
    }
});

client.on("raw", (d) => client.manager.updateVoiceState(d));

client.once("ready", () => {
    console.log(`Bot logado como ${client.user.tag}`);
    client.manager.init(client.user.id);
});

client.manager.on("nodeConnect", node => console.log(`Nó Lavalink "${node.options.identifier}" conectado.`));
client.manager.on("nodeError", (node, error) => console.log(`Erro no Nó: ${error.message}`));

client.login("SEU_DISCORD_BOT_TOKEN");



Passo 3: Colocando Tudo Juntos


  1. No dashboard da Square Cloud, inicialize o seu Lavalink Server e certifique-se de que ele exibe o status Online.
  2. Escolha uma das opções acima (Python ou Node.js), coloque todos os arquivos da pasta do bot escolhido dentro de um arquivo .zip.
  3. Envie o zip do bot para a Square Cloud através do botão Nova aplicação.
  4. Inicialize o bot e abra o terminal de logs. Se a conexão tiver sucesso, você verá a mensagem confirmando que o Nó Lavalink está pronto.



💡 Dicas de Otimização e Troubleshooting


  • Erro de Conexão (WebSocket Error / Connection Refused): A Square Cloud gerencia os domínios web sob conexões seguras com certificados SSL próprios. Por isso, ao configurar o seu bot (seja em Python ou Node.js), use obrigatoriamente a porta pública 443 e habilite o parâmetro secure / https / wss, em vez de tentar acessar diretamente a porta interna 80.
  • Quedas e Latência no Áudio: O processamento de áudio depende muito da CPU disponível. Monitore os recursos do Lavalink no Dashboard. Se perceber picos recorrentes de 100% de uso de CPU ao decodificar streams, considere aumentar os recursos alocados do servidor Lavalink e do bot para garantir mais núcleos de processamento.
  • Estabilidade do Bot: Bots de música tendem a acumular objetos de filas muito extensas na memória RAM. Monitore frequentemente o consumo do bot para mitigar Memory Leaks utilizando limpezas periódicas de filas inativas.



⚠️ O Grande Desafio: Restrições de IP do YouTube (Sign-in Required)


Se você configurar tudo corretamente e, ao tentar tocar uma música, o bot simplesmente pular a faixa ou exibir um erro como 403 Forbidden ou Sign-in required, você acabou de esbarrar na proteção do YouTube.


O YouTube bloqueia agressivamente requisições vindas de IPs de datacenters (como os servidores da Square Cloud, AWS, Google Cloud, etc.) para evitar abusos e web scraping de áudio. Como milhares de bots compartilham as mesmas faixas de IP de grandes servidores, esses IPs entram rapidamente na "lista negra" da plataforma.


Como contornar esse problema?


Para fazer o seu Lavalink na Square Cloud funcionar com links do YouTube de forma estável, você tem três caminhos principais:


  1. Utilizar o Plugin Youtube-Source com Cookies: As versões mais recentes das fontes do Lavalink permitem que você exporte um arquivo de cookies de uma conta do YouTube secundária (usando extensões de navegador como Get cookies.txt LOCALLY) e o configure no servidor. Isso simula um usuário real autenticado.
  2. Mudar para Fontes Alternativas: Configurar o bot para utilizar nativamente o SoundCloud, Bandcamp ou Twitch como mecanismos de busca padrão no application.yml contorna completamente o bloqueio do YouTube. Para o Spotify, lembre-se de que os plugins apenas convertem os metadados da música (nome e artista) para buscá-la em uma plataforma de áudio; portanto, o áudio final ainda precisará vir de uma fonte que não esteja bloqueada (como o SoundCloud).



Use sempre uma versão do Lavalink compatível com o client (wrapper) do seu bot: o Lavalink v4 é baseado em REST e não conversa com um client v3, o que derruba o WebSocket. Resumo da rede na Square Cloud: o servidor Lavalink abre na porta 80 e o client conecta na porta 443 com secure: true. Se aparecer WebSocket closed abnormally (1006), veja Lavalink closed abnormally (1006): como resolver.

Atualizado em: 02/07/2026

Este artigo foi útil?

Compartilhe seu feedback

Cancelar

Obrigado!