Skip to main content

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

Descarga Lavalink.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 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.

Reforzando la seguridad

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.

Creando el archivo de configuración de 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).

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.
Coloca Lavalink.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.
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.

Conectando 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):
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.

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.