Migrationen Du kommst von Heroku, Render, Hatchbox oder Cloud 66? Wir ziehen deine Produktions-App innerhalb von 48 Stunden um →
Was auf deinem Server wirklich passiert, wenn du Railyard verbindest: ein zeilenweises Audit unserer Docker-, Caddy-, Firewall- und Zero-Lock-in-Architektur ← Blog Sicherheit & BYOC-Architektur • 9 Min. Lesezeit

Was auf deinem Server wirklich passiert, wenn du Railyard verbindest: ein zeilenweises Audit unserer Docker-, Caddy-, Firewall- und Zero-Lock-in-Architektur

Almokhtar Bekkour

Almokhtar Bekkour, Founder, Systems Architect

27. Oktober 2026 · 9 Min. Lesezeit

Die meisten DevOps-Engineers, die keinen PaaS-Agenten ausprobieren wollen, lehnen nicht die Idee eines solchen ab. Sie lehnen ab, nicht zu wissen, was er tut: was installiert wird, welche Ports sich öffnen, ob er nach Hause telefoniert oder Verbindungen annimmt, und was zurückbleibt, wenn sie gehen. Das ist eine vernünftige Sache, die man beantwortet haben will, bevor man irgendetwas als Root auf einer Produktionsmaschine ausführt. Dieser Beitrag überspringt also die übliche “was Railyard für dich tut”-Rahmung und beschreibt stattdessen, aus dem tatsächlichen Quellcode, was zwischen dem Klick auf Server verbinden und der Meldung des Agenten als bereit passiert, was sich laufend ändert, und was der Code beim Detach tut, da Letzteres nicht zur einfachsten Lesart unserer eigenen FAQ passt.

Einen Server verbinden: die tatsächlichen Schritte

Einen Server zu verbinden ist ein Hintergrundjob, der eine SSH-Sitzung mit dem Schlüssel öffnet, den du angibst (oder einem, den Railyard generiert hat, falls es den Server erstellt hat), und eine feste Befehlssequenz ausführt. In dieser Reihenfolge:

  1. Docker, installiert über das offizielle get.docker.com-Skript, falls noch nicht vorhanden. Wenn du dich nicht als Root verbindest, wird dein Nutzer zur docker-Gruppe hinzugefügt, damit spätere Schritte nicht für jeden Docker-Aufruf sudo brauchen.
  2. Eine 2-GB-Swap-Datei unter /swapfile, nur erstellt, wenn noch kein Swap existiert, mit vm.swappiness auf 10 gesetzt. Build-Server bekommen eine größere, dimensioniert, um genug Spielraum für einen laufenden Build zu lassen.
  3. UFW-Regeln für die Ports 22, 80, 443 und 50052, dann wird UFW erzwungen aktiviert, falls es installiert, aber aus war. Wenn UFW überhaupt nicht installiert ist, wird dieser Schritt übersprungen und protokolliert, nicht stillschweigend angenommen.
  4. Unbeaufsichtigte Sicherheitsupdates: Das Paket unattended-upgrades wird installiert, falls es fehlt, und /etc/apt/apt.conf.d/20auto-upgrades wird geschrieben, um nächtliche Paketlisten-Updates und unbeaufsichtigte Sicherheitsupdates zu aktivieren. Ein Neustart wird von diesem Schritt nie automatisch ausgelöst; das ist eine separate, bewusste Aktion von der eigenen Seite des Servers.
  5. nixpacks, für Buildpack-artige Deploys aus einem Repository, außer der Server hat eine reine Datenbankrolle.
  6. Der Agent selbst: ein TLS-Bundle unter /var/lib/railyard-agent/tls, wenn die CA der Control-Plane konfiguriert ist (für Railyards eigene gehostete Control-Plane immer der Fall; sie verweigert das Anhängen eines Klartext-Agenten, statt stillschweigend zurückzufallen), eine Env-Datei unter /etc/railyard-agent.env, die Binärdatei unter /usr/local/bin/railyard-agent, und eine systemd-Unit (railyard-agent.service) mit Restart=always, erhöhter CPU- und I/O-Priorität, und OOMScoreAdjust=-900. Der eigene Kommentar der Unit-Datei erklärt warum: “der Agent ist der einzige Weg, diese Maschine zu erreichen, lass niemals einen außer Kontrolle geratenen Build oder einen in der Crash-Loop hängenden Container ihn aushungern.”
  7. Caddy, als lucaslorentz/caddy-docker-proxy, mit gemountetem Docker-Socket des Hosts ausgeführt, damit es Container über Label entdecken und automatisch zu ihnen routen kann, veröffentlicht 80 und 443. Wird auf einem reinen Datenbankserver übersprungen.
  8. Datastores, falls für diesen Server konfiguriert (standardmäßig Postgres und Redis; MySQL, ClickHouse, RabbitMQ, MongoDB, InfluxDB, Elasticsearch, MinIO und Memcached sind Opt-in), jeder als eigener Container mit einem generierten 40-Zeichen-Passwort, auf einem dedizierten railyard-Docker-Netzwerk.

