SOW 文档

用一个自包含二进制创建并管理 APT / YUM 软件仓库。

SOW 是 Pigsty 出品的自包含软件仓库管理器:一个静态 Go 二进制, 在 Linux 与 macOS 上创建并维护 APT(DEB)YUM(RPM) 软件仓库 —— 不需要 createrepo_cdpkg-scanpackagesreprepro,也没有常驻服务。

它提供两条相互隔离的运行路径:

  • Plain 平面模式 —— sow create 把任意一个存放 .rpm / .deb 的目录就地变成 可直接对外服务的平面仓库,输出确定性可复现。
  • Managed 托管模式 —— 工作区模型:Debian 风格包池、按架构渲染的发布视图、 GPG 签名、成员策略、事务式构建与完整审计账本。

从哪里开始

你想要……阅读
立刻把仓库跑起来快速上手
先理解设计与心智模型核心概念
搭建生产级 YUM / APT 仓库教程
理解架构决策与版本边界设计
替换现有 createrepo_c / reprepro 流水线迁移指南
查命令或配置字段参考

上手指南

安装 SOW,五分钟发布一个可用仓库,并建立它背后的心智模型。

教程

端到端实操:从一堆包文件开始,做出客户端可以直接安装的已签名软件仓库。

功能

SOW 的工作原理与设计取舍:两条运行路径、包池投影、成员策略、签名、事务与审计。

设计

SOW 背后的架构决策:所有权、仓库布局、发布、兼容性与版本演进。

参考

命令语法、配置 schema、磁盘布局、退出码、JSON 输出与实测兼容矩阵。

最后修改:2026-08-08: init commit (fe725aa)