quiq/registry-ui

Registry UI

概述

Registry UI是一个轻量级Web用户界面，专为Docker Registry或兼容的容器镜像仓库设计，提供直观的可视化管理能力。该工具简化了镜像仓库的日常操作，允许用户通过浏览器浏览仓库结构、查看镜像标签详情、执行基本管理任务，无需依赖命令行工具。

核心功能和特性

• 仓库浏览：以层级结构展示Registry中的所有镜像仓库
• 标签管理：查看每个仓库的镜像标签列表及元数据信息
• 镜像操作：支持删除镜像标签（需Registry配置支持删除功能）
• 搜索功能：快速检索仓库和镜像标签
• 响应式界面：适配桌面和移动设备的现代UI设计
• 轻量部署：通过Docker容器化部署，配置简单，启动迅速

使用场景和适用范围

• 开发团队：可视化管理内部Docker Registry，简化镜像版本控制流程
• 运维人员：监控Registry存储占用，清理过期镜像，优化存储空间
• 个人开发者：本地测试环境中快速查看和管理Docker镜像
• 教学场景：直观展示Docker Registry的组织结构和镜像管理概念

使用方法和配置说明

基础部署（Docker Run）

通过以下命令快速启动Registry UI容器：

bash
docker run -d \
  -p 8080:8080 \
  -e REGISTRY_URL=http://your-registry-ip:5000 \
  --name registry-ui \
  quiq/registry-ui

访问 http://localhost:8080 即可打开Web界面。

环境变量配置

Docker Compose示例

以下是与Docker Registry联动的docker-compose配置：

yaml
version: '3'
services:
  registry:
    image: registry:2
    ports:
      - "5000:5000"
    volumes:
      - registry-data:/var/lib/registry
    environment:
      - REGISTRY_STORAGE_DELETE_ENABLED=true  # 启用删除功能
      
  registry-ui:
    image: quiq/registry-ui
    ports:
      - "8080:8080"
    environment:
      - REGISTRY_URL=http://registry:5000
      - DELETE_ENABLED=true
    depends_on:
      - registry

volumes:
  registry-data:

高级配置（带认证的Registry）

若Registry启用了HTTP Basic认证，需添加认证环境变量：

bash
docker run -d \
  -p 8080:8080 \
  -e REGISTRY_URL=https://secure-registry.example.com \
  -e REGISTRY_USER=admin \
  -e REGISTRY_PASSWORD=SecurePass123! \
  --name secure-registry-ui \
  quiq/registry-ui

注意事项

• CORS配置：若Registry与UI不在同一域名下，需在Registry中配置CORS策略，允许UI域名的跨域请求
• 删除权限：启用删除功能前需确保Registry已设置REGISTRY_STORAGE_DELETE_ENABLED=true
• HTTPS支持：生产环境建议通过反向代理（如Nginx）为UI配置HTTPS加密
• 版本兼容性：建议使用Docker Registry v2及以上版本以获得完整功能支持

参考链接

• 官方GitHub仓库：https://github.com/Quiq/registry-ui