nicolast/static-container-registry

static-container-registry

镜像概述

static-container-registry是一个通过静态Nginx HTTP服务器提供服务的Docker兼容只读注册表工具，无需运行完整的注册表解决方案，可实现容器镜像的拉取功能。

核心功能

• 支持Docker pull操作，兼容Docker等容器运行时工具
• 通过skopeo工具导入多种来源的镜像（如Docker Hub、本地守护进程）
• 利用硬链接优化存储，减少重复镜像层的空间占用
• 自动生成Nginx配置文件，简化部署流程

使用场景

• 离线环境中提供容器镜像的分发服务
• 轻量级只读注册表需求场景（如测试环境、固定版本镜像分发）
• 降低注册表部署和维护成本的场景

配置说明

1. 准备镜像目录
   创建存放镜像的目录：

   bash
   mkdir images/
   

2. 导入镜像
   使用skopeo将镜像复制到指定目录结构（以alpine为例）：

   bash
   mkdir images/alpine
   skopeo copy --format v2s2 --dest-compress docker://docker.io/alpine:3.9.3 dir:images/alpine/3.9.3
   

3. 优化存储
   使用hardlink工具硬链接重复文件，减少空间占用：

   bash
   hardlink -c -vv images
   

4. 生成Nginx配置
   运行脚本生成注册表所需的Nginx配置：

   bash
   ./static-container-registry.py ./images > registry.conf
   

Docker部署示例

bash
docker run \
    --name static-oci-registry \
    -p 127.0.0.1:80:80 \
    --mount type=bind,source=/绝对路径/到/images目录,destination=/var/lib/images,ro \
    --rm \
    --read-only \
    --mount type=tmpfs,destination=/run \
    --mount type=tmpfs,destination=/var/cache/nginx \
    docker.io/nicolast/static-container-registry:latest

注意替换/绝对路径/到/images目录为实际存放镜像的目录路径。

目标与非目标

• 目标：实现Docker分发API的必要部分，支持容器镜像拉取
• 非目标：不支持镜像上传（push）功能，不保证实现分发API的所有细节

致谢

• @mtrmac：提示使用skopeo的dir目标
• @rhatdan及skopeo团队：提供skopeo工具