FreeBSD启动环境管理

系统更新、软件升级或关键配置调整后，如果出现启动异常，临时查找旧配置往往来不及。对于使用 ZFS 根文件系统的 FreeBSD，可以在变更前创建启动环境，保留当时的系统状态。需要恢复时，再选择旧环境启动，减少逐项撤销修改的工作。

一、确认系统支持启动环境

本教程使用 FreeBSD 基础系统中的 bectl，适用于已配置 ZFS 启动环境的主机。管理命令以 root 身份执行，普通账号需要通过已经配置好的权限提升工具执行。

先检查系统版本和存储情况：

freebsd-version -kru
mount -p
zpool list
zfs list -o name,canmount,mountpoint
bectl list

重点确认根目录 / 位于 ZFS 数据集上，并且 bectl list 能列出已有环境。常见的根数据集名称类似：

zroot/ROOT/default

这只是布局示例，实际操作应使用服务器自己的数据池和数据集名称。

如果根目录使用 UFS，或 bectl 无法识别启动环境，应先查明原因。仅有一个用于存放文件的 ZFS 数据池，并不代表系统支持按本文流程切换启动环境。

启动环境能恢复哪些内容

启动环境保护的是相应 ZFS 数据集中的文件，不会自动恢复整台服务器的所有数据。

例如，系统配置和程序文件可能位于启动环境中，网站上传文件、数据库文件、用户目录也可能放在独立共享数据集上。切换系统后，这些共享数据仍然保持切换前的状态。

操作前应结合 mount -p 和 zfs list 确认实际布局。尤其是数据库已经升级或迁移数据结构时，不能只切回旧程序就认定业务已经恢复。

二、查看当前环境及启动标记

执行：

bectl list

输出包含环境名称、活动状态、挂载点、空间占用和创建时间等信息。

其中 Active 列常见标记如下：

• N：当前正在运行的环境。
• R：已设置为默认重启进入的环境。
• T：仅供下一次启动使用的临时环境。
• -：没有上述活动标记。

多个标记可能组合出现。判断下一次会进入哪个环境时，要同时检查临时启动设置，不能只看 R。

变更前记录当前环境名称。后续如果需要恢复原来的默认启动设置，要使用实际名称，不要直接照抄示例中的 default。

三、在变更前创建恢复环境

创建一个名为 before-change-01 的启动环境：

bectl create -r before-change-01
bectl list

before-change-01 是示例名称，实际使用时可以加入变更编号，并确保名称没有被占用。

create 默认以当前运行环境为基础创建新环境，-r 同时处理该启动环境下的子数据集。它不会把启动环境之外的所有共享数据集一起纳入。

创建完成后，当前系统仍然运行在原环境中。此时再执行计划内的更新或配置修改，刚创建的环境就保留了变更前的系统文件状态。

创建环境不会自动复制一份完整磁盘，但后续文件变化会影响空间占用。变更前后都应检查：

zpool list
bectl list

如果数据池空间紧张，不应因为初始环境占用较小就持续创建恢复点而不清理。

四、临时启动旧环境并验证

如果变更后出现异常，但仍能进入系统，可先临时选择旧环境：

bectl activate -t before-change-01
bectl list

检查临时启动标记后，在允许中断业务的维护时间执行：

shutdown -r now

重启后检查：

bectl list
freebsd-version -kru
mount -p

确认 before-change-01 成为当前运行环境，再核对网络、关键服务、应用配置和实际业务请求。

-t 表示只指定下一次启动使用的环境。它不会持续监测系统是否健康，也不会在启动卡住时自动替你重启服务器。远程主机应提前确认可以使用云控制台或其他带外管理入口。

如果系统已经无法正常启动，可以通过 FreeBSD 启动加载器的启动环境选择功能尝试进入旧环境。具体菜单外观随版本和启动配置变化，应以实际显示为准。

验证正常后设置为默认环境

如果决定以后继续使用恢复环境，执行：

bectl activate before-change-01
bectl list

确认默认启动标记指向目标环境。

如果仅做恢复演练，仍打算返回原环境，则使用之前记录的原环境名称进行激活。切换前应确认程序版本与共享业务数据仍然兼容。

五、只查看旧配置，不切换整个系统

有时只需要比较某个配置文件，可以挂载未运行的启动环境。

以下示例要求 before-change-01 不是当前正在运行的环境，挂载目录也没有被其他文件系统占用：

mkdir -p /mnt/be-before-change
bectl mount before-change-01 /mnt/be-before-change

比较两份系统配置：

diff -u /mnt/be-before-change/etc/rc.conf /etc/rc.conf

diff 显示差异时返回非零状态是正常行为，不代表挂载失败。

比较结束后卸载：

bectl unmount before-change-01

需要恢复配置时，先确认具体差异，再单独处理文件。不要把旧环境的整个 /etc 无差别覆盖到当前系统。

六、清理不再使用的环境

先查看环境及快照信息：

bectl list
bectl list -s
zpool list

确认目标环境不是当前环境、默认启动环境或临时启动目标，也不再承担恢复用途后，才能删除。

例如，明确不再需要 before-change-01 时：

bectl destroy before-change-01

这个命令不会再次询问确认，执行前必须核对名称。

如果提示保留了来源快照，不要直接补上其他删除参数。应先确认是否还有克隆或恢复流程依赖它。

删除环境后，实际释放空间也不一定等于列表中直观看到的占用值，因为其他环境和快照可能仍引用相同数据。

七、常见问题

1、创建了启动环境，为什么数据库没有恢复到旧状态？

数据库可能位于独立共享数据集上，或者数据库服务使用外部存储。应按实际挂载关系判断保护范围，数据库恢复仍需要相应备份和一致性方案。

2、临时进入旧环境后，为什么再次重启又回到原环境？

使用 bectl activate -t 只对下一次启动生效。确定旧环境可以长期使用后，需要执行不带 -t 的 bectl activate。

3、能否只为恢复一个配置文件而不重启？

可以挂载未运行的环境，比较并提取需要的文件。但配置是否兼容当前程序版本，仍需单独核对。

4、启动环境能代替异地备份吗？

不能。启动环境通常仍保存在同一数据池中，无法独立应对数据池损坏、磁盘整体丢失等情况。

八、操作完成后的检查

每次变更都应留下明确的恢复点名称、创建时间和保护范围。恢复演练结束后，确认当前环境与默认启动环境符合预期，并核对共享业务数据是否与当前程序兼容。这样下一次出现异常时，才能按既定步骤恢复。

广告合作

QQ群号：4114653