# Barn 文档

> 两条命令启动 Barn，再按需查阅管理、配置与命令契约。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

Barn 把一份 Pigsty 兼容的 Inventory 启动成固定 IP 的 QEMU 虚拟机。每个 Unix
用户只有一套 deployment，状态位于 `~/.barn`，因此生命周期与 SSH 命令可在任意
目录运行。

按任务选择最短路径：

- **[开始使用](start/)**：两条命令启动第一个实验环境，再按需管理与排障。
- **[参考](reference/)**：Inventory 字段、命令、参数、输出与退出码。
- **[关于](about/)**：设计、真机验证、已知限制与发布门禁。

新手先按[快速上手](start/tutorial/)从源码准备 **Barn 0.9.0 发布候选**。
CLI 就绪后，用 `barn up` 启动实验环境，用 `barn ssh` 进入虚拟机。

> [!IMPORTANT]
> 0.9.0 是 Barn 的首次发行，当前尚未发布。只使用新命令、新环境变量与全新状态，
> 不保留旧开发版本兼容或状态迁移。详见[发布与验证记录](about/status/#documentation-baseline)。

---

本节页面：

- [开始使用](/zh/docs/start/): 用 up 启动 Barn、用 ssh 进入客机，其余管理、排障、镜像、构建与清理按需阅读。
- [参考](/zh/docs/reference/): Barn 读取的 Pigsty Inventory 与命令行的准确契约。
- [关于 Barn](/zh/docs/about/): 产品模型、实现边界、真机证据、当前限制与发布门禁。