Risu Server

AdonisJS
Open Source
TypeScript
Infrastructure
Self-hosted
Svelte

Un panneau auto-hébergé pour cartographier ses serveurs, les services qui tournent dessus et ce qui dépend de quoi.

Risu Server

Le contexte

Été 2025, chez Kalya Santé. Je m'occupais des serveurs en plus du développement, et il me manquait un endroit où voir d'un coup d'œil quels services tournaient où, et ce qui dépendait de quoi.

La question qui m'intéressait se pose toujours avant de toucher à une machine : si j'arrête cette base une heure pour la mettre à jour, qu'est-ce qui tombe avec ? Les outils de supervision répondent très bien à « qu'est-ce qui est en panne ». Aucun ne dit ce qui va l'être.

Risu Server (risu, c'est l'écureuil en japonais) est un panneau auto-hébergé qui garde cette carte à jour. J'ai commencé le 11 juin 2025, la version 1.0.0 date du 14 juillet.

Une fiche par service

Chaque service a sa fiche, avec ce qu'on cherche toujours au mauvais moment : le serveur qui l'héberge, les ports exposés, le chemin d'installation, le dépôt du code, des notes en Markdown et la date de la dernière maintenance.

La fiche d'un service dans Risu Server : ses dépendances et les services qui dépendent de lui

La partie utile est à droite. D'un côté, ce dont le service a besoin pour fonctionner. De l'autre, tous ceux qui ont besoin de lui. Chaque lien porte un niveau (critique, optionnel ou solution de repli), parce que perdre son cache et perdre sa base de données ne se valent pas.

Un contrôle empêche aussi de créer une boucle. Si A dépend de B, Risu refuse que B dépende de A, même par trois intermédiaires.

La carte

Le tableau de bord dessine l'ensemble. Les serveurs sont des boîtes avec leurs services rangés dedans. Les traits sont les dépendances.

La cartographie des services : trois serveurs, neuf services et leurs dépendances

L'historique Git garde une trace honnête de la bagarre. Le 12 juin, un commit s'appelle « feat: ouais ouais ouais ». Le suivant, le même jour, « feat: good graph ». Entre les deux, j'ai abandonné une première bibliothèque de graphes pour Cytoscape, qui sait dessiner des nœuds à l'intérieur d'autres nœuds. La première traîne d'ailleurs encore dans les dépendances du projet, je ne l'ai jamais retirée.

Un serveur peut aussi avoir un parent, ce qui sert à représenter une machine virtuelle posée sur un hôte physique.

La liste des serveurs, avec leur hébergeur, leur localisation et leurs services

Les captures de cette page montrent une infrastructure inventée pour l'occasion. Les adresses IP sortent des plages réservées à la documentation.

Ce que Risu ne fait pas

Il ne surveille rien, et je préfère l'écrire ici que le laisser découvrir dans le code. Le champ « URL de contrôle » existe, la route qui renvoie l'état des serveurs aussi, mais elle tire cet état au hasard : 95 % de chances d'être « en ligne ». C'était un bouche-trou en attendant de brancher de vraies sondes, et je ne l'ai jamais remplacé.

Savoir si un service répond, des outils comme Uptime Kuma le font déjà très bien, et mieux que ce que j'aurais écrit. Ce qu'ils n'ont pas, c'est la carte des dépendances. C'est la partie de Risu qui vaut quelque chose.

Le dépôt n'a plus bougé depuis août 2025.

Autour de la carte

La connexion passe uniquement par OAuth. Les adresses du fournisseur d'identité et la correspondance des champs se règlent par variables d'environnement, donc Risu se branche sur le système de connexion qu'une équipe a déjà, sans stocker un seul mot de passe.

Un script peut lire et alimenter la carte par une API REST, avec des clés dont seule l'empreinte est conservée en base. Sa documentation Swagger est générée à partir des routes.

Côté installation, le projet fournit une image Docker et un paquet Cloudron.

Ce qui est humain, ce qui est IA. Sur 97 commits, 82 sont de moi et 15 de Jules, l'agent de code de Google, à qui j'ai laissé les corvées : conteneurisation, intégration continue, erreurs TypeScript, README. L'un de ses commits s'intitule « Jules was unable to complete the task in time ». Au moins, il prévient.

Stack technique

Couche Technologie Ce qu'elle fait ici
Serveur AdonisJS 6 Routes, API et connexion OAuth
Interface Svelte 5 avec Inertia Des pages Svelte servies par AdonisJS, sans API intermédiaire à maintenir
Données SQLite, via l'ORM Lucid Un seul fichier à sauvegarder
Graphe Cytoscape Les services dessinés à l'intérieur de leur serveur
Style Tailwind CSS, DaisyUI 5 Composants et thèmes
API Clés d'API, Swagger généré Lecture et écriture depuis des scripts
Installation Docker, paquet Cloudron Deux façons de l'héberger chez soi

Voir le code sur GitHub