# 当前状态 > Barn 0.9.0 重命名候选、发布边界、历史验收记录与已知限制。 --- LLMS 索引： [llms.txt](/zh/llms.txt) --- Barn 0.9.0 是项目更名后的首次发行候选，**尚未发布**。源码检查、本地构建、 软件包、CI、发行和线上文档分别核验；源码中出现新名称不代表公开交付已完成。 安装方式见[快速上手](../../start/tutorial/#安装)。 ## 文档基线 {#documentation-baseline} | 对象 | 当前身份 | 使用方式 | |---|---|---| | 程序与当前文档 | Barn 0.9.0 发布候选 | 从包含改名变更的源码构建；发行包命令在发布后使用。 | | CLI 与配置 | `barn`、`barn.yml`、`BARN_*` | 不提供旧名称别名或环境变量回退。 | | 状态与宿主资源 | `~/.barn`、Barn 网络与 helper | 使用新状态重新创建；不迁移旧开发环境。 | | 镜像仓库 | 官方入口的 `/barn` 前缀 | Catalog 仍需验签；云端迁移和公开访问要独立核验。 | 旧内部环境应先停机并保留所需数据，再按全新安装创建 Barn 环境；不要仅改名旧状态目录。 最终发布提交、制品摘要、Homebrew 与公开入口在完成后单独记录。历史 0.2–0.8 记录仍保留 Farrow 名称，不能当作 Barn 0.9.0 的发布或验收证明。 ## macOS 客机 {#macos-guests} `barn mac` 在 Apple 芯片上运行 macOS 27 虚拟机，见[教程](../../start/macos/)与 [命令参考](../../reference/mac/)。组件名称为 `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 验证概览 {#summary} | 宿主或产物 | 路径 | 最后验证 | 结果 | |---|---|---|---| | 两台 Linux amd64（`m0`、`m3`） | KVM，每机七系统 | 2026-09-21（0.8.0） | 从零初始化、首次 SSH、最终候选原位升级、重复 up、stop/start、磁盘身份与 Ansible 配置读取通过 | | 两台 macOS arm64（`m1`、`m5`） | HVF，每机七系统 | 2026-09-21（0.8.0） | 同样的生命周期检查通过，另通过每机七节点 Ansible ping | | Catalog `2026092001` | 9 个 Family、37 个工件；九月 Debian/Ubuntu 更新 | 2026-09-21 | 内置/本地/LAN/公开 Catalog 字节一致；十个新增镜像在两个公开入口可访问且大小正确；所选镜像通过四机原生 pro 验收 | | Ubuntu 26.04 amd64 | KVM、QEMU 10.2.1、Ubuntu 24.04 Guest | 2026-09-16（0.7.0 恢复） | 损坏盘重置、探测失败、忙碌挂载、保留盘重建、共享目录恢复与重复健康 up 通过 | | macOS arm64 | HVF、Ubuntu 24.04.4 Guest | 2026-09-05（0.6.0 生命周期修改） | 创建、扩容、同伴 SSH、stop/start、reload、recreate、部分状态与缩容通过 | | macOS 26.6.2 arm64 | HVF、QEMU 11.1、socket_vmnet | 2026-09-01（`v0.2.0`） | 选点创建/SSH/stop/start、增量创建已缓存镜像、whole status、whole destroy 通过 | | macOS 26.6.2 arm64 | HVF、QEMU 11.1、socket_vmnet | 2026-08-27 | 单节点与增量四节点通过 | | Ubuntu 26.04 amd64（`mx`） | KVM、QEMU 10.2.1、NetworkManager | 2026-09-01（`v0.2.0`） | 审计现存四节点 deployment 为存活并进入控制 Guest | | Ubuntu 26.04 amd64（`mx`） | KVM、QEMU 10.2.1、NetworkManager | 2026-08-27 | setup、单节点、增量创建四节点与卸载通过 | | macOS arm64 | HVF 宿主、TCG 兼容规则、Rocky Linux 8.10 arm64 | 2026-08-28 | 启动、stop/start、44.2 秒达到 readiness 通过 | | 已发布 Catalog `2026090501` | 9 个 Family、27 个 qcow2 工件 | 2026-09-05 | 工件校验、内置/公开字节一致，以及两个官方入口的签名更新通过 | | 已发布 Catalog `2026082903` | 9 个 Family、27 个已签名 qcow2 工件 | 2026-08-29 | 全量 SHA-256 校验与干净客户端拉取 `d13:stable` 通过 | 本轮每台宿主均覆盖 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](https://github.com/pgsty/farrow/actions/runs/35568664994)、独立 [打包 Snapshot](https://github.com/pgsty/farrow/actions/runs/35568664948) 和 [Tag 工作流](https://github.com/pgsty/farrow/actions/runs/35569143101)通过。 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](https://github.com/pgsty/homebrew-infra/commit/9c3401958a435248ebf0e5402e7efff712ee1c4c) 四个平台均已选择 0.8.0，归档摘要与公开发布一致。本地语法、更新器测试、一致性/样式/ 平台检查、严格在线 audit 和原生 arm64 `brew fetch` 通过。macOS 与 Linux 上的 [CI 任务](https://github.com/pgsty/homebrew-infra/actions/runs/35570285428)也通过元数据、 更新器、样式、平台和 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 目录共享。[发布说明](../../../blog/release/farrow-0.8.0/)列出生命周期计时样本和镜像版本。 ### Farrow 0.7.0 发布：2026-09-16 发布提交 `9c6d4896d93733d1cb60a7e5d8591e9a06659c9d` 在打 Tag 前通过完整 [源码 CI](https://github.com/pgsty/farrow/actions/runs/35118137961) 与独立 [打包 Snapshot](https://github.com/pgsty/farrow/actions/runs/35118137990)。 [Tag 工作流](https://github.com/pgsty/farrow/actions/runs/35119206685) 重复检查并生成包含 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` 限制明确报告，详见[升级说明](../../../blog/release/farrow-0.7.0/)。 本次未发布新客机镜像，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](https://github.com/pgsty/farrow/actions/runs/33959205857)， 最新打包改动在 `13d9d70` 通过独立的 [Snapshot 与软件包检查](https://github.com/pgsty/farrow/actions/runs/33958857302)。 [Tag 工作流](https://github.com/pgsty/farrow/actions/runs/33959431603) 重复源码检查， 验证四平台归档、四份 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、依赖、权限 以及归档/软件包一致性。没有发布任何产物；这些结果也不会扩展真机矩阵。