🐳 Docker Registry Browser

Interface web minimaliste pour parcourir, inspecter et gérer les images d'un Docker Registry V2, écrite en Ruby on Rails.

📊 Métadonnées

Champ	Valeur
Nom	Docker Registry Browser
Slug	`docker-registry-browser`
Catégorie principale	cat-container-registry
Langage	Ruby (29)
Stars	⭐ 688
Dernière MAJ	2026-06-04
Repo	github.com/klausmeyer/docker-registry-browser
Site	hub.docker.com/r/klausmeyer/docker-registry-browser

📝 Description

Docker Registry Browser est une interface web open source pour le Docker Registry HTTP API V2 (Distribution), permettant de lister les images, parcourir les tags, examiner les couches (layers) et supprimer des artefacts depuis un navigateur. L'application est écrite en Ruby on Rails et sert de compagnon léger à un registre auto-hébergé tel que le registry:2 officiel, Harbor ou un miroir maison.

Le projet fournit une image Docker prête à l'emploi (klausmeyer/docker-registry-browser) qui se branche sur n'importe quel registre exposant l'API V2, le tout sans base de données externe. Idéal pour les homelabbers qui veulent un point d'entrée visuel à leur stack d'images OCI.

🐳 Installation Docker

services:
  docker-registry-browser:
    image: klausmeyer/docker-registry-browser
    container_name: docker-registry-browser
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    environment:
      - PUID=1000
      - PGID=1000
      - REGISTRY_URL=http://registry:5000
      - BASIC_AUTH_PASSWORD=changeme
      - NO_DELETE=true

⚠️ Adapte image/port/volumes selon le README officiel : https://github.com/klausmeyer/docker-registry-browser

🔀 Reverse Proxy (Traefik)

services:
  docker-registry-browser:
    image: klausmeyer/docker-registry-browser
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.docker-registry-browser.rule=Host(`registry-ui.example.com`)"
      - "traefik.http.routers.docker-registry-browser.entrypoints=websecure"
      - "traefik.http.routers.docker-registry-browser.tls.certresolver=letsencrypt"
      - "traefik.http.services.docker-registry-browser.loadbalancer.server.port=8080"

🔧 Configuration

Pointer REGISTRY_URL (ou URL) vers l'URL du Docker Registry V2 à administrer
Authentification Basic Auth activable côté UI via BASIC_AUTH_PASSWORD
NO_DELETE=true pour exposer l'UI en lecture seule et empêcher la suppression accidentelle de tags

🔀 Alternatives

Open source :

Harbor (registry + UI complète, gestion RBAC, scan, replication)
Portus (UI Ruby on Rails plus ancienne, interface d'auth centralisée)

Propriétaires :

Docker Hub (SaaS officiel, registry managé)
JFrog Artifactory (registry enterprise multi-format)

🔒 Sécurité

UI à protéger par reverse proxy HTTPS (Traefik/Nginx) avec authentification forte
Si l'API du registre sous-jacent n'est pas elle-même sécurisée, prévoir un réseau privé ou un VPN

📚 Ressources

🔗 Pages Liées

cat-container-registry — Catégorie container-registry
Catalogue-Self-Hosted — Hub principal

3.9 KiB Raw Blame History