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

文档基线

旧内部环境应先停机并保留所需数据，再按全新安装创建 Barn 环境；不要仅改名旧状态目录。 最终发布提交、制品摘要、Homebrew 与公开入口在完成后单独记录。历史 0.2–0.8 记录仍保留 Farrow 名称，不能当作 Barn 0.9.0 的发布或验收证明。

macOS 客机

barn mac 在 Apple 芯片上运行 macOS 27 虚拟机，见教程与 命令参考。组件名称为 Barn Mac.app，签名标识为 io.pgsty.barn.mac-runner。它使用独立的 $BARN_HOME/mac，不提供旧开发环境迁移命令。

2026-09-29 改名后，本地 CLI/hosts-helper 测试、原生 Bridge/镜像/退出提示/菜单测试、 runner 编译、ad-hoc 签名验证与 probe 通过。这些检查没有启动 VM，未重新执行完整 Mac 实机生命周期。此前的实机结果按原身份保留在下文。

发行前仍需核验

• 最终 Barn 提交的完整源码、归档、DEB/RPM、安装器与跨平台检查；
• 新名称下的全新宿主准备、Linux/macOS VM 生命周期与清理；
• Mac Developer ID 签名、公证及正式发布；
• GitHub 仓库、Homebrew、两地镜像源与 barn.pgsty.com 的实际公开状态。

以下保留改名前的历史记录；其中的旧命令、路径、版本和链接只描述当时的检查点。

Farrow Mac 实机记录：2026-09-29

改名前的 Farrow 开发源码于 2026-09-29 在运行 macOS 27.0（26A428）的 Apple 芯片 Mac 上完成验证，使用 ad-hoc 签名的开发构建。验证期间没有下载 macOS 镜像：每个测试目录都以 APFS 克隆方式 复用 2026-09-26 由 Apple 固定版本 27.0 恢复镜像准备的基础镜像。

• 源码门禁：完整 make check、原生组件测试，以及 Mac 发布包构建与解包后的校验和、签名、探测检查均通过。
• 自动化实机验收：16 个阶段全部通过，用时 244.9 秒：从基础镜像创建、带共享目录的命名机器、相互独立的身份与 sshd 策略、磁盘隔离、彼此隔离的每机网络、DNS 与公网 HTTPS、退出码与参数边界、共享目录双向写入、正常停启、configure、拒绝第三台运行中的虚拟机、recreate 更换身份、桌面与双向剪贴板、重复 up 不改变基础镜像，以及 destroy。
• 人工检查：从已准备的基础镜像创建到 SSH 就绪 22 秒；正常关机 6.5 秒；启动到 SSH 就绪 6–12 秒；强制断电 0.7 秒；macOS 恢复模式启动；更换网段后固定的主机密钥仍然有效；通过已安装的 OpenSSH 条目执行 ssh mac1。

macOS 客机尚待完成：Developer ID 签名、公证与正式发布；用当前 CLI 下载并安装 macOS （在没有基础镜像时首次 up，或 image update）；桌面菜单中的 Restart… 与 Shut Down…；其他 Apple 芯片机型与 macOS 27 后续更新；以及物理宿主重启。

改名前的 Linux 验证概览

本轮每台宿主均覆盖 Rocky Linux 9.8/10.2、Debian 12.15/13.7、Ubuntu 22.04.5/24.04.5/26.04.1，共 28 个成功的客机实例。临时验收 VM 已在之后清理。 两个公开 Catalog 的 SHA-256 均为 23e8dbf6c19bd192d56c6d71eb30901f17945b3487e427a43abe108463780306。 两端分别执行隔离的 farrow update，成功验签并激活 revision 2026092001。 公开镜像检查覆盖每端十个新增对象的 HEAD/内容长度，没有重新下载并计算全部公开工件摘要。

旧检查点尚未覆盖的范围

• EL9 宿主的 NetworkManager + firewalld，以及当前 systemd-networkd 重放；
• 物理宿主重启后的持久性；
• macOS amd64 与 Linux arm64 真机运行，目前仅有构建/打包检查；
• 当前 Linux/amd64 原生 EL7 生命周期；
• macOS 目录共享：已测 QEMU 无法重开 Farrow 安全持有的目录描述符；
• 完整的 Pigsty configure → farrow up → install.yml；
• 修正后的全新 Homebrew socket_vmnet 安装认证路径原生重放；
• 通过公开安装器、Homebrew 或公开 DEB/RPM 软件包完成干净宿主准备与 VM 创建。

当前内置版本均为 supported，只有 EOL EL7 与保留兼容版本 EL9 9.3/9.6、EL10 10.0 为 deprecated。active/standby Catalog 公钥已经内置；私钥托管、轮换与 Release 职责 必须在 1.0 前正式落实。

Farrow 验证历史