Nichts in dieser Sequenz rührt einen Container an, den du schon laufen hattest. Benannte Container sind spezifisch (railyard-caddy, railyard-postgres, und so weiter), der einzige Weg, wie das mit etwas kollidiert, das schon auf der Maschine ist, ist also, wenn du zufällig schon einen Container mit genau einem dieser Namen hattest.

Die Firewall, genau

Die Basis-UFW-Allow-Regeln sind 22 (SSH), 80 und 443 (Caddy), und 50052 (der eigene gRPC-Port des Agenten, unten erklärt). WireGuard fügt, wenn du privates Netzwerk für das Team aktivierst, eine UDP-Allow-Regel auf Port 51820 hinzu. Über diese Basis hinaus kann der Agent selbst zusätzliche Ports öffnen, aber nur auf Anweisung der Control-Plane während eines Heartbeats, mit einem railyard-operator-Kommentar in der UFW-Regelliste markiert, damit sie identifizierbar sind und automatisch entfernt werden, sobald sie nicht mehr gewollt sind, zum Beispiel wenn du eine “mehr öffentliche Ports”-Einstellung einer App ausschaltest. Datastore-Ports (5432, 6379 und so weiter) werden standardmäßig nicht geöffnet; sie bleiben nur im privaten Docker-Netzwerk erreichbar, außer du schaltest für diesen Server ausdrücklich Legacy-Port-Publishing ein, oder fügst deine eigene IP unter Trusted Addresses einer App hinzu, was einen Proxy öffnet, der auf genau diese eine Adresse beschränkt ist, nicht den Port selbst.

Wie der Agent tatsächlich mit der Control-Plane spricht

Das ist der Teil, bei dem es sich lohnt, präzise zu sein, denn die ehrliche Antwort ist nuancierter als “nur ausgehend.” Der Agent macht zwei Dinge gleichzeitig. Er wählt sich als gRPC-Client bei der Control-Plane ein, um sich zu registrieren und alle 10 Sekunden einen Heartbeat zu senden, der CPU-, RAM-, Festplatten-, Prozess- und Traffic-Metriken trägt, über eine Verbindung, die der Agent immer selbst initiiert. Getrennt davon betreibt er auch seinen eigenen gRPC-Server, der auf 0.0.0.0:50052 lauscht, genau das, was die UFW-Regel oben öffnet. Die Control-Plane wählt sich direkt in diesen Port ein für die eigentliche Arbeit: Deploys, Log-Streaming, einen Befehl innerhalb eines Containers ausführen, Backup und Wiederherstellung, Betriebssystem-Upgrades. Dieser eingehende Pfad, kein rein ausgehender, ist das, worüber Deploys und Logs von Anfang an gelaufen sind, und es ist immer noch das, was sie heute ausführt.

Es gibt eine neuere, vom Agenten initiierte Streaming-RPC im Protokoll (Connect), die gezielt dafür gebaut ist, einen Server ganz ohne eingehende Erreichbarkeit zu überleben, hinter NAT ohne Port-Forwarding. Zum Zeitpunkt dieses Schreibens beweist sie nur, dass der Agent einen dauerhaften ausgehenden Stream halten und Pings austauschen kann; sie trägt noch keine Deploys oder irgendeine der schwereren RPCs. Der Quellcode-Kommentar dazu sagt es klar: Der bestehende Einwahl-Pfad “ist unberührt und bleibt, wie heute tatsächlich alles funktioniert.” Wenn du entscheidest, ob du 50052 eingehend öffnest, ist das die echte Antwort: ja, heute ist die Erreichbarkeit dieses Ports von Railyards Control-Plane aus der Weg, wie der Agent Anweisungen bekommt.

Jeder Aufruf, in beide Richtungen, trägt einen Bearer-Token, der für diesen Server einzigartig ist. Auf Railyards eigener gehosteter Control-Plane läuft jeder Agent zusätzlich mit Mutual TLS: einem Zertifikat pro Server, ausgestellt von Railyards eigener Zertifizierungsstelle, wobei der Server das Client-Zertifikat der Control-Plane validiert und umgekehrt, erzwungen, indem das Anhängen eines Agenten im Klartext überhaupt verweigert wird, statt sich still zu verschlechtern. Eine selbst gehostete, Single-Tenant-Control-Plane ohne konfigurierte CA kann den Agenten stattdessen in einem reinen Klartext-Bearer-Token-Modus betreiben, ein bewusster Kompromiss, der für jemanden verfügbar ist, der seine eigene Control-Plane betreibt, nicht die Standardeinstellung beim gehosteten Produkt.

