26.2 OpenBSD 系统安装

在了解 OpenBSD 项目的基本概述后，本节将详细介绍 OpenBSD 系统的安装流程，从镜像下载到自定义分区设置，为后续系统配置与使用奠定基础。

下载镜像

以 OpenBSD 7.7、AMD64 架构为例，请访问 https://cdn.openbsd.org/pub/OpenBSD/7.7/amd64 获取系统镜像。

若是刻录 U 盘安装，请下载 install77.img（同时支持 UEFI 和 BIOS）；若是用于虚拟机体验，请下载 install77.iso。

ISO 镜像同样支持 UEFI 和 BIOS 启动。

警告

截至 OpenBSD 7.7，请勿使用 Ventoy 1.1.05 引导实体机安装，否则会卡在文件集选择阶段。

安装过程（UEFI）

本节将介绍在 UEFI 环境下安装 OpenBSD 系统的详细步骤。

技巧

OpenBSD 安装程序实际上调用的是位于 distrib/miniroot/install.sub 的脚本。该安装脚本高度耦合，截至写作时，有三千两百余行。

使用 install77.iso，并开启 VMware 虚拟机的 UEFI 功能。

Welcome to the OpenBSD/amd64 7.7 installation program.

(I)nstall, (U)pgrade, (A)utoinstall or (S)hell? i	# 此处的 i 是用户键入的，下同

输入 i，按 回车键，开始安装。

Choose your keyboard layout ('?', or 'L' for list) [default]?

选择键盘布局，按 回车键，选择默认的美国键盘即可。

System hostname? (short form, e.g. 'foo') ykla

系统主机名可以选择较短的名称，将来主机名会显示为 ykla 这样的形式。

Available network interfaces are: em0 vlan0.

上面将列出系统所识别的网卡。

Network interface to configure? (name, lladdr, '?' , or 'done ') [em0] # 此处按回车键

IPv4 address for em0? (or 'autoconf' or 'none')[autoconf] # 此处按回车键自动 DHCP IPv4

IPv6 address for em0? (or 'autoconf' or 'none')[none] # 此处按回车键不需要 IPv6

Available network interfaces are: em0 vlan0.

Network interface to configure? (name, lladdr, '?' , or 'done ') [done] # 此处按回车键，若设定错误，可输入 [em0] 退回到上面几步。

此步骤用于选择网络连接。为避免不必要的麻烦，请尽量选择有线网络。可先输入 ?，详细了解网络名称后再选择。如本例中 em0 为有线网络，vlan0 是虚拟 VLAN 接口。

后续配置均可直接按 回车键 确认。

Password for root account? (will not echo)

设置 root 账号密码，输入后回车确认（密码不会显示在屏幕上）。

Password for root account? (again)

再次输入一遍 root 账号密码，按 回车键 确认。

Start sshd(8) by default? [yes]

按 回车键 确认，启用 SSH 服务。

Do you want the X Windows System to be started by xenodm(1)? [no] yes # 输入 yes，按回车键确认

启用 xenodm 以运行 X Window System。

Setup a user? (enter a lower-case loginname, or 'no') [no] ykla # 输入你要的用户名，按回车键确认

设置普通用户的用户名。

Full user name for ykla?

用户全名，可随意输入或者按 回车键 默认。

Password for ykla account? (will not echo)

为该账号设置密码（密码不会显示在屏幕上）。按 回车键 确认。

Password for ykla account? (again)

再次输入该用户名的密码。按 回车键 确认。

Allow root ssh login?(yes, no, prohibit-password)[no] yes

输入 yes 按 回车键 确认，以允许 root 登录 ssh。

What timezone are you in? ('?' for list) [GB] Asia

输入 Asia（亚洲），按 回车键 确认。

What sub-timezone of 'Asia' are you in? ('?' for list) Shanghai

输入 Shanghai（注意 S 为大写字母），按 回车键 确认。

Available disks are: sd0.

Encrypt the root disk? (disk,  'no' or '?' for details) [no]

按 回车键，不加密磁盘。

Available disks are: sd0

Which one is the root disk? (or 'done') [sd0] ?

输入 ? 可查看硬盘：

Which disk is the root disk? ('?' for details) [sd0] ?
    sd0: NVMe, VMware Virtual N, 1.3 (50.0G)
Available disks are: sd0.
Which disk is the root disk? ('?' for details) [sd0]

这一步是选择要将系统安装在哪一块硬盘。按 ? 列出识别的所有硬盘。请务必记住所有的盘符。然后输入需要安装的位置，如这里选择 sd0。输入 sd0 回车。

