Centrifugo

À propos de Centrifugo

Ce qui est installé

Prêt au démarrage du VPS

OS compatibles

Distributions Linux au choix

Application

Centrifugo

Stack technique

DockerGoCentrifugo

RAM minimum

1 Go minimum

CPU minimum

1 vCPU

Port par défaut

8113

Accès

root par SSH

Fonctionnalités clés

• Connexions temps réel — WebSocket, avec des SDK clients officiels pour JavaScript, Dart/Flutter, Swift, Java/Android, Go et Python.
• API de publication — un appel HTTP avec l'en-tête X-API-Key suffit pour envoyer un message à un canal, depuis n'importe quel langage.
• Authentification par jeton — votre backend signe des JWT (HS256) ; une connexion sans jeton valide est refusée.
• Canaux et abonnements côté serveur — la liste des canaux d'un utilisateur peut être portée par son jeton, sans code client supplémentaire.
• Console d'administration — état du nœud, nombre de clients connectés et envoi de commandes d'API depuis le navigateur, protégée par mot de passe.
• Léger — un binaire Go unique, quelques dizaines de Mo de RAM au repos.

Quand utiliser cette solution ?

Guide

Déployer Centrifugo sur votre VPS

1. 1

   Créer le VPS et choisir l'adresse

   Commandez un VPS Ubuntu 24.04 ; 1 Go de RAM suffit pour démarrer. Centrifugo exige un domaine : les navigateurs s'y connectent en wss:// et votre backend appelle son API en HTTPS, sur un nom stable. Il s'ouvre sur un sous-domaine de l'un de vos domaines, ou sur le sous-domaine gratuit du VPS (centrifugo.{dns_slug}.servorbit-dns.com), HTTPS compris. Inutile d'acheter un nom de domaine.

2. 2

   Installer Centrifugo depuis le Marketplace

   Dans votre espace client, sélectionnez Centrifugo, choisissez l'adresse et cliquez sur Installer. Le script déploie le conteneur officiel, génère le mot de passe de la console, la clé de l'API serveur et la clé de signature des jetons, puis configure le reverse proxy nginx en HTTPS, WebSocket compris.

3. 3

   Se connecter la première fois

   Ouvrez https://votre-domaine : la console d'administration demande un mot de passe. Saisissez celui affiché dans votre espace client. La page d'accueil indique la version du nœud et le nombre de clients connectés.

4. 4

   Récupérer les clés de votre backend

   Connectez-vous au VPS en SSH et lisez /opt/centrifugo/.env : ENCRYPTION_KEY est la clé de l'API serveur (en-tête X-API-Key) et ENCRYPTION_KEY_HEX64 la clé HMAC qui signe les jetons de connexion. Rangez-les dans les secrets de votre application, jamais dans le code envoyé au navigateur.

5. 5

   Publier et connecter vos clients

   Votre backend signe un JWT HS256 (sub = identifiant de l'utilisateur, channels = canaux à suivre) et le remet au navigateur, qui se connecte avec le SDK centrifuge sur wss://votre-domaine/connection/websocket. Ajoutez l'origine de votre site à CENTRIFUGO_CLIENT_ALLOWED_ORIGINS dans /opt/centrifugo/docker-compose.yml, relancez avec docker compose up -d, puis publiez avec un POST sur https://votre-domaine/api/publish.