immobilienscout24/registry

自定义Docker仓库镜像

镜像概述

本镜像是一个自定义构建的Docker仓库，支持Docker Registry V2 API规范，集成基本认证（Basic Auth）机制。主要用于在私有环境中安全存储、分发和管理Docker镜像，提供可控的访问权限管理，确保镜像资源的安全性和可管理性。

核心功能和特性

• V2 API支持：完全兼容Docker Registry V2 API，可与标准Docker客户端无缝集成，支持镜像的推送、拉取、删除等操作
• 基本认证机制：通过用户名/密码认证控制访问权限，防止未授权用户访问或修改镜像
• 自定义构建：基于官方Registry镜像优化，可根据实际需求调整配置，适应不同场景
• 数据持久化：支持通过数据卷挂载实现镜像数据的持久化存储，确保数据不丢失
• 轻量级设计：精简镜像体积，降低资源占用，适合在各种环境中部署

使用场景和适用范围

• 企业内部私有镜像仓库：存储和管理企业内部开发的私有镜像，保护知识产权
• 开发/测试环境：集中管理项目依赖的镜像，确保团队使用统一版本的基础镜像
• 需要访问控制的环境：对镜像访问有严格权限要求的场景，如生产环境镜像管理
• 离线或边缘环境：在无互联网连接的环境中部署本地镜像仓库，满足离线开发和部署需求

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  -p 5000:5000 \
  -v /path/to/registry/data:/var/lib/registry \
  -v /path/to/auth:/auth \
  -e REGISTRY_AUTH=htpasswd \
  -e REGISTRY_AUTH_HTPASSWD_REALM="Registry Realm" \
  -e REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd \
  --name custom-registry \
  [镜像名称]

环境变量配置

基本认证设置

1. 创建htpasswd文件（需安装apache2-utils工具）：

   bash
   mkdir -p /path/to/auth
   htpasswd -Bc /path/to/auth/htpasswd username
   

   按提示输入密码，创建用户认证信息

2. 启动容器时挂载该目录，如基本使用示例所示

docker-compose配置示例

yaml
version: '3'
services:
  registry:
    image: docker.xuanyuan.run/[镜像名称]
    ports:
      - "5000:5000"
    volumes:
      - ./registry-data:/var/lib/registry
      - ./auth:/auth
    environment:
      - REGISTRY_AUTH=htpasswd
      - REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm
      - REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd
      - REGISTRY_STORAGE_DELETE_ENABLED=true
    restart: always

客户端使用示例

1. 登录私有仓库：

   bash
   docker login localhost:5000
   

   输入创建的用户名和密码

2. 推送镜像：

   bash
   docker tag my-image:latest localhost:5000/my-image:latest
   docker push localhost:5000/my-image:latest
   

3. 拉取镜像：

   bash
   docker pull localhost:5000/my-image:latest