Use (W)hole disk MBR, whole disk (G)PT or (E)dit? [gpt]

回车，选择使用 GPT 分区表。

Use (A)uto layout, (E)dit auto layout, or create (C)ustom layout? [a]

这里直接按回车键，选择系统默认分区。

警告

由于默认情况下，自动分区的存储空间分配不够合理，使用该方式时可能无法安装桌面环境。

技巧

文末附有自定义分区设置，供参考。

Available disks are: sd0. Which disk do you wish to initialize? (or 'done') [done]  # 直接按回车键

Let's install the sets!

Location of sets? (cd0 disk ftp http or 'done') [cd0]  # 直接按回车键

直接按回车键，选择 cd0，即使用安装介质作为软件源。

Pathname to the sets? (or 'done') [7.7/amd64]	# 直接按回车键

直接按回车键。

Select sets by entering a set name, a file name pattern or 'all'. De-select
sets by prepending a '-', e.g.: '-game*'. Selected sets are labelled `[X]`

[X] bsd       [X] bsd.rd      [X] comp77.tgz   [X] game77.tgz  [X] xshare77.tgz [X] xserv77.tgz
[X] bsd.mp    [X] base77.tgz  [X] man77.tgz    [X] xbase77.tgz [X] xfont77.tgz


Set name(s)? (or 'abort' or 'done') [done] -game*

此处可输入 -game* 以取消选择 game77.tgz，其余保持选中状态；也可以直接按 回车键。

警告

即使不使用桌面环境，也建议勾选 xserv77.tgz，否则部分软件可能无法正常运行。

Set name(s)? (or 'abort' or 'done') [done] 输入 -game*

[X] bsd       [X] bsd.rd      [X] comp77.tgz   [ ] game77.tgz  [X] xshare77.tgz [X] xserv77.tgz
[X] bsd.mp    [X] base77.tgz  [X] man77.tgz    [X] xbase77.tgz [X] xfont77.tgz

Set name(s)? (or 'abort' or 'done') [done] 直接按回车键
Directory does not contain SHA256sig. Continue without verification? [no] yes	# 请输入 yes，然后直接按回车键

此后开始安装系统。约 5 分钟后，系统会显示如下提示：

Location of sets? (cd0 disk http nfs or 'done') [done]  # 直接按回车键
Time appears wrong.   Set to 'Mon Dec 16 22:43:37CST 2824' ? [yes]  # 直接按回车键

警告

如果不希望在 fw_update 阶段卡住，请在按 回车键 前拔掉网线，断开网络连接。

CONGRATULATIONS! Your OpenBSD install has been successfully completed!

When you login to your new system the first time, please read your mail
using the 'mail' command.

Exit to (S)heLL, (H)alt or (R)eboot? [reboot] 
# 按回车键重启进入新系统 

系统已成功安装，重启后即可进入新系统。

警告

如果不希望遇到报错 ssh(fail): no hostkeys available, invalid format，请在重启前恢复网络连接。

附录：自定义分区

本附录详细介绍 OpenBSD 的自动分区机制，并提供手动分区的方法供参考。

OpenBSD 自动分区的源代码分析

OpenBSD 默认的自动分区实际调用的是 sbin/disklabel/editor.c 文件中的相关函数。

// 磁盘容量大于等于 11.25 GB（含）时执行下面的分区策略
struct space_allocation alloc_big[] = {
	{  MEG(150),         GIG(1),   5, "/"		},
	{   MEG(80),       MEG(256),  10, "swap"	},
	{  MEG(120),         GIG(4),   8, "/tmp"	},
	{   MEG(80),         GIG(4),  13, "/var"	},
	{ MEG(1500),        GIG(30),  10, "/usr"	},
	{  MEG(384),         GIG(1),   3, "/usr/X11R6"	},
	{    GIG(1),        GIG(20),  15, "/usr/local"	},
	{    GIG(2),         GIG(5),   2, "/usr/src"	},
	{    GIG(5),         GIG(6),   4, "/usr/obj"	},
	{    GIG(1),       GIG(300),  30, "/home"	}
	/* 除此之外的任何内容，留给用户自行决定 */
};


// 磁盘容量介于 2.38 GB（含）到 11.25 GB（不含）之间时执行下面的分区策略
struct space_allocation alloc_medium[] = {
	{  MEG(800),         GIG(2),   5, "/"		},
	{   MEG(80),       MEG(256),  10, "swap"	},
	{ MEG(1300),         GIG(3),  78, "/usr"	},
	{  MEG(256),         GIG(2),   7, "/home"	}
};


