koretskyi/registry

Docker Registry v2 镜像文档

概述

Docker Registry v2 是Docker官方提供的镜像仓库服务，用于搭建私有Docker镜像仓库，支持镜像的存储、分发和管理。该镜像提供了安全认证、TLS加密等功能，适用于企业内部或私有环境中的镜像管理需求。

核心功能与特性

• 镜像存储管理：支持Docker镜像的上传、下载和存储
• 认证机制：集成htpasswd认证，控制仓库访问权限
• TLS加密：支持HTTPS协议，保障数据传输安全
• 数据持久化：通过卷挂载实现镜像数据的持久化存储
• 高可用性：支持容器重启策略，确保服务稳定运行

使用场景

• 企业内部私有Docker镜像仓库搭建
• 开发团队内部镜像共享与版本管理
• 离线环境或隔离网络中的Docker镜像存储
• 需要控制镜像访问权限的安全场景

使用方法

1. 准备认证文件

创建认证目录并生成htpasswd文件：

bash
mkdir auth
docker run --entrypoint htpasswd registry:2 -Bbn testuser testpasswd > auth/htpasswd

• testuser：用户名
• testpasswd：用户密码
• -B：使用bcrypt算法加密密码
• -b：非交互式模式
• -n：不输出换行符

2. 准备TLS证书（可选但推荐）

创建证书目录并放置TLS证书文件（domain.crt和domain.key）：

bash
mkdir certs
# 将证书文件复制到certs目录
# 例如：cp /path/to/your/domain.crt certs/
#      cp /path/to/your/domain.key certs/

3. 启动Registry容器

bash
docker run -d \
  -p 5000:5000 \
  --restart=always \
  --name registry \
  -v $(pwd)/auth:/auth \
  -e "REGISTRY_AUTH=htpasswd" \
  -e "REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm" \
  -e REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd \
  -v $(pwd)/certs:/certs \
  -e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/domain.crt \
  -e REGISTRY_HTTP_TLS_KEY=/certs/domain.key \
  -v $(pwd)/data:/var/lib/registry \
  registry:2

参数说明

• -d：后台运行容器
• -p 5000:5000：映射容器5000端口到主机5000端口
• --restart=always：容器退出时自动重启
• --name registry：指定容器名称为registry
• -v $(pwd)/auth:/auth：挂载认证文件目录
• -v $(pwd)/certs:/certs：挂载TLS证书目录
• -v $(pwd)/data:/var/lib/registry：挂载数据目录，实现镜像数据持久化

环境变量配置

验证部署

1. 登录私有仓库：

bash
docker login localhost:5000

2. 推送测试镜像：

bash
docker tag hello-world:latest localhost:5000/hello-world:latest
docker push localhost:5000/hello-world:latest

3. 拉取测试镜像：

bash
docker pull localhost:5000/hello-world:latest