Saltar al contenido principal

​
Introducción

Para desarrollar y alojar un servidor de Lavalink en Square Cloud, es esencial seguir una secuencia estructurada de configuraciones y requisitos previos. Esta guía técnica cubrirá todo el proceso, desde la configuración inicial hasta el despliegue en producción.

​
Requisitos previos

  • Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
  • Plan activo: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros planes disponibles y elige el más adecuado para tus necesidades.
Esta guía usa el runtime de Java.

​
Obtener el proyecto

Descarga Lavalink.jar desde la página oficial de releases. Esta guía usa Lavalink v4: elige la release 4.x más reciente (4.2.0 o posterior) y asegúrate de que tu bot use un cliente de Lavalink hecho para v4 y compatible con DAVE (consulta Conectar tu bot).
Ya tenemos todo listo para el deploy en nuestras releases de lavalink-web, con el plugin de YouTube configurado. Descarga el project.zip y súbelo: durante el deploy de Lavalink, reemplaza el valor provisional de LAVALINK_SERVER_PASSWORD en las variables de entorno por una contraseña larga y aleatoria.
Crea un archivo application.yml junto a Lavalink.jar. La configuración mínima de abajo escucha en el puerto de la variable de entorno PORT (Square Cloud la define como 80) y reproduce YouTube a través del plugin youtube-source oficial, ya que la fuente de YouTube integrada en Lavalink está obsoleta:
application.yml
Lavalink descarga el plugin en su primer inicio. Para todas las demás opciones (otras fuentes, filtros, buffers), consulta el archivo de ejemplo oficial.
Mantén address: 0.0.0.0 y no reemplaces el puerto por un valor fijo distinto de 80: Square Cloud entrega el tráfico de tu subdominio al puerto 80 de tu aplicación.

​
Definir una contraseña segura

Reemplaza el valor de password por una contraseña segura y aleatoria de al menos 32 caracteres. Para no dejarla en tus archivos, defínela en la variable de entorno LAVALINK_SERVER_PASSWORD: Lavalink da prioridad a las variables de entorno sobre el application.yml. Añade la variable en la Configuración avanzada del formulario de subida o en la página Variables de entorno de tu aplicación en el dashboard, o desde la CLI:
Consulta Variables de entorno para ver las demás formas de gestionarlas.

​
Configurar Square Cloud

Crea un archivo squarecloud.app junto a Lavalink.jar. El campo SUBDOMAIN publica tu servidor en https://<subdomain>.squareweb.app:
squarecloud.app
MAIN=Lavalink.jar hace que Square Cloud inicie el servidor con java -jar Lavalink.jar, MEMORY es su RAM en MB, y AUTORESTART=true lo vuelve a iniciar si falla (consulta cómo funciona el auto restart).

​
Qué va en el ZIP

  • Lavalink.jar
  • application.yml
  • squarecloud.app
Coloca los tres archivos en la misma carpeta y comprímelos en un archivo .zip para subirlo desde el dashboard.

​
Hacer deploy y verificar

​
A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.
2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.
Subiendo aplicación a Square Cloud
4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​
A través de la CLI

Para usar este método, tu proyecto necesita un archivo de configuración llamado squarecloud.app en su raíz. Le indica a Square Cloud cómo ejecutar tu aplicación.

Guía del archivo de configuración

Aprende a crear el archivo de configuración squarecloud.app que define el entorno de tu aplicación.
1

Instala la CLI

Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:
2

Inicia sesión

Ejecuta el comando de abajo. Abre tu navegador: aprueba el inicio de sesión allí y la CLI queda lista. No hay ninguna clave de API que copiar. Para scripts y CI, consulta autenticación de la CLI.
3

Sube tu proyecto

Desde la carpeta de tu proyecto, ejecuta el comando de abajo. La CLI comprime la carpeta actual en un zip, dejando fuera lo que lista squarecloud.ignore, y lo sube:
Para subir un zip que creaste tú mismo, pásalo con --file:
4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal:
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​
Conectar tu bot

Lavalink escucha en el puerto 80 dentro de Square Cloud, pero tu bot se conecta a través del edge público, que sirve HTTPS en el puerto 443. Configura el nodo en tu cliente de Lavalink así (los nombres de los campos varían entre librerías):
Desde marzo de 2026, Discord solo deja entrar bots en canales de voz con DAVE, su cifrado de extremo a extremo para la voz. Lavalink lo admite desde la versión 4.2.0, y el cliente de Lavalink de tu bot también debe admitirlo: si no, el bot se conecta a Lavalink pero no puede entrar en un canal de voz.

​
Errores comunes

Conectarse con el puerto 80 o con secure: false falla: usa el puerto 443 y secure: true, como se muestra en Conectar tu bot. Si la conexión se cierra con el código 1006, consulta Conexión de Lavalink cerrada con código 1006.

​
Próximos pasos

Bot de Discord

Aloja el bot de música que se conecta a tu servidor Lavalink.

Errores de bots de Discord

Soluciona tokens inválidos, intents que faltan y errores de conexión con Lavalink.

Runtime de Java

Cómo ejecuta Square Cloud las aplicaciones Java.
Para más información sobre Lavalink, consulta la documentación oficial de Lavalink.

​
Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema: la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.