sigma
  
Sigma 是一个极容易部署和维护的镜像仓库，并且自主完整实现了 [OCI Distribution Specification 1.1](https://github.com/opencontainers/distribution-spec/tree/v1.1.0) 的协议，除了支持 docker 客户端以外，还支持其他类型的各种客户端，例如 [oras](https://github.com/oras-project/oras)，[apptainer](https://github.com/apptainer/apptainer)，[helm](https://github.com/helm/helm), [nerdctl](https://github.com/containerd/nerdctl) 等。在部署层面上完全可以做到 all-in-one 的部署，启动单个容器即可将整体的镜像仓库的所有服务启动起来，在高可用层面也可以将各个模块分别单独部署。
## 快速开始
你可以用以下的一个简单的命令来运行起来 Sigma 镜像仓库:
```bash
docker run --name sigma -p 3000:3000 --rm tosone/sigma:nightly-alpine
```
默认的用户名密码是: sigma/Admin@123, 如果你想在启动的时候初始化其他的用户名密码, 请根据[这里](https://docs.sigma.tosone.cn/docs/configuration)的配置说明来修改配置文件。
## Demo Server
演示服务器部署在一个运行 Debian 12.1 Linux 发行版的 AWS EC2 实例上(2核4G内存, 40G磁盘)，使用的 Docker 版本是 25.0.3，演示服务器是参照[这里](tools/demo-server)说明搭建的。
访问: , username/password: sigma/Admin@123
## Architecture
下图按运行层次展示 Sigma 的主要组件，从客户端入口到请求处理、后台任务，再到它们依赖的基础设施服务。
## Features
- [x] 支持 [OCI Distribution Specification 1.1](https://github.com/opencontainers/distribution-spec/tree/v1.1.0) 的协议。
- [x] 支持 OCI Image v1 格式和 OCI Image Index v1 格式。
- [x] 支持 OCI artifacts，例如：helm charts，apptainer 等等。
- [x] 支持获取 OCI 制品的 sbom。
- [x] 支持 OCI 制品的安全扫描。
- [x] 支持镜像代理。
- [x] 支持 Namespace 级别的配额限制。
- [x] 支持镜像的自动垃圾回收。
- [x] 支持镜像签名。
- [x] 支持镜像构建，构建的镜像自动签名，构建的驱动支持 Docker，Podman，Kubernetes。
- [ ] 支持镜像复制。
## AI 客户端与自动化
Sigma 为 AI 客户端和外部自动化工具提供了两种集成方式：
- `sigma-cli`：单个二进制，通过 REST API 操作远程 Sigma 服务端，覆盖命名空间、仓库、Tag、制品、成员和用户。详细说明见 [CLI 与 AI Agent](docs/cli.md)。
- 外部 REST API skill：`tools/skill/sigma-api-operator` 打包了可复用的 skill 和 `swagger.yaml`，方便 Claude Code、Copilot CLI 等 CLI agent 发现 Sigma API，并通过 HTTP 请求操作资源，包括 CLI 尚未封装的接口。
## Alternatives
- [Distribution](https://distribution.github.io/distribution/)
- [Harbor](https://goharbor.io/)
- [zot](https://zotregistry.io/)