Introducción
- Sigue el tutorial a continuación y aloja tu servidor de Lavalink hoy mismo, ¡es súper sencillo! Si necesitas ayuda, contáctanos a través de nuestros canales oficiales de soporte.
- A continuación, deberás crear una cuenta en Square Cloud, lo cual puede hacerse a través de la página de registro. Puedes usar tu correo electrónico para crear una cuenta.
- Por último, necesitas tener un plan activo en tu cuenta. Compara los planes disponibles y elige uno según tus necesidades.
Eligiendo la versión
DescargaLavalink.jar desde la página oficial de releases. Esta guía usa Lavalink v4: elige la release 4.x más reciente y asegúrate de que tu bot use un cliente de Lavalink hecho para v4.
Creando el application.yml
Crea un archivoapplication.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
Reforzando la seguridad
Reemplaza el valor depassword 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:
Creando el archivo de configuración de Square Cloud
Crea un archivosquarecloud.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).
Aprende más sobre: cómo crear el archivo de configuración para Square Cloud.
El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; se usará para definir el nombre, la descripción, la versión, el archivo principal, entre otras cosas.
Hacer deploy de Lavalink
ColocaLavalink.jar, application.yml y squarecloud.app en la misma carpeta (para subirlos desde el dashboard, comprímelos en un archivo .zip). Luego, sube tu proyecto a Square Cloud.
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.
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.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

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
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.
A través de la CLI
Para usar este método, tu proyecto necesita un archivo de configuración llamadosquarecloud.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 Para subir un zip que creaste tú mismo, pásalo con
squarecloud.ignore, y lo sube:--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.
Conectando tu bot
Lavalink escucha en el puerto80 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):
Conectarse con el puerto
80 o con secure: false falla. 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.

