文档 · 1.0

安装

keelOS 装在一块盘的开头：一个 2 GiB 的启动分区。安装程序只问装到哪块盘，别的（盘上剩下的空间、其他的盘、管理员密码）都在装好以后的网页上设置。整个过程大约十分钟。

装之前先看一遍硬件要求，特别是固件里要关掉 Secure Boot、只用 UEFI 启动。

1. 下载 ISO

最新版本在 https://keelos.dev/dl/keelos-latest.iso。每个版本的文件名是 keelos-<版本>.iso，版本号是提交号加构建时间，例如 keelos-1e88ea4-20261009T042139Z.iso。

这个 ISO 是"混合"格式：既可以当光盘用（服务器 IPMI 的虚拟光驱），也可以原样写进 U 盘。

2. 写进 U 盘（或挂到 IPMI）

用 U 盘（1 GB 以上就够，里面的内容会被清掉）：

• Windows：用 Rufus，选这个 ISO，在弹出的对话框里选 以 DD 镜像模式写入。写好以后在磁盘管理里能看到两个分区（约 480 MB 和 4 MB），这是对的。
• Linux / FreeBSD：dd if=keelos-<版本>.iso of=/dev/<U 盘> bs=4M（of= 后面一定要写对设备名）。

用服务器的 IPMI / BMC：把 ISO 挂到虚拟光驱（Virtual Media），下一次从光驱启动。

3. 从 U 盘启动

1. 插上 U 盘，开机时按启动菜单键（常见的是 F11、F12 或 Esc），选带 UEFI: 字样的那一项。
2. 屏幕上先是 keel hypervisor 的启动信息，然后是 FreeBSD 的启动过程，最后出现安装程序。从 U 盘读系统要一两分钟。

看不到 U 盘的话：检查固件是不是关了 CSM/Legacy、Secure Boot 是不是关了；联想的机器还要看 U 盘是不是在 Excluded from boot order 列表里（见硬件要求）。

4. 安装程序

安装程序是控制台上的文字问答，用英文（控制台的字体没有中文）。直接回车选方括号里的默认值。

第一个问题：装还是只试用

  1) install
  2) try only: write nothing
Choice [1]:

• 1) install：装到硬盘。
• 2) try only：什么都不写，keelOS 就在内存里跑起来，可以先看看网页、试试虚拟机。拔掉 U 盘重启以后，一切都不会留下。

如果这台机器上已经装过 keelOS，选项会变成三个：1) upgrade（把新版本写进另一个槽位，设置、存储池和虚拟机都不动，见升级与重启）、2) fresh install（清掉一块盘重新装）、3) try only。

第二个问题：装到哪块盘

安装程序列出所有的盘：名字（ada0、nda0 这样的）、大小、型号，以及盘上现在有什么（分区、别的系统、ZFS 池）。

1. 输入盘的名字，例如 nda0。
2. 盘上有东西的话，安装程序会说明上面有什么，并要求你再输入一遍盘名确认清除。直接回车可以换一块盘。
3. 别的系统留下的 ZFS 池（比如原来 NAS 的数据盘）会列出来，但安装程序不会去碰它；那几块盘可以以后在网页上导入，或者直通给 NAS 虚拟机。

注意：选中的那块盘上原有的数据会全部清掉。盘上启动分区后面剩下的空间不会被使用，留到网页上建存储池时再决定。

确认

安装程序显示一段摘要（装到哪块盘、启动分区多大），确认以后开始写盘，一两分钟写完。写完提示 Reboot now：拔掉 U 盘，回车重启。

5. 第一次启动

1. 从硬盘启动，先是 hypervisor，然后是宿主系统，大约一两分钟。
2. 第一次启动时，keelOS 在所有网口上用 DHCP 要地址。拿到以后，主机的屏幕（和串口）上会显示网页的地址，例如 https://192.168.1.10/。
3. 如果网络里没有 DHCP，屏幕上会问网络设置：选哪个网口、是不是 VLAN 中继口（不是就填 0）、地址（例如 192.168.1.10/24）、网关和 DNS。以后也可以在主机控制台上用 keel host net setup 重新设置，见网络。

接下来用浏览器打开这个地址，做首次设置。

装好以后盘上有什么

主机的设置放在启动分区上，而不是存储池里：存储池出了问题，主机照样能起来、能登录网页。

重装或换盘

• 重装：用 U 盘启动，选 fresh install，选同一块盘再输一遍盘名。上一次安装留下的存储池 zones 也会被清掉。
• 只升级：不需要 U 盘，在网页上升级就行，见升级与重启。用 U 盘时选 upgrade 效果一样。