Aller au contenu principal

Roastgate

Roastgate est une interface web qui pilote le nginx installé sur votre serveur. Elle tourne dans un conteneur Docker à côté de nginx et gère :

  • Les reverse proxies : rediriger un domaine vers une application ou un conteneur.
  • Les sites : servir des fichiers statiques (un site web, une single page application).
  • Les listes blanches d'IP : restreindre un proxy ou un site à certaines adresses.
  • Les certificats Let's Encrypt : les obtenir, les renouveler et les supprimer.

Roastgate n'utilise jamais de format propre : elle lit et écrit les fichiers nginx classiques. Votre /etc/nginx reste la source de vérité, vous pouvez donc continuer à modifier les fichiers à la main, et arrêter d'utiliser Roastgate à tout moment sans rien perdre.

Alpha

Roastgate en est à ses versions alpha 0.x : les réglages, le schéma de la base de données et le comportement peuvent changer d'une version à l'autre. Sauvegardez le volume de données avant chaque mise à jour.

Le tableau de bord : nginx 1.24.0 est joignable, avec les boutons Check again, Test configuration et Reload nginx

Ce qu'elle gère​

ÉlémentContenuEmplacementActif lorsque
Reverse proxiesblocs serverconf.d/<name>.confle fichier se termine par .conf (et non .conf.disabled)
Sitesblocs serversites-available/<name>un lien symbolique existe dans sites-enabled/
Listes blancheslignes allow <ip>;whitelists/<name>.confune configuration l'inclut avec include
CertificatsLet's Encrypt/etc/letsencryptune configuration y fait référence

Les arborescences Debian et Ubuntu (conf.d/, sites-available/, sites-enabled/) sont prises en charge.

Un cycle de modification sûr​

Chaque modification faite depuis Roastgate (enregistrement, activation, désactivation, suppression, restauration) suit le même cycle :

  • L'ancien contenu est conservé en tant que sauvegarde (les 30 plus récentes par fichier), voir Sauvegardes.
  • Les écritures sont atomiques (fichier temporaire, puis renommage) et conservent les permissions d'origine du fichier.
  • Si nginx -t échoue, la modification est annulée et l'erreur nginx est affichée. nginx continue de tourner avec la configuration précédente.
  • Si nginx -t échouait déjà pour une raison sans rapport avec votre modification, celle-ci est également annulée, et Roastgate vous le signale.

Par où commencer​

  1. Installez Roastgate sur votre serveur.
  2. Lancez la première configuration.
  3. Créez votre premier reverse proxy ou site.
  4. Protégez votre compte avec l'authentification à deux facteurs ou une passkey.