crkit

Crkit

Container Registry Kit — 兼容 OCI Distribution Spec V2 的制品注册中心。

支持容器镜像和任意 OCI Artifact 格式制品的存储、代理与分发。

快速开始

# 启动本地 Registry（默认监听 :5000）
crkit serve registry

# 指定端口
crkit serve registry --addr=:5070

启动后可通过标准 OCI 工具访问：

docker pull localhost:5000/library/alpine
skopeo copy alpine:latest docker://localhost:5000/library/alpine:latest

存储模式

本地存储（默认）

基于文件系统存储，无需外部依赖：

# 本地磁盘
crkit serve registry

# S3 对象存储
crkit serve registry --content-backend=s3://bucket/prefix

代理缓存

启动本地缓存层，拉取时自动回源到远程 Registry：

crkit serve registry \
  --remote-endpoint=https://docker.io \
  --remote-username=user \
  --remote-password=pass \
  --addr=:5070

直连代理

不缓存，直接代理所有请求到远程 Registry：

crkit serve registry \
  --remote-endpoint=https://docker.io \
  --no-cache \
  --addr=:5070

CLI 命令

API

遵循 OCI Distribution Spec V2：

开发

# 构建
just build

# 运行测试
just go test

# 代码生成
just go gen

更多细节见 架构文档 和 编码规范。