> 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/diskless.8.md). # diskless.8 `diskless` — 通过 PXE 在网络上引导系统 ## 名称 `diskless` ## 描述 通过网络引导机器的能力对于 *diskless*（无盘）或 *dataless*（无数据）机器非常有用，也可作为修复或重新安装本地磁盘文件系统时的临时措施。本文件提供了客户端通过网络引导时，客户端与其服务器之间交互的一般性描述。 ## 操作 通过网络引导系统时，客户端与服务器之间的交互分为三个阶段： 1. 第一阶段引导程序（通常是内置在以太网卡中的 PXE）加载第二阶段引导程序。 2. 第二阶段引导程序（通常是 pxeboot(8)）加载模块和内核，并引导内核。 3. 内核通过 NFS 挂载根目录，并从此处继续。 下面将分别详细描述每个阶段。 首先，第一阶段引导程序通过网络加载第二阶段引导程序。第一阶段引导程序通常使用 BOOTP 或 DHCP 获取要加载的文件名，然后使用 TFTP 加载该文件。该文件通常称为 `pxeboot`，应从 **/boot/pxeboot** 复制到服务器上的 TFTP 目录中，该目录通常为 **/tftpdir**。 第二阶段引导程序随后加载附加模块和内核。这些文件可能不在 DHCP 或 BOOTP 服务器上。你可以使用 DHCP 配置中提供的 `next-server` 选项来指定存放第二阶段引导文件和内核的服务器。第二阶段程序使用 NFS 或 TFTP 获取这些文件。默认使用 NFS。如果你使用 pxeboot(8)，可以通过在 [make.conf(5)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man5/make.conf.5.md) 中设置 `LOADER_TFTP_SUPPORT=YES`，然后通过以下命令重新编译并重新安装 pxeboot(8)，来安装使用 TFTP 的版本。在此处通常需要使用 TFTP，这样你就可以将自定义内核放在 **/tftpdir/** 中。如果你使用 NFS 且没有为 `diskless` 客户端准备自定义根文件系统，第二阶段引导将加载服务器的内核作为 `diskless` 机器的内核，这可能不是你想要的结果。 ```sh cd /usr/src/stand make clean; make; make install cp /boot/pxeboot /tftpdir/ ``` 在第三阶段，内核以两种方式之一获取 IP 网络配置，然后继续挂载根文件系统并开始运行。如果第二阶段加载器支持使用内核环境将网络配置传递给内核，则内核将使用该信息配置网络接口。否则，它必须使用 DHCP 或 BOOTP 获取配置信息。引导脚本识别 `diskless` 启动，并执行 **/etc/rc.d/resolv**、**/etc/rc.d/tmp**、**/etc/rc.d/var** 和 **/etc/rc.initdiskless** 中的操作。 ## 配置 要运行 `diskless` 客户端，你需要以下内容： * 一个导出根分区和 **/usr** 分区并具有适当权限的 NFS 服务器。`diskless` 脚本可用于只读分区，只要根分区以 `-maproot=0` 导出，以便访问某些系统文件。例如，**/etc/exports** 可以包含以下行： ```sh -ro -maproot=0 -alldirs /usr -ro -alldirs ``` 其中 是服务器上根分区的挂载点。在许多情况下，你可能会决定（同样以只读方式）导出服务器自身使用的根目录。 * 一个 BOOTP 或 DHCP 服务器。可以通过取消 **/etc/inetd.conf** 中 “`bootps`” 行的注释来启用 bootpd(8)。**/etc/bootptab** 示例可能如下： ```sh .default:\ hn:ht=1:vm=rfc1048:\ :sm=255.255.255.0:\ :sa=:\ :gw=:\ :rp=":": :ha=0123456789ab:tc=.default ``` 其中 、 和 含义明确。 * 一个正确初始化的根分区。如果你刚刚开始，应直接使用服务器自身的根目录 **/**，不要尝试克隆它。 你通常不希望为 `diskless` 引导使用与服务器上相同的 `rc.conf` 或 `rc.local` 文件。`diskless` 引导脚本提供了一种机制，通过该机制你可以覆盖 **/etc** 中的各种文件（以及根目录下的其他子目录）。 你应特别注意的一个差异是 **/etc/defaults/rc.conf** 中 `local_startup` 的值。`diskless` 引导的典型值是 `mountcritremote`，但你的需求可能不同。 脚本提供了四个覆盖目录，分别位于 **/conf/base**、**/conf/default**、**/conf/** 和 **/conf/**。你应始终创建 **/conf/base/etc**，它将完全替换 `diskless` 机器上服务器的 **/etc**。你可以在此处克隆服务器的 **/etc**，也可以创建一个特殊文件，告诉 `diskless` 引导脚本将服务器的 **/etc** 重新挂载到 **/conf/base/etc**。方法是创建文件 **/conf/base/etc/diskless\_remount**，其中包含要用作 `diskless` 机器 **/etc** 基础的挂载点。例如，该文件可能包含： ```sh 10.0.0.1:/etc ``` 或者，如果服务器包含多个独立的根目录，该文件可能包含： ```sh 10.0.0.1:/usr/diskless/4.7-RELEASE/etc ``` 这可以工作，但如果你将 **/usr/diskless/4.7-RELEASE** 复制到 **/usr/diskless/4.8-RELEASE** 并升级了安装，就需要修改 `diskless_remount` 文件以反映该移动。为避免这种情况，`diskless_remount` 文件中以 **/** 开头的路径会自动加上客户端根目录的实际路径作为前缀，因此该文件可以改为包含： ```sh /etc ``` `diskless` 脚本创建内存文件系统来保存被覆盖的目录。默认只创建 5MB 的分区，可能不足以满足你的需求。要覆盖此设置，可以创建文件 **/conf/base/etc/md\_size**，其中包含要为该目录创建的内存磁盘大小（以 512 字节扇区为单位）。 然后你通常在 **/conf/default/etc** 目录中提供逐文件覆盖。至少必须通过 **/conf/default/etc/fstab**、**/conf/default/etc/rc.conf** 和 **/conf/default/etc/rc.local** 为 **/etc/fstab**、**/etc/rc.conf** 和 **/etc/rc.local** 提供覆盖。 覆盖是分层的。你可以在 **/conf//etc** 目录中提供特定于网络的默认值，其中 表示通过 BOOTP 获得的 `diskless` 系统的广播 IP 地址。`diskless_remount` 和 `md_size` 功能可在任何这些目录中使用。配置功能也适用于 **/etc** 以外的目录，只需在 **/conf/{base,default,,}/\*** 中创建要替换或覆盖的目录，并按处理 **/etc** 的方式处理即可。 由于你通常使用 **/conf/base/etc/diskless\_remount** 克隆服务器的 **/etc**，你可能希望从内存文件系统中删除不需要的文件。例如，如果服务器有防火墙而你没有，你可能希望删除 **/etc/ipfw\.conf**。可以通过创建 **/conf/base/.remove** 文件来实现。例如，**/conf/base/etc.remove** 包含引导脚本应从内存文件系统中删除的相对路径列表。 至少，你通常需要在 **/conf/default/etc/fstab** 中包含以下内容： ```sh : / nfs ro 0 0 :/usr /usr nfs ro 0 0 ``` 你还需要创建自定义版本的 **/conf/default/etc/rc.conf**，其中应包含 `diskless` 客户端的启动选项，以及 **/conf/default/etc/rc.local**（可以为空，但能防止服务器自身的 **/etc/rc.local** 泄漏到 `diskless` 系统）。 在 `rc.conf` 中，你很可能不需要设置 `hostname` 和 `ifconfig_*`，因为这些将由启动代码设置。最后，如果多个 `diskless` 客户端共享相同的配置文件，使用以 `` `hostname` `` 作为切换变量的 `case` 语句进行特定于机器的配置可能会很方便。 * `diskless` 客户端的内核将通过 NFS 或 TFTP 加载，必须包含对 NFS 客户端的支持： ```sh options NFSCL options NFS_ROOT ``` 如果你使用的引导机制不通过内核环境将网络配置传递给内核，还需要包含以下选项： ```sh options BOOTP options BOOTP_NFSROOT options BOOTP_COMPAT ``` *注意：* PXE 环境不需要这些选项。 `diskless` 引导环境依赖内存支持的文件系统来支持临时本地存储，以防根文件系统以只读方式挂载；因此，需要在内核配置的 device 部分添加以下内容： ```sh device md ``` 如果你使用防火墙，请记住默认设置为 "open"，否则你的内核将无法发送/接收 BOOTP 数据包。 ## 安全问题 请注意，使用未加密的 NFS 挂载根分区和用户分区可能会暴露加密密钥等信息。 ## 参见 [ethers(5)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man5/ethers.5.md), exports(5), [make.conf(5)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man5/make.conf.5.md), bootpd(8), mountd(8), nfsd(8), pxeboot(8), [reboot(8)](/man/man8/reboot.8.md), [tftpd(8)](/man/man8/tftpd.8.md) **ports/net/etherboot** ## 历史 `diskless` 环境首次出现于 FreeBSD 2.2.5。 ## 缺陷 本手册页可能不完整。 FreeBSD 有时需要写入根分区，因此启动脚本会在某些位置（例如 **/etc** 和 **/var**）挂载 MFS 文件系统，同时尝试保留原始内容。该过程可能无法处理所有情况。 --- # 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/diskless.8.md?ask=&goal= ``` `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.