中间件 - Wizard Doc

最后修改人	孙荣利
最后修改时间	2026-09-19 18:09:42
创建人	孙荣利
创建时间	2026-09-19 18:09:42

该文档由孙荣利创建于 2026-09-19 18:09:42 ，孙荣利在 2026-09-19 18:09:42 修改了该文档。

[TOCM]

一、简介

```text
Registry 是存放和分发容器镜像的服务器，而 Registry-UI 则是为 Registry 提供图形化管理界面的工具。它们之间的关系，可以类比为“仓库”和“仓库的管理后台”。

为什么选型Registry而非Harbor、Nexus？
因为Registry占资源小，仅占几十M内存，而Harbor、Nexus得1.5G-2G内存
```

二、安装部署

#### 1. 目录结构

```shell
registry
└── docker-compose.yml
```

#### 2. 目录准备

```shell
mkdir -p /data/registry
cd /data/registry
touch docker-compose.yml
```

#### 3. docker-compose.yml

```yaml
version: '3'  # Compose 文件版本声明（新版已标记过时，仅告警不影响运行，可留可删）
services:  # 服务定义
  registry:  # Docker Registry 镜像仓库服务
    container_name: registry  # 容器名称
    image: repo.358369.xyz/registry:2.8.3  # 私有仓库镜像（registry 2.8.3）
    environment:  # 环境变量
      TZ: Asia/Shanghai  # 时区设为上海
      REGISTRY_STORAGE_DELETE_ENABLED: true  # 启用镜像删除功能（默认 registry 禁止删除）
    ports:  # 端口映射
     - "5000:5000"  # 宿主机 5000 → 容器 5000（registry API 端口）
    volumes:  # 数据卷
     - registry_data:/var/lib/registry  # 命名卷：镜像数据持久化
    restart: always  # 容器异常退出/主机重启后自动拉起
  registry-ui:  # Registry Web 管理界面服务
    container_name: registry-ui  # 容器名称
    image: repo.358369.xyz/docker-registry-ui:2.5.7-debian  # 私有仓库镜像
    restart: always  # 容器异常退出/主机重启后自动拉起
    ports:  # 端口映射
      - 5001:80  # 宿主机 5001 → 容器 80（Web 管理界面）
    environment:  # 环境变量
      - SINGLE_REGISTRY=true  # 单仓库模式（只管理一个 registry）
      - REGISTRY_TITLE=Docker Registry UI  # Web 界面标题
      - DELETE_IMAGES=true  # 允许在界面删除镜像
      - SHOW_CONTENT_DIGEST=true  # 显示镜像摘要（digest）
      - NGINX_PROXY_PASS_URL=http://registry:5000  # 反向代理指向 registry 服务（容器内网互通）
      - SHOW_CATALOG_NB_TAGS=true  # 显示仓库标签数量
      - CATALOG_MIN_BRANCHES=1  # 标签数少于该值不计入展示
      - CATALOG_MAX_BRANCHES=1  # 标签数多于该值不展示
      - TAGLIST_PAGE_SIZE=100  # 标签列表每页条数
      - REGISTRY_SECURED=false  # registry 未启用认证
      - CATALOG_ELEMENTS_LIMIT=1000  # 仓库列表最大展示数量
volumes:  # 命名卷声明
  registry_data:  # 镜像数据卷
```

#### 4. docker compose up -d

```shell
docker compose up -d
```

> **备注**
> 1. 端口说明：`5000` 为 registry API 端口，`5001` 为 Web 管理界面（registry-ui）端口。
> 2. 镜像数据通过命名卷 `registry_data` 持久化，实际存储于宿主机 `/var/lib/docker/volumes/registry_data`。
> 4. `version: '3'` 字段在最新版 Docker Compose 中已标记为过时（启动时会告警，但不影响运行），可保留也可移除。