Startseite › Entwickler-Tools › Dockerfile-Linter

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.

–
Füge ein Dockerfile ein
    Anzeige
    Anzeige

    Anleitung: Dockerfile-Linter

    1. Füge dein Dockerfile in den Editor ein, lade es hoch oder lade eines der Beispiele.
    2. Lies die Punktzahl und die Anzahl der Fehler, Warnungen und Vorschläge; die Stage-Karten zeigen, wie viele Layer jede Stage erzeugt.
    3. Ö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.
    4. Beheben und erneut prüfen: Das Dockerfile wird beim Tippen erneut geprüft.
    5. 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.

    CodeRegelTypische Lösung
    DF101FROM muss die erste Anweisung seinNur ARG darf vor FROM stehen
    DF102Unbekannte AnweisungBehebe den Tippfehler oder ergänze das fehlende \ in der Zeile darüber
    DF103Ungültiges JSON in Exec-FormCMD ["npm", "start"] mit doppelten Anführungszeichen
    DF104 / DF105Doppelter Stage-Name / unbekanntes COPY --fromEindeutiges AS name; nur auf frühere Stages verweisen
    DF106Mehrere Quellen brauchen ein Verzeichnis als ZielCOPY a.txt b.txt ./
    DF107 / DF108Ungültiger EXPOSE-Port / relatives WORKDIREXPOSE 8080 und WORKDIR /app
    DF201 / DF202Base-Image ohne festen Tag oder mit :latestFROM python:3.12-slim
    DF203Container läuft als rootUSER app in der finalen Stage
    DF204 – DF208apt-get: update mit install, Cache-Bereinigung, -y, apt vs. apt-get, kein upgradeapt-get update && apt-get install -y --no-install-recommends … && rm -rf /var/lib/apt/lists/*
    DF209 / DF210Caches von apk und yum/dnfapk add --no-cache bzw. dnf clean all
    DF211 / DF216sudo und chmod 777USER-Wechsel, COPY --chown
    DF212 / DF313ADD für lokale Dateien, ungeprüfte URLsCOPY bzw. ADD --checksum=sha256:…
    DF213Mehr als ein CMD oder ENTRYPOINTNur das letzte behalten
    DF214MAINTAINER ist veraltetLABEL org.opencontainers.image.authors=…
    DF215Geheimnis in ENV oder ARGLaufzeitvariablen oder RUN --mount=type=secret
    DF217Leerzeile in einer FortsetzungEntferne die Leerzeile
    DF301 – DF313Vorschlä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-AnzahlSiehe 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:

    1. Base-Image mit festem Tag, Systempakete in einem RUN installiert und bereinigt.
    2. Nur Abhängigkeitsdateien: package.json und package-lock.json, requirements.txt, go.mod und go.sum.
    3. Installation der Abhängigkeiten: npm ci, pip install --no-cache-dir -r requirements.txt, go mod download.
    4. Quellcode: COPY . ., mit einer .dockerignore, die .git, node_modules und Build-Ausgaben ausschließt.
    5. Build-Schritt, idealerweise in einer eigenen Stage; kopiere dann nur das Ergebnis in ein kleines Laufzeit-Image.
    6. Laufzeiteinstellungen: USER, EXPOSE, HEALTHCHECK und ein CMD oder ENTRYPOINT in 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.

    Ähnliche Tools

    Alle Code-Generatoren & Builder ansehen →