English日本語

快速上手

四步,从下载到第一台虚拟机。

1下载

下载 keelOS 的 ISO 文件。

下载 ISO

从 GitHub 发布页下载 keelos-版本号.iso(公测版,2026-10-11 起)。同一个文件既能写 U 盘,也能当光盘或服务器的虚拟光驱用。

版本号是提交号加上构建时间(UTC),比如 keelos-196d733-20261001T104152Z.iso:时间越晚,版本越新。

先确认硬件

64 位 Intel CPU,固件里打开 VT-x(直通还要 VT-d)。AMD 刚开始支持(虚拟机能跑,直通还没有),见常见问题。

一块 4 GiB 以上、512 字节扇区的盘装 keelOS(4Kn 的盘不能用来启动)。这块盘剩下的空间和其他盘都可以放虚拟机。

内存 8 GB 就能跑几台虚拟机。一个有线网口。

我们测过的机器和配件见硬件兼容性。

2启动盘

把 ISO 写进一个 1 GB 以上的 U 盘,从它启动。

在 Windows 上做 U 盘

用 Rufus:选 U 盘和 ISO,点开始,弹出问题时选 DD 镜像模式(不要选 ISO 模式)。或者用 balenaEtcher,不用选什么。U 盘上原来的东西会被清掉。

在 macOS 或 Linux 上做 U 盘

用 balenaEtcher,或者 dd。先确认设备名,写错会清掉别的盘。

dd if=keelos-版本号.iso of=/dev/sdX bs=4M   # Linux,sdX 是 U 盘
dd if=keelos-版本号.iso of=/dev/rdiskN bs=4m # macOS,diskutil list 查 N
服务器:用 BMC 的虚拟光驱

有 IPMI / iDRAC / iLO / Supermicro BMC 的服务器不用 U 盘:在 BMC 的网页里把 ISO 挂成虚拟光驱,设一次从光驱启动。

固件设置

UEFI 启动,关掉 CSM / Legacy(镜像里没有传统 BIOS 的启动代码)。关掉 Secure Boot。打开 VT-x 和 VT-d。

开机时按启动菜单键(联想常见 F12,Supermicro 是 F11),选 U 盘。

3安装

控制台上选 install,选一块盘、一个网口,等一两分钟,拔掉 U 盘重启。

正常安装

keelOS 先在内存里跑起来,控制台上问装还是退出,回车就是装。

  1) install
  2) quit: write nothing
Choice [1]:

向导列出每块盘和盘上现有的东西(分区、文件系统、ZFS 池),装着 Windows 或旧池的盘一眼就能认出来。keelOS 只占选中那块盘开头的一小部分;选有东西的盘要输入盘名确认。再选网口(默认是有链路的那个),DHCP 或固定地址。

已经装过 keelOS

菜单会变成三项:upgrade(把新版本写进另一个槽位,设置、存储池和虚拟机都不动)、fresh install(清掉一块盘重新装)、quit。安装盘没有“只试用”:不装就没有存储池,虚拟机起不来。

盘上有东西

向导会显示盘上有什么,要你输入盘名才清除。输入空就回去换一块盘。

Disk to install to [ada2]: ada0
  ada0 holds GPT: ms-basic-data 1 GiB (msdosfs "WINDOWS").
  Everything on ada0 will be erased.
  Type ada0 to erase it (empty: pick another disk): ada0

4配置

用浏览器打开控制台上显示的地址,设管理员密码。剩下的都在网页里点。

打开网页,设密码

控制台的登录提示上面写着网页地址,例如 https://192.168.1.10/。证书是主机自己签的,浏览器会让你确认一次。

第一页是设置管理员密码(至少 8 个字符),它也是 root 的密码。谁先打开谁设,所以装完马上设。忘了?在主机的控制台上运行 keel admin reset。

建存储池

配置 → 存储 → 建立存储池 zones。勾上启动盘剩下的空间和/或其他盘:1 块是单盘,2 块镜像,3 块起 raidz,4 块起 raidz2。

可选:在第二块盘上放一份启动分区,第一块坏了照样能启动。

配网络

配置 → 网络 → 物理端口 → 探测。keelOS 在每个口上听一听,找出子网、VLAN、路由器和 DHCP 服务器,在端口上发现的里把建议的网络建起来。虚拟机接的是网络,不是网口。

建第一台虚拟机

配置 → 存储 → ISO 镜像 → 上传 ISO,传一个系统安装盘(或给网址让主机下载)。

虚拟机 → 新建虚拟机,选模板(Windows 11、Linux、FreeBSD……),填名字、CPU、内存、磁盘、ISO 和网络,勾上建好就启动,点建立。在浏览器里打开图形(VNC)装系统,或者用任何 RDP 客户端连到虚拟机的屏幕。

接下来

  • 重启一次宿主(在主机上 shutdown -r now),看虚拟机暂停、再原地继续。这就是 keelOS 的意义。
  • 升级:系统 → 升级,给它新的 keelOS ISO。新版本写进启动分区的另一个槽,宿主重启进去,虚拟机只是暂停。新版本起不来,下次启动回到旧的。设置都保留。
  • 把硬盘控制器或 NVMe 交给 NAS 虚拟机,或者把网卡的 SR-IOV VF 交给软路由:见直通那篇文章。