每条记录只属于当天真正执行过的准确 Checkpoint；后续源码或文档修改不会自动继承真机证明。

Farrow 0.8.0：2026-09-21

发布 tag v0.8.0 指向 320a32afa8f6fca02592215aa0d5607ca4e852b2。 源码 CI、独立 打包 Snapshot 和 Tag 工作流通过。 Tag 工作流生成 20 个资产，其中 19 项载荷列入校验清单。发布提交相对下述已验收运行时 只更新 README 与发布说明；在该 tag 上重新本地构建也通过归档/软件包检查。

Release 于 2026-09-21 公开。通过宿主已配置的代理匿名下载全部 20 个资产，不携带 GitHub 凭据；每项均返回 HTTP 200，完整正文 SHA-256 与 API 摘要及已检查草稿一致， 19 项载荷全部匹配校验清单。公开安装器在 macOS arm64 与 Linux amd64 的隔离用户目录 均成功安装，报告 0.8.0 / 320a32a，CLI/helper 字节与各自已校验的公开归档一致。 Linux 下载通过临时 SSH 回环转发访问已有代理，验证后已关闭。默认安装与 VM/网络状态 保持不变。这些检查验证了二进制安装；通过公开安装器准备全新宿主并创建 VM 仍待验证。

Homebrew Tap 四个平台均已选择 0.8.0，归档摘要与公开发布一致。本地语法、更新器测试、一致性/样式/ 平台检查、严格在线 audit 和原生 arm64 brew fetch 通过。macOS 与 Linux 上的 CI 任务也通过元数据、 更新器、样式、平台和 audit 检查。本轮没有重新执行 brew install、升级、relink 或 brew test。

从零初始化的基线为 6d7870e26cb2f4082a00c188f746783fc027687e。四台宿主分别清理 已确认归属的旧环境与网络，从空 Farrow 用户状态和缓存开始，使用同一局域网仓库拉起 七系统 pro 配置。Linux 实际安装 DEB；macOS 使用完整已校验归档，以用户级安装保留 配对的 CLI/helper。

运行时候选 1c054a027420b5410c6f6feb344e27e001ae1af1 加入 Homebrew 认证顺序修复， 通过完整本地 make check 及发布归档/软件包检查。随后在四机原位安装，完成健康 up、 两轮客机 SSH、stop/start 和 Ansible 配置读取；两台 Mac 还分别通过七节点 Ansible ping。 VM UUID、镜像身份、根盘/数据盘路径及 inode 保持，健康重复 up 还保持运行进程。 验证包括真实数据盘访问、Debian locale/XFS 和控制节点到其他客机的 SSH。

这是从零 6d 基线，再用最终 1c 候选原位复验生命周期，不能写成 1c 再次从零初始化。 新的 Homebrew 顺序有修复前失败、修复后通过的回归；原生从零阶段使用固定后端归档， 未覆盖全新 Homebrew Formula 安装。没有重启物理宿主，没有运行完整 Pigsty 安装或 macOS 目录共享。发布说明列出生命周期计时样本和镜像版本。

Farrow 0.7.0 发布：2026-09-16

发布提交 9c6d4896d93733d1cb60a7e5d8591e9a06659c9d 在打 Tag 前通过完整 源码 CI 与独立 打包 Snapshot。 Tag 工作流 重复检查并生成包含 20 个资产的草稿，检查后公开发布。20 个匿名下载均返回 HTTP 200，字节与检查过的草稿 一致，19 项载荷全部通过摘要校验。macOS arm64 与 Ubuntu amd64 的公开安装器安装结果 均与发布归档中的二进制一致。下载验证使用宿主现有代理，m3 通过临时回环隧道访问该代理。 pgsty/infra/farrow Formula 已刷新到 v0.7.0，本机 Homebrew 升级与 brew test 通过； 干净宿主 Formula 安装仍待重放。

Ubuntu amd64/KVM 故障矩阵覆盖 ext4/XFS 损坏、持久盘、探测失败、忙碌挂载、只读共享 和重复健康 up 保留进程。公开版 0.6.0 因出网探测失败而中断，0.7.0 在 3.3 秒内接续 同一台 VM；探测失败期间已有盘的数据与 UUID 保持不变。升级后回退 0.6.0，仍能执行 status、stop、start 与 destroy，包括存在可选警告缓存的情况。最终 0.7.0 归档新建的 VM 无警告启动，也不会继承旧实例的警告缓存。

公开安装器装出的 Linux 二进制还在 3.2 秒内重置了人为破坏的可丢弃 ext4 数据盘， 明确报告数据已丢弃，同时保留 VM 运行进程；随后 stop、start 与 purge 均通过。

