> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man8/beinstall.8.md).

# beinstall.8

`beinstall.sh` — 使用当前 FreeBSD 源码树安装引导环境

## 名称

`beinstall.sh`

## 概要

`beinstall.sh [options ...]`

## 描述

`beinstall.sh` 使用当前 FreeBSD 源码树安装引导环境。`beinstall.sh` 还会在新引导环境的沙箱中自动执行 **/etc** 更新（使用 etcupdate(8)）和软件包更新（使用 pkg-upgrade(8)）。

成功完成后，系统将准备好引导进入新引导环境。失败时，目标引导环境将被销毁。无论何种情况，正在运行的系统保持不变，不会发生引导进入部分更新系统的情况（由于安装或硬件故障）。此外，整个安装过程只需要一次重启，因为是在新引导环境中执行的。

`beinstall.sh` 需要完全构建好的 world 和 kernel。它还需要 [pkg(8)](/man/man8/pkg.8.md)，该工具不在基本系统中，必须手动安装。

传递给 `beinstall.sh` 的 `options` 是 world 和 kernel 标志，例如 [build(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/build.7.md) 中描述的 `KERNCONF`。

## 环境变量

用户可修改的变量。如有需要，可在环境中设置：

**`BE_UTILITY`**（默认：“`bectl`”）管理 ZFS 引导环境的工具。可以是基本系统中的 bectl(8)，或来自 ports（sysutils/beadm）的 beadm(1)。

**`CONFIG_UPDATER`**（默认：“`etcupdate`”）配置更新器：支持 etcupdate(8)。设置为空字符串可跳过。

**`ETCUPDATE_FLAGS`**（默认：“`-F`”）使用 etcupdate(8) 时的标志。

**`NO_PKG_UPGRADE`**（默认：“”）如果非空，将跳过 “`pkg upgrade`”。

## 文件

**src/tools/build/beinstall.sh** `beinstall.sh` 在源码树中的位置。

## 参见

[build(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/build.7.md), [development(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/development.7.md), bectl(8), etcupdate(8), [pkg(8)](/man/man8/pkg.8.md)

## 历史

`beinstall.sh` 受 Solaris/illumos 风格升级启发，功能与之类似。

`beinstall.sh` 手册页首次出现于 FreeBSD 12.0。

## 作者

`beinstall.sh` 脚本由 Will Andrews <will@FreeBSD.org> 实现。本手册页由 Mateusz Piotrowski <0mp@FreeBSD.org> 编写。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man8/beinstall.8.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.