chickenbellyfin/registry-ui

Docker Registry UI

Github: https://github.com/chickenbellyfin/registry-ui

概述

Docker Registry UI是一个轻量级的Docker镜像仓库Web界面工具，用于可视化管理Docker Registry中的镜像。该工具基于Python、sanic框架和water.css样式库构建，提供简洁的用户界面和基本的镜像管理功能。

核心功能

• 极简的Web界面设计
• 支持基本认证和登录功能
• 多架构镜像支持

使用场景

• 需要可视化管理Docker Registry镜像的环境
• 对镜像仓库有基本访问控制需求的场景
• 需要查看和管理多架构镜像的用户
• 个人或小型团队的Docker镜像管理需求

使用方法

Docker Run

bash
docker run -p 8000:8000 chickenbellyfin/registry-ui <http://registry.url>

Docker Compose

yaml
services:
  registryui:
    image: chickenbellyfin/registry-ui
    container_name: registryui
    ports:
      - 8000:8000
    environment:
      - REGISTRY_URL=http://registry.url
    restart: unless-stopped

配置说明

CLI参数

CLI参数优先级高于环境变量。

usage: main.py [-h] [-r REGISTRY] [-l] [-u USERNAME] [-p PASSWORD]

可选参数:
  -h, --help            显示帮助信息并退出
  -r REGISTRY, --registry REGISTRY
                        镜像仓库URL（需包含http://或https://）
  -l, --login           为需要基本认证的仓库显示登录页面
  -u USERNAME, --username USERNAME
                        镜像仓库基本认证用户名
  -p PASSWORD, --password PASSWORD
                        镜像仓库基本认证密码

环境变量

授权说明

• 授权机制通过在HTTP头中以Basic Auth方式转发用户名和密码实现，无论凭据是在服务器设置中配置还是来自用户的登录Cookie。
• 如果通过-u/-p或REGISTRY_USERNAME/REGISTRY_PASSWORD设置了仓库用户名和密码，应用将始终尝试使用这些凭据，即使用户未登录。如果设置了--login或APP_ENABLE_LOGIN，建议不要设置仓库用户名和密码，这将强制每个用户在访问前通过登录页面输入凭据。
• 任何需要基本认证的仓库必须启用HTTPS。
• 如果仓库暴露在公网，建议启用授权机制。

本应用提供多种授权选项，但不保证安全性，也不强制用户遵循安全实践。

部署示例：结合HTTPS和基本认证与Registry一同部署

可以使用Web服务器/反向代理（如caddy）在同一URL下托管Web应用和镜像仓库。

此配置允许在https://my.registry.url托管镜像仓库（支持镜像推送/拉取到my.registry.url/<image>:<tag>），并在浏览器中通过该URL显示带登录页面的Web界面。Docker客户端和Web访问的凭据将与仓库的htpasswd配置相同。

docker-compose.yaml

yaml
services:
  caddy:
    image: caddy
    container_name: caddy
    restart: unless-stopped
    ports:
      - 80:80
      - 443:443
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - certs-volume:/data

  registry:
    image: registry:2
    container_name: registry
    restart: unless-stopped
    volumes:
      - 'registry-volume:/var/lib/registry'
      - './htpasswd:/auth'
    environment:
    # 如何配置仓库基本认证
    # https://docs.docker.com/registry/deploying/#native-basic-auth
      - REGISTRY_AUTH=htpasswd
      - REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm
      - REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd

  registry-ui:
    image: chickenbellyfin/registry-ui
    container_name: registry-ui
    restart: unless-stopped
    environment:
      - REGISTRY_URL=https://my.registry.url
      - APP_ENABLE_LOGIN=true

volumes:
  certs-volume:
  registry-volume:

Caddyfile

my.registry.url {
  handle /v2* {
    reverse_proxy registry:5000
  }
  reverse_proxy registry-ui:8000
}