文章

keelOS: 公测开始！从安装 keelOS 到第一台 Win10 虚拟机

2026-10-11 · Wanpeng Qian

本教程针对 keelOS 2026-10-11 发布的公测版。keelOS 每周发布新版本，界面和步骤可能已经有变化，教程会落后一些；以你手上版本的界面为准。

keelOS 公测开始了。这篇文章从一台空机器开始，一步一步装好 keelOS，再在上面装好第一台 Windows 10 虚拟机：用 kRDPclient 装好系统、直通核显、装 keelagent。全程大约一到两个小时，大部分时间在等 Windows 安装。

先用两句话介绍 keelOS。keelOS 是给家里或小办公室那一台服务器用的虚拟化系统，基于 FreeBSD 和 bhyve，所有管理都在网页上完成。它的特点是宿主系统可以升级、重启，而虚拟机只暂停几十秒、不关机，直通的显卡和硬盘也跟着保留。

推荐硬件

推荐用带核显的 8–10 代 Intel CPU、两个网卡、两块硬盘；最低一个网卡、一块硬盘也能装。

另外要准备一个 2 GB 以上的 U 盘做安装盘。BIOS 里记得打开 VT-x（Intel Virtualization Technology）和 VT-d，启动方式用 UEFI。

准备：下载和做启动盘

1. 下载 keelOS：在 GitHub 的发布页 下载最新的 keelos-版本号.iso（约 500 MB），旁边的 .sha256 可以用来核对文件。
2. 做启动 U 盘：ISO 是混合镜像，直接整盘写进 U 盘。Windows 上用 Rufus（提示时选“以 DD 镜像模式写入”）或 balenaEtcher；Linux 和苹果电脑上用 dd。U 盘上原来的东西会被清掉。
3. 下载 Windows 10 的 ISO：微软官网的 Windows 10 下载页。中文、英文、日文版都可以，选 64 位。这个 ISO 先放在你自己的电脑上，等一下从网页上传。

安装 keelOS

从 U 盘启动后，keelOS 先在内存里运行，屏幕上出现蓝底的安装菜单。安装程序不用网络，网络等装好以后第一次启动时自动用 DHCP 拿地址。

菜单的几项：

• Upgrade：只有硬盘上已经装过 keelOS 时才出现，新机器看不到。
• Fresh install：全新安装。
• Disk tools：磁盘工具，看每块盘上有什么、把盘抹干净。
• Try only：只试用，什么都不写。
• Quit：退出。

安装步骤：

1. 先清盘（盘上有东西时）。全新安装只装到空盘。盘上有旧系统、旧的 keelOS 或旧的 ZFS 池时，进 Disk tools，用空格选中要清的盘，点 Erase，再输入盘名确认。旧的 keelOS 启动分区一定要清掉，否则主板可能从它启动。清完点 Back 回到菜单。
2. 选盘。进 Fresh install，列表里只有能装的空盘。用空格选一块或多块：有两块盘时两块都选上，每块盘开头会写一个一样的 2 GB 启动分区，哪块都能启动，剩下的空间留着不动。没有空盘时，它会列出所有盘和上面的东西，让你先去 Disk tools 清一块。
3. 确认。点 Install，最后一个确认框里选 Yes（光标默认在 No 上，防止误按回车）。拷贝一般一两分钟。
4. 重启。装完拔掉 U 盘，选重启。

重启后，控制台登录提示上面会显示主机名和网页地址，比如 https://192.168.1.50/。如果 30 秒内没拿到地址（没有 DHCP，或者交换机口要 VLAN），控制台会问你要不要手工设网络。

第一次打开网页

在同一个局域网的电脑上，用浏览器打开控制台显示的地址。证书是 keelOS 自己生成的，浏览器会提示不安全，选“继续前往”即可。

1. 设管理员密码。第一次打开时页面会要求设置管理员密码，它同时也是主机 root 的密码。以后用它登录网页。
2. 建立存储池。虚拟机的硬盘、ISO 都放在存储池里，没有池就不能建虚拟机。进“配置 → 存储”，页面上方有“建立存储池 zones”。装了两块盘时，把两块盘启动分区后面的空间都选上，就是镜像（一块坏了数据还在）。确认框会列出每块盘会变成什么。
3. 建网络。虚拟机的网卡要接到一个网络上。进“配置 → 网络”，“建议”里会列出主机的网口，按它建一个网络（比如叫 lan）。有两个网卡时，用第二个网卡给虚拟机，管理网页和虚拟机的流量就分开了。

下载 kRDPclient

kRDPclient 是 keelOS 自己的 Windows RDP 客户端，建议从装 Windows 开始就用它：画面比网页控制台顺畅，还能把本机的 U 盘交给虚拟机、共享剪贴板和声音。

1. 在你自己的 Windows 电脑上打开 keelOS 的网页，进“配套软件”，在 kRDPclient 那一栏点“下载（带本主机）”，得到一个约 10 MB 的 zip。
2. 解压，运行 krdpclient.exe。这台主机已经加好了（zip 里带着为你生成的令牌和主机的证书），打开就能看到主机上的虚拟机。
3. 双击一台虚拟机，就连上它的控制台。

zip 里的令牌带着你在这台主机上的权限，不要转给别人。kRDPclient 第一次启动时把它导入并删掉文件；它在“系统 → 令牌”里显示为“kRDPclient · 你的名字 · 日期”，在那里吊销就能让这个客户端失效。

