Barn

Farrow 0.8.0：恢复更顺畅，镜像更新

Mon, 21 Sep 2026 00:00:00 +0800

Farrow 0.8.0 减少初始化中断和部分节点启动失败后的手工操作，同时更新 Debian 与 Ubuntu 镜像，保留全部旧 Catalog 工件和已有 VM 身份。

主要变化

宿主准备接续原命令。 交互式 start、restart、reload 可以补齐宿主工具，恢复已确认完整的 Farrow 网络。macOS 新网络安装先完成 Homebrew 发现/安装或固定归档下载、校验，再申请管理员认证，避免 Homebrew 清除过早获取的 sudo 凭据。
单个节点失败不阻断独立节点。 up、start 将宿主共享目录缺失的影响限制在对应节点；新节点准备失败时，独立的已停止节点仍可启动。错误指出源目录和挂载点，不创建空目录掩盖问题。restart/reload/recreate 在停止已有 VM 前先检查共享能否访问。
恢复保留身份。 公钥缺失时从原私钥派生；私钥丢失时给出备份恢复指引，不生成新的登录身份。macOS vmnet 日志目录恢复保留网络归属证据，避免误报自身网段冲突。
失败保留上下文。 重试命令保留配置、仓库和适用参数，start 的重试仍是 start。 setup 与重试使用同一操作编号；还没有部署状态时也能读取有大小上限的事件日志。查询未缓存镜像信息不再要求 QEMU。
清理准确汇总最终结果。 显式删除持久盘或 purge 不再同时声称保留和删除同一磁盘。之前删除单个节点留下的受管磁盘，不再阻断其余实验环境的销毁。

九月镜像

内置 Catalog 2026092001 包含九个 Family、37 个工件，保留前一版全部 27 个工件。以下新 stable 均覆盖 amd64 与 arm64：

Farrow 0.7.0：简化测试环境，自动恢复故障

Wed, 16 Sep 2026 00:00:00 +0800

Farrow 0.7.0 简化测试环境的启动与恢复。重复执行 farrow up 即可继续中断的工作、重试未完成的客机初始化，并原位更新旧的客机脚本，无需重启正在运行的虚拟机。

主要变化

缩短首次使用路径。 交互式 up 可以创建默认配置、准备缺少的宿主工具，并恢复已正确安装但未运行的 Farrow 网络。短检查保持安静，长任务显示进度，完成后给出简洁结果。
可用的环境继续运行。 数据盘、共享目录、客机主机名、节点间 SSH 和私网分别初始化。可选功能失败时明确报告限制，保留可用的管理 SSH；后续 up 跳过健康步骤。
自动恢复测试数据盘。 可用文件系统直接复用；无法识别或确认损坏的文件系统会被清空重建并重新挂载，结果明确提示旧数据已丢弃。探测失败、设备暂缺、挂载占用和底层 I/O 故障不会触发格式化。
减少手工排障。 不可写的共享目录降级为只读，权限修正后重复 up 恢复；已停止虚拟机的自动 SSH 端口被占用时重新分配。镜像传输支持续传和官方源故障切换，保留摘要校验。
精简输出，分离提示与状态。 成功命令给出短摘要，限制按问题分组，JSON/YAML 保留结构化结果。客机警告单独缓存，不进入 schema-2 虚拟机状态和节点工件目录，旧版本仍可读取并管理原有环境。

升级说明

数据盘按可丢弃的测试存储处理。up 可能清空损坏的文件系统，包括 persistent 数据盘。 persistent 表示销毁、重建虚拟机时保留盘，不表示在故障恢复时保留损坏内容。有价值的数据请存放在这些测试盘之外。此次自动清盘不涉及系统盘和宿主机共享目录。

Farrow 0.6.0：默认 U24，更顺手的本地虚拟机体验

Sat, 05 Sep 2026 00:00:00 +0800

Farrow 0.6.0 默认使用 Ubuntu 24.04，完善本地 Pigsty 实验环境的计划、启动、扩容和重建体验。

主要变化

默认 Ubuntu 24.04。 新配置与内置镜像目录使用 u24:stable。目录版本 2026090501 同时纳入官方仓库已经发布的 Debian 12/13、Rocky Linux 8/9 镜像更新。
准备宿主前就能查看计划。 Catalog 镜像的 plan 无需先安装 QEMU 或配置网络（已注册的 local-* 镜像仍需 qemu-img 校验缓存），展示准确镜像版本、资源总量、待启动节点、变化字段、磁盘影响，并保留自定义 -f 路径。
状态和错误更清晰。 状态表直接显示镜像、CPU 与内存，异常节点不再遮住健康节点。状态损坏报告具体文件与原因；镜像摘要错误返回 7，SSH 的 255 原样透传； --no-wait 明确说明跳过就绪检查。
先检查，再中断。 局部 recreate 在删除磁盘前发现同伴配置冲突；reload 在停机前检查启动依赖。停止、销毁和运行时清理沿用现有部署锁，一致地处理状态。
节点名称随环境更新。 启动与删除节点后更新 Guest 内 Farrow 管理的 hosts 和控制节点 SSH 配置；同名节点重建后可以直接连接，无需手动清理 Guest 的 known_hosts。用户 SSH 内容及全局选项的作用域得到保留。
减少命令行意外。 init 自定义路径给出可用的下一步命令，展示参数不再误读选项值，整数容量与多文档 YAML 不再被静默截断。ALL_PROXY/all_proxy 提供代理回退，同时尊重专用代理和 NO_PROXY。

