Zum Inhalt springen
Serverküche
Suche

Die Suche wird geladen …

Compose-Prüfer: dein docker-compose.yml gegengelesen

Füg dein compose.yaml ein und bekomm die Schwachstellen genannt: ungepinnte Images, Datenbanken im Proxy-Netz, Geheimnisse im Klartext, offene Ports.

Füg deine compose.yaml unten ein. Der Prüfer liest sie, während du tippst, und nennt die Stellen, an denen die Datei von dem abweicht, was sich in unseren Rezepten bewährt hat. Mit Beispiel einsetzen siehst du, wie das aussieht.

Die Prüfung läuft vollständig in deinem Browser – der Inhalt wird nicht übertragen.

Was der Prüfer anschaut

Die Meldungen haben drei Stufen. Ein Fehler heißt, dass etwas nicht funktionieren wird. Eine Warnung steht für ein echtes Risiko, meistens für die Sicherheit oder für ein Update, das dich überrascht. Ein Hinweis ist eine Frage an dich: Oft ist es so richtig, manchmal nicht.

WasStufeWarum
Kein services:-BlockFehlerOhne ihn ist es keine Compose-Datei, fast immer ist die Einrückung verrutscht.
Traefik-Labels, aber der Dienst hängt nicht im Netz proxyFehlerTraefik sieht nur Container in seinem eigenen Netz. Die Labels bleiben wirkungslos, und du bekommst einen 404.
Image ohne Versions-Tag oder mit :latestWarnungDas nächste pull bringt eine Version, die du nicht ausgesucht hast. Bei Diensten mit build: ist :latest dagegen üblich und wird nicht gemeldet.
Datenbank oder Cache im Netz proxyWarnungSie muss nur für die eigene Anwendung erreichbar sein. Erkannt wird das am Dienstnamen (db, postgres, redis, mariadb …).
docker.sock ohne :roWarnungSchreibzugriff auf den Docker-Socket ist praktisch Root auf dem Host.
privileged: trueWarnungHebt die Isolation des Containers fast vollständig auf. Meist genügt ein gezieltes cap_add.
Feld version:HinweisCompose ignoriert es und warnt beim Start, es kann weg.
Keine restart-PolicyHinweisNach einem Neustart des Servers bleibt der Dienst aus.
Veröffentlichte Ports bei einem Dienst hinter TraefikHinweisFür HTTP unnötig, der Dienst wäre dann an Traefik vorbei erreichbar. Ports für DNS, SSH, Mail, VPN und WebRTC (etwa 53, 22, 993, 51820, 10000) meldet der Prüfer nicht, die kann ein HTTP-Proxy nicht weiterreichen.
Passwort, Token oder Schlüssel im Klartext unter environment:HinweisDie Datei landet in Backups und vielleicht in einem Git-Repository. Besser ist eine Variable wie ${DB_PASSWORD} mit dem Wert in einer .env. Nicht gemeldet werden Variablen, Platzhalter wie DEIN_PASSWORT und bereits gehashte Werte wie ein argon2-Hash.

Woher die Regeln kommen

Jede Regel stammt aus den Rezepten dieser Seite. Zusammen enthalten sie 67 Compose-Dateien mit 102 Diensten (Stand 13.11.2026), und jede davon lief auf einem echten Server, bevor sie veröffentlicht wurde. Darum steht bei vielen Meldungen dabei, wie es der Bestand macht: 98 % der Images sind auf eine Version festgelegt, 85 von 102 Diensten starten mit restart: unless-stopped neu, und nur 12 % veröffentlichen überhaupt einen Port.

Das ist eine Messlatte und kein Gesetz. Der Prüfer kennt deinen Anwendungsfall nicht. Wenn ein Hinweis in deinem Setup nicht passt, ignorier ihn.

Was er nicht prüft

Der Prüfer liest die Datei, wie sie dasteht, und kennt genau die zehn Regeln oben. Einiges sieht er deshalb nicht:

  • Ob Compose die Datei annimmt. Er prüft das YAML und den services:-Block, aber nicht jeden Schlüssel. Das erledigt docker compose config -q im Projektordner auf dem Server: Es findet Tippfehler in Schlüsselnamen, ungültige Ports und Netze, die nirgends definiert sind, und warnt bei fehlenden Variablen. Jeden Wert prüft aber auch Compose nicht.
  • Was in .env und env_file steht. Variablen bleiben unaufgelöst. Ein Passwort in command: oder in einem Label fällt ihm ebenfalls nicht auf.
  • Andere Reverse Proxys. Die Regeln zum Netz proxy und zu veröffentlichten Ports greifen nur bei Traefik-Labels. Für Caddy oder Nginx Proxy Manager gibt es keine Labels, an denen er sich festhalten könnte.
  • Datenbanken mit eigenwilligem Namen. Heißt dein Postgres-Dienst storage, erkennt er ihn nicht als Datenbank.
  • Die ausführliche Schreibweise. docker.sock, als Volume mit type: bind eingebunden, sieht er nicht.
  • Härtung und Images selbst. cap_drop, read_only, ein eigener Benutzer, Healthchecks und Ressourcen-Limits stehen in Docker-Container absichern. Ob ein Image bekannte Sicherheitslücken hat oder der Tag überhaupt existiert, prüft er nicht.

Deine Datei bleibt bei dir

Alles läuft in deinem Browser. Das Skript wertet den Text im Feld aus und schickt nichts an einen Server, auch nicht an unseren. Du kannst die Seite nach dem Laden sogar offline benutzen.

Häufige Fragen

Wird meine compose.yaml irgendwo gespeichert oder verschickt?
Nein. Der Prüfer läuft komplett in deinem Browser: Das Skript liest den Text aus dem Feld, wertet ihn aus und zeigt das Ergebnis an. Es gibt keine Anfrage an einen Server. Trotzdem gilt die alte Regel: Echte Passwörter gehören nicht in eine Compose-Datei, egal wohin du sie kopierst.
Der Prüfer meldet nichts. Ist meine Datei damit in Ordnung?
Sie hat keine der zehn Stolperstellen, die er kennt. Ob sie startet, sagt dir erst docker compose config -q auf dem Server, und wie gut der Container abgeschottet ist, steht in Docker-Container absichern. Der Prüfer ersetzt keins von beiden.
Muss ich jede Meldung beheben?
Fehler ja, denn dann funktioniert etwas nicht. Warnungen fast immer, sie stehen für ein echtes Risiko. Hinweise sind Fragen an dich: Ein Dienst, der bewusst nur einmal läuft, braucht keine restart-Policy, und ein Wert, der wie ein Passwort heißt, kann harmlos sein.
Warum nicht einfach :latest, wenn ich sowieso immer die neueste Version will?
Weil du dann nicht entscheidest, wann das Update passiert. Mit :latest zieht der nächste docker compose pull irgendeine neue Version, auch eine mit Breaking Changes, und du weißt hinterher nicht, welche vorher lief. Mit einer festen Version aktualisierst du bewusst und kannst zurück. Wie das ohne viel Aufwand geht, steht in Docker-Stack aktuell halten.
Ist es egal, ob die Datei compose.yaml oder docker-compose.yml heißt?
Für den Prüfer ja, er sieht nur den Inhalt. Docker Compose findet beide Namen von selbst und bevorzugt compose.yaml, wenn beide im Ordner liegen.