Centrifugo

Acerca de Centrifugo

Lo que se instala

Listo al arrancar el VPS

SO compatibles

Distribuciones Linux a elegir

Aplicación

Centrifugo

Stack técnico

DockerGoCentrifugo

RAM mínima

1 GB mínimo

CPU mínima

1 vCPU

Puerto por defecto

8113

Acceso

root por SSH

Funcionalidades clave

• Conexiones en tiempo real — WebSocket, con SDK cliente oficiales para JavaScript, Dart/Flutter, Swift, Java/Android, Go y Python.
• API de publicación — basta una llamada HTTP con la cabecera X-API-Key para enviar un mensaje a un canal, desde cualquier lenguaje.
• Autenticación por token — tu backend firma JWT (HS256); se rechaza toda conexión sin un token válido.
• Canales y suscripciones del lado del servidor — el token de un usuario puede llevar su lista de canales, sin código cliente adicional.
• Consola de administración — estado del nodo, número de clientes conectados y comandos de la API desde el navegador, protegida por contraseña.
• Ligero — un único binario Go, unas decenas de MB de RAM en reposo.

¿Cuándo usar esta solución?

Guía

Desplegar Centrifugo en su VPS

1. 1

   Crear el VPS y elegir la dirección

   Contrata un VPS Ubuntu 24.04; 1 GB de RAM basta para empezar. Centrifugo requiere un dominio: los navegadores se conectan por wss:// y tu backend llama a su API por HTTPS, en un nombre estable. Se abre en un subdominio de uno de tus dominios o en el subdominio gratuito del VPS (centrifugo.{dns_slug}.servorbit-dns.com), con HTTPS incluido. No hace falta comprar un dominio.

2. 2

   Instalar Centrifugo desde el Marketplace

   En tu área de cliente, selecciona Centrifugo, elige la dirección y pulsa Instalar. El script despliega el contenedor oficial, genera la contraseña de la consola, la clave de la API de servidor y la clave de firma de los tokens, y configura el proxy inverso nginx en HTTPS, WebSocket incluido.

3. 3

   Iniciar sesión por primera vez

   Abre https://tu-dominio: la consola de administración pide una contraseña. Introduce la que aparece en tu área de cliente. La página de inicio muestra la versión del nodo y el número de clientes conectados.

4. 4

   Recuperar las claves de tu backend

   Conéctate al VPS por SSH y lee /opt/centrifugo/.env: ENCRYPTION_KEY es la clave de la API de servidor (cabecera X-API-Key) y ENCRYPTION_KEY_HEX64 la clave HMAC que firma los tokens de conexión. Guárdalas en los secretos de tu aplicación, nunca en el código que se envía al navegador.

5. 5

   Publicar y conectar tus clientes

   Tu backend firma un JWT HS256 (sub = identificador del usuario, channels = canales que seguir) y se lo entrega al navegador, que se conecta con el SDK centrifuge en wss://tu-dominio/connection/websocket. Añade el origen de tu sitio a CENTRIFUGO_CLIENT_ALLOWED_ORIGINS en /opt/centrifugo/docker-compose.yml, reinicia con docker compose up -d y publica con un POST a https://tu-dominio/api/publish.