该 0.6.0 中断现场已经删除了暂存的控制节点 SSH 私钥。管理访问恢复，但节点间 SSH 仍以 control-ssh 限制明确报告，详见升级说明。 本次未发布新客机镜像，Catalog 2026090501 不变；未新增 macOS HVF、宿主重启或完整 Pigsty 安装重放。

Farrow 0.6.0 发布：2026-09-05

生命周期与 UX 修改通过 Claude Code Fable 5.1 / xhigh 两轮对抗性审查；发布元数据与 CI 测试夹具修复也分别获得了后续批准。发布提交 057774e3a13477782a2ae07bd71127d03c0f1ae7 通过完整的 Go 1.27.1 源码 CI， 最新打包改动在 13d9d70 通过独立的 Snapshot 与软件包检查。 Tag 工作流 重复源码检查， 验证四平台归档、四份 Linux 软件包、八份 SPDX、安装器、Homebrew Formula、发布元数据 及全部 19 项校验和，生成包含 20 个资产的 Release。 Release 已公开，全部资产摘要与校验清单一致。隔离的 macOS arm64 安装目录通过公开下载 路径从 0.5.0 升级到 0.6.0，两个已安装程序均与校验后的发布归档字节一致；发布二进制 还通过了 init 和新建 U24 环境的 plan 验证。

隔离的 macOS arm64/HVF U24 环境通过了首次启动、不重启控制节点的扩容、控制节点到 同伴的 SSH、stop/start、正常 reload、局部重建、缩容和 Guest 名称刷新。无效镜像 reload 与存在配置冲突的局部重建均在影响现有 VM 前停止；部分状态损坏仍能展示健康节点，SSH 的 255 退出码原样透传。最终的 Guest SSH 作用域修复经真实 OpenSSH 有效配置测试验证。 验证结束后已移除测试环境。

已发布 Catalog 2026090501 默认使用 u24:stable，并纳入 Catalog 2026090302 中已经 公开的 Debian/Rocky 镜像更新。27 个工件全部通过仓库字节校验，两个官方入口提供与内置 目录完全一致的内容及生产签名，隔离客户端分别完成了 farrow update。本次应用发布没有构建新 Guest 镜像；没有重新执行 Linux 宿主 VM 生命周期、宿主重启或完整 Pigsty 安装。

Farrow 0.5.0 发布：2026-09-03

准确 Commit fc85b65ff6a24b0933b56ae1179be9ada2ba91b1 在打 Tag 前同时通过主干的完整 Go 1.27.1 源码门禁与独立 GoReleaser Snapshot/Package 路径。准确 Tag 工作流随后再次执行 源码/工具链检查，构建并验证四个平台 Archive、四份 Linux 原生 Package、八份 SPDX、 Homebrew Formula、Installer、release.json 与 19 项 Checksum Manifest，最后创建包含 20 个资产的 Pre-release。

0.5.0 加入无需确认的整套 Deployment purge/rm，明确全球 repo.pigsty.io 默认仓库与 中国 --mirror，移除隐藏的 Catalog Upstream 回退，并加入摘要锁定的 Debian/Rocky 八目标 官方镜像 Candidate Builder。Builder 结果仍是未签名的 testing Candidate；本次应用发布 不会提升任何镜像 Catalog 或真机 VM 生命周期结果。

Farrow 0.4.0 发布：2026-09-02

精确 Tag Commit 通过 make check，以及发布工作流的 Archive、DEB/RPM、SBOM、Checksum、 Installer、Homebrew Formula 与 Package 一致性门禁。up 在未准备好的终端宿主机上会自己 执行 setup，vm_disks[].fs 默认为 auto，就绪失败携带 Guest 最后一行错误，全部命令 共享一套输出风格。首次运行路径未在全新宿主机上重放；本节不声称新增真机 VM 重放。

Farrow 0.3.0 发布：2026-09-02

精确 Tag Commit 通过 make check，以及发布工作流的 Archive、DEB/RPM、SBOM、Checksum、 Installer、Homebrew Formula 与 Package 一致性门禁。Catalog 刷新改为显式操作：配置仓库 使用 farrow update，精确源使用 image sync；Guest 就绪失败携带逐节点阶段与下一步 日志命令。本节不声称新增真机 VM 重放。

Farrow 0.2.0 发布：2026-09-01

源码 Commit 59d1b62aebb3d044a317e4006cc8a0bf56f4feaf 已标记 v0.2.0。 该准确 Commit 的源码 CI 与独立手动触发的 Packaging Workflow 均通过。稳定版 Local Release 路径还构建并验证了四平台 Archive、amd64/arm64 DEB 与 RPM、8 份 SPDX、 配套 Helper 摘要、Archive/Package 一致性、Homebrew Formula、Installer、Release Metadata 与 19 项最终 Checksum。

