20.2 使用 BVCP 通过 Web 界面管理 bhyve 虚拟机

bhyve 是 FreeBSD 原生的虚拟机管理程序（hypervisor），通过 vmm 内核模块提供硬件辅助虚拟化支持，客户机操作系统可直接利用 CPU 虚拟化扩展指令集。

BVCP（bhyve Virtual-Machine Control Panel）是 bhyve 的 Web 图形化管理工具，可创建、启动、停止虚拟机。

本节实验环境基于 FreeBSD 14.2-RELEASE。BVCP 2.1.4 版本尚不支持中文本地化。

本软件项目仓库地址为：https://github.com/DaVieS007/bhyve-webadmin

技巧
无需提前配置任何服务、加载任何模块或安装其他软件。按照本节步骤即可完成操作。

20.2.1 安装 BVCP

安装 BVCP 分为以下步骤：

下载 BVCP 分发文件：使用 fetch 命令从官方服务器获取 BVCP 压缩包。
sh
```
# fetch https://bhyve.npulse.net/release.tgz
```
1
解压缩 BVCP 分发文件：将下载的压缩包解压到当前目录。
sh
```
# tar -xzvf release.tgz
```
1

安装 BVCP：进入解压后的目录并执行安装脚本，该脚本会自动完成软件部署、数据库初始化和服务配置。

# cd bhyve-webadmin
root@ykla:/home/ykla/bhyve-webadmin-2.1.4 # ./install.sh
Installing BVCP into your FreeBSD Installation within seconds ...

Press [CTRL] + [C] to Abort !
bvcp_enable:  -> YES
 N  2024-12-21 11:32:35 | Kinga-Framework | 2024/02-17@build-336/FreeBSD64-L
 N  2024-12-21 11:32:35 | Product Name    | BVCP-Backend
 N  2024-12-21 11:32:35 | Description     | BVCP Bhyve Backend/Helper Module
 N  2024-12-21 11:32:35 | License         | Community Edition
 N  2024-12-21 11:32:35 | Copyright       | All rights reserved for the author: nPulse.net / Viktor Hlavaji
 N  2024-12-21 11:32:35 | Guardian | Create Process, PID: 1132
 N  2024-12-21 11:32:35 | SW | VFS:BuiltIn Loaded
 N  2024-12-21 11:32:35 | ThreadPool | 10/10 Threads initialised
 N  2024-12-21 11:32:35 | LVM::MAIN | Initialising ..



                    ██████╗ ██╗   ██╗ ██████╗██████╗
                    ██╔══██╗██║   ██║██╔════╝██╔══██╗
                    ██████╔╝██║   ██║██║     ██████╔╝
                    ██╔══██╗╚██╗ ██╔╝██║     ██╔═══╝
                    ██████╔╝ ╚████╔╝ ╚██████╗██║
                    ╚═════╝   ╚═══╝   ╚═════╝╚═╝

            Bhyve Virtual-Machine Control Panel under FreeBSD

 N  2024-12-21 11:32:35 | BVCP | Initialising BVCP-Backend 2.1.4 Application

  [>] Generating Entropy ... [217157D53CDD4122589AEE05D866C84C]

 Welcome to initial setup menu!
 The Software is located at: /var/lib/nPulse/BVCP

 The Software is producing pseudo filesystem scheme for virtual machines using symlinks
 Where to create metadata, iso_images, database, config, logs: (Does not need much space), default: [/vms]_>   # 按回车确认，安装所需的 iso_images 镜像将存放在此目录下

……省略一部分……


            Bhyve Virtual-Machine Control Panel under FreeBSD

 N  2024-12-21 11:33:46 | BVCP | Initialising BVCP-Backend 2.1.4 Application
 N  2024-12-21 11:33:48 | BVCP | Starting Database ...
 (!) Admin Credentials recreated,
   - User: admin 		# 用户名 admin
   - Password: AdJFjNjG # 密码 AdJFjNjG

 N  2024-12-21 11:33:48 | SW | Program exited gracefully...
