jc21/registry-ui

Docker Registry UI

!Version !Stars !Pulls

!Docker Registry UI

是否需要一个可视化网站来展示Docker Registry的内容？这款工具能帮助你以美观的方式列出镜像、标签及相关信息。该项目提供https://hub.docker.com/r/jc21/registry-ui/%EF%BC%8C%E5%8F%AF%E8%BF%9E%E6%8E%A5%E5%88%B0%E7%8E%B0%E6%9C%89Registry%E3%80%82

注意：本项目仅支持Docker Registry v2。

镜像概述和主要用途

Docker Registry UI是一个Web界面工具，旨在提供Docker Registry的可视化管理能力。通过该界面，用户可以直观地查看Registry中的镜像列表、标签信息，并进行基本的镜像管理操作，尤其适合需要图形化方式监控和管理Docker镜像的场景。

核心功能和特性

• 直观展示Registry中的镜像列表及标签信息
• 提供镜像拉取/推送命令示例
• 支持镜像删除功能（需额外配置）
• 轻量级预构建Docker镜像，部署简单
• 可与现有Docker Registry集成

使用场景和适用范围

• 个人或团队内部Docker镜像管理
• 需要图形化界面监控Registry内容的场景
• 配合Docker Registry v2使用的环境
• 希望简化镜像查看和基本操作的用户

快速开始

使用Rancher？

通过添加https://github.com/jc21/rancher-templates%EF%BC%8C%E5%8F%AF%E8%BD%BB%E6%9D%BE%E5%90%AF%E5%8A%A8%E5%8C%85%E5%90%ABRegistry%E7%9A%84%E6%A0%88%E3%80%82

创建包含UI的完整Docker Registry栈

这是最简单的部署方式。参考示例https://github.com/jc21/docker-registry-ui/blob/master/doc/full-stack/docker-compose.yml%E6%96%87%E4%BB%B6%EF%BC%8C%E5%B0%86%E5%85%B6%E6%94%BE%E7%BD%AE%E5%9C%A8Docker%E4%B8%BB%E6%9C%BA%E4%B8%8A%E5%B9%B6%E8%BF%90%E8%A1%8C%EF%BC%9A

bash
docker-compose up -d

然后通过 [***] 访问服务。

连接到现有Docker Registry

以下是适用于已有Registry的docker-compose.yml配置：

bash
version: "2"
services:
  app:
    image: jc21/registry-ui
    ports:
      - 80:80
    environment:
      - REGISTRY_HOST=your-registry-server.com:5000  # 替换为实际Registry地址
      - REGISTRY_SSL=true                            # 是否启用HTTPS
      - REGISTRY_DOMAIN=your-registry-server.com:5000 # UI中显示的Registry域名
      - REGISTRY_STORAGE_DELETE_ENABLED=             # 启用删除功能需设为true
    restart: on-failure

若需让Registry和UI在同一域名和端口共存，可参考https://github.com/jc21/docker-registry-ui-proxy/blob/master/conf.d/proxy.conf%EF%BC%8C%E5%85%B6%E4%B8%AD%E5%8C%85%E5%90%AB%E7%A1%AE%E4%BF%9D%E6%8E%A8%E9%80%81%E5%8A%9F%E8%83%BD%E6%AD%A3%E5%B8%B8%E7%9A%84%E5%BF%85%E8%A6%81%E8%B0%83%E6%95%B4%E3%80%82

环境变量

• REGISTRY_HOST - 必填：用于API调用的Registry主机名和可选端口
• REGISTRY_SSL - 可选：若通过HTTPS访问Registry，设为true
• REGISTRY_DOMAIN - 可选：UI中显示的Registry域名，用于拉取/推送命令示例
• REGISTRY_STORAGE_DELETE_ENABLED - 可选：设为true或1启用删除功能（需先完成Registry配置）

删除支持

Registry的删除功能默认未启用，需完成以下步骤才能使用：

在Registry中启用删除

启动Registry容器时添加环境变量：

bash
docker run -d -p 5000:5000 -e REGISTRY_STORAGE_DELETE_ENABLED=true --name my-registry registry:2

在UI中启用删除

与Registry配置类似，向registry-ui容器添加环境变量**REGISTRY_STORAGE_DELETE_ENABLED=true**（仅true为有效值）。

清理Registry

删除镜像不会自动移除blob层，需在Registry主机上执行垃圾回收：

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

若需每30分钟自动执行，可添加定时任务：

0,30 * * * * /bin/docker exec -it my-registry bin/registry garbage-collect /etc/docker/registry/config.yml >> /dev/null 2>&1

截图

![仪表盘]([] ![镜像详情]([] ![拉取示例]([] ![推送示例]([]

待办事项

• 为仓库添加分页功能（当前仅获取300个镜像）
• 添加对Registry认证机制的支持