Dockerfile-Generator
Wähle deinen Stack und deine Optionen und erhalte ein produktionsreifes Dockerfile nach aktuellen Best Practices: Multi-Stage-Builds, gecachte Abhängigkeits-Layer, ein Non-Root-User und ein optionaler Healthcheck. Eine passende .dockerignore sowie die Build- und Run-Befehle werden ebenfalls erzeugt.
Zuletzt aktualisiert:
Erzeugte Dateien
Anleitung: Dockerfile-Generator
- Wähle einen Stack: Node.js, Python, Go oder eine statische Website, die von nginx ausgeliefert wird.
- Wähle die Version und die Variante des Basis-Images (alpine, slim, distroless) sowie deinen Paketmanager oder deine Abhängigkeitsdatei.
- Lege die App-Details fest: Arbeitsverzeichnis, Port, Startbefehl, Umgebungsvariablen und einen optionalen Healthcheck-Pfad.
- Aktiviere Best Practices wie Multi-Stage-Build, Non-Root-User und BuildKit-Cache-Mounts.
- Kopiere oder lade das Dockerfile und die .dockerignore in dein Projektstammverzeichnis und führe dann den angezeigten docker-build-Befehl aus.
Referenz der Dockerfile-Anweisungen
| Anweisung | Was sie tut | Tipp |
|---|---|---|
FROM image AS name | Startet eine Build-Stage von einem Basis-Image. | Lege ein Versions-Tag fest (node:24-alpine), verlass dich nie auf latest. |
WORKDIR /app | Setzt (und erstellt) das Arbeitsverzeichnis für die folgenden Schritte. | Verwende es statt RUN cd …. |
COPY src dest | Kopiert Dateien aus dem Build-Kontext oder mit --from=stage aus einer anderen Stage. | Füge --chown=user:group hinzu, damit ein Non-Root-User schreiben kann. |
RUN command | Führt einen Befehl aus und speichert das Ergebnis als neuen Layer. | Verbinde zusammengehörige Befehle mit &&, um Layer klein zu halten. |
ENV KEY=value | Setzt Umgebungsvariablen für die folgenden Schritte und den laufenden Container. | Baue niemals Secrets ein; sie bleiben in der Image-Historie. |
EXPOSE 3000 | Dokumentiert den Port, auf dem die App lauscht. | Zum Veröffentlichen brauchst du trotzdem -p host:container. |
USER name | Führt die folgenden Schritte und den Container als dieser User aus. | Setze es nach Schritten, die Root brauchen (Paketinstallationen). |
HEALTHCHECK CMD … | Lässt Docker den Container als healthy oder unhealthy markieren. | Der Befehl muss im Image vorhanden sein (kein curl in slim-Images). |
CMD ["exe","arg"] | Standardbefehl, wird durch docker run-Argumente ersetzt. | Verwende die JSON-Exec-Form, damit Signale deine App erreichen. |
ENTRYPOINT ["exe"] | Festes Programm; CMD- und Run-Argumente werden angehängt. | Gut für Single-Binary-Images wie Go-Apps. |
Typische Image-Größen nach Basis
Ungefähre komprimierte Größen der Basis-Images auf Docker Hub (deine App und Abhängigkeiten kommen hinzu). Entscheidend ist die Größenordnung: Die Wahl der Laufzeit-Basis zählt mehr als fast jede andere Optimierung.
| Basis-Image | Ungefähre Größe | Geeignet für |
|---|---|---|
gcr.io/distroless/static-debian12 | ~2 MB | Statische Go- oder Rust-Binaries |
alpine:3.22 | ~4 MB | Winzige Images, die trotzdem eine Shell brauchen |
nginx:1.28-alpine | ~20 MB | Statische Websites und SPAs |
node:24-alpine | ~55 MB | Node-Apps ohne knifflige native Module |
python:3.13-slim | ~45 MB | Die meisten Python-Web-Apps |
node:24-slim | ~75 MB | Node-Apps, die glibc brauchen |
golang:1.26 / node:24 (vollständig) | 300 MB+ | Nur Build-Stages, nicht das finale Image |
Checkliste für ein produktionsreifes Image
- Ordne Layer von selten nach häufig geändert: Basis-Image, Systempakete, Abhängigkeits-Manifeste, Installation der Abhängigkeiten, dann Quellcode.
- Verwende eine Lock-Datei und einen sauberen Installationsbefehl (
npm ci,pnpm install --frozen-lockfile, fixierterequirements.txt), damit Builds reproduzierbar sind. - Halte Secrets mit
.dockerignoreaus dem Build-Kontext heraus und übergib sie zur Laufzeit oder mitRUN --mount=type=secret. - Als Non-Root ausführen und diesem User nur das überlassen, was er schreiben muss.
- SIGTERM behandeln: Starte deinen Prozess direkt in der Exec-Form oder füge
--initzudocker runhinzu, wenn deine App Kindprozesse startet. - Regelmäßig scannen und neu bauen (zum Beispiel mit
docker scout cves), um Sicherheitspatches im Basis-Image zu übernehmen.
Häufige Fragen
Was ist ein Multi-Stage-Docker-Build?
Ein Dockerfile mit mehreren FROM-Anweisungen. Frühe Stages installieren Compiler und Entwicklungsabhängigkeiten und bauen die App; die letzte Stage startet von einem kleinen Basis-Image und kopiert nur das fertige Ergebnis hinein. Das Ergebnis ist ein kleineres, sichereres Image ohne Build-Tools.
Warum sollte der Container als Non-Root-User laufen?
Wenn ein Angreifer in die App eindringt, hat ein Prozess ohne Root-Rechte im Container und auf dem Host deutlich weniger Rechte. Das offizielle node-Image enthält einen node-User, distroless-Images bieten ein nonroot-Tag, und für andere Images legt der Generator einen eigenen User an.
Warum package.json vor dem restlichen Code kopieren?
Docker cacht jeden Layer. Wenn zuerst nur die Abhängigkeits-Manifeste und die Lock-Datei kopiert werden, wird der langsame Installationsschritt aus dem Cache wiederverwendet, bis sich deine Abhängigkeiten ändern. Reine Codeänderungen sind so in Sekunden neu gebaut.
Alpine, slim oder distroless: Welche Basis sollte ich nehmen?
Alpine ist am kleinsten, nutzt aber musl libc, was manche nativen Module und Python-Wheels kaputt machen kann. Debian slim ist ein sicherer, kompatibler Standard. Distroless-Images enthalten nur deine App und ihre Laufzeit, ohne Shell oder Paketmanager – ideal für statische Go-Binaries.
Was macht die .dockerignore?
Sie listet Dateien auf, die Docker nicht an den Build-Kontext senden soll, etwa node_modules, .git, lokale .env-Dateien und Build-Ausgaben. Das macht Builds schneller, verhindert, dass Secrets in Images landen, und verhindert, dass auf dem Host gebaute Abhängigkeiten die im Container installierten überschreiben.
Veröffentlicht EXPOSE den Port?
Nein. EXPOSE dokumentiert nur, auf welchem Port die App lauscht. Veröffentlichen musst du ihn weiterhin zur Laufzeit mit docker run -p 8080:3000 oder im ports-Abschnitt von docker-compose.
Was ist der Unterschied zwischen CMD und ENTRYPOINT?
CMD legt den Standardbefehl fest, der durch Argumente von docker run ersetzt wird. ENTRYPOINT legt das Programm fest, das immer läuft; CMD oder Run-Argumente werden daran angehängt. Verwende die JSON-Exec-Form, damit Signale wie SIGTERM deinen Prozess erreichen.
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.