Skip to content

Introduction

Qu'est-ce que Cadmin ?

Cadmin est un gestionnaire multi-serveurs pour Caddy. Il permet de gerer les virtual hosts, les certificats TLS et les configurations de reverse proxy de plusieurs serveurs Caddy depuis une interface web centralisee.

Architecture hub / agent

Cadmin repose sur une architecture hub/agent :

                        +---------------------------+
                        |           Hub             |
                        |  (Backend API + Frontend) |
                        |       SQLite DB           |
                        +-----+----------+----------+
                              |          |
                   HTTPS      |          |      HTTPS
                 (Bearer)     |          |    (Bearer)
                              v          v
                  +-----------+--+  +----+-----------+
                  |   Agent A    |  |   Agent B      |
                  |  Serveur 1   |  |  Serveur 2     |
                  |  +--------+  |  |  +--------+   |
                  |  | Caddy  |  |  |  | Caddy  |   |
                  |  +--------+  |  |  +--------+   |
                  +--------------+  +----------------+
  • Hub : serveur central qui heberge l'API backend (Hono + SQLite), le frontend React et la base de donnees. C'est le point d'entree pour tous les utilisateurs.
  • Agent : service leger deploye sur chaque serveur ou tourne une instance Caddy. L'agent recoit les ordres du hub (rechargement de config, lecture des logs) et les transmet a l'API admin de Caddy.

La communication entre le hub et les agents se fait en HTTP avec authentification par Bearer token.

A qui s'adresse Cadmin ?

Cadmin est destine aux administrateurs systeme et DevOps qui gerent plusieurs serveurs Caddy et souhaitent :

  • Centraliser la gestion des virtual hosts et reverse proxies
  • Avoir un historique des modifications (changelog avec diff)
  • Consulter les logs d'acces depuis une interface unique
  • Gerer les utilisateurs et les droits d'acces