Installation Finished!
Navigate: https://[your-ip]:8086  # 访问地址为 https://[your-ip]:8086，如果在安装 BVCP 的机器上访问，可使用 https://localhost:8086

文件结构：

/
├── var/
│   └── lib/
│       └── nPulse/
│           └── BVCP/ # BVCP 软件安装位置
└── vms/ # 虚拟机元数据、ISO 镜像、数据库、配置、日志存放目录
    └── iso_images/ # ISO 镜像存放目录

20.2.2 安装 Ubuntu 24.04

安装过程分为两个主要步骤：获取安装镜像和通过 Web 界面配置虚拟机。

下载 Ubuntu 24.04 安装镜像：从中国科学技术大学镜像站获取 Ubuntu 24.04 桌面版安装镜像。
sh
```
# fetch https://mirrors.ustc.edu.cn/ubuntu-releases/noble/ubuntu-24.04.1-desktop-amd64.iso
```
1
将镜像移动到 BVCP 镜像目录：将下载的 ISO 文件移动到 BVCP 配置的镜像存放目录，以便 Web 界面识别和使用。
sh
```
# mv ubuntu-24.04.1-desktop-amd64.iso /vms/iso_images
```
1

完成上述准备工作后，即可通过 Web 界面开始创建虚拟机。以下截图展示了完整的配置过程：

配置过程

登录时忽略上方显示的电子邮件（email）字段，直接输入安装过程中生成的用户名 admin 和对应密码即可。

登录界面

配置界面

安装完成后按回车键重启系统。

重启系统

重启后进入新系统：

新系统界面

20.2.3 安装 Windows 11 IoT Enterprise LTSC, version 24H2 (x64) - DVD (English)

详细步骤与前文 Ubuntu 24.04 的安装说明类似，可参见前一节“使用 bhyve 及 vm-bhyve 工具安装 Windows 11”，此处仅列出关键区别。

在 Create new network interface 步骤中创建新网卡接口时，需要特别注意网卡类型的选择：

网卡配置

请选择 Intel PRO e1000 网卡类型，Windows 系统默认不包含其他网卡类型的驱动程序。

网卡选择

完成网卡配置后即可开始安装。

安装过程

20.2.4 故障排除与未竟事宜

本节列出 BVCP 使用过程中可能遇到的问题及解决方法。

20.2.4.1 如何卸载 BVCP

如需卸载 BVCP，可参考官方文档（FreeBSD bhyve Project. Uninstallation of BVCP[EB/OL]. [2026-03-26]. https://bhyve.npulse.net/uninstall）。

20.2.5 参考文献

たかちゃん. bhyve を GUI で操作する BVCP の導入。[EB/OL]. running-dog.net, (2024-02-05)[2026-03-25]. https://running-dog.net/2024/02/post_2933.html. 提供了 BVCP 安装与配置的实用指南。
FreeBSD bhyve Project. How to install BVCP[EB/OL]. [2026-03-25]. https://bhyve.npulse.net/installation. 官方安装说明，详细指导了 BVCP 部署流程。
FreeBSD bhyve Project. TroubleShoot / Frequently Asked Questions (FAQ)[EB/OL]. [2026-03-25]. https://bhyve.npulse.net/technical. 常见疑难解答，提供故障排除方案。
FreeBSD bhyve Project. Deploy Virtual Machine (Windows)[EB/OL]. [2026-03-25]. https://bhyve.npulse.net/deploy_windows. 官方 Windows 安装说明，详述了 Windows 虚拟机部署。

20.2 使用 BVCP 通过 Web 界面管理 bhyve 虚拟机 ​

20.2.1 安装 BVCP ​

20.2.2 安装 Ubuntu 24.04 ​

20.2.3 安装 Windows 11 IoT Enterprise LTSC, version 24H2 (x64) - DVD (English) ​

20.2.4 故障排除与未竟事宜 ​

20.2.4.1 如何卸载 BVCP ​

20.2.5 参考文献 ​