// 磁盘容量介于 700 M（含）到 2.38 GB（不含）之间时执行下面的分区策略
struct space_allocation alloc_small[] = {
	{  MEG(700),         GIG(4),  95, "/"		},
	{    MEG(1),       MEG(256),   5, "swap"	}
};


// 磁盘容量介于 1 MB 到 700 M（不含）之间时执行下面的分区策略
struct space_allocation alloc_stupid[] = {
	{    MEG(1),      MEG(2048), 100, "/"		}
};

根据 sbin/disklabel/extern.h 头文件中的宏：

#define MEG(x)	((x) * 1024LL * (1024 / DEV_BSIZE))    // 实际上是 1 MB
#define GIG(x)  (MEG(x) * 1024LL)    // 实际上是 1 GB

我们再看结构体 struct space_allocation：

{  MEG(150),         GIG(1),   5, "/"		},

若磁盘总大小满足，先依次按最小大小为所有指定分区进行初次分配，则在初次分配中，先将 / 分区指定 150 MB，然后按照权重 5% 对剩余磁盘空间进行二次分配，二次分配后的 / 不会超过最大大小限制 1 GB。即无论磁盘多大，/ 大小的硬限制始终为 1 GB，上述代码最早可追溯到 2009 年。

sa[alloc_table->sz - 1].rate = 100; /* 最后一个分区是贪婪分配的。 */

注意到，最后超过最大权重限制的分区都会被授予以下分区：

• 若磁盘总大小大于等于 2.38 GB（含）：/home

• 若磁盘总大小介于 700 M（含）到 2.38 GB 之间（不含）：swap

思考题

在实际使用中，/ 分区很快就会被填满，而 /home 几乎完全为空。并且原生的文件系统不支持磁盘的再分配，如缩减分区，调整顺序。

你认为这种设计的根本缺陷在哪？请尝试改正并通过邮件列表向 OpenBSD 项目提交改进建议。

实际执行计算的是同 sbin/disklabel/editor.c 文件内的函数 allocate_space()，其中 if (xtrablks < sa[i].minsz) 表明先验证磁盘总大小是否满足初次分配的最小要求。从结构体 alloc_big[]、alloc_medium[]、alloc_small[] 最后到 alloc_stupid[] 依次降级计算。

函数 allocate_partition() 则执行实际写入。

思考题

请分析在 UEFI 下，OpenBSD 自动生成的 EFI 分区在哪个位置？

自动安装的分区如下：

# cat /etc/fstab    # 查看系统文件系统挂载配置文件内容
798e155a2c1de208.b none swap sw
798e155a2c1de208.a / ffs rw 1 1
798e155a2c1de208.l /home ffs rw,nodev,nosuid 1 2
798e155a2c1de208.d /tmp ffs rw,nodev,nosuid 1 2
798e155a2c1de208.f /usr ffs rw,nodev 1 2
798e155a2c1de208.g /usr/X11R6 ffs rw,nodev 1 2
798e155a2c1de208.h /usr/local ffs rw,wxallowed,nodev 1 2
798e155a2c1de208.k /usr/obj ffs rw,nodev,nosuid 1 2
798e155a2c1de208.j /usr/src ffs rw,nodev,nosuid 1 2
798e155a2c1de208.e /var ffs rw,nodev,nosuid 1 2

以人类可读格式显示 sd0 磁盘的磁盘标签信息：

# disklabel -h sd0
# /dev/rsd0c:
type: SCSI
disk: SCSI disk
label: VMware Virtual N
duid: 798e155a2c1de208
flags:
bytes/sector: 512
sectors/track: 63
tracks/cylinder: 255
sectors/cylinder: 16065
cylinders: 10443
total sectors: 167772160 # total bytes: 81920.0M
boundstart: 532544
boundend: 167772127

16 partitions:
#                size           offset  fstype [fsize bsize   cpg]
  a:          1024.0M           532544  4.2BSD   2048 16384 12960 # /
  b:          3343.4M          2629696    swap                    # none
  c:         81920.0M                0  unused                    
  d:          4096.0M          9477056  4.2BSD   2048 16384 12960 # /tmp
  e:          9268.1M         17865664  4.2BSD   2048 16384 12960 # /var
  f:          8567.8M         36846784  4.2BSD   2048 16384 12960 # /usr
  g:          1024.0M         54393600  4.2BSD   2048 16384 12960 # /usr/X11R6
  h:         11625.7M         56490752  4.2BSD   2048 16384 12960 # /usr/local
  i:           260.0M               64   MSDOS                    
  j:          2913.5M         80300160  4.2BSD   2048 16384 12960 # /usr/src
  k:          6144.0M         86267104  4.2BSD   2048 16384 12960 # /usr/obj
  l:         33653.4M         98850016  4.2BSD   2048 16384 12960 # /home

