Primeros pasos con Aplicaciones en ServerPrism

Esta guía te acompaña en la configuración de la aplicación autoalojada que hayas elegido (5e Tools, Owncast, Rathole o Yarr) en tu servidor ServerPrism. Cubre el pedido, la configuración inicial, la configuración y los problemas comunes.

Antes de empezar

Asegúrate de tener una cuenta de ServerPrism y de estar listo para implementar un nuevo servidor o de tener un servidor de 'Aplicaciones' existente listo para su configuración.

Pedidos en ServerPrism

1. Selecciona un plan: Inicia sesión en ServerPrism y elige un servidor de 'Aplicaciones'. Recomendamos empezar con al menos 2 GB de RAM, escalando hasta 12 GB para aplicaciones más exigentes o cargas de usuarios más altas.
2. Elige una región: Selecciona la ubicación del servidor más cercana a tus usuarios principales para un rendimiento óptimo.
3. Implementar: Completa el pedido. Tu servidor comenzará a aprovisionarse automáticamente.

Primer arranque

Después de realizar el pedido, tu servidor comenzará a aprovisionarse. Este proceso suele tardar unos minutos. Puedes monitorear su estado a través del panel de ServerPrism en https://serverprism.com/dashboard. Una vez que el estado del servidor muestre 'Running' y veas la salida de la consola indicando que la aplicación ha comenzado, estará lista.

Conexión / invitación de usuarios

El método para conectarse a tu aplicación depende de la que hayas implementado:

• 5e Tools: Accede a tu instancia a través de la dirección IP y el puerto del servidor (por ejemplo, http://TU_IP_DEL_SERVIDOR:PUERTO). El puerto predeterminado suele ser 80 o 8080 para aplicaciones web. Consulta la pestaña 'Startup' en tu panel de ServerPrism para la variable APP_PORT si es configurable.
• Owncast: Tu instancia de Owncast será accesible a través de http://TU_IP_DEL_SERVIDOR:PUERTO. El puerto predeterminado para Owncast es 8080. También puedes configurar un dominio personalizado o un subdominio de ServerPrism para un acceso más fácil.
• Rathole: Rathole es un proxy inverso. La conexión implica configurar los clientes para que se conecten a través de Rathole a tus servicios internos. Esto requiere configurar el server.toml de Rathole y las configuraciones del cliente. No tiene una interfaz web directa para los usuarios.
• Yarr: Accede a tu instancia de Yarr a través de http://TU_IP_DEL_SERVIDOR:PUERTO. El puerto predeterminado suele ser 8080.

Para facilitar el acceso, puedes adjuntar un subdominio gratuito a tu servidor desde tu panel de control de ServerPrism.

Conceptos básicos de configuración

La configuración de cada aplicación se realiza normalmente a través de variables de entorno en la pestaña Startup del panel de ServerPrism o editando archivos de configuración específicos utilizando el File Manager o SFTP.

5e Tools

• Almacenamiento de datos: 5e Tools utiliza una base de datos local. La configuración es mínima. Normalmente puedes encontrar configuraciones relacionadas con las rutas de datos en las variables de inicio si es necesario.
• Acceso: Asegúrate de que la variable APP_PORT en la pestaña Startup coincida con el puerto al que intentas acceder.

Owncast

• Archivo de configuración: Owncast utiliza principalmente config.yaml ubicado en el directorio de datos de la aplicación. Puedes editarlo a través del File Manager.
• Acceso de administrador: La primera vez que accedas a Owncast, se te pedirá que crees una cuenta de administrador. Aquí es donde configuras tu clave de transmisión y otras configuraciones.
• Variables de inicio: Consulta la pestaña Startup para OWNCAST_DATABASE_PATH, OWNCAST_DATA_PATH o OWNCAST_PORT para personalizar las ubicaciones de los datos o los puertos de escucha.

Rathole

• Archivo de configuración: Rathole requiere un archivo server.toml. Este archivo define los puertos de escucha y los servicios que proxyará. Debes editar este archivo para que Rathole funcione.
  • Ejemplo de server.toml (editar a través del File Manager):

  [server]
  bind_addr = "0.0.0.0:8000" # Server listening port
  
  [server.services.my_service]
  type = "tcp"
  token = "your_secret_token"
  bind_addr = "0.0.0.0:2222" # Port clients connect to
  remote_addr = "127.0.0.1:22" # Internal service Rathole forwards to
  

• Tokens: Asegúrate de que el token en server.toml coincida con la configuración del cliente para una conexión segura.

Yarr

• Configuración: La configuración de Yarr a menudo se gestiona a través de variables de entorno o un archivo config.json. Consulta la pestaña Startup para variables como YARR_PORT, YARR_DATABASE_PATH o YARR_ADMIN_EMAIL.
• Configuración inicial: La primera vez que accedas a Yarr, es posible que debas pasar por un asistente de configuración inicial para crear un usuario administrador y configurar los ajustes básicos.

Problemas comunes

1. La aplicación no se inicia: Consulta la consola del servidor en el panel de ServerPrism para ver los mensajes de error. La falta de archivos de configuración, variables de entorno incorrectas o conflictos de puertos son causas comunes. Asegúrate de que todos los archivos requeridos estén presentes y correctamente formateados.
2. No se puede acceder a la interfaz web:
   • Verifica que la aplicación esté ejecutándose y escuchando en el puerto esperado (por ejemplo, 8080).
   • Verifica las reglas del firewall de tu servidor (ServerPrism suele encargarse de esto, pero asegúrate de que tu aplicación no esté intentando usar un puerto bloqueado no estándar).
   • Confirma que estás usando la dirección IP y el puerto correctos en tu navegador. Si usas un dominio, asegúrate de que el DNS apunte correctamente a la IP de tu servidor.
3. El cliente de Rathole no se conecta: Vuelve a verificar que el token en tu server.toml coincida con la configuración del cliente. Asegúrate de que el bind_addr para el servicio en server.toml esté correctamente configurado y sea accesible.
4. Rendimiento lento: Si tu aplicación se ejecuta lentamente, considera actualizar tu plan de servidor para obtener más RAM o CPU. Puedes hacerlo desde tu panel de cliente de ServerPrism.

Si encuentras problemas persistentes, recopila tu ID de servidor y la salida de registro relevante de la consola y abre un ticket de soporte en https://serverprism.com/tickets.

Próximos pasos

• Dominios personalizados: Para una configuración más profesional, adjunta un dominio personalizado o un subdominio gratuito de ServerPrism a tu aplicación desde tu panel de control de ServerPrism.
• Cambio de tiempo de ejecución: Si decides cambiar a una aplicación diferente (por ejemplo, de Owncast a Yarr), puedes hacerlo fácilmente a través de la pestaña Startup en tu panel de ServerPrism seleccionando un nuevo tiempo de ejecución. Esto volverá a crear la imagen de tu servidor con la nueva aplicación.
• Configuración avanzada: Consulta la documentación oficial de la aplicación elegida para funciones avanzadas, integraciones y opciones de personalización.