升级说明

升级程序不会自动替换已有磁盘，也不会修改显式选择的镜像。旧配置若依赖隐式 Debian 13 默认值，请先在 all.vars 中加入 vm_image: d13，再使用 0.6.0 应用配置。执行变更前先看 farrow plan；farrow start 继续使用已应用状态。

Farrow 0.4.0：一条命令、能用的数据盘、统一的输出

Wed, 02 Sep 2026 00:00:00 +0800

Farrow 0.4.0 是被 0.5.0 取代的公开 pre-1.0 发布。它把首次运行压缩为一条命令，修复了 Debian 与 Ubuntu 镜像上的默认数据盘，并让全部命令使用同一套输出风格。Pigsty Inventory 格式、固定 IP Deployment 模型、状态布局与内嵌 Catalog revision 2026082903 均未变化。

Farrow 0.5.0：显式处置、显式仓库、可复现镜像

Thu, 03 Sep 2026 00:00:00 +0800

说明

本页记录 0.5.0。0.7.0 已增加官方镜像源故障回退，未发布的 0.9 候选移除了 rm 别名。请按安装版本阅读当前命令行说明。

Farrow 0.5.0 是被 0.6.0 取代的公开 pre-1.0 发布。它为一次性实验室加入明确处置命令，让仓库地域成为操作者的显式选择，并提供可复现的下一代官方 Guest 镜像准备路径。Pigsty Inventory 契约、Deployment 状态格式与内嵌 Catalog revision 2026082903 均未变化。

Farrow 0.3.0：显式 Catalog 与可操作的就绪诊断

Wed, 02 Sep 2026 00:00:00 +0800

Farrow 0.3.0 是被 0.4.0 取代的公开 pre-1.0 发布。它移除隐式 Catalog 刷新，把 Guest Bootstrap 失败变成可操作的逐节点结果，并在不改变 Pigsty Inventory 与固定 IP Deployment 模型的前提下简化 CLI。

变化

up、plan 与普通 image 命令只使用一份当前本地 Catalog 快照，绝不隐式获取 Catalog 元数据。farrow update 显式获取配置仓库；image sync 激活精确 URL 或文件。
Guest Bootstrap 原子写入失败阶段。部分操作报告每个失败节点、阶段与错误；就绪失败会直接指向 farrow logs <node>。
已运行 Guest 可在不重启 QEMU 的情况下复查。生命周期部分失败后，SSH 客户端配置仍会根据全部 committed 节点重建。
Netplan 按确定性 MAC 匹配且不再重命名接口。vm_disks[].fs: auto 优先 XFS，必要时回退到 ext4。
删除冗余 ss 命令与含义模糊的根/参数短写；image reset 取代 reset-manifest，旧名称仍是别名。

验证边界

源码 Commit da6d02426da93c677c94c67fec4eb4fcecf4766a 通过完整本地源码门禁与 GoReleaser 全量 Snapshot：单测与 Race、Vet、Staticcheck、govulncheck、四目标构建、镜像流水线与 Installer 边界、Archive/Package 一致性、依赖许可证、SBOM 和 Linux 原生 Package 校验。Tag 工作流在公开 Release 前重复执行了这些检查。

Farrow 0.2.0：选点收敛与发布完整性

Tue, 01 Sep 2026 00:00:00 +0800

Farrow 0.2.0 是被 0.3.0 取代的公开 pre-1.0 发布。它保留 0.1.0 引入的 Pigsty Inventory 与磁盘 Deployment 格式，同时修复最终真机重放中发现的网络与选点收敛边界。

主要变化

10.0.0.0/8 等较宽 VPN 排除路由不再误拦 Farrow 自有的 10.10.10.0/24；相同或更具体的外部路由、重叠接口、已占用地址与自有路由缺失仍然 Fail Closed。
farrow up <node> 只下载并准备选中的节点。Inventory 中没有 State 的 desired peer 显示为 absent；SSH/hosts/provision、UUID/端口分配、生命周期与持久盘校验使用 committed 节点集合，同时保留后续扩容意图。
新 Guest 写入 # farrow-deployment-host；添加当前 hosts 行前，会同时清理该标记与 0.1.0 发布过的 # farrow-project-host。
未发布中间版本中的命令取消、结构化输出、确认、reload、诊断脱敏、Installer 保留策略与依赖图精简，全部直接进入 0.2.0。

