← Blogue Sécurité et architecture BYOC • 11 min de lecture Ce qui se passe vraiment sur votre serveur quand vous connectez Railyard : un audit ligne par ligne de notre architecture Docker, Caddy, pare-feu et sans enfermement
La plupart des ingénieurs DevOps qui refusent d’essayer un agent PaaS ne s’opposent pas à l’idée d’en avoir un. Ils s’opposent à ne pas savoir ce qu’il fait : ce qui s’installe, quels ports s’ouvrent, s’il téléphone à la maison ou accepte des connexions, et ce qui reste derrière s’ils partent. C’est une chose raisonnable à vouloir savoir avant de faire tourner quoi que ce soit en root sur une machine de production. Donc cet article passe le cadrage habituel « ce que Railyard fait pour vous » et décrit plutôt, à partir du vrai code source, ce qui se passe entre cliquer sur Connecter un serveur et l’agent qui rapporte être prêt, ce qui change de façon continue, et ce que le code fait au détachement, puisque ce dernier point ne correspond pas à la lecture la plus simple de notre propre FAQ.
Connecter un serveur : les vraies étapes
Connecter un serveur est une tâche de fond qui ouvre une session SSH avec la clé que vous fournissez (ou une que Railyard a générée, si vous l’avez laissé créer le serveur) et exécute une séquence fixe de commandes. Dans l’ordre :
- Docker, installé via le script officiel
get.docker.coms’il n’est pas déjà présent. Si vous ne vous connectez pas en root, votre utilisateur est ajouté au groupedockerpour que les étapes suivantes n’aient pas besoin desudoà chaque appel Docker. - Un fichier swap de 2 Go à
/swapfile, créé seulement si aucun swap n’existe déjà, avecvm.swappinessfixé à 10. Les serveurs de build en reçoivent un plus grand, dimensionné pour laisser assez de marge à un build en cours. - Des règles UFW pour les ports 22, 80, 443 et 50052, puis UFW est forcé en activation s’il était installé mais désactivé. Si UFW n’est pas installé du tout, cette étape est passée et journalisée, pas simplement présumée.
- Mises à jour de sécurité sans surveillance : le paquet
unattended-upgradesest installé s’il manque, et/etc/apt/apt.conf.d/20auto-upgradesest écrit pour activer les mises à jour nocturnes de la liste de paquets et les mises à niveau de sécurité sans surveillance. Un redémarrage n’est jamais déclenché automatiquement par cette étape; c’est une action séparée et délibérée depuis la propre page du serveur. - nixpacks, pour des déploiements façon buildpack depuis un dépôt, à moins que le serveur ait un rôle base de données seulement.
- L’agent lui-même : un paquet TLS sous
/var/lib/railyard-agent/tlssi l’autorité de certification du plan de contrôle est configurée (toujours vrai pour le propre plan de contrôle hébergé de Railyard; il refuse de rattacher un agent en clair plutôt que de se replier silencieusement), un fichier d’environnement à/etc/railyard-agent.env, le binaire à/usr/local/bin/railyard-agent, et une unité systemd (railyard-agent.service) avecRestart=always, une priorité CPU et E/S élevée, etOOMScoreAdjust=-900. Le propre commentaire du fichier d’unité explique pourquoi : « l’agent est le seul moyen d’atteindre cette machine, ne jamais laisser un build incontrôlé ou un conteneur en boucle de plantage l’affamer. » - Caddy, sous la forme de
lucaslorentz/caddy-docker-proxy, exécuté avec le socket Docker de l’hôte monté pour qu’il puisse découvrir les conteneurs par étiquette et router vers eux automatiquement, publiant les ports 80 et 443. Passé si le serveur a un rôle base de données seulement. - Bases de données, si certaines sont configurées pour ce serveur (Postgres et Redis par défaut; MySQL, ClickHouse, RabbitMQ, MongoDB, InfluxDB, Elasticsearch, MinIO et Memcached sont optionnelles), chacune dans son propre conteneur avec un mot de passe généré de 40 caractères, sur un réseau Docker dédié
railyard.
Rien dans cette séquence ne touche un conteneur que vous aviez déjà en marche. Les conteneurs nommés sont spécifiques (railyard-caddy, railyard-postgres, et ainsi de suite), donc la seule façon que ça entre en collision avec quelque chose déjà sur la machine, c’est si vous aviez justement déjà un conteneur avec exactement l’un de ces noms.
Le pare-feu, précisément
Les règles d’autorisation UFW de base sont 22 (SSH), 80 et 443 (Caddy), et 50052 (le propre port gRPC de l’agent, expliqué plus bas). WireGuard, si vous activez le réseau privé pour l’équipe, ajoute une règle d’autorisation UDP sur le port 51820. Au-delà de cette base, l’agent peut ouvrir des ports supplémentaires de lui-même, mais seulement sur instruction du plan de contrôle pendant un battement de cœur, étiquetés avec un commentaire railyard-operator dans la liste de règles UFW pour qu’ils soient identifiables et retirés automatiquement dès qu’ils ne sont plus voulus, par exemple quand vous désactivez un paramètre « plus de ports publics » sur une application. Les ports de base de données (5432, 6379 et ainsi de suite) ne sont pas ouverts par défaut; ils restent accessibles seulement sur le réseau Docker privé à moins que vous activiez explicitement la publication de ports héritée pour ce serveur, ou ajoutiez votre propre IP sous les adresses de confiance d’une application, ce qui ouvre un proxy limité à cette seule adresse, pas le port lui-même.
Comment l’agent parle vraiment au plan de contrôle
C’est la partie qui vaut la peine d’être précise, parce que la réponse honnête est plus nuancée que « sortant seulement ». L’agent fait deux choses à la fois. Il appelle vers l’extérieur le plan de contrôle comme client gRPC pour s’enregistrer et envoyer un battement de cœur toutes les 10 secondes, portant les métriques de CPU, mémoire, disque, processus et trafic, sur une connexion que l’agent initie toujours. Séparément, il fait aussi tourner son propre serveur gRPC, écoutant sur 0.0.0.0:50052, ce que la règle UFW ci-dessus ouvre. Le plan de contrôle appelle directement dans ce port pour le vrai travail : déploiements, diffusion de journaux, exécution d’une commande à l’intérieur d’un conteneur, sauvegarde et restauration, mises à niveau système. Ce chemin entrant, pas un chemin sortant seulement, est ce sur quoi les déploiements et les journaux ont tourné depuis le début, et c’est encore ce qui les fait tourner aujourd’hui.
Il existe un RPC de diffusion plus récent, initié par l’agent, dans le protocole (Connect) construit spécifiquement pour survivre sur un serveur sans aucune accessibilité entrante, derrière un NAT sans redirection de port. Au moment d’écrire ces lignes, il prouve seulement que l’agent peut maintenir un flux sortant persistant et échanger des pings; il ne porte pas encore les déploiements ni aucun des RPC plus lourds. Le commentaire du code source à ce sujet le dit clairement : le chemin existant d’appel entrant « reste intact et demeure la façon dont tout fonctionne vraiment aujourd’hui ». Si vous décidez d’ouvrir le port 50052 en entrant, voici la vraie réponse : oui, aujourd’hui, ce port accessible depuis le plan de contrôle de Railyard est comment l’agent reçoit ses instructions.
Chaque appel, dans les deux directions, porte un jeton de type bearer unique à ce serveur. Sur le propre plan de contrôle hébergé de Railyard, chaque agent tourne en plus avec du TLS mutuel : un certificat par serveur émis depuis la propre autorité de certification de Railyard, le serveur validant le certificat client du plan de contrôle et vice versa, appliqué en refusant de rattacher un agent en clair du tout plutôt que de se dégrader silencieusement. Un plan de contrôle auto-hébergé et mono-locataire sans autorité de certification configurée peut faire tourner l’agent dans un mode en clair, jeton bearer seulement, à la place, ce qui est un compromis délibéré disponible pour quelqu’un qui exploite son propre plan de contrôle, pas le défaut sur le produit hébergé.
Ce que l’agent change dans le temps, pas seulement au rattachement
Au-delà de la configuration initiale, trois choses tournent en continu ou en réponse à des instructions du plan de contrôle :
WireGuard, quand le réseau privé est activé pour l’équipe, comme une interface nommée ry0. Il installe wireguard-tools si ça manque, génère une paire de clés stockée à /etc/railyard/wg.key, et ajoute des pairs (les autres serveurs de l’équipe) par clé publique et point de terminaison tels que le plan de contrôle les rapporte, retirant tout pair qui n’est plus dans cette liste. Networking couvre comment les applications se référencent vraiment les unes les autres une fois que c’est activé.
ActiveProtect, qui surveille le motif spécifique d’un scanner : une réponse 404 à une requête dont le chemin correspond à des sondes connues de scanner de vulnérabilités (/.env, /wp-admin, xmlrpc.php, phpmyadmin, et similaires). Trois coups depuis la même IP en une minute la font bannir pour 24 heures, appliqué avec une chaîne iptables (RAILYARD-BAN) insérée à la fois dans INPUT et DOCKER-USER, ne touchant jamais une adresse privée ou de bouclage peu importe son comportement. C’est séparé de la protection contre les attaques par force brute SSH, qui est la propre prison sshd de fail2ban, installée à la demande la première fois qu’ActiveProtect est activé, pas quelque chose que ça invente soi-même.
Mises à jour sans surveillance, au-delà de la passe automatique nocturne mise en place au rattachement, peuvent aussi être déclenchées à la demande depuis la propre page du serveur : installer tout, ou seulement les mises à jour de sécurité, avec ou sans le redémarrage que leur finalisation demande parfois. Rien ne redémarre le serveur sans que ça soit un choix explicite de votre part.
Ce qui n’est jamais touché
Vos propres clés SSH restent exactement comme elles étaient. Les clés publiques des membres d’équipe sont ajoutées à l’intérieur d’un bloc clairement délimité dans authorized_keys (« railyard team keys: begin / end »), et seulement à l’intérieur de ce bloc; tout ce que vous avez ajouté vous-même, avant ou après, est laissé intact, et retirer un membre ne retire que sa ligne. Consultez Teams, SSO et accès pour voir comment cette liste de clés est vraiment gérée par équipe. sshd_config lui-même n’est jamais édité directement. Ce que l’agent ajoute, une fois, c’est un fichier complémentaire à /etc/ssh/sshd_config.d/00-railyard.conf qui désactive l’authentification par mot de passe et fixe une connexion root par clé seulement, et seulement si votre sshd_config prend déjà en charge les fichiers complémentaires et qu’au moins une vraie connexion par clé fonctionne déjà, vérifié d’abord pour que ça ne puisse pas vous enfermer dehors. Il valide la configuration avec sshd -t avant de recharger et revient automatiquement en arrière si sshd la rejette. Définissez RAILYARD_SSH_HARDENING=off dans le fichier d’environnement de l’agent pour arrêter ça entièrement. Les conteneurs que vous aviez déjà en marche avant de connecter le serveur ne sont jamais inspectés, arrêtés ou touchés par aucune étape ci-dessus.
Détacher et annuler ne sont pas la même chose, et le code les traite différemment
Annuler un abonnement Railyard ne touche pas du tout un serveur; c’est un indicateur au niveau de la facturation, et rien dans le code ne le lie à arrêter ou détacher quoi que ce soit. Cette partie tient exactement comme vous l’attendriez : vos applications sont des conteneurs sur un serveur que votre fournisseur cloud vous facture, et perdre l’accès au tableau de bord n’atteint pas ce serveur.
Cliquer sur Détacher sur un serveur spécifique est une action différente et délibérée, et ce n’est pas une opération neutre pour les applications qui y tournent. Le contrôleur de détachement arrête d’abord chaque application sur ce serveur (un docker stop propre, donnant à chaque processus son délai d’arrêt, suivi d’un docker rm -f) avant de demander quoi faire des registres d’application eux-mêmes (archiver ou supprimer), et seulement après ça désassigne le serveur de l’équipe. Caddy lui-même n’est jamais arrêté par ça, donc il continue de tourner, mais avec chaque backend vers lequel il routait disparu, il n’y a plus rien pour lui à servir. Si vous détachez un serveur spécifiquement pour le remettre à quelqu’un d’autre avec ses applications encore en marche, ce n’est pas ce que fait le bouton Détacher aujourd’hui; il est construit pour redonner un serveur proprement, pas pour un transfert en direct.
Vérifiez-le vous-même
Rien de ce qui précède ne devrait être pris sur la foi. Sur n’importe quel serveur que vous avez connecté :
# l'agent, en marche et qui redémarre de lui-même s'il plante
systemctl status railyard-agent
journalctl -u railyard-agent -n 50 --no-pager
# ce qui écoute vraiment, et sur quelle interface
ss -tlnp
# les règles de pare-feu actuellement appliquées
sudo ufw status numbered
# les conteneurs vraiment en marche, par nom
docker ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}'
# l'interface de réseau privé, si activée
sudo wg show
# la chaîne de bannissement que maintient ActiveProtect
sudo iptables -L RAILYARD-BAN -n
# mises à jour sans surveillance, vraiment activées
cat /etc/apt/apt.conf.d/20auto-upgrades
# le fichier complémentaire SSH, si présent, et rien d'autre dans sshd_config changé
cat /etc/ssh/sshd_config.d/00-railyard.conf 2>/dev/null || echo "not present"
Si quoi que ce soit dans une future version de cet article ne correspond pas à ce que vous voyez sur votre propre machine, c’est un bug qui vaut la peine d’être signalé, pas un exercice de confiance.
FAQ
L’agent a-t-il besoin d’un port entrant ouvert, ou est-il sortant seulement?
Aujourd’hui, les deux : il appelle vers l’extérieur pour l’enregistrement et les battements de cœur, et il fait aussi tourner son propre serveur gRPC sur le port 50052 dans lequel le plan de contrôle se connecte pour les déploiements, les journaux et les commandes. Un chemin sortant seulement existe dans le protocole pour les serveurs sans aucune accessibilité entrante, mais il ne porte pas encore de vraies commandes; le chemin entrant est ce qui fait vraiment tourner les choses en ce moment.
Connecter un serveur touche-t-il mon accès SSH existant?
Vos propres clés et sshd_config sont laissés intacts. L’agent ajoute les clés des membres d’équipe à l’intérieur de son propre bloc délimité dans authorized_keys, et, si votre configuration prend en charge les fichiers complémentaires et qu’une connexion par clé fonctionnelle existe déjà, ajoute un fichier complémentaire qui désactive l’authentification par mot de passe. Les deux sont réversibles, et l’étape de durcissement SSH peut être désactivée entièrement avec une variable d’environnement.
Qu’arrive-t-il à mes conteneurs si j’arrête de payer pour Railyard?
Rien. Annuler un abonnement est un indicateur de facturation sans aucun chemin de code qui arrête, retire ou détache quoi que ce soit; vos conteneurs continuent de tourner sur votre propre serveur exactement comme ils étaient.
Qu’arrive-t-il à mes conteneurs si je clique sur Détacher sur un serveur?
Ils sont arrêtés et retirés, proprement, avant que le serveur soit désassigné de l’équipe. C’est différent d’annuler un abonnement, et ça vaut la peine de le savoir avant de cliquer sur ce bouton pour un serveur que vous voulez vraiment garder en marche sans surveillance.
Le trafic entre mes applications sur le même serveur est-il privé par défaut?
Oui, sans aucune configuration : les références même-serveur se résolvent automatiquement via un alias de réseau Docker. À travers les serveurs, c’est privé une fois que vous activez le réseau WireGuard de l’équipe; jusque-là, une référence entre serveurs se résout encore, simplement via l’adresse publique normale de l’application plutôt qu’une adresse privée.