matterstech/gitlab-container-registry

GitLab Fork Docker Container Registry 镜像文档

镜像概述

本镜像是基于GitLab fork的Docker Container Registry实现，专为搭建私有Docker镜像仓库设计。它继承了Docker官方Registry的核心功能，并可能包含GitLab生态相关的定制化特性，支持企业或团队构建安全、可控的Docker镜像存储与分发系统，满足私有环境下的镜像管理需求。

核心功能与特性

• 私有镜像仓库支持：提供独立的私有Docker镜像存储能力，避免依赖公共仓库，保障镜像安全性。
• GitLab集成优化：作为GitLab fork版本，可能原生支持与GitLab CI/CD、用户认证等生态组件的集成（具体集成特性需参考对应GitLab fork版本的文档）。
• 完整镜像管理：支持镜像推送（push）、拉取（pull）、删除（delete）等基础操作，以及标签管理、版本控制。
• 灵活存储配置：支持本地文件系统、云存储（如S3、GCS）等多种存储后端，适应不同环境的存储需求。
• 安全特性：可配置TLS加密传输、访问控制策略（如基于令牌的认证），保护镜像传输与访问安全。

使用场景

• 企业内部私有镜像仓库：用于存储企业内部开发的Docker镜像，限制外部访问，保障知识产权和代码安全。
• 开发团队协作：供开发团队共享内部镜像，统一开发、测试、生产环境的镜像版本，提升协作效率。
• GitLab生态环境：在已部署GitLab的企业或团队中，作为配套的私有镜像仓库，与GitLab CI/CD流水线无缝对接，实现镜像自动构建、推送与部署。
• 边缘环境镜像分发：在网络隔离或带宽有限的边缘环境中，搭建本地镜像仓库，减少外部依赖，提升镜像拉取速度。

使用方法与配置说明

基本使用（Docker Run）

通过以下命令快速启动私有镜像仓库（基础配置）：

bash
docker run -d \
  --name gitlab-fork-registry \
  -p 5000:5000 \
  -v /path/to/local/storage:/var/lib/registry \
  gitlab-fork-docker-registry:latest

参数说明：

• -p 5000:5000：将容器内Registry服务端口（默认5000）映射到主机5000端口，允许外部通过http://主机IP:5000访问仓库。
• -v /path/to/local/storage:/var/lib/registry：挂载主机目录作为持久化存储，确保容器重启后镜像数据不丢失（替换/path/to/local/storage为实际存储路径）。

配置TLS加密（安全访问）

为保障传输安全，建议配置TLS证书（需提前准备SSL证书文件，如domain.crt和domain.key）：

bash
docker run -d \
  --name gitlab-fork-registry \
  -p 443:5000 \
  -v /path/to/certs:/certs \
  -v /path/to/local/storage:/var/lib/registry \
  -e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/domain.crt \
  -e REGISTRY_HTTP_TLS_KEY=/certs/domain.key \
  gitlab-fork-docker-registry:latest

此时仓库可通过https://仓库域名访问（默认443端口）。

关键环境变量配置

以下为常用环境变量（具体支持的变量需参考镜像对应的GitLab fork版本文档）：

持久化存储

为避免容器重启导致镜像数据丢失，需将仓库存储目录持久化。除上述-v挂载本地目录外，还可配置云存储后端（如AWS S3），示例环境变量：

bash
-e REGISTRY_STORAGE=s3 \
-e REGISTRY_STORAGE_S3_BUCKET=my-registry-bucket \
-e REGISTRY_STORAGE_S3_REGION=us-east-1 \
-e REGISTRY_STORAGE_S3_ACCESSKEY=AKIAEXAMPLE \
-e REGISTRY_STORAGE_S3_SECRETKEY=secretkeyexample

访问仓库

启动后，可通过以下命令测试仓库功能：

1. 登录仓库（若开启认证）：

   bash
   docker login 仓库地址:端口
   

2. 推送本地镜像：

   bash
   docker tag 本地镜像名:标签 仓库地址:端口/镜像名:标签
   docker push 仓库地址:端口/镜像名:标签
   

3. 拉取仓库镜像：

   bash
   docker pull 仓库地址:端口/镜像名:标签
   

注意事项

• 生产环境中务必开启认证与TLS加密，防止未授权访问。
• 存储目录需确保有足够磁盘空间，建议定期备份镜像数据。
• 具体功能与配置项可能因GitLab fork版本不同有所差异，建议结合对应版本的官方文档进行详细配置。