buluma/docker-registry-ui

Docker Registry UI

概述

Docker Registry UI是一款轻量级的Docker Registry Web管理工具，基于Go语言开发，支持多种镜像格式（Manifest v2 schema 1/2、Manifest List等），可自动适配认证方式，缓存仓库列表并后台刷新，还提供事件监听与标签生命周期管理功能。UI本身不实现TLS或认证，建议通过nginx等代理服务增强安全。

核心功能

• 浏览命名空间、仓库及标签信息
• 展示镜像层详情与多架构/缓存类型子镜像
• 自动发现基础认证、令牌服务等认证方式
• 后台缓存仓库列表与标签计数并定时刷新
• 监听Registry通知事件，支持sqlite/MySQL存储事件数据
• 通过命令行或内置cron任务清理旧标签（保留指定天数或数量）

使用场景

• Docker Registry的可视化管理，快速查看镜像结构与元数据
• 镜像标签生命周期管理，自动清理过期或冗余标签
• 监控Registry事件，追踪镜像推送、删除等操作记录

配置说明

基础运行

bash
docker run -d -p 8000:8000 -v /本地路径/config.yml:/opt/config.yml:ro \
    --name=registry-ui docker.xuanyuan.run/buluma/docker-registry-ui

附加配置

• 挂载自定义根CA证书：

  bash
  -v /本地路径/rootcacerts.crt:/etc/ssl/certs/ca-certificates.crt:ro
  

• 持久化事件数据（sqlite）：

  bash
  -v /本地路径/data:/opt/data  # 确保/data目录属主为nobody（UID 65534）
  

• 设置时区：

  bash
  -e TZ=Asia/Shanghai
  

Registry事件监听配置

在Registry配置文件中添加通知端点：

yaml
notifications:
  endpoints:
    - name: docker-registry-ui
      url: http://registry-ui地址:8000/api/events
      headers:
        Authorization: [Bearer 你的令牌]
      timeout: 1s
      threshold:5
      backoff:10s
      ignoredmediatypes:
        - application/octet-stream

使用MySQL存储事件

修改config.yml中的event_database_driver为mysql，event_database_location为MySQL DSN（如user:pass@tcp(localhost:3306)/dbname）。需提前创建数据库，并可手动创建事件表：

sql
CREATE TABLE events (
    id INTEGER PRIMARY KEY AUTO_INCREMENT,
    action CHAR(4) NULL,
    repository VARCHAR(100) NULL,
    tag VARCHAR(100) NULL,
    ip VARCHAR(15) NULL,
    user VARCHAR(50) NULL,
    created DATETIME NULL
);

标签清理任务

1. 先在Registry配置中启用删除功能：

   yaml
   storage:
     delete:
       enabled: true
   

2. 方式一：通过系统cron执行容器命令：

   bash
   10 3 * * * root docker exec -t registry-ui /opt/docker-registry-ui -purge-tags  # 每天3:10执行
   # 测试模式（不实际删除）：
   docker exec -t registry-ui /opt/docker-registry-ui -purge-tags -dry-run
   

3. 方式二：通过config.yml内置cron：

   yaml
   purge_tags_keep_days:90
   purge_tags_keep_count:2
   purge_tags_schedule:'0 10 3 * * *'  # 格式含秒数，参考robfig/cron文档
   

调试模式

设置环境变量开启HTTP请求详细日志：

bash
-e GOREQUEST_DEBUG=1