macOS arm64/HVF 重放在 MonoProxy 的 10.0.0.0/8 覆盖排除路由存在时执行： 选点创建 u24-1、SSH、stop/start、增量创建已缓存的 el9-1、含五个 absent desired peer 的 whole status、两节点 SSH，以及 whole destroy/SSH fragment 清理全部通过。 在 Ubuntu 26.04 amd64/KVM 上，Linux 二进制无变更地审计了一套现存四节点 Farrow Deployment，并进入控制 Guest。

编译默认镜像仓库仍是签名的 COS 入口 https://repo.pigsty.cc/farrow。独立检查的 https://repo.pgsty.com/farrow 源站提供字节一致的 Catalog、Authoring Metadata、 Checksum 与镜像，并已将 Nginx Worker 收敛为只读权限。

Schema-3 Catalog 收口：2026-08-29

Catalog Revision 2026082903 是当天的源码与开发仓库检查点：9 个 Family、27 个分架构工件。 内置 Catalog 与已发布 catalog.json 的 SHA-256 同为 571b1ff9c7d4d42355df3392ea62a339471c2d01d868669a7625fac8b93f245d； 已发布 repo.yaml 也与源码维护文件完全一致。全新 HTTP 与 HTTPS 客户端均接受了生产公钥 4686B39A40F9B562 对应的分离签名。

全部 27 个已发布 qcow2（合计 19 GiB）均按 Catalog 完成全量 SHA-256 校验。随后一套空白 临时 Farrow Home 完整下载了 409.3 MiB 的 Darwin/arm64 默认 d13:stable 工件，重新计算 摘要，并通过 qcow2 结构与虚拟容量检查。这些只证明发布完整性与客户端路径，不能替代 真机生命周期矩阵；本次 Catalog 核验没有重建任何现有 VM。

0.1.0 Candidate：2026-08-28 与 2026-08-29

两份隔离的 v0.1.0 Candidate 都通过了稳定版 Local Release 路径，随后被 0.2.0 取代。 其中两项事实仍独立成立：Darwin/arm64 二进制处理了两台 QMP Socket 被外部删除的运行中 节点，仅 stop/start 这两台，13.7 秒后均恢复 readiness，另外两台同伴的 boot ID 保持不变； 一次完整 macOS 出厂清理暴露了源码测试对已安装 qemu-img 的依赖，空白宿主无法仅列出 Catalog。现在只有真正需要校验本地 qcow2 字节时才解析 Store，回归测试会显式从 PATH 移除 QEMU，make check 在 QEMU/Farrow/网络状态全部不存在时通过。

EL7/EL8 兼容性：2026-08-28

Commit 7c666c7 在两轮独立对抗审查后恢复 EL7/EL8。第一轮因破坏前运行时预检顺序与签名 Catalog 基线迁移问题给出 BLOCK；修复并补回归测试后，第二轮给出 PASS，且没有 Required Fix。

在当时的检查点，Catalog 2026082801 已在开发仓库签名激活：9 个 Family、17 个镜像 工件；包含两份 socket_vmnet Archive 在内的 19 个 Repository Payload 均重新通过完整 SHA 校验。干净客户端接受了公开签名与准确嵌入摘要。

隔离的 macOS arm64 生命周期重放用内置 TCG 兼容规则启动 Rocky Linux 8.10 arm64， stop/start 后 44.2 秒达到 readiness，并验证 NetworkManager、固定 IP/无路由/无 DNS、 dba UID/GID 88 与 generation/spec marker。EL7 字节、qcow2、BIOS 布局与 4K XFS Root 已验证；Linux/amd64 原生 Farrow 生命周期仍待重放。

真机重放：2026-08-27

概览表中的两台宿主均通过固定 IP、SSH readiness、默认 CPU/内存/根盘/数据盘、cloud-init、 stop/start、跨目录操作、扩容时控制节点 boot ID 不变、控制节点横向 SSH、忽略未消费的 Pigsty 变更、配置缺席不删除、显式 destroy。

Linux 还验证了 NOPASSWD 自动化、调用者可用的 Debian helper 权限、非特权 bridge smoke、 四个 tap 挂接时拒绝卸载，以及 destroy 后精确恢复宿主状态。

交互式宿主网络与 hosts 命令会自行调用 sudo，外部 sudo -v 只是可选优化。 Darwin 的 network.json 丢失时，也可用字节一致的接口双份证据、准确 launchd plist 与 已安装二进制摘要重建仅用于卸载的归属计划。

2026-08-28，校准后的工作树通过 unit、race、vet、staticcheck、govulncheck、四平台交叉 构建、模拟镜像流水线边界、许可证校验与 GoReleaser 配置校验。隔离的本地 GoReleaser Snapshot 还构建并验证了四个平台归档、两个架构的 DEB/RPM、SPDX、Checksum、依赖、权限 以及归档/软件包一致性。没有发布任何产物；这些结果也不会扩展真机矩阵。