命令参考 on Barn

macOS 命令

Wed, 11 Nov 2026 00:00:00 +0800

管理具名原生 macOS VM、桌面访问、恢复镜像与共享基础镜像。

下列选项均存在于 1.1.0 和 1.2.0。

原生 macOS VM 需要 Apple Silicon、macOS 27+ 与匹配的 Barn.app（宿主上的原生应用包），应由已登录桌面的普通用户运行。状态位于 $BARN_HOME/mac，独立于 Linux 清单。

宿主网络命令

Wed, 11 Nov 2026 00:00:00 +0800

检查、安装和移除 Linux 客机使用的固定 IP 网络。

本参考对应 Barn 1.2.0；选项表区分 1.1.0 已有选项 与 1.2.0 新增选项，具体范围见版本基线。所有命令继承全局选项。

`barn network status`

barn network status [flags]

检查宿主上供 Linux 客机使用的唯一 Barn 网络，包括后端、已安装 CIDR、归属、健康状态和生命周期预检发现。--cidr 指定预期子网，省略时检查已安装子网；本操作只读。每个原生 Mac VM 的独立网络另行管理。

仓库命令

Wed, 11 Nov 2026 00:00:00 +0800

根据 repo.yaml 与 qcow2 制品扫描、构建和校验静态镜像仓库。

本参考对应 Barn 1.2.0；选项表区分 1.1.0 已有选项 与 1.2.0 新增选项，具体范围见版本基线。所有命令继承全局选项。

`barn repo scan`

barn repo scan <root> [flags]

扫描包含 repo.yaml 与平铺 images/ 目录的仓库根路径，报告已跟踪、缺失、未跟踪和不安全的 qcow2 文件，不修改文件，也不需要 qemu-img。扫描成功即退出 0，即使发现问题也是如此；自动化必须检查 missing 和 unsafe，不能只看退出码。

镜像命令

Wed, 11 Nov 2026 00:00:00 +0800

更新签名目录、查看和下载镜像、导入本地文件以及清理缓存。

本参考对应 Barn 1.2.0；选项表区分 1.1.0 已有选项 与 1.2.0 新增选项，具体范围见版本基线。所有命令继承全局选项。

官方仓库和 HTTP 源必须提供受信任的分离签名。显式选择的自定义 HTTPS 仓库或本地目录可以不签名，但来源必须恰好是该仓库的 catalog.json；只要提供了签名，就必须验签成功。详见目录信任规则。

客机访问与 hosts

Wed, 11 Nov 2026 00:00:00 +0800

连接 Linux 客机、执行脚本、读取日志，以及发布 SSH 和 hosts 条目。

本参考对应 Barn 1.2.0；选项表区分 1.1.0 已有选项 与 1.2.0 新增选项，具体范围见版本基线。所有命令继承全局选项。

`barn ssh`

barn ssh [flags] [node] [-- command...]

打开所选已准备节点的交互 SSH 会话，默认选择已准备的控制节点，否则选第一个已准备节点。远程命令必须放在 -- 后，参数会像普通 ssh 一样合并后交给远程 shell 解析；Barn 选项放在分隔符前。节点参数必须是解析后的节点名，不能使用 IP、别名或组名。

Linux 生命周期

Wed, 11 Nov 2026 00:00:00 +0800

规划、创建、启停、调整、查看和显式删除 Linux 虚拟机。

本参考对应 Barn 1.2.0；选项表区分 1.1.0 已有选项 与 1.2.0 新增选项，具体范围见版本基线。所有命令继承全局选项。

节点参数使用 meta、node-1 等解析后的名称，省略时选择该命令清单或已应用范围内的全部节点；IP、组名、vm_alias 均不能作为选择器。plan、up、reload、resize、recreate 依次读取 -f、当前目录清单、已应用状态，其他生命周期命令直接使用已应用状态。

准备与工具

Wed, 11 Nov 2026 00:00:00 +0800

生成清单、准备宿主、校验配置，以及查看版本和生成补全脚本。

本参考对应 Barn 1.2.0；选项表区分 1.1.0 已有选项 与 1.2.0 新增选项，具体范围见版本基线。所有命令继承全局选项。

`barn setup`

barn setup [meta|dual|trio|full] [flags]

准备宿主软件包、固定 IP 网络、镜像与所选清单，然后运行 barn up 创建 Linux VM。meta、dual、trio、full 模板分别包含 1、2、3、4 个节点；未指定模板或 -f 时复用发现的清单，没有清单才生成 meta。-c 与规格选项用于生成模板，显式规格选项不能用来改写已有清单；1.2.0 复用清单时也忽略规格环境变量。