跳转到主要内容

Pre-1.0 · 原生 Go + QEMU

一份 Inventory， 一套 Deployment。

Farrow 在 macOS 与 Linux 上，把 Pigsty 兼容的 Inventory 启动成固定 IP 的 QEMU 虚拟机。同一份文件既描述 VM，也部署 Pigsty；没有项目模型，也没有需要 对账的第二种配置。

简化后的代码线最近一次真机重放是 2026-08-27，覆盖 macOS arm64 与 Ubuntu amd64；尚无公开 v1 软件包。

跟随教程 查阅参考

真机验证与限制

当前模型

更少的机制，更清楚的行为

Farrow 面向一套可信的本地 Pigsty 实验环境，不是通用云控制平面。

1份 Inventoryfarrow.yml 或 pigsty.yml查看详情
1套用户 Deployment状态位于 ~/.farrow查看详情
4个已重放节点增量扩容查看详情
2种真机宿主macOS arm64 + Linux amd64查看详情

两个顶级栏目

文档与博客

文档只保留三个目录；博客承载历史动态，不再与当前契约混在一起。

安装与操作

开始使用

安装、教程、日常操作与故障排查。

打开

准确契约

参考

Inventory 变量、命令、参数、输出与退出码。

打开

设计与证据

关于

简化模型、真机矩阵、限制与发布门禁。

打开

一台扩到四台

教程

最短的新手完整路径，包括交给 Pigsty。

打开

vm_* 字段

配置

默认值、磁盘、共享、命名、地址与漂移。

打开

历史动态

博客

开发快照与发布说明，与当前文档分离。

打开

正常路径

准备一次，然后启动

在 farrow.yml 或 pigsty.yml 所在目录执行。

farrow setup
farrow up
farrow status

增加主机行后再次 up：创建新节点、启动选中的已停止节点，运行中节点不受影响；删掉一行永远不会删除 VM。

产品边界

刻意保留的约束

01

一份事实

Pigsty Inventory 同时是 VM 规格与部署清单。

02

节点粒度

新增是增量的；变更与删除必须显式执行。

03

可归属

变更前核验进程身份、属主、路径与网络 manifest。

04

原生

只用 HVF 或 KVM，不静默跨架构模拟。

简短回答

开始之前

工作目录还是 Farrow 项目吗？

不是。状态是 ~/.farrow 下唯一的一套 deployment；显式或当前目录发现的 Inventory 提供期望状态，没有文件时生命周期命令可回退到已应用规格。

可以直接使用 pigsty.yml 吗？

可以。Farrow 读取已记录的 VM 字段，以及用于命名、控制节点和管理员身份的一小组 Pigsty 字段；其余参数保持不透明。

setup 会修改宿主吗？

会。依赖、固定 IP 网络与 hosts helper 变更都会先展示并确认；Linux 网络 smoke 失败会按归属 manifest 回滚。

Farrow 可以用于生产吗？

不可以。它仍是 pre-1.0 的本地开发运行时；请在状态页查看准确验证矩阵与开放门禁。

从一份文件、三条命令开始。跟随精简教程，之后按需查阅参考。

教程参考状态