Para operadores

Guía del operador de anfitriones

Preparar un anfitrión Linux para Sibrel: correo, S3, LiveKit, HTTPS, copias de seguridad, actualizaciones y límites de la federación.

Verificado con el proyecto: 2026-10-15 · Soporte: support@sibrel.net

Antes de la instalación

  • Prepara un servidor Linux, acceso administrativo, un dominio y DNS.
  • Identifica al operador y al contacto de soporte; define las reglas de registro y de tratamiento de datos.
  • Prepara SMTP o una pasarela de correo de Sibrel autorizada. La verificación del registro necesita correo funcional.
  • Elige almacenamiento compatible con S3: MinIO local o un bucket externo.
  • Elige LiveKit local o separado para las llamadas.
  • Abre los puertos necesarios en los cortafuegos del servidor y del proveedor.

Instalación y estado operativo

Usa el asistente de gestión de anfitriones de una versión compatible de la aplicación o del panel. Pide acceso SSH y los ajustes de correo, almacenamiento y medios. Permítele modificar solo las máquinas destinadas a Sibrel.

Tras la instalación, prueba GET /api/host/readiness, el registro con correo, la subida y descarga de archivos, una llamada entre dos redes externas y una conexión de bot. Una respuesta HTTP correcta no basta para validar la calidad de las llamadas.

Proxy y pasarela

El proxy inverso debe reenviar la actualización WebSocket para /api/bots/gateway y los sockets de los clientes. No registres el parámetro del token en los registros de acceso. Renueva los certificados automáticamente y vigila su caducidad.

Elige los puertos de LiveKit y TURN según tu configuración. Los nodos S3 y de medios separados deben ser alcanzables desde los servidores correspondientes y las redes de los clientes.

Copias de seguridad y actualizaciones

  • Copia PostgreSQL, el almacenamiento de objetos, la configuración y las claves de federación en un lugar protegido.
  • Define la conservación y un calendario de copias; prueba la restauración periódicamente en otra máquina.
  • Antes de actualizar, revisa las migraciones y la compatibilidad de los clientes, y haz una copia de seguridad.
  • Actualizar anfitriones instalados con el asistente puede detener la aplicación. Avisa antes a los usuarios.
  • Una copia de la base de datos durante una actualización no significa que la base se revierta automáticamente ante cualquier fallo.
  • Protege SSH, los secretos de los servicios y las copias frente a accesos no autorizados.

Mover servicios y añadir nodos

Los nodos S3 adicionales reparten las subidas nuevas pero no replican los archivos antiguos. Las salas se asignan a nodos de medios; quitar un nodo de la configuración no migra las salas existentes.

Al cambiar direcciones y buckets, conserva el acceso a los objetos antiguos. La migración de archivos, los cambios de DNS y la retirada de máquinas antiguas son tareas distintas. Un diagrama de infraestructura no demuestra que la migración haya funcionado.

Federación y reglas

Conecta solo anfitriones conocidos con claves verificadas. Vigila la compatibilidad de versiones, las rutas de red y el tratamiento de repeticiones. El relé no es una cola garantizada y no mejora los medios automáticamente.

Los operadores son responsables de sus anfitriones y de los usuarios bajo su autoridad. Lee las reglas de creación y uso de anfitriones y publica tu propia información sobre el tratamiento de datos.

Registro y acceso

El administrador del host puede cerrar el registro público y crear cuentas manualmente en el panel. Este ajuste se aplica a ese host. Aplica las migraciones, conserva una copia de seguridad y comprueba que los usuarios existentes pueden iniciar sesión antes de completar una actualización del servidor.