> For the complete documentation index, see [llms.txt](https://handbook.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://handbook.bsdcn.org/di-23-zhang-z-wen-jian-xi-tong-zfs/23.7.-yin-dao-huan-jing.md).

# 23.7.引导环境

引导环境是包含操作系统的数据集树的可引导克隆。在采用 Root-on-ZFS 布局安装的系统上，这些数据集位于 **zroot/ROOT** 之下，正在运行的系统位于 **zroot/ROOT/default**。创建引导环境会对根数据集进行快照和克隆，这一过程在几秒内完成，并且在各环境开始分化之前几乎不占用空间。

使用 **bectl(8)** 管理引导环境。在进行重大更改（如操作系统升级或大型软件包升级）之前，创建一个新的环境：

```sh
# bectl create beforeupgrade
# bectl list
BE            Active Mountpoint Space Created
default       NR     /          2.43G 2026-07-11 11:26
beforeupgrade -      -          328K  2026-07-11 11:31
```

在 `Active` 列中，`N` 标记当前正在使用的环境，`R` 标记重启后变为活动的环境。

像往常一样使用 **freebsd-update(8)** 或 **pkg(8)** 执行升级。升级会修改活动环境，而 `beforeupgrade` 保留系统原状。如果升级后的系统无法启动或运行异常，重启并从 FreeBSD 加载器的 `Boot Environments` 菜单中选择 `beforeupgrade`。在加载器菜单中选择环境仅影响当前启动。要使回滚永久生效，激活该环境：

```sh
# bectl activate beforeupgrade
```

运行 `bectl activate -t _beName_` 则仅为下次启动激活一个环境，这在远程系统上测试更改时非常有用。

要在不启动的情况下检查或修复非活动环境的内容，将其挂载到临时位置：

```sh
# bectl mount beforeupgrade
/tmp/be_mount.c1Xk
# bectl umount beforeupgrade
```

销毁不再需要的环境以回收其占用的空间：

```sh
# bectl destroy beforeupgrade
```

> **提示**
>
> 在每次 **freebsd-update(8)** 升级或大型 **pkg(8)** 操作之前创建引导环境，提供了一种无需从备份恢复即可返回已知良好系统的即时方式。

## 23.7.1. 引导环境与应用

引导环境仅包含 **zroot/ROOT** 下的数据集。在默认的 Root-on-ZFS 布局中，这包含整个根文件系统（包括 **/usr/local** 和 **/var/db**），因此已安装的软件包及其元数据会与操作系统一起回滚。**zroot/ROOT** 之外的数据集（如 **zroot/home**、**zroot/var/log** 和 **zroot/var/mail**）是共享的：每个环境看到相同的文件，激活较旧的环境不会使它们恢复到较早的状态。

在依赖引导环境之前，围绕这种划分规划数据集布局。必须能在回滚后保留的数据（如从软件包安装的应用程序的数据库）应位于 **zroot/ROOT** 之外的独立数据集上：

```sh
# zfs create -o mountpoint=/var/db/postgres zroot/pgdata
```

采用此布局，回滚到较旧的环境会将数据库服务器二进制文件恢复到之前的版本，而数据库内容保持不变。反之亦然：在测试新环境时写入共享数据集的文件在切换回来后仍然存在，因此引导环境不能替代这些数据集的快照。