From 70f2349129e197285e51451d216e3aec150fecb3 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 26 Sep 2026 06:27:25 +0800 Subject: [PATCH] Add host public IPv4 pool and automatic VM IP allocation --- README.md | 6 +- static/app.js | 90 +++++++++++--- static/index.html | 22 +++- static/styles.css | 3 + tests/test_app.py | 52 ++++++++- tests/test_database.py | 12 ++ tests/test_public_ip_pool.py | 75 ++++++++++++ tests/test_registration_http.py | 187 +++++++++++++++++++++++++++++ tests/test_remote_host.py | 30 +++++ virsh_panel/app.py | 201 ++++++++++++++++++++++++++++++-- virsh_panel/database.py | 11 +- virsh_panel/remote_host.py | 105 +++++++++++++++++ 12 files changed, 760 insertions(+), 34 deletions(-) create mode 100644 tests/test_public_ip_pool.py diff --git a/README.md b/README.md index 96e4288b..cb7b7973 100644 --- a/README.md +++ b/README.md @@ -64,7 +64,7 @@ SELECT id, username, email FROM users WHERE id = 1; 核对查询结果中的邮箱和管理员标志后,再刷新面板;权限会从数据库即时读取,不必重启。此后用邮箱登录,不能用用户名登录。不要把 `admin=1` 给公开注册用户。 3. 管理员在网页配置 SMTP 地址、端口、SSL/STARTTLS、发件邮箱及需要时的 SMTP 账号密码;设置加密保存在 MariaDB,页面不回显密码。完成后,访客可用邮箱验证码注册(10 分钟有效,重复发送与输错次数受限);邮箱验证成功即可登录,但须由管理员在“用户审核”批准后才能创建虚拟机。普通用户不能添加宿主机、导入云镜像模板、配置 SMTP 或更新面板,也看不到其他人的虚拟机和初始密码。面板外创建或管理员创建的未归属虚拟机仅管理员可见;当前没有从网页将旧 VM 分配给用户的功能。 -4. 在网页填写 B 的 IP/DNS、SSH 端口、虚拟机地区、现有的 **root 客户端 SSH 私钥**、磁盘目录、ISO 目录和网络名称。地区是这台宿主机上虚拟机共用的展示标签,可留空;它不影响 SSH 连接或已导入的模板。私钥必须与 B 的 root 账号**已经授权的公钥**匹配;仅有 root 密码或 B 的 SSH 主机密钥不能代替它。加密私钥还需填写其口令。保存宿主机设置时,面板会将口令与私钥加密写入 MariaDB,以便面板重启后自动连接和无人登录时继续采样;设置 API 不回显口令,面板代码也不将其写入浏览器存储。**旧版本中只在内存解锁过的口令无法自动恢复**:升级后进入“宿主机设置”,不必重新粘贴原私钥,填写原口令并重新保存一次。只在“解锁宿主机 SSH 私钥”页面输入不会持久保存。 +4. 在网页填写 B 的 IP/DNS、SSH 端口、虚拟机地区、现有的 **root 客户端 SSH 私钥**、磁盘目录、ISO 目录和网络名称。还可配置由服务商分配且已路由到该宿主机的**公网 IPv4 `/24` 地址池**、同网段网关、DNS,以及不能分配给虚拟机的保留地址。地区是这台宿主机上虚拟机共用的展示标签,可留空;它不影响 SSH 连接或已导入的模板。私钥必须与 B 的 root 账号**已经授权的公钥**匹配;仅有 root 密码或 B 的 SSH 主机密钥不能代替它。加密私钥还需填写其口令。保存宿主机设置时,面板会将口令与私钥加密写入 MariaDB,以便面板重启后自动连接和无人登录时继续采样;设置 API 不回显口令,面板代码也不将其写入浏览器存储。**旧版本中只在内存解锁过的口令无法自动恢复**:升级后进入“宿主机设置”,不必重新粘贴原私钥,填写原口令并重新保存一次。只在“解锁宿主机 SSH 私钥”页面输入不会持久保存。 5. 点击“扫描主机指纹”,再通过 B 的可信控制台运行 `ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub` 独立核对;确认后在网页测试、保存。保存前会重扫并测试 SSH 与 libvirt API,失败不会覆盖现有连接。 宿主机私钥、已填写的私钥口令和配置加密保存在 MariaDB。数据库备份与 `data/master.key` 同时泄露时,这些凭据可以被解密,因此须分别严密保护;运行中的 root 面板进程同样能使用它们。OpenSSH 连接时需要读取私钥文件,Linux 上面板会将其临时还原到权限为 `0700` 的 `/dev/shm` 内存文件系统目录;面板关闭时清除。`data/runtime-wrappers/` 只包含不带密钥的启动包装器。若 SSH agent 异常退出,后台采样会限频尝试使用已保存口令恢复连接;若保存的口令错误,仍需管理员检查并重新保存。面板仅支持单个 Uvicorn worker。 @@ -89,7 +89,9 @@ SELECT id, username, email FROM users WHERE id = 1; 面板的“创建虚拟机”现在有独立的“公网云镜像”方式。先在宿主机设置中选择已工作的 Linux 网桥,例如 `bridge:br0`;打开创建弹窗的“导入新的云镜像模板”,填写 [AlmaLinux 10 官方 Generic Cloud qcow2 镜像](https://wiki.almalinux.org/cloud/Generic-cloud)在 `https://repo.almalinux.org/almalinux/10/cloud/x86_64/images/` 下的下载地址、发布方 SHA-256 和模板显示名。地址必须是官方 HTTPS 直链,面板不会跟随重定向。面板服务器 A 需要能访问该地址。导入在后台运行,一次只允许一个任务,面板下载、校验 SHA-256 后通过当前 libvirt SSH 连接把模板镜像上传到 B 的磁盘池;无需登录 B 手工复制。模板目录记录加密保存在 MariaDB,绑定当前宿主机身份和磁盘池。不要在导入期间关闭面板进程;若进程异常退出,运行中的导入任务记录不会恢复,可能需要检查项目 `data/` 中的 `.cloud-image-*` 临时文件和 B 磁盘池中 `panel-template-*` 卷,不要未经核对就删除。 -选择模板后,填写 VM 资源、已分配给你的**具体公网 IPv4/CIDR**(如实际公网地址加 `/24` 或 `/28`)、同网段网关、1–4 个公网 DNS 地址,再选择一种 root 登录方式:填写 OpenSSH **公钥**时,只能用对应私钥登录 `root@<公网IP>`,密码输入会隐藏;不填公钥时,可以设置 12–128 字符的初始 root 密码,可用它从 VNC 和 SSH 登录;公钥和密码都不填时,面板会自动生成强初始 root 密码。客体登录密钥与连接宿主机的 root 私钥是两套独立凭据。面板会校验公网地址、网络/广播地址、网关和已由面板分配的重复 IP;它无法检测面板外设备的 IP 占用,也无法替服务商分配或路由公网 IP。当前版本只支持网关与 VM IP 同一子网的桥接 IPv4;服务商给出 `/32` 或异网段网关时不要强填,需另做路由网络模式。上游网络还必须允许 VM 使用额外 MAC,`br0` 本身不能保证公网可达。 +选择模板后填写 VM 资源和 root 登录方式。如果宿主机已配置公网 `/24` 地址池,创建时会自动选择一个尚未使用的地址,并沿用宿主机设置的网关和 DNS;用户不能在创建请求中另填 IP、网关或 DNS 来绕过地址池。面板会跳过网络地址、广播地址、网关、保留地址、宿主机自身的字面 IPv4,以及 libvirt 可见虚拟机元数据中的已用 IP,并防止面板并发创建分到相同地址。地址池用尽时创建会报错,不会复用仍占用的地址;面板删除 VM 后会释放其地址占用记录。旧宿主机若未配置地址池,仍可按原方式手填已分配给你的**具体公网 IPv4/CIDR**(如 `/24` 或 `/28`)、同网段网关和 1–4 个 DNS 地址。填写 OpenSSH **公钥**时,只能用对应私钥登录 `root@<公网IP>`,密码输入会隐藏;不填公钥时,可以设置 12–128 字符的初始 root 密码,可用它从 VNC 和 SSH 登录;公钥和密码都不填时,面板会自动生成强初始 root 密码。客体登录密钥与连接宿主机的 root 私钥是两套独立凭据。面板无法探测面板及 libvirt 元数据之外的设备是否占用地址,也无法替服务商分配或路由公网 IP;**不要把未由服务商分配或路由给你的整个 `/24` 填入地址池**。当前版本只支持网关与 VM IP 同一子网的桥接 IPv4;服务商给出 `/32` 或异网段网关时不要强填,需另做路由网络模式。上游网络还必须允许 VM 使用额外 MAC,`br0` 本身不能保证公网可达。 + +若 DNS 本身位于该 `/24` 中,它的地址也会自动跳过。面板创建成功后会保留 IP 占用记录,只有通过面板删除 VM 才自动释放;如果直接在宿主机或其他工具中删除 VM,旧占用记录会保守保留,避免误将该 IP 分给新 VM,需核查真实占用情况后再处理。 每个已登录用户都可导入并命名自己的**单行 OpenSSH 公钥**:已审核账号从侧栏“公钥管理”进入,等待审核的账号可用“管理我的公钥”入口。可以粘贴 `.pub` 文件内容,或在浏览器选择本地 `.pub` 文件填入表单;面板只接受公钥,不要选择或粘贴私钥。列表只显示当前账户导入的公钥;管理员账户也不能把另一个用户的公钥当作自己的预设公钥使用。创建公网云镜像 VM 时可以选择已导入的公钥,不必重复粘贴;也可以继续临时手动填写公钥,或选择初始 root 密码。预设公钥、手动公钥与密码不能同时使用。未通过管理员审核的用户可以管理自己的公钥,但仍不能创建虚拟机。删除公钥只删除面板中的预设记录,**不会撤销已经写入现有虚拟机的 SSH 授权密钥**;要撤销现有 VM 的访问权限,需在客体系统中删除对应的 `authorized_keys` 条目或重装并更换登录密钥。 diff --git a/static/app.js b/static/app.js index 7a6172bf..ab9e55d0 100644 --- a/static/app.js +++ b/static/app.js @@ -190,7 +190,7 @@ function stopPolling() { } function clearAdminContent() { - for (const id of ["smtp-host", "smtp-username", "smtp-password", "smtp-from-address", "host-address", "host-region", "host-storage-pool", "host-iso-pool", "host-network"]) byId(id).value = ""; + for (const id of ["smtp-host", "smtp-username", "smtp-password", "smtp-from-address", "host-address", "host-region", "host-storage-pool", "host-iso-pool", "host-network", "host-public-pool-cidr", "host-public-gateway", "host-public-dns", "host-public-reserved"]) byId(id).value = ""; byId("smtp-port").value = 465; byId("smtp-tls-mode").value = "ssl"; byId("smtp-status").hidden = true; @@ -390,6 +390,10 @@ function showHostView(hostConfig = { configured: false }) { byId("host-storage-pool").value = configured ? (hostConfig.storage_pool || "default") : "default"; byId("host-iso-pool").value = configured ? (hostConfig.iso_pool || "iso") : "iso"; byId("host-network").value = configured ? (hostConfig.default_network || "default") : "default"; + byId("host-public-pool-cidr").value = configured ? (hostConfig.public_pool_cidr || "") : ""; + byId("host-public-gateway").value = configured ? (hostConfig.public_gateway || "") : ""; + byId("host-public-dns").value = configured && Array.isArray(hostConfig.public_dns_servers) ? hostConfig.public_dns_servers.join(", ") : ""; + byId("host-public-reserved").value = configured && Array.isArray(hostConfig.public_reserved_ips) ? hostConfig.public_reserved_ips.join("\n") : ""; text("host-key-required-mark", configured ? "" : "*"); text("host-key-hint", configured ? "留空则继续使用已保存的私钥;填写或选择文件会替换它。已保存私钥不会回显。" @@ -945,6 +949,27 @@ function hostPayload() { if (!privateKey && !state.hostConfig?.private_key_configured) { throw new Error("首次连接需要提供宿主机 root 账号已有的 SSH 私钥。"); } + const publicPoolCidr = byId("host-public-pool-cidr").value.trim(); + const publicGateway = byId("host-public-gateway").value.trim(); + const publicDnsServers = byId("host-public-dns").value.split(/[\s,;]+/).filter(Boolean); + const publicReservedIps = [...new Set(byId("host-public-reserved").value.split(/[\s,;]+/).filter(Boolean))]; + if (!publicPoolCidr && (publicGateway || publicDnsServers.length || publicReservedIps.length)) { + throw new Error("填写公网网关、DNS 或保留地址时,必须先填写允许分配的 /24 网段;如需关闭地址池,请将这四项全部清空。"); + } + if (publicPoolCidr) { + if (!validPublicPoolCidr(publicPoolCidr)) { + throw new Error("公网地址池必须是服务商实际分配给该宿主机的可路由 IPv4 /24 网段地址,不可填写单台主机 IP 或示例保留网段。"); + } + if (!validPoolMember(publicGateway, publicPoolCidr)) { + throw new Error("公网地址池网关必须是该 /24 网段内有效的 IPv4 地址,且不能是网段或广播地址。"); + } + if (publicDnsServers.length < 1 || publicDnsServers.length > 4 || !publicDnsServers.every((address) => ipv4Parts(address))) { + throw new Error("公网地址池需配置 1 至 4 个有效的 DNS IPv4 地址。"); + } + if (!publicReservedIps.every((address) => validPoolMember(address, publicPoolCidr))) { + throw new Error("额外保留的 IP 必须是该 /24 网段内的有效主机地址,不能填写网段或广播地址。"); + } + } return { host, port, @@ -956,6 +981,10 @@ function hostPayload() { storage_pool: byId("host-storage-pool").value.trim(), iso_pool: byId("host-iso-pool").value.trim(), default_network: byId("host-network").value.trim(), + public_pool_cidr: publicPoolCidr, + public_gateway: publicGateway, + public_dns_servers: publicDnsServers, + public_reserved_ips: publicReservedIps, }; } @@ -1802,6 +1831,13 @@ function selectedCreateSource() { return document.querySelector('input[name="source"]:checked')?.value || "iso"; } +function configuredPublicPool() { + if (state.resources && Object.prototype.hasOwnProperty.call(state.resources, "public_pool_cidr")) { + return String(state.resources.public_pool_cidr || "").trim(); + } + return String(state.hostConfig?.public_pool_cidr || "").trim(); +} + function updateCreateAuthMode() { const cloud = selectedCreateSource() === "cloud"; const publicKey = byId("vm-guest-ssh-public-key"); @@ -1819,11 +1855,18 @@ function updateCreateAuthMode() { function updateCreateSource() { const cloud = selectedCreateSource() === "cloud"; + const publicPool = configuredPublicPool(); + const automaticPublicIp = cloud && Boolean(publicPool); byId("vm-iso-field").hidden = cloud; byId("vm-template-field").hidden = !cloud; byId("vm-cloud-fields").hidden = !cloud; byId("create-iso-tip").hidden = cloud; byId("create-cloud-tip").hidden = !cloud; + byId("vm-auto-public-pool").hidden = !automaticPublicIp; + text("vm-auto-public-pool-description", publicPool + ? `创建时将从 ${publicPool} 中选择未使用的公网 IP,并自动配置宿主机保存的网关和 DNS。` + : "创建时将从宿主机地址池中选择未使用的 IP,并自动写入网关和 DNS。"); + byId("vm-manual-public-network").hidden = automaticPublicIp; const iso = byId("vm-iso"); iso.required = !cloud; @@ -1835,8 +1878,8 @@ function updateCreateSource() { savedKey.disabled = !cloud || savedKey.options.length <= 1; ["vm-public-ip-cidr", "vm-gateway", "vm-dns"].forEach((id) => { const input = byId(id); - input.required = cloud; - input.disabled = !cloud; + input.required = cloud && !automaticPublicIp; + input.disabled = !cloud || automaticPublicIp; }); const publicKey = byId("vm-guest-ssh-public-key"); publicKey.required = false; @@ -2406,7 +2449,7 @@ byId("host-back-button").addEventListener("click", () => { }); byId("host-address").addEventListener("input", resetFingerprint); byId("host-port").addEventListener("input", resetFingerprint); -for (const id of ["host-region", "host-storage-pool", "host-iso-pool", "host-network"]) { +for (const id of ["host-region", "host-storage-pool", "host-iso-pool", "host-network", "host-public-pool-cidr", "host-public-gateway", "host-public-dns", "host-public-reserved"]) { byId(id).addEventListener("input", markHostTestStale); } byId("host-private-key").addEventListener("input", () => { @@ -2779,6 +2822,23 @@ function validPublicIpCidr(value) { return true; } +function validPublicPoolCidr(value) { + const match = /^([^/]+)\/24$/.exec(value); + const parts = match && ipv4Parts(match[1]); + if (!parts || parts[3] !== 0) return false; + if ((parts[0] === 192 && parts[1] === 0 && parts[2] === 2) + || (parts[0] === 198 && parts[1] === 51 && parts[2] === 100) + || (parts[0] === 203 && parts[1] === 0 && parts[2] === 113)) return false; + return validPublicIpCidr(`${parts[0]}.${parts[1]}.${parts[2]}.1/24`); +} + +function validPoolMember(value, publicPoolCidr) { + const parts = ipv4Parts(value); + const network = ipv4Parts(publicPoolCidr.split("/")[0]); + return Boolean(parts && network && parts[0] === network[0] && parts[1] === network[1] + && parts[2] === network[2] && parts[3] >= 1 && parts[3] <= 254); +} + function validGatewayForCidr(gateway, publicIpCidr) { const gatewayParts = ipv4Parts(gateway); const [ip, prefixText] = publicIpCidr.split("/"); @@ -2816,9 +2876,12 @@ byId("create-form").addEventListener("submit", async (event) => { if (source === "cloud") { body.source = "cloud"; body.template_id = String(data.get("template_id") || ""); - body.public_ip_cidr = String(data.get("public_ip_cidr") || "").trim(); - body.gateway = String(data.get("gateway") || "").trim(); - body.dns_servers = String(data.get("dns_servers") || "").split(/[\s,;]+/).filter(Boolean); + const automaticPublicIp = Boolean(configuredPublicPool()); + if (!automaticPublicIp) { + body.public_ip_cidr = String(data.get("public_ip_cidr") || "").trim(); + body.gateway = String(data.get("gateway") || "").trim(); + body.dns_servers = String(data.get("dns_servers") || "").split(/[\s,;]+/).filter(Boolean); + } const selectedKeyId = String(data.get("guest_ssh_key_id") || ""); if (selectedKeyId) { const keyId = Number(selectedKeyId); @@ -2838,15 +2901,15 @@ byId("create-form").addEventListener("submit", async (event) => { showError("create-error", "请先选择或导入云镜像模板。"); return; } - if (!validPublicIpCidr(body.public_ip_cidr)) { + if (!automaticPublicIp && !validPublicIpCidr(body.public_ip_cidr)) { showError("create-error", "请填写有效的公网 IPv4/CIDR,例如已分配给你的地址和 /24 或 /28 前缀;不能填写网段或广播地址。"); return; } - if (!validGatewayForCidr(body.gateway, body.public_ip_cidr)) { + if (!automaticPublicIp && !validGatewayForCidr(body.gateway, body.public_ip_cidr)) { showError("create-error", "请填写与虚拟机 IP 同网段的有效网关 IPv4,且不能与虚拟机 IP 相同。非同网段网关暂不支持。"); return; } - if (!body.dns_servers.length || body.dns_servers.length > 4 || !body.dns_servers.every((address) => ipv4Parts(address))) { + if (!automaticPublicIp && (!body.dns_servers.length || body.dns_servers.length > 4 || !body.dns_servers.every((address) => ipv4Parts(address)))) { showError("create-error", "请填写 1 至 4 个有效的 DNS IPv4 地址,用逗号或空格分隔。"); return; } @@ -2875,11 +2938,12 @@ byId("create-form").addEventListener("submit", async (event) => { setButtonBusy(button, true, "正在创建…"); try { const autoPassword = source === "cloud" && !body.guest_ssh_key_id && !body.guest_ssh_public_key && !body.root_password; - await api("/api/v1/vms", { method: "POST", body }); + const createdVm = await api("/api/v1/vms", { method: "POST", body }); closeModal(); + const createdIp = String(createdVm?.public_ip_cidr || "").split("/")[0]; toast(autoPassword - ? `虚拟机 ${body.name} 创建成功。初始 root 密码可在虚拟机详情页查看。` - : `虚拟机 ${body.name} 创建成功。`, "success"); + ? `虚拟机 ${body.name} 创建成功${createdIp ? `,公网 IP:${createdIp}` : ""}。初始 root 密码可在虚拟机详情页查看。` + : `虚拟机 ${body.name} 创建成功${createdIp ? `,公网 IP:${createdIp}` : ""}。`, "success"); await loadVMs(true); window.setTimeout(() => void loadVMs(true), 1200); } catch (error) { diff --git a/static/index.html b/static/index.html index 41fe14c4..ff1c6f4e 100644 --- a/static/index.html +++ b/static/index.html @@ -5,8 +5,8 @@ VirtPilot · 虚拟机管理 - - + +
@@ -164,6 +164,15 @@
可直接填写宿主机上的绝对路径,如 /home/kvm;也兼容现有 libvirt 存储池名称。
可直接填写宿主机上的绝对路径,如 /home/iso;不是面板服务器的路径。
libvirt 虚拟网络填名称;宿主机现有 Linux 网桥 br0 填 bridge:br0。
+
+
公网 IPv4 地址池仅用于云镜像虚拟机;配置后创建时由面板从该 /24 网段自动分配未占用的地址。请先确认这些公网 IP 已分配给该宿主机,并由上游网络允许虚拟机使用。
+
+
填写真实可路由的网段地址,不是某台虚拟机的 IP;留空则继续手动指定公网 IP。
+
网关不会被分配给虚拟机。
+
填写 1 至 4 个 DNS 地址,用逗号或空格分隔。
+
这些地址不会自动分配。请填写面板之外已占用的地址;若宿主机地址填的是域名,也请把宿主机自身的公网 IP 填在这里。
+
+
仅通过 HTTPS 传输并保存在面板服务器。请确保这把密钥已在宿主机 root 账号上获得授权。
未选择文件;已保存的密钥不会在这里显示。
保存时会加密写入面板数据库,供重启后自动连接和后台持续采样;面板不会回显口令或写入浏览器存储。
@@ -362,7 +371,7 @@