Was der Agent laufend ändert, nicht nur beim Attach

Über die ursprüngliche Einrichtung hinaus laufen drei Dinge durchgehend oder als Reaktion auf Anweisungen der Control-Plane:

WireGuard, wenn privates Netzwerk für das Team aktiviert ist, als Interface mit dem Namen ry0. Es installiert wireguard-tools, falls es fehlt, generiert ein Schlüsselpaar gespeichert unter /etc/railyard/wg.key, und fügt Peers (andere Server des Teams) über öffentlichen Schlüssel und Endpoint hinzu, wie die Control-Plane sie meldet, und entfernt jeden Peer, der nicht mehr in dieser Liste ist. Netzwerk behandelt, wie Apps tatsächlich aufeinander verweisen, sobald das aktiviert ist.

ActiveProtect, das nach dem spezifischen Muster eines Scanners sucht: eine 404-Antwort auf einen Request-Pfad, der bekannten Vulnerability-Scanner-Sonden entspricht (/.env, /wp-admin, xmlrpc.php, phpmyadmin, und ähnliche). Drei Treffer von derselben IP innerhalb einer Minute führen zu 24 Stunden Sperre, durchgesetzt mit einer iptables-Chain (RAILYARD-BAN), eingefügt in sowohl INPUT als auch DOCKER-USER, niemals eine private oder Loopback-Adresse betreffend, egal wie sie sich verhält. Das ist getrennt vom SSH-Brute-Force-Schutz, der fail2bans eigenes sshd-Jail ist, bei Bedarf installiert, wenn ActiveProtect zum ersten Mal aktiviert wird, nicht etwas, das dieses selbst erfindet.

Unbeaufsichtigte Upgrades, über den nächtlichen automatischen Durchlauf hinaus, der bei der Verbindung eingerichtet wird, können auch auf Anfrage von der eigenen Seite des Servers ausgelöst werden: alles installieren, oder nur Sicherheitsupdates, mit oder ohne den Neustart, den das Abschließen manchmal braucht. Nichts startet den Server neu, ohne dass das eine ausdrückliche Entscheidung auf deiner Seite ist.

Was nie angefasst wird

Deine eigenen SSH-Schlüssel bleiben exakt, wie sie waren. Die öffentlichen Schlüssel der Teammitglieder werden innerhalb eines klar begrenzten Blocks in authorized_keys hinzugefügt (“railyard team keys: begin / end”), und nur innerhalb dieses Blocks; alles, was du selbst hinzugefügt hast, davor oder danach, bleibt unberührt, und das Entfernen eines Mitglieds entfernt nur dessen Zeile. Siehe Teams, SSO und Zugriff, wie diese Schlüsselliste tatsächlich pro Team verwaltet wird. sshd_config selbst wird nie direkt bearbeitet. Was der Agent einmal hinzufügt, ist eine Drop-in-Datei unter /etc/ssh/sshd_config.d/00-railyard.conf, die Passwort-Authentifizierung ausschaltet und Key-only-Root-Login setzt, und nur, wenn deine sshd_config schon Drop-ins unterstützt und mindestens ein echter Key-basierter Login schon existiert, das wird vorher geprüft, damit das dich nicht aussperren kann. Es validiert die Konfiguration mit sshd -t, bevor es neu lädt, und macht die Änderung automatisch rückgängig, wenn sshd sie ablehnt. Setze RAILYARD_SSH_HARDENING=off in der Environment-Datei des Agenten, um das komplett zu stoppen. Container, die du schon liefen hattest, bevor du den Server verbunden hast, werden von keinem Schritt oben je inspiziert, gestoppt oder angefasst.

Detach und Kündigung sind nicht dasselbe, und der Code behandelt sie unterschiedlich

Ein Railyard-Abo zu kündigen rührt überhaupt keinen Server an; es ist ein Flag auf Abrechnungsebene, und nichts im Code verbindet das mit dem Stoppen oder Trennen von irgendetwas. Dieser Teil hält genau so, wie du es erwarten würdest: Deine Apps sind Container auf einem Server, den dein Cloud-Anbieter dir abrechnet, und der Verlust des Dashboard-Zugriffs reicht nicht in diesen Server hinein.