400 G 硬盘自动分区如下：

# df -h    # 以人类可读的格式显示各文件系统的磁盘使用情况
Filesystem     Size    Used   Avail Capacity  Mounted on
/dev/sd0a      986M    128M    809M    14%    /
/dev/sd0l      295G   36.0K    281G     1%    /home
/dev/sd0d      3.9G   12.0K    3.7G     1%    /tmp
/dev/sd0f     29.1G    1.4G   26.2G     6%    /usr
/dev/sd0g      986M    321M    615M    35%    /usr/X11R6
/dev/sd0h     19.4G    146K   18.4G     1%    /usr/local
/dev/sd0k      5.8G    2.0K    5.5G     1%    /usr/obj
/dev/sd0j      4.8G    2.0K    4.6G     1%    /usr/src
/dev/sd0e     11.5G    8.0M   11.0G     1%    /var

执行手动分区

了解自动分区的机制后，可以根据实际需求执行手动分区，以更合理地分配磁盘空间。

在系统分区阶段，选择 C（Custom），即“自定义设置”。

p m（注意之间的空格）

输入 p m（注意之间的空格）来显示硬盘。其他选项如下表：

代码	作用
p m	查看分区大小
A	自动分区
a	增加分区
d	删除分区
z	删除全部分区
q	确认分区

假设磁盘容量为 80 GB，可规划分区为：EFI 260 MB、/ 75 G、其余空间分配给 swap。

顺序不可动，否则无法启动！必须先分一个 /，再分 swap。基本思路：自动分区 → 删去 i 分区以外的分区 → 分 / → 分 swap

使用 d 删除现有的分区，但会保留 i 分区这个 EFI 分区（OpenBSD 7.5 及以上，7.5 以下请逐个删除除 MSDOS 以外的所有分区）

查看当前分区状态：

键入 p m

OpenBSD area: 532544-167772127; size: 81660.0M; free: 81660.0M
#       size        offset    fstype [fsize bsize  cpg]
  c:    81920.0M          0    unused
  i:      260.0M         64    MSDOS

设置 75 GB 的 / 分区：

partition: [a]	# 此处键入 a

offset: [532544]	# 直接按回车键即可 

size: [167239583] 75G # 此处键入 75G

FS type: [4.2BSD]	# 直接按回车键即可，表示使用 UFS 文件系统

mount point: [none] /	# 此处键入 /，代表设定根分区

设置交换分区，把剩余空间都给交换分区：

partition: [b]	# 直接按回车键即可 

offset: [157822560]	# 直接按回车键即可 

size: [9949567]	# 直接按回车键即可 

FS type: [swap]	# 直接按回车键即可 

然后查看当前分区状态：

键入 p m

OpenBSD area: 532544-167772127; size: 81660.0M; free: 81660.0M
#             size            offset    fstype   [fsize bsize  cpg]
  a:      76801.8M           532544      4.2BSD    2048 16384    1  #   /  
  b:       4858.2M        157822560        swap
  c:      81920.0M                0      unused
  i:        260.0M               64       MSDOS

需要注意的是，在 size 一栏中未输入具体数值而直接按 回车键，表示将上一步剩余的全部容量分配给该分区，即 swap 分区。

配置完毕，记得输入 q 确认。

键入 q

Write new label?: [y]

回车确认写入新的分区标签。

至此，分区配置完成。

从 release 升级到 stable 或 current

除了标准的 release 版本外，OpenBSD 还提供了 stable 和 current 版本供高级用户选择。本节介绍如何从 release 版本升级到这些版本。

OpenBSD 的版本分为三类：release、stable 和 current。release 是官方正式发布的稳定版本，每六个月发布一次；stable 是在 release 基础上应用安全补丁的版本；current 是开发版本，包含最新的功能但可能不稳定。

OpenBSD 不建议从 release 升级到 current，建议直接使用 快照版本（即预构建的 current）。这是因为 current 版本的 ABI 变动频繁，从 release 直接升级可能遇到兼容性问题。

