Dockerfile-Linter
Füge ein Dockerfile ein und erhalte sofort eine Prüfung anhand von 38 Best-Practice-Regeln: Base-Images ohne festen Tag oder mit latest, apt-get update in eigenem Layer, übrig gebliebene Paket-Caches, fehlender USER ohne Root-Rechte, CMD in Shell-Form, Geheimnisse in ENV und mehr. Jeder Fund verweist auf seine Zeile und erklärt, warum er wichtig ist und wie du ihn behebst.
Zuletzt aktualisiert:
Regeln (0 aktiviert)
Entferne das Häkchen bei einer Regel, um sie zu ignorieren. Deine Auswahl wird in diesem Browser gespeichert. Du kannst auch # lint-ignore: DF201 in die Zeile über einer Anweisung schreiben.
Anleitung: Dockerfile-Linter
- Füge dein Dockerfile in den Editor ein, lade es hoch oder lade eines der Beispiele.
- Lies die Punktzahl und die Anzahl der Fehler, Warnungen und Vorschläge; die Stage-Karten zeigen, wie viele Layer jede Stage erzeugt.
- Öffne jeden Fund: Klicke auf die Zeilennummer, um dorthin zu springen, und klappe Warum es wichtig ist auf, um die Begründung und ein korrigiertes Beispiel zu sehen.
- Beheben und erneut prüfen: Das Dockerfile wird beim Tippen erneut geprüft.
- Passe die Regeln an, wenn eine Prüfung nicht zu deinem Projekt passt, und kopiere dann den Bericht für ein Code-Review oder Ticket.
Regelübersicht
Die Regeln sind nach Schweregrad gruppiert. Fehler lassen den Build scheitern oder verhalten sich anders als beabsichtigt, Warnungen betreffen Sicherheit, Größe oder Reproduzierbarkeit, und Vorschläge sind gute Gewohnheiten.
| Code | Regel | Typische Lösung |
|---|---|---|
| DF101 | FROM muss die erste Anweisung sein | Nur ARG darf vor FROM stehen |
| DF102 | Unbekannte Anweisung | Behebe den Tippfehler oder ergänze das fehlende \ in der Zeile darüber |
| DF103 | Ungültiges JSON in Exec-Form | CMD ["npm", "start"] mit doppelten Anführungszeichen |
| DF104 / DF105 | Doppelter Stage-Name / unbekanntes COPY --from | Eindeutiges AS name; nur auf frühere Stages verweisen |
| DF106 | Mehrere Quellen brauchen ein Verzeichnis als Ziel | COPY a.txt b.txt ./ |
| DF107 / DF108 | Ungültiger EXPOSE-Port / relatives WORKDIR | EXPOSE 8080 und WORKDIR /app |
| DF201 / DF202 | Base-Image ohne festen Tag oder mit :latest | FROM python:3.12-slim |
| DF203 | Container läuft als root | USER app in der finalen Stage |
| DF204 – DF208 | apt-get: update mit install, Cache-Bereinigung, -y, apt vs. apt-get, kein upgrade | apt-get update && apt-get install -y --no-install-recommends … && rm -rf /var/lib/apt/lists/* |
| DF209 / DF210 | Caches von apk und yum/dnf | apk add --no-cache bzw. dnf clean all |
| DF211 / DF216 | sudo und chmod 777 | USER-Wechsel, COPY --chown |
| DF212 / DF313 | ADD für lokale Dateien, ungeprüfte URLs | COPY bzw. ADD --checksum=sha256:… |
| DF213 | Mehr als ein CMD oder ENTRYPOINT | Nur das letzte behalten |
| DF214 | MAINTAINER ist veraltet | LABEL org.opencontainers.image.authors=… |
| DF215 | Geheimnis in ENV oder ARG | Laufzeitvariablen oder RUN --mount=type=secret |
| DF217 | Leerzeile in einer Fortsetzung | Entferne die Leerzeile |
| DF301 – DF313 | Vorschläge: no-install-recommends, pip-Cache, WORKDIR statt cd, Exec-Form, zusammengefasste RUNs, cachefreundliche COPY-Reihenfolge, pipefail, ENV key=value, Großschreibung, HEALTHCHECK, npm ci, Layer-Anzahl | Siehe die Erklärung unter jedem Fund |
Ein cachefreundlicher Dockerfile-Aufbau
Docker baut einen Layer neu, wenn sich die Anweisung oder die kopierten Dateien ändern, und ebenso jeden Layer danach. Ordne die Anweisungen von selten bis häufig geändert:
- Base-Image mit festem Tag, Systempakete in einem RUN installiert und bereinigt.
- Nur Abhängigkeitsdateien:
package.jsonundpackage-lock.json,requirements.txt,go.modundgo.sum. - Installation der Abhängigkeiten:
npm ci,pip install --no-cache-dir -r requirements.txt,go mod download. - Quellcode:
COPY . ., mit einer.dockerignore, die.git,node_modulesund Build-Ausgaben ausschließt. - Build-Schritt, idealerweise in einer eigenen Stage; kopiere dann nur das Ergebnis in ein kleines Laufzeit-Image.
- Laufzeiteinstellungen:
USER,EXPOSE,HEALTHCHECKund einCMDoderENTRYPOINTin Exec-Form.
Mit dieser Reihenfolge werden beim Bearbeiten einer Quelldatei die gecachten Abhängigkeits-Layer wiederverwendet, und der Neubau dauert Sekunden statt Minuten.
Häufige Fragen
Was prüft ein Dockerfile-Linter?
Er liest jede Anweisung und vergleicht sie mit allgemein empfohlenen Dockerfile-Praktiken: reproduzierbare Base-Images (feste Tags), kleine Layer (Paket-Caches im selben RUN entfernt), Sicherheit (ein Benutzer ohne Root-Rechte, keine Geheimnisse in ENV, kein chmod 777), korrekte Syntax (gültiges JSON in Exec-Form, bekannte Anweisungen, gültige EXPOSE-Ports) und Effizienz des Build-Caches (Abhängigkeitsdateien vor dem Quellcode kopiert).
Warum sollten apt-get update und apt-get install im selben RUN stehen?
Docker speichert jede RUN-Anweisung als Layer im Cache. Hat apt-get update ein eigenes RUN, wird dieser Layer bei späteren Builds wiederverwendet, auch wenn du der install-Zeile Pakete hinzufügst. apt-get arbeitet dann mit alten Paketlisten und kann fehlschlagen oder veraltete Versionen installieren. Stehen beide in einem RUN, gefolgt von rm -rf /var/lib/apt/lists/*, werden die Listen aktualisiert und im selben Layer wieder entfernt.
Warum verlangt der Linter eine USER-Anweisung?
Sofern ein Dockerfile kein USER setzt, läuft der Containerprozess als root. Wird die Anwendung kompromittiert, erleichtert root im Container den Ausbruch auf den Host oder Manipulationen an eingehängten Dateien. Lege einen Benutzer ohne Rechte an, installiere zuerst die Pakete und wechsle dann in der finalen Stage mit USER.
Was ist der Unterschied zwischen Shell-Form und Exec-Form?
Die Shell-Form (CMD python app.py) führt den Befehl über /bin/sh -c aus, sodass dein Programm ein Kindprozess der Shell ist und beim Stoppen des Containers kein SIGTERM erhält; Docker wartet 10 Sekunden und beendet es dann hart. Die Exec-Form (CMD ["python", "app.py"]) startet das Programm direkt als PID 1, sodass es sauber herunterfahren kann.
Wie viele Layer sind zu viele?
Docker unterstützt bis zu 127 Layer in einem Image, aber schon lange vorher machen viele Layer Pulls langsamer und Images schwerer zu untersuchen. Nur RUN, COPY und ADD fügen Dateisystem-Layer hinzu. Der Linter schlägt vor, aufeinanderfolgende RUN-Anweisungen zusammenzufassen, und meldet die finale Stage, wenn sie mehr als 15 Layer erzeugt. Multi-Stage-Builds helfen am meisten, weil nur die finale Stage im Image landet.
Ist das dasselbe wie hadolint?
Nein. Das ist ein unabhängiger, browserbasierter Linter mit eigenem Regelsatz (Codes DF101 bis DF313), inspiriert von Dockers offiziellen Best-Practice-Empfehlungen. Er führt kein ShellCheck für RUN-Befehle aus. Für CI-Pipelines ist ein Kommandozeilen-Linter eine gute Ergänzung; dieses Tool ist praktisch für schnelle Reviews und um zu verstehen, warum es jede Regel gibt.
Kann ich eine Regel für eine Zeile ignorieren?
Ja. Setze einen Kommentar wie # lint-ignore: DF201 in die Zeile direkt über der Anweisung, um die Regel dort zu überspringen, oder entferne das Häkchen bei der Regel in der Regelliste, um sie überall abzuschalten. Die Regelliste wird in deinem Browser gespeichert.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.