别的 RDP 客户端（比如 Windows 自带的远程桌面）也能连：地址是 主机地址:3389，用户名是虚拟机的名字，密码是管理员密码，每台虚拟机的页面上都写着。只是没有 U 盘、声音这些功能。

新建 Windows 10 虚拟机

进“虚拟机”页，点“新建虚拟机”，选 Windows → 桌面版 → Windows 10。向导一共六步：

1. 架构：选“64 位（x64）”。另外两项是 32 位和“64 位，BIOS”，后者用来导入旧电脑或 ESXi 上用 BIOS 方式装的 Windows。
2. 系统：系统来自 ISO，点“从这台电脑上传”，选下载好的 Windows 10 ISO。上传完会自动选中。驱动 ISO 不用选：默认的 NVMe 硬盘和 e1000 网卡 Windows 自带驱动。
3. 资源：默认 4 个 vCPU、8 GB 内存、64 GB 硬盘，按你的机器调。
4. 网络：网卡 1 接到刚才建的网络（lan）。
5. 选项：TPM 2.0 和显卡保持默认。
6. 确认：看一遍设置，把“建好就启动”的勾去掉，点“建立”。先不开机，等 kRDPclient 连上再开。

建好后会进到这台虚拟机的页面。先在 kRDPclient 里双击这台虚拟机（列表没更新就刷新一下），连上它的控制台；再回到网页点“启动”。你会在 kRDPclient 里从第一帧开始看着它启动，就像坐在一台刚按下电源键的电脑前面。没有 Windows 电脑时，也可以在虚拟机页面点“图形（VNC）→ 在本页打开”，再点“启动”。看到“Press any key”马上按一个键，进入 Windows 安装程序：

1. 选语言 → 现在安装。
2. 产品密钥可以点“我没有产品密钥”，以后再激活；选一个版本（专业版、家庭版）。
3. 选“自定义：仅安装 Windows”，硬盘列表里就有 64 GB 的盘，选它下一步。
4. 等它拷文件、重启几次，最后进入初始设置（地区、键盘、账户）。网卡已经能用，可以登录微软账户，也可以建本地账户。

到桌面就装好了。建议先跑一遍 Windows 更新。

直通核显

把核显交给 Windows 以后，Windows 有了硬件加速，接在主机 HDMI 上的显示器也会显示 Windows 的桌面。

1. 先关机。在 Windows 里正常关机。
2. 保留核显。进“配置 → PCI 直通”，找到 Intel 的显卡（比如 vgapci0 · UHD Graphics 630），点“保留给直通”，勾上“立即生效”。如果页面提示现在做不到，就重启一次主机，重启后开机时就会保留它。
3. 加到虚拟机。进这台 Windows 的页面 → 编辑 → PCI 设备，在下拉框里选核显，点“添加”，保存。同一块核显可以分给好几台虚拟机，但同一时间只有先启动的那台能用。
4. 启动。点“启动”。开机画面（Windows 的徽标）这时只在 keelOS 的控制台里看得到，显示器还是黑的。
5. 装 Intel 显卡驱动。进 Windows 后，设备管理器的“显示适配器”里会多出一块显卡。让 Windows 更新自动装驱动，或者从 Intel 官网下载。驱动装好后，HDMI 上的显示器就亮了。

这之后，每次开机的徽标仍然只在 keelOS 的控制台里出现，Intel 驱动加载后显示器才亮，这是正常的。远程看 Windows 的画面用 kRDPclient，它拿到的就是核显输出的画面。

安装 keelagent

keelagent 运行在有显卡的 Windows 虚拟机里，用这块显卡把 Windows 的画面编码成视频交给 keelOS。kRDPclient 看到的画面更清楚，主机的 CPU 也更省。它目前是实验功能。

1. 打开 agent 通道。进虚拟机页面 → 编辑，勾上“给 guest 里编码 agent 的通道”，保存。
2. 冷启动。在 Windows 里关机，再在网页上点“启动”。这个设置要关机再开才生效，Windows 里的重启不算。
3. 下载。在 Windows 里用浏览器打开 keelOS 的网页，登录后进“配套软件”，下载 keelagent.exe。也可以在别的电脑上下载后拷进去。
4. 安装。双击 keelagent.exe，在它的窗口里点“安装”。它会连同需要的驱动一起装成 Windows 服务，以后开机自动运行。

常见问题

• 装好后主板还是启动了旧系统或旧的 keelOS：另一块盘上还留着旧的启动分区。重新从 U 盘启动，用 Disk tools 把那块盘清掉；或者在 BIOS 的启动顺序里把“keelOS gpt/keelboot…”排在前面。
• 安装程序出了问题：在控制台登录提示用 root 登录（没有密码），安装日志在 /var/log/keel-install.log，反馈时请附上。
• 网页打不开：确认电脑和主机在同一个网段，地址以 https:// 开头；控制台上显示的地址以主机当前拿到的为准。
• 错过了“Press any key”：虚拟机会停在“没有可启动设备”之类的画面。在网页上强制关闭它再启动，这次盯着 kRDPclient 及时按键。
• 直通核显后显示器开机时是黑的：正常。显示器要等 Windows 的 Intel 驱动加载后才亮，之前的开机画面在 kRDPclient 里看。

反馈

公测期间遇到问题，请到 GitHub Issues 提交，写上 keelOS 的版本号（网页右下角）、硬件型号和出问题的步骤，有截图或日志更好。

← 文章 · 为什么选 keelOS