Skip to main content

​
Introdução

Para desenvolver e hospedar um servidor Lavalink na Square Cloud, siga a sequência de configurações e pré-requisitos abaixo. Este guia cobre todo o processo, da configuração inicial ao deploy em produção.

​
Pré-requisitos

  • Conta Square Cloud: Cadastre-se através da página de cadastro usando seu e-mail.
  • Plano ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.
Este guia usa o runtime Java.

​
Obtenha o projeto

Baixe o Lavalink.jar na página oficial de releases. Este guia usa o Lavalink v4: escolha a release 4.x mais recente (4.2.0 ou mais nova) e confirme que seu bot usa um cliente Lavalink feito para a v4 e com suporte a DAVE (veja Conecte o seu bot).
Já temos tudo pronto para deploy nas nossas releases do lavalink-web, com o plugin do YouTube configurado. Baixe o project.zip e envie o projeto: durante o deploy do Lavalink, troque o valor provisório de LAVALINK_SERVER_PASSWORD nas variáveis de ambiente por uma senha longa e aleatória.
Crie um arquivo application.yml ao lado do Lavalink.jar. A configuração mínima abaixo escuta na porta da variável de ambiente PORT (a Square Cloud a define como 80) e toca o YouTube pelo plugin oficial youtube-source, já que a fonte do YouTube embutida no Lavalink está descontinuada:
application.yml
O Lavalink baixa o plugin na primeira inicialização. Para todas as outras opções (outras fontes, filtros, buffers), veja o arquivo de exemplo oficial.
Mantenha address: 0.0.0.0 e não troque a porta por um valor fixo diferente de 80: a Square Cloud entrega o tráfego do seu subdomínio na porta 80 da sua aplicação.

​
Defina uma senha forte

Troque o valor de password por uma senha forte e aleatória com pelo menos 32 caracteres. Para mantê-la fora dos seus arquivos, defina-a na variável de ambiente LAVALINK_SERVER_PASSWORD: o Lavalink dá prioridade às variáveis de ambiente sobre o application.yml. Adicione a variável em Configuração avançada, no formulário de upload, ou na página Variáveis de ambiente da sua aplicação no dashboard, ou pela CLI:
Veja Variáveis de ambiente para as outras formas de gerenciá-las.

​
Configure a Square Cloud

Crie um arquivo squarecloud.app ao lado do Lavalink.jar. O campo SUBDOMAIN publica seu servidor em https://<subdomain>.squareweb.app:
squarecloud.app
O MAIN=Lavalink.jar faz a Square Cloud iniciar o servidor com java -jar Lavalink.jar, o MEMORY é a RAM dele em MB, e o AUTORESTART=true o inicia de novo se ele travar (veja como funciona o auto restart).

​
O que vai no ZIP

  • Lavalink.jar
  • application.yml
  • squarecloud.app
Coloque os três arquivos na mesma pasta e compacte-os em um arquivo .zip para enviar pelo dashboard.

​
Faça o deploy e verifique

​
Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.
2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.
3

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.
Enviando aplicação para a Square Cloud
4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

​
Via CLI

Para usar esse método, seu projeto precisa de um arquivo de configuração chamado squarecloud.app na raiz. Ele informa à Square Cloud como executar a sua aplicação.

Guia do arquivo de configuração

Saiba como criar o arquivo de configuração squarecloud.app que define o ambiente da sua aplicação.
1

Instale a CLI

Instale a CLI da Square Cloud. Se você já a tem, execute o mesmo comando para atualizá-la:
2

Faça login

Execute o comando abaixo. Ele abre o seu navegador: aprove o login lá e a CLI está pronta. Não há nenhuma chave de API para copiar. Para scripts e CI, veja autenticação da CLI.
3

Envie o seu projeto

Na pasta do seu projeto, execute o comando abaixo. A CLI compacta a pasta atual, deixando de fora o que o squarecloud.ignore lista, e faz o upload:
Para enviar um zip que você mesmo criou, passe-o com --file:
4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. Verifique o status e os registros da sua aplicação diretamente pelo terminal:
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

​
Conecte o seu bot

O Lavalink escuta na porta 80 dentro da Square Cloud, mas seu bot se conecta pela borda pública, que serve HTTPS na porta 443. Configure o nó no seu cliente Lavalink assim (os nomes dos campos variam entre bibliotecas):
Desde março de 2026, o Discord só deixa bots entrarem em canais de voz com DAVE, a criptografia de ponta a ponta da voz. O Lavalink tem suporte a partir da versão 4.2.0, e o cliente Lavalink do seu bot também precisa ter: sem isso, o bot conecta ao Lavalink, mas não entra no canal de voz.

​
Erros comuns

Conectar com a porta 80 ou secure: false falha: use a porta 443 e secure: true, como mostrado em Conecte o seu bot. Se a conexão fechar com o código 1006, veja Conexão do Lavalink fechada com código 1006.

​
Próximos passos

Bot do Discord

Hospede o bot de música que se conecta ao seu servidor Lavalink.

Erros de bot do Discord

Corrija tokens inválidos, intents faltando e erros de conexão do Lavalink.

Runtime Java

Como a Square Cloud roda aplicações Java.
Para saber mais sobre o Lavalink, consulte a documentação oficial do Lavalink.

​
Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4,9/5 em 402 avaliações no Google e Trustpilot.