正在连接控制面板…
VirtPilot
FIRST RUN SETUP

先连接数据库,
再开始管理。

面板业务数据保存在 MariaDB 中。只需在首次启用时填写连接信息,无需预先编辑面板配置文件。

01 · 配置数据库02 · 创建初始用户03 · 授予管理员权限
步骤 01 / 03

连接 MariaDB

请先准备可连接的数据库与账号。连接信息只提交给面板服务,不会保存在浏览器中。

请先完成你自己的 HTTPS 反向代理,并核对证书和域名,再输入数据库密码与初始化令牌。

数据库需由你预先创建并授权;面板不会自动安装 MariaDB。初始化令牌完成初始用户创建后失效。

VirtPilot
FIRST RUN SETUP

欢迎使用
VirtPilot

完成数据库连接后先创建初始用户,再由你在数据库中将其 admin 字段改为管理员权限。

01 · 配置数据库02 · 创建初始用户03 · 授予管理员权限
步骤 02 / 03

创建初始用户

使用面板首次启动时在终端输出的一次性初始化令牌。完成后令牌将失效。

安全检查:请先完成你自己的 HTTPS 反向代理,并确认浏览器连接的是你信任的证书和域名,再输入令牌、密码或宿主机私钥。

初始用户默认没有管理员权限。创建后请由你在数据库中将该用户 admin 字段设为 1,并手动补充登录邮箱,再用邮箱登录配置 SMTP 和宿主机。面板账号与宿主机 root 账号相互独立。

VirtPilot
ACCOUNT STATUS

等待管理员审核

邮箱已验证,账号正在等待管理员审核。审核通过后才能创建和管理虚拟机。

VirtPilot
步骤 03 / 03

连接 libvirt 宿主机

填入现有的 root SSH 信息,面板将通过 libvirt API 管理远端虚拟机。

1

SSH 连接信息

使用宿主机已有的 root 私钥,不创建额外的系统账号。

用于展示这台宿主机上的虚拟机所在地区;留空时显示“未设置”。
可直接填写宿主机上的绝对路径,如 /home/kvm;也兼容现有 libvirt 存储池名称。
供创建虚拟机安装系统时选择;填写宿主机上的绝对路径,如 /home/iso,或现有存储池名称。
专供上传救援模版使用,不能与安装 ISO 目录相同,也不要通过软链接或绑定挂载指向同一目录。请先在宿主机创建目录;面板只注册已存在的目录,不会自动创建。
libvirt 虚拟网络填名称;宿主机现有 Linux 网桥 br0 填 bridge:br0。
公网 IPv4 地址池仅用于云镜像虚拟机;配置后面板只从填写的服务商获配网段自动分配地址。请按真实前缀填写,不要把仅获配的 /28 误填成 /24。
可填网段或段内地址/前缀,例如 123.123.123.113/28 会保存为 123.123.123.112/28;留空则手动指定公网 IP。
网关不会被分配给虚拟机。
只影响虚拟机内的网络掩码,不扩大可分配 IP 范围。如果你的服务商要求客体使用 /24,而获配地址池是 /28,这里填 24。
填写 1 至 4 个 DNS 地址,用逗号或空格分隔。
这些地址不会自动分配。请填写面板之外已占用的地址;若宿主机地址填的是域名,也请把宿主机自身的公网 IP 填在这里。
仅通过 HTTPS 传输并保存在面板服务器。请确保这把密钥已在宿主机 root 账号上获得授权。
未选择文件;已保存的密钥不会在这里显示。
保存时会加密写入面板数据库,供重启后自动连接和后台持续采样;面板不会回显口令或写入浏览器存储。
2

核对 SSH 主机指纹

先扫描面板看到的公钥,再与宿主机控制台显示的指纹对比。

请在宿主机 B 的控制台执行 ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub 并逐字核对。当前仅支持 Ed25519 主机密钥;不要仅凭网页显示就信任该指纹。

3

测试并保存

测试 root SSH、libvirt、存储池和虚拟网络是否可用。

尚未测试连接

root 私钥拥有很高权限。请保护面板管理员密码,仅通过 HTTPS 访问面板,并限制能访问面板的网络范围。

VirtPilot
HOST KEY LOCKED

解锁宿主机 SSH 私钥

宿主机 的私钥尚未自动解锁。请输入口令以恢复连接;若要重启后自动连接,请随后在“宿主机设置”中重新保存口令。

在这里输入只用于本次解锁;在“宿主机设置”重新保存后,口令会加密写入数据库供后台使用。面板不会将口令写入浏览器存储;请通过 HTTPS 连接面板。