Auf Detach bei einem bestimmten Server zu klicken ist eine andere, bewusste Aktion, und sie ist für die Apps darauf kein No-op. Der Detach-Controller stoppt zuerst jede App auf diesem Server (ein sanftes docker stop, das jedem Prozess sein Shutdown-Timeout gibt, gefolgt von docker rm -f), bevor er fragt, was mit den App-Einträgen selbst passieren soll (archivieren oder löschen), und erst dann den Server vom Team abhängt. Caddy selbst wird davon nie gestoppt, läuft also weiter, aber da jedes Backend, zu dem es routete, verschwunden ist, bleibt nichts mehr für es zu bedienen. Wenn du einen Server gezielt trennst, um ihn mit noch laufenden Apps an jemand anderen zu übergeben, ist das nicht, was der heutige Detach-Button tut; er ist dafür gebaut, einen Server sauber zurückzugeben, nicht für eine Live-Übergabe.

Verifiziere es selbst

Nichts davon sollte man einfach glauben. Auf jedem Server, den du verbunden hast:

# the agent, running and restarting on its own if it crashes
systemctl status railyard-agent
journalctl -u railyard-agent -n 50 --no-pager

# what's actually listening, and on which interface
ss -tlnp

# the firewall rules currently applied
sudo ufw status numbered

# containers actually running, by name
docker ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}'

# the private network interface, if turned on
sudo wg show

# the ban chain ActiveProtect maintains
sudo iptables -L RAILYARD-BAN -n

# unattended upgrades, actually enabled
cat /etc/apt/apt.conf.d/20auto-upgrades

# the SSH drop-in, if present, and nothing else in sshd_config changed
cat /etc/ssh/sshd_config.d/00-railyard.conf 2>/dev/null || echo "not present"

Wenn irgendetwas in einer zukünftigen Version dieses Beitrags nicht zu dem passt, was du auf deiner eigenen Maschine siehst, ist das einen Bug-Report wert, keine Vertrauensübung.

FAQ

Braucht der Agent einen offenen eingehenden Port, oder ist er rein ausgehend?

Heute beides: Er wählt sich für Registrierung und Heartbeats aus, und er betreibt auch seinen eigenen gRPC-Server auf Port 50052, in den sich die Control-Plane für Deploys, Logs und Befehle einwählt. Ein rein ausgehender Pfad existiert im Protokoll für Server ohne eingehende Erreichbarkeit, trägt aber noch keine echten Befehle; der eingehende Pfad ist das, was gerade tatsächlich alles ausführt.

Rührt das Verbinden eines Servers meinen bestehenden SSH-Zugriff an?

Deine eigenen Schlüssel und sshd_config bleiben unberührt. Der Agent fügt die Schlüssel der Teammitglieder innerhalb seines eigenen begrenzten Blocks in authorized_keys hinzu, und, wenn deine Konfiguration Drop-ins unterstützt und schon ein funktionierender Key-basierter Login existiert, fügt er eine Drop-in-Datei hinzu, die Passwort-Authentifizierung deaktiviert. Beides ist umkehrbar, und der SSH-Hardening-Schritt kann komplett mit einer Umgebungsvariable ausgeschaltet werden.

Was passiert mit meinen Containern, wenn ich nicht mehr für Railyard bezahle?

Nichts. Eine Kündigung ist ein Abrechnungs-Flag ohne Codepfad, der irgendetwas stoppt, entfernt oder trennt; deine Container laufen auf deinem eigenen Server genau so weiter, wie sie waren.

Was passiert mit meinen Containern, wenn ich bei einem Server auf Detach klicke?

Sie werden sanft gestoppt und entfernt, bevor der Server vom Team abgehängt wird. Das ist anders als eine Kündigung, und es lohnt sich, das zu wissen, bevor du es bei einem Server anklickst, den du eigentlich unbeaufsichtigt weiterlaufen lassen willst.

Ist der Traffic zwischen meinen Apps auf demselben Server standardmäßig privat?

Ja, ohne Einrichtung: Same-Server-Referenzen lösen sich automatisch über einen Docker-Netzwerk-Alias auf. Über Server hinweg ist es privat, sobald du das WireGuard-Netzwerk des Teams aktivierst; bis dahin löst sich eine Cross-Server-Referenz trotzdem auf, nur über die normale öffentliche Adresse der App statt einer privaten.

Lies den Code, nicht nur diesen Beitrag.

Alles, was hier beschrieben wird, läuft tatsächlich, wenn du einen Server verbindest. Verifiziere es selbst mit den Befehlen am Ende, auf deiner eigenen Maschine.

14-tägige Testphase in jedem Plan. Ein fester Preis pro Team, deine Server zum Preis deines Anbieters.

Design
Farben