# onyx

**Repository Path**: wangtsingx/onyx

## Basic Information

- **Project Name**: onyx
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-20
- **Last Updated**: 2025-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Onyx - OCIv2 按需加载与去重镜像引擎

Onyx 是一个基于 Go 实现的容器镜像优化系统，
解决传统 OCIv1 镜像中 **下载慢、存储冗余、FUSE 性能差** 的问题。

## 特性
- ✅ 文件级 + 块级去重
- ⚡ 按需加载 (Lazy Fetch)
- 🧩 兼容 OCIv1 层结构
- 🚫 不依赖 FUSE
- 🧠 支持访问时序预取

## 模块
- `onyx-indexer`: 镜像层索引生成工具
- `onyx-daemon`: 按需加载与缓存服务
- `onyxctl`: 控制与调试工具
- `internal/`: 存储、下载、预取、OCI接口实现

## 快速开始
```bash
make build
./bin/onyx-daemon --config /etc/onyx/config.yaml
```