mittwald/registry

带HTTP认证的Docker Registry

概述

本项目提供一个即用型Docker镜像，基于官方Docker Registry（v3版本）扩展，添加了HTTP基本认证功能。它通过环境变量自动配置基于htpasswd的认证，便于部署安全的私有Docker Registry。

核心功能和特性

• 基于官方Docker Registry v3构建
• 自动配置htpasswd认证
• 通过环境变量实现简单设置
• 最小依赖（仅添加apache2-utils用于htpasswd功能）

使用场景和适用范围

适用于需要快速部署带有基本身份验证的私有Docker Registry的场景，特别适合个人开发者、小型团队或需要简单安全控制的私有镜像仓库环境。

使用方法和配置说明

本地运行Registry

shellsession
user@local $ docker run -d \
  -p 5000:5000 \
  -e REGISTRY_USER=myuser \
  -e REGISTRY_PASSWORD=mypassword \
  --name registry \
  mittwald/registry:3

在mittwald云上运行Registry

shellsession
user@local $ mw container run \
  -p 5000:5000 \
  -e REGISTRY_USER=myuser \
  -e REGISTRY_PASSWORD=mypassword \
  --name registry \
  mittwald/registry:3

必填环境变量

• REGISTRY_USER: 用于Registry认证的用户名
• REGISTRY_PASSWORD: 用于Registry认证的密码

可选环境变量

• REGISTRY_AUTH_HTPASSWD_REALM: 认证领域名称（默认值："Registry Realm"）

同时支持所有标准Docker Registry环境变量，更多选项请参见https://docs.docker.com/registry/configuration/%E3%80%82

推送和拉取镜像

当Registry配置了认证后，在推送或拉取镜像前需要先登录。以下示例假设Registry运行在mittwald云上，且已将Registry容器连接到默认p-XXXXXX.project.space子域的某个子域名。

bash
# 登录到Registry
docker login registry.p-XXXXXX.project.space

# 标记镜像
docker tag myimage:latest registry.p-XXXXXX.project.space/myimage:latest

# 推送镜像
docker push registry.p-XXXXXX.project.space/myimage:latest

# 拉取镜像
docker pull registry.p-XXXXXX.project.space/myimage:latest

构建镜像

如需自行构建镜像：

bash
docker build -t mittwald/registry:3 .

工作原理

auth-entrypoint.sh脚本的工作流程：

1. 验证REGISTRY_USER和REGISTRY_PASSWORD环境变量是否已设置
2. 使用提供的凭据生成htpasswd文件
3. 设置必要的Registry认证环境变量
4. 将控制权传递给标准Registry入口点

许可证

本项目采用MIT许可证 - 详见LICENSE文件。