真机与发布证据

准确源码 Commit 在 MonoProxy 在线时完成 macOS arm64/HVF 重放：选点创建 u24-1、 SSH、stop/start、增量创建已缓存的 el9-1、两节点 SSH、五个显式 absent peer 与 whole destroy 全部通过。在 Ubuntu 26.04 amd64/KVM 上，当前 Linux 二进制无变更地审计了一套现存四节点 Deployment，并进入控制 Guest。

RC6 开发候选：Owner-scope Tier 1 交付

Tue, 25 Aug 2026 00:00:00 +0800

注意

Barn 之前的历史记录。本页保留前任候选的准确身份，不证明当前 Barn 二进制或路径。当前边界见当前状态。

Piglet 1.0.0-rc.6 是单一 Native-QEMU 路径的 Owner-scope 本地开发候选。它在两条 Tier 1 宿主上关闭了要求的 Quick 与准确四节点 full 场景，并加入 Durable 特权网络事务。它刻意不是公开 Release。

为什么 Barn 没有 Project

Thu, 27 Aug 2026 19:00:00 +0800

说明

2026-09-29 更名： Barn 0.9.0 尚未发布；本文名称已同步更新。2026-09-26 校准记录：保留原始写作日期；下文已按当前实现更新。公开版本与未发布候选的边界见当前状态，不以本文日期代替发布或验收日期。

开发快照：Go 1.27 产品能力面

Mon, 24 Aug 2026 00:00:00 +0800

注意

Barn 之前的历史记录。本页名称、命令、路径、Hash 与结论只描述前任快照；当前行为以 Barn 状态和使用指南为准。

Piglet 的 2026-08-24 源码快照已经远不止最初的 QEMU Spike。它现在提供一套连贯本地 VM 产品：零配置 Quick、固定地址私有实验室、13 份 Piglet 自有 Profile、可审计 Pigsty Inventory 边界、显式持久化/状态迁移、诊断与可复现 Release Toolchain。

快速上手

Mon, 01 Jan 0001 00:00:00 +0000

安装

本教程以 Barn 0.9.0 发布候选为准。当前请先从源码构建；以下发行包和 Homebrew 命令在 0.9.0 发布、Formula 更新之后使用，不能把文档中的链接当作已经发布的证明。进度见当前状态。

配置

Mon, 01 Jan 0001 00:00:00 +0000

本参考描述 Barn 0.9.0 发布候选。Barn 只使用新名称与全新的 Barn 状态，不提供旧开发版本的兼容或迁移层。编写脚本前先核对 barn version，发布进度见当前状态。

设计

Mon, 01 Jan 0001 00:00:00 +0000

一个有用的抽象

Barn 把一份 Pigsty Inventory 启动成一套本地 QEMU deployment。它刻意不再拥有 project marker、项目注册表、租约模型、Provider Layer 或第二种配置格式。

为什么每个 Barn 节点都有两张网卡

Thu, 27 Aug 2026 20:00:00 +0800

说明

当前状态

Mon, 01 Jan 0001 00:00:00 +0000

Barn 0.9.0 是项目更名后的首次发行候选，尚未发布。源码检查、本地构建、软件包、CI、发行和线上文档分别核验；源码中出现新名称不代表公开交付已完成。安装方式见快速上手。

命令行

Mon, 01 Jan 0001 00:00:00 +0000

日常管理

Mon, 01 Jan 0001 00:00:00 +0000

本教程描述 Barn 0.9.0 发布候选。发布与验收边界见当前状态。

检查与访问

barn status
barn ssh meta
barn exec node-1 -- hostname
barn logs meta --source serial

应用状态默认位于 ~/.barn（可由 BARN_HOME 覆盖），这些命令可在任意目录执行。切换工作目录不会创建另一套 deployment。 Status 默认显示镜像和资源；--verbose 显示架构、加速器、SSH 端口和 PID， TCG 在普通输出中也明确标记。异常节点不会隐藏其他节点的状态。 barn up 会在选中 VM 启动后，根据完整 applied deployment 重建默认 SSH 别名；因此局部 up 不会删除未选中节点，可直接运行 ssh meta；如需手工重写，使用 barn ssh-config --install。 plan、up、reload、recreate 依次优先使用 -f、当前目录发现的 Inventory，两者都没有时才回退到已应用规格；validate 始终需要文件。

Mac 命令

Mon, 01 Jan 0001 00:00:00 +0000

重要

Barn 0.9.0 发布候选，尚未发布。 本页描述改名后的 barn mac，使用全新 Barn 状态，不提供旧开发环境迁移。改名前的实机记录保留在当前状态，不代表改名后已经完成同等验收。请以实际运行的 barn mac --help 为准。

声明式不等于破坏式

Thu, 27 Aug 2026 21:00:00 +0800

说明

工程与发布

Mon, 01 Jan 0001 00:00:00 +0000

本页描述 Barn 0.9.0 发布候选。构建命令使用当前工作区，请同时记录提交与未提交变更。源码构建和本地检查通过不代表已经正式发布。

仓库边界

Barn 源码仓库包含代码、测试、构建/打包定义、法律声明、README.md、CHANGELOG.md、 CONTRIBUTING.md、SECURITY.md 与双语应用发布说明。本网站提供用户、设计、运维与发布文档。运行行为和命令参数需要以匹配的源码及二进制核对；未发布源码的行为不能代表公开软件包。

故障排查

Mon, 01 Jan 0001 00:00:00 +0000

本页描述 Barn 0.9.0 发布候选。使用版本相关说明前，请先检查 barn version。

先收集诊断信息（status 可能收敛中断的运行时状态）：

barn doctor --json
barn network status --json
barn status --json

下载与 PATH 问题

安装器从 GitHub Release 下载程序；--mirror 选择的是 Barn 镜像仓库，不会重定向安装器下载。如果访问 GitHub 需要代理，在终端将 HTTPS_PROXY 或 ALL_PROXY 设置为已有代理的地址。macOS 系统代理设置本身不会替命令行工具配置这些环境变量。

镜像

Mon, 01 Jan 0001 00:00:00 +0000

Barn 使用物化的静态 Catalog 与不可变 qcow2 工件。官方与 HTTP Catalog 必须签名；用户显式选择的本地或 HTTPS 仓库可以不签名。更新 Catalog 不需要发布新的 Barn 二进制，但二进制决定信任哪些签名公钥与镜像安全规则。

自动化与客机脚本

Mon, 01 Jan 0001 00:00:00 +0000

本文示例以 Barn 0.9.0 发布候选为准。宿主命令应由拥有部署的普通 Unix 用户运行。每次调用使用同一份 Inventory 和 BARN_HOME；切换工作目录不会创建独立实验环境。

存储、文件与服务访问

Mon, 01 Jan 0001 00:00:00 +0000

本教程使用 Barn 0.9.0 发布候选的接口。执行客机内检查之前，先完成快速上手。示例使用 meta 节点与默认子网；调整已有配置时，请沿用实际节点名称与地址。

创建 VM 前选择磁盘

每个节点默认有 64 GiB 根盘，以及挂载到 /data 的 128 GiB 非持久数据盘。 vm_disk 以 GiB 设置根盘大小，vm_disks 替换整个数据盘列表； vm_disks: [] 表示不配置额外数据盘。

macOS 虚拟机

Mon, 01 Jan 0001 00:00:00 +0000

重要

PID 不是虚拟机身份

Fri, 28 Aug 2026 10:00:00 +0800

说明

镜像仓库

Mon, 01 Jan 0001 00:00:00 +0000

正常使用不需要先执行镜像命令：barn up 默认按本机架构解析 u24:stable，并拉取最终对应的不可变版本。 Barn 一直使用已安装构建内置的 Catalog，直到你运行 barn update：它会获取、校验并激活仓库当前的 Catalog；没有任何自动刷新。恢复时可用 image sync 显式激活精确 URL 或文件。

镜像流水线

Mon, 01 Jan 0001 00:00:00 +0000

底层 packaging/image-pipeline/build.sh 接受一份已下载的不可变 qcow2 与独立获得的 SHA-256。它绝不下载、上传、修改 Barn 运行时/网络状态、读取签名密钥，也不会把镜像标成 supported。

以下命令从 Barn 源码目录执行。需要 Python 3 与 qemu-img；offline 还需要可用的 libguestfs virt-customize、virt-cat。这是镜像构建宿主的依赖，与 barn setup 为运行 VM 安装的依赖是不同边界。

repo.yaml 是意图，catalog.json 是证据

Sat, 29 Aug 2026 19:00:00 +0800

说明

从源码构建

Mon, 01 Jan 0001 00:00:00 +0000

Barn 0.9.0 目前是尚未发布的候选版本。本页用于从包含改名变更的源码构建与检查；正式发布后的安装方式见快速上手。

选择源码

使用已经包含 Barn 改名变更的工作区。在源码推送到公开仓库后，也可以克隆：

卸载与清理环境

Mon, 01 Jan 0001 00:00:00 +0000

本页会删除虚拟机与本地数据。先确认当前状态，不要在仍需保留 Barn VM 时继续：

barn st

1. 删除 deployment

彻底删除节点、持久盘、密钥与 deployment 状态：