byrdal/registry-ui

Registry UI

一个现代、轻量级的Web界面，用于浏览和管理Docker容器镜像仓库。基于Nuxt 4（Vue 3 + TypeScript）构建，设计用于与任何兼容Docker Registry HTTP API v2的仓库无缝协作。

核心功能和特性

• 浏览仓库和镜像 — 查看所有容器镜像，包括标签、大小和时间戳
• 智能标签分组 — 具有相同摘要的镜像会被分组，一目了然地显示所有标签
• 存储分析 — 实时存储使用量计算，支持重复数据删除
• 镜像删除 — 直接从UI删除镜像（需仓库配置支持）
• 搜索功能 — 按名称快速筛选仓库
• 复制拉取命令 — 一键复制带有正确仓库URL的docker pull命令
• 自动同步 — 后台同步保持UI与仓库数据最新
• 多平台支持 — 同时支持单平台镜像和多架构清单列表

使用场景和适用范围

• 个人开发者管理本地Docker镜像仓库
• 团队内部私有镜像仓库的可视化管理
• 需要监控镜像存储使用情况的环境
• 希望简化镜像拉取和删除操作的场景
• 兼容任何标准Docker Registry v2仓库（包括官方 registry 镜像、Harbor等）

使用方法和配置说明

使用Docker快速开始

使用Registry UI最简单的方式是通过Docker Hub上的预构建镜像。

使用Docker Compose（推荐）

创建docker-compose.yml文件：

yaml
services:
  registry:
    image: registry:3.0.0
    environment:
      REGISTRY_STORAGE_DELETE_ENABLED: "true"  # 启用镜像删除功能
    ports:
      - "5000:5000"
    volumes:
      - ./registry-data:/var/lib/registry

  registry-ui:
    image: byrdal/registry-ui:latest
    environment:
      REGISTRY_URL: http://registry:5000           # 内部API URL
      REGISTRY_PUBLIC_URL: localhost:5000          # UI中显示的公共拉取URL
      REGISTRY_TITLE: "我的容器镜像仓库"           # 可选：自定义标题
    ports:
      - "3000:3000"
    volumes:
      - ./registry-ui-data:/data

启动服务：

bash
docker-compose up -d

通过http://localhost:3000访问UI界面

使用Docker Run

如果已有运行中的Docker仓库：

bash
docker run -d \
  -p 3000:3000 \
  -e REGISTRY_URL=http://your-registry:5000 \
  -e REGISTRY_PUBLIC_URL=registry.example.com:5000 \
  -e REGISTRY_TITLE="我的镜像仓库" \
  -v ./data:/data \
  byrdal/registry-ui:latest

配置参数

通过环境变量配置Registry UI：

重要：仓库URL说明

• REGISTRY_URL：后端用于与Docker仓库API通信的URL（例如Docker网络中的http://registry:5000）
• REGISTRY_PUBLIC_URL：用户在docker pull命令中应使用的URL（例如registry.example.com、localhost:5000）

搭建自己的镜像仓库

选项1：基础仓库

bash
docker run -d \
  -p 5000:5000 \
  --name registry \
  -v ./registry-data:/var/lib/registry \
  registry:3.0.0

选项2：启用删除功能的仓库

要通过UI启用镜像删除功能：

bash
docker run -d \
  -p 5000:5000 \
  --name registry \
  -e REGISTRY_STORAGE_DELETE_ENABLED=true \
  -v ./registry-data:/var/lib/registry \
  registry:3.0.0

选项3：带认证的仓库

生产环境中使用基本认证：

bash
# 创建htpasswd文件
docker run --rm --entrypoint htpasswd registry:3.0.0 -Bbn username password > htpasswd

# 运行带认证的仓库
docker run -d \
  -p 5000:5000 \
  --name registry \
  -e REGISTRY_AUTH=htpasswd \
  -e REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd \
  -e REGISTRY_AUTH_HTPASSWD_REALM="Registry Realm" \
  -e REGISTRY_STORAGE_DELETE_ENABLED=true \
  -v ./htpasswd:/auth/htpasswd \
  -v ./registry-data:/var/lib/registry \
  registry:3.0.0

然后配置Registry UI的凭据：

bash
docker run -d \
  -p 3000:3000 \
  -e REGISTRY_URL=http://registry:5000 \
  -e REGISTRY_PUBLIC_URL=localhost:5000 \
  -e REGISTRY_USERNAME=username \
  -e REGISTRY_PASSWORD=password \
  -v ./data:/data \
  byrdal/registry-ui:latest

UI使用指南

浏览镜像

仪表板显示所有仓库，包括：

• 仓库名称和初始图标
• 可用标签（最多显示10个，带有溢出指示器）
• 一键复制拉取命令
• 最后更新时间戳
• 每个仓库的存储大小
• 所有镜像的总存储使用量

查看镜像详情

点击任何仓库名称可查看：

• 按摘要分组的所有镜像
• 每个镜像的多个标签（当标签指向相同内容时）
• 平台信息（架构和操作系统）
• 创建和最后查看时间戳
• 摘要和媒体类型
• 删除按钮（当删除功能启用时）

删除镜像

1. 使用REGISTRY_STORAGE_DELETE_ENABLED=true在Docker仓库中启用删除功能
2. 导航到仓库详情页面
3. 点击任何镜像的删除按钮
4. 确认删除
5. 仓库将自动刷新

注意：删除操作会移除清单。要回收磁盘空间，还必须在仓库上运行垃圾回收：

bash
docker exec registry bin/registry garbage-collect /etc/docker/registry/config.yml

技术栈

• 前端：Nuxt 4、Vue 3（组合式API）、Tailwind CSS 4
• 后端：Nitro（Nuxt服务器）、better-sqlite3
• 容器：Node.js 20 Alpine、Supercronic（用于调度）
• CI/CD：GitHub Actions（多平台构建：amd64、arm64）

工作原理

1. 后台同步：定时任务（或手动脚本）定期从Docker Registry API v2获取元数据并存储在本地SQLite数据库中
2. API层：Nuxt服务器API路由查询数据库并提供REST端点
3. 前端：Vue 3页面使用useFetch()消费API端点并显示数据
4. 删除功能：删除镜像时，UI调用仓库的删除API，然后触发刷新以更新数据库

UI从不直接修改仓库数据——仅读取数据并在请求时发送删除命令。

许可证

MIT

贡献

欢迎贡献！请随时提交Pull Request。