一个基于 containerd 的容器管理 TUI 工具，提供深度容器运行时 introspection 能力。
- 📦 容器列表: ID、名称、镜像、状态、运行时间、Pod 关联
- 🌲 容器树形视图: 层级化展示 Pod 与容器关系
- 📊 容器详情页:
- 基本信息汇总（状态、PID、启动时间、重启次数）
- 环境变量（支持 Kubernetes 标记）
- 进程 Top 视图（CPU、内存、RSS 实时监控）
- 进程树展示（层级进程关系）
- 进程列表（详细信息）
- 挂载卷浏览（带来源追踪和状态标记）
- 镜像层查看（快照、压缩信息、磁盘占用）
- 网络信息（CNI、DNS、端口映射、多 IP）
- 运行时信息（OCI 配置、runc 状态、CRI 元数据）
- 存储信息（可写层、快照使用量）
- 🖼️ 镜像列表: 名称、Digest、大小、创建时间
- 📐 镜像详情: 标签、配置信息、内容路径
- 🥞 镜像层分析:
- 分层结构可视化
- 压缩/未压缩 Digest
- 快照存储状态
- 磁盘占用统计
- 容器层叠加展示
- 🎯 Pod 列表: 名称、命名空间、UID、容器数量
- 🔗 Pod 关联: 容器与 Pod 的双向导航
- CRI 元数据集成: 从 CRI 获取挂载、网络、状态信息
- 挂载来源追踪:
cri: CRI 配置的挂载runtime-default: 运行时默认挂载live-extra: 运行时动态添加的挂载
- 挂载状态:
declared+live/declared-only/live-only - CNI 网络详情: 接口、路由、DNS、端口映射
- 进程资源监控: CPU 使用率、内存 RSS、内存百分比
# Linux AMD64
curl -L -o cray.tar.gz https://github.com/icebergu/c-ray/releases/latest/download/cray-linux-amd64.tar.gz
tar -xzf cray.tar.gz
# Linux ARM64
curl -L -o cray.tar.gz https://github.com/icebergu/c-ray/releases/latest/download/cray-linux-arm64.tar.gz
tar -xzf cray.tar.gz
# macOS Intel
curl -L -o cray.tar.gz https://github.com/icebergu/c-ray/releases/latest/download/cray-darwin-amd64.tar.gz
tar -xzf cray.tar.gz
# macOS Apple Silicon
curl -L -o cray.tar.gz https://github.com/icebergu/c-ray/releases/latest/download/cray-darwin-arm64.tar.gz
tar -xzf cray.tar.gz
# 移动到 PATH
chmod +x cray
sudo mv cray /usr/local/bin/# 克隆仓库
git clone https://github.com/icebergu/c-ray.git
cd c-ray
# 本地构建
make build
# 交叉编译 Linux
GOOS=linux GOARCH=arm64 go build -o bin/cray-linux ./cmd/cray# 启动 TUI（默认）
cray
# 或显式指定
cray tui
# 自定义 containerd socket 路径
CONTAINERD_SOCKET=/run/containerd/containerd.sock cray
# 自定义 namespace
CONTAINERD_NAMESPACE=k8s.io cray
# 完整参数
cray -socket /run/containerd/containerd.sock -namespace k8s.io -timeout 30适用于非交互式环境（CI/CD、远程执行）：
# 容器操作
cray test list-containers
cray test container-detail <container-id>
cray test container-processes <container-id>
cray test container-top <container-id>
cray test container-mounts <container-id>
cray test container-layers <container-id>
# 镜像操作
cray test list-images
cray test image-detail <image-ref>
cray test image-layers <image-id>
# Pod 操作
cray test list-pods| 按键 | 功能 |
|---|---|
↑/↓ 或 j/k |
导航列表 |
Enter |
进入详情/选择 |
Esc 或 q |
返回/退出 |
Tab |
切换视图标签 |
1-9 |
快速切换详情页标签 |
r |
刷新数据 |
/ |
搜索过滤 |
# 使用测试脚本
./scripts/test-in-kind.sh
# 手动复制到 kind 节点
GOOS=linux GOARCH=arm64 go build -o bin/cray-linux ./cmd/cray
cat bin/cray-linux | docker exec -i kind-control-plane bash -c "cat > /usr/local/bin/cray && chmod +x /usr/local/bin/cray"
docker exec kind-control-plane cray test list-containers.
├── cmd/
│ └── cray/ # 主程序入口
├── pkg/
│ ├── models/ # 数据模型（容器、镜像、Pod、网络）
│ ├── runtime/ # 运行时抽象层
│ │ ├── containerd/ # containerd 实现
│ │ │ ├── client.go # 核心客户端
│ │ │ └── mounts.go # 挂载信息收集
│ │ └── cri/ # CRI 元数据客户端
│ ├── sysinfo/ # 系统信息采集
│ │ ├── procfs/ # 进程信息
│ │ ├── cgroup/ # CGroup 资源
│ │ └── mount/ # 挂载点信息
│ └── ui/ # TUI 界面层
│ ├── app.go # 应用主框架
│ └── views/ # 视图组件
│ ├── container_detail.go # 容器详情页框架
│ ├── container_list.go # 容器列表
│ ├── container_tree.go # 容器树形视图
│ ├── detail_summary_view.go # 详情汇总
│ ├── image_layers_view.go # 镜像层
│ ├── image_list.go # 镜像列表
│ ├── mounts_view.go # 挂载视图
│ ├── network_info_view.go # 网络信息
│ ├── pod_list.go # Pod 列表
│ ├── process_summary_view.go # 进程汇总
│ ├── process_tree_view.go # 进程树
│ ├── processes_view.go # 进程列表
│ ├── runtime_info_view.go # 运行时信息
│ ├── storage_view.go # 存储信息
│ └── top_view.go # Top 视图
├── docs/ # 技术文档
│ ├── containerd/ # containerd 相关
│ ├── design/ # 设计文档
│ └── runtime-spec/ # 运行时规范
└── scripts/ # 测试脚本
- 语言: Go 1.24.3+
- TUI 框架: tview
- 终端库: tcell
- 容器运行时: containerd
- CRI 接口: Kubernetes CRI API
type Runtime interface {
ListContainers(ctx context.Context) ([]*models.Container, error)
GetContainerDetail(ctx context.Context, id string) (*models.ContainerDetail, error)
GetContainerProcesses(ctx context.Context, id string) ([]*models.Process, error)
GetContainerTop(ctx context.Context, id string) (*models.TopInfo, error)
GetContainerMounts(ctx context.Context, id string) ([]*models.Mount, error)
ListImages(ctx context.Context) ([]*models.Image, error)
GetImageLayers(ctx context context.Context, id, snapshotter, rwKey string) ([]*models.ImageLayer, error)
ListPods(ctx context.Context) ([]*models.Pod, error)
// ...
}通过独立的 CRI 客户端获取 Kubernetes 级别的元数据：
- ContainerMounts: CRI 配置的挂载点声明
- PodSandboxNetwork: CNI 结果、DNS 配置、端口映射
- ContainerStatus: 重启次数、退出状态、环境变量
- 项目架构设计
- containerd 运行时集成
- 容器列表与详情
- 镜像管理与层分析
- Pod 列表与关联
- 进程监控与资源统计
- CRI 元数据集成
- 网络信息展示（CNI）
- 挂载来源追踪
- 存储与快照分析
- 多平台构建与发布
欢迎提交 Issue 和 Pull Request！
MIT License