经过测试，如果直接从 release 升级到 current 可能会遇到问题，例如：

===> sbin/shutdown
install -c -s  -o root -g _shutdown  -m 4550 shutdown /sbin/shutdown
install -c -o root -g bin -m 444  /usr/src/sbin/shutdown/shutdown.8 /usr/share/man/man8/shutdown.8
install: unknown group _shutdown
*** Error 1 in target 'realinstall'
*** Error 1 in sbin/shutdown (<bsd.prog.mk>:157 'realinstall')
*** Error 2 in sbin (<bsd.subdir.mk>:48 'realinstall')
*** Error 2 in . (<bsd.subdir.mk>:48 'realinstall')
*** Error 2 in . (Makefile:97 'do-build')
*** Error 2 in /usr/src (Makefile:74 'build'

获取 current 版本源码的步骤：

$ cd /usr                                                      # 切换到 /usr 目录
$ cvs -qd [email protected]:/cvs checkout -P src       # 从 OpenBSD anoncvs 仓库检出 src 源码树
$ cvs -qd [email protected]:/cvs checkout -P xenocara  # 从 OpenBSD anoncvs 仓库检出 xenocara（X Window 系统源码）
$ cvs -qd [email protected]:/cvs checkout -P ports     # 从 OpenBSD anoncvs 仓库检出 Ports 树

获取 7.3 -stable 版本源码的步骤：

$ cd /usr                                                                  # 切换到 /usr 目录
$ cvs -qd [email protected]:/cvs checkout -rOPENBSD_7_3 -P src       # 从 OpenBSD anoncvs 仓库检出 OPENBSD_7_3 版本的 src 源码树
$ cvs -qd [email protected]:/cvs checkout -rOPENBSD_7_3 -P xenocara  # 从 OpenBSD anoncvs 仓库检出 OPENBSD_7_3 版本的 xenocara 源码
$ cvs -qd [email protected]:/cvs checkout -rOPENBSD_7_3 -P ports     # 从 OpenBSD anoncvs 仓库检出 OPENBSD_7_3 版本的 Ports 树

从源码编译和升级系统的步骤：

# cd /sys/arch/$(machine)/compile/GENERIC.MP      # 进入内核编译目录，该路径在 CVS 源码拉取完成后才会存在
# make obj                                       # 创建内核编译所需的对象目录
# make config                                    # 生成内核配置相关文件
# make -j4 && make install                       # 使用 4 个并行任务编译并安装内核
# cd /usr/src                                   # 切换到基本系统源码目录
# make obj && make -j4 build                     # 创建对象目录并使用 4 个并行任务编译基本系统
# sysmerge                                      # 合并系统配置文件的更新
# cd /dev && ./MAKEDEV all                       # 生成并更新所有设备节点
# cd /usr/xenocara                              # 切换到 xenocara（X Window 系统）源码目录
# make bootstrap                                 # 构建 xenocara 所需的引导工具
# make obj                                       # 创建 xenocara 编译所需的对象目录
# make build                                     # 编译 Xorg（xenocara）

参考文献

• OpenBSD Project. Anonymous CVS[EB/OL]. (2024-03-25)[2026-03-25]. https://www.openbsd.org/anoncvs.html. OpenBSD 官方 CVS 匿名访问指南，提供代码仓库获取方法。

• OpenBSD Project. FAQ - Building the System from Source[EB/OL]. (2024-03-25)[2026-03-25]. https://www.openbsd.org/faq/faq5.html. 详细说明从源码编译 OpenBSD 系统的步骤与配置。

• OpenBSD Project. release — building an OpenBSD release[EB/OL]. (2024-03-25)[2026-03-25]. https://man.openbsd.org/release. OpenBSD 官方手册页，介绍发布版本构建流程。

课后习题

1. 在 QEMU 中安装 OpenBSD CURRENT，使用自定义分区（仅 / 和 swap），记录安装过程并验证系统能否正常启动，分析这种极简分区方案的适用场景与限制。

2. 检出 OpenBSD CURRENT 源码，修改 sbin/disklabel/editor.c 中的 alloc_big 数组，将 / 分区最大限制从 1 GB 调整为 10 GB，重新编译 disklabel 工具并在测试环境中验证其效果。

3. 从 OpenBSD -release 版本通过源码升级到 -stable，记录整个升级过程中遇到的问题（如 _shutdown 用户组缺失等），并分析为什么 OpenBSD 团队选择不保持向下兼容的设计决策及其对用户的约束。