Docker/Registry
Eine eigene Docker Image-Registry
Docker-Image registry als eigener Container betreiben
So behältst du die volle Kontrolle über deine Images, umgehst Rate-Limits und sparst Gebühren für private Repositories.
Lokale Registry
- Lokale Registry schnell starten
Für lokale Tests auf deinem eigenen Rechner reicht ein einziger Befehl im Terminal: [1, 2]
docker run -d -p 5000:5000 --restart always --name private-registry registry:2
• Erreichbarkeit. Die Registry läuft nun im Hintergrund und ist lokal unter localhost:5000 erreichbar.
• Images hochladen. Damit Docker weiß, wohin ein Image geladen werden soll, musst du es mit der Adresse der Registry taggen:
docker tag mein-image:latest localhost:5000/mein-image:latest
docker push localhost:5000/mein-image:latest
Verwende Code mit Vorsicht.
• Images herunterladen. Auf demselben Host kannst du das Image anschließend wieder abrufen: [1, 2]
docker pull localhost:5000/mein-image:latest
Verwende Code mit Vorsicht.
Produktivbetrieb
- Produktivbetrieb auf einem Server (mit HTTPS & Login)
Sobald andere Rechner über das Netzwerk oder Internet auf die Registry zugreifen sollen, erzwingt Docker aus Sicherheitsgründen eine verschlüsselte HTTPS-Verbindung sowie eine Authentifizierung.
• Persistenter Speicher. Binde ein lokales Verzeichnis oder ein Docker-Volume ein, damit deine Images bei einem Neustart oder Update des Registry-Containers nicht verloren gehen. [1]
• Reverse Proxy & SSL. Schalte einen Reverse Proxy wie Nginx, Traefik oder Caddy vor den Port 5000. Dieser übernimmt das SSL-Zertifikat (z. B. über Let's Encrypt) und leitet Anfragen von einer Domain wie registry.deinedomain.de intern weiter. [1]
• Zugangsschutz. Richte eine Basic-Authentifizierung (Benutzername und Passwort via htpasswd) entweder direkt in der Registry-Konfiguration oder über den vorgeschalteten Reverse Proxy ein. Danach melden sich Clients vor dem Push/Pull per docker login registry.deinedomain.de an. [1, 2]
Alternativen
- Alternativen zum puren registry-Container
Die offizielle Docker Registry bietet keine eigene Weboberfläche und keine feingranulare Rechteverwaltung. Wenn du mehr Komfort benötigst, bieten sich folgende Lösungen an:
Lösung Besonderheiten Ideal für
Offizielle Docker Registry Sehr ressourcenschonend, schnell eingerichtet, rein API-basiert (ohne UI). Einzelentwickler, kleine Teams, interne CI/CD-Pipelines.
Harbor Open-Source-Registry mit Web-UI, Rollenverwaltung, Vulnerability-Scanning und Image-Replikation. Unternehmen und größere Teams mit hohen Sicherheitsanforderungen.
GitLab / Gitea / Forgejo Integrierte Container-Registry direkt in der jeweiligen Git-Plattform. Teams, die ohnehin eine dieser Plattformen selbst hosten.
JFrog Artifactory / Nexus Universelle Repository-Manager für Docker-Images sowie weitere Paketformate (npm, Maven, PyPI). Komplexe Entwicklungsumgebungen mit verschiedenen Artefakt-Typen.
Eine ausführliche Schritt-für-Schritt-Anleitung für den Einstieg findest du im offiziellen Docker Blog sowie bei Sliplane. [1, 2]