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.
| Was | Stufe | Warum |
|---|---|---|
Kein services:-Block | Fehler | Ohne ihn ist es keine Compose-Datei, fast immer ist die Einrückung verrutscht. |
Traefik-Labels, aber der Dienst hängt nicht im Netz proxy | Fehler | Traefik sieht nur Container in seinem eigenen Netz. Die Labels bleiben wirkungslos, und du bekommst einen 404. |
Image ohne Versions-Tag oder mit :latest | Warnung | Das 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 proxy | Warnung | Sie muss nur für die eigene Anwendung erreichbar sein. Erkannt wird das am Dienstnamen (db, postgres, redis, mariadb …). |
docker.sock ohne :ro | Warnung | Schreibzugriff auf den Docker-Socket ist praktisch Root auf dem Host. |
privileged: true | Warnung | Hebt die Isolation des Containers fast vollständig auf. Meist genügt ein gezieltes cap_add. |
Feld version: | Hinweis | Compose ignoriert es und warnt beim Start, es kann weg. |
Keine restart-Policy | Hinweis | Nach einem Neustart des Servers bleibt der Dienst aus. |
| Veröffentlichte Ports bei einem Dienst hinter Traefik | Hinweis | Fü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: | Hinweis | Die 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 erledigtdocker compose config -qim 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
.envundenv_filesteht. Variablen bleiben unaufgelöst. Ein Passwort incommand:oder in einem Label fällt ihm ebenfalls nicht auf. - Andere Reverse Proxys. Die Regeln zum Netz
proxyund 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 mittype: bindeingebunden, 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?
Der Prüfer meldet nichts. Ist meine Datei damit in Ordnung?
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?
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?
: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?
compose.yaml, wenn beide im Ordner liegen.