diff --git a/README.md b/README.md index cb7b7973..639fed27 100644 --- a/README.md +++ b/README.md @@ -89,9 +89,13 @@ 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 资源和 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` 本身不能保证公网可达。 +选择模板后填写 VM 资源和 root 登录方式。宿主机公网地址池支持实际获配的 `/24` 至 `/30` 前缀。例如服务商分配 `123.123.123.112/28`、宿主机网关为 `123.123.123.113` 时,在宿主机设置填写该 `/28` 网段(填写 `123.123.123.113/28` 也会规范化为 `123.123.123.112/28`),网关填 `123.123.123.113`,DNS 按服务商要求填写。自动分配只考虑此 `/28` 的有效主机地址;扣除网关后是 `123.123.123.114` 至 `123.123.123.126`,还会跳过保留、已用及池内 DNS 地址。**不要填写 `123.123.123.114/24` 或 `123.123.123.0/24`,除非服务商确实分配了整个 `/24`。**设置页会预览输入前缀换算出的实际网段和主机地址范围。 -若 DNS 本身位于该 `/24` 中,它的地址也会自动跳过。面板创建成功后会保留 IP 占用记录,只有通过面板删除 VM 才自动释放;如果直接在宿主机或其他工具中删除 VM,旧占用记录会保守保留,避免误将该 IP 分给新 VM,需核查真实占用情况后再处理。 +“虚拟机网卡前缀”与可分配地址池是独立设置:留空时客体使用地址池前缀;如果现场确认服务商要求 VM 内配置 `/24`,而实际只获配上述 `/28`,这里填 `24`,新建 VM 将获得例如 `123.123.123.114/24`,但面板仍只会从 `123.123.123.112/28` 挑选地址。可填写的客体前缀范围为 `/24` 到地址池前缀,以确保整个地址池中的 IP 与网关处于同一客体子网。修改此项不会自动改写已创建 VM;云镜像重装会保留该 VM 首次创建时的网络前缀。若使用 `/28` 不通,其具体原因仍需结合宿主机路由、网桥及服务商网络确认;仅改变面板掩码无法替代上游放行或路由配置。 + +配置地址池后,创建时会自动选择一个尚未使用的地址,并沿用宿主机设置的网关和 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。当前版本只支持网关与 VM IP 同一子网的桥接 IPv4;服务商给出 `/32` 或异网段网关时不要强填,需另做路由网络模式。上游网络还必须允许 VM 使用额外 MAC,`br0` 本身不能保证公网可达。 + +若 DNS 本身位于该地址池中,它的地址也会自动跳过。面板创建成功后会保留 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 ab9e55d0..ec42ca21 100644 --- a/static/app.js +++ b/static/app.js @@ -190,7 +190,8 @@ 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", "host-public-pool-cidr", "host-public-gateway", "host-public-dns", "host-public-reserved"]) 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-vm-prefix", "host-public-dns", "host-public-reserved"]) byId(id).value = ""; + refreshPublicPoolPreview(); byId("smtp-port").value = 465; byId("smtp-tls-mode").value = "ssl"; byId("smtp-status").hidden = true; @@ -391,7 +392,9 @@ function showHostView(hostConfig = { configured: false }) { 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 || "") : ""; + refreshPublicPoolPreview(); byId("host-public-gateway").value = configured ? (hostConfig.public_gateway || "") : ""; + byId("host-public-vm-prefix").value = configured && Number.isInteger(hostConfig.public_vm_prefix) ? String(hostConfig.public_vm_prefix) : ""; 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 ? "" : "*"); @@ -951,23 +954,29 @@ function hostPayload() { } const publicPoolCidr = byId("host-public-pool-cidr").value.trim(); const publicGateway = byId("host-public-gateway").value.trim(); + const publicVmPrefixText = byId("host-public-vm-prefix").value.trim(); + const publicVmPrefix = publicVmPrefixText ? Number(publicVmPrefixText) : null; 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 && (publicGateway || publicVmPrefix !== null || publicDnsServers.length || publicReservedIps.length)) { + throw new Error("填写公网网关、虚拟机网卡前缀、DNS 或保留地址时,必须先填写服务商分配的公网网段;如需关闭地址池,请将这些项全部清空。"); } if (publicPoolCidr) { - if (!validPublicPoolCidr(publicPoolCidr)) { - throw new Error("公网地址池必须是服务商实际分配给该宿主机的可路由 IPv4 /24 网段地址,不可填写单台主机 IP 或示例保留网段。"); + const pool = parsePublicPool(publicPoolCidr); + if (!pool) { + throw new Error("公网地址池请填写服务商实际分配的 IPv4 网段(/24 至 /30),例如 123.123.123.112/28;/28 可填段内网关/前缀并自动换算,/24 必须填写网段起始地址。"); + } + if (publicVmPrefix !== null && (!Number.isInteger(publicVmPrefix) || publicVmPrefix < 24 || publicVmPrefix > pool.prefix)) { + throw new Error(`虚拟机网卡前缀须介于 /24 和地址池前缀 /${pool.prefix} 之间;留空则使用 /${pool.prefix}。`); } if (!validPoolMember(publicGateway, publicPoolCidr)) { - throw new Error("公网地址池网关必须是该 /24 网段内有效的 IPv4 地址,且不能是网段或广播地址。"); + throw new Error("公网地址池网关必须是该网段内有效的 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 网段内的有效主机地址,不能填写网段或广播地址。"); + throw new Error("额外保留的 IP 必须是该网段内的有效主机地址,不能填写网段或广播地址。"); } } return { @@ -983,6 +992,7 @@ function hostPayload() { default_network: byId("host-network").value.trim(), public_pool_cidr: publicPoolCidr, public_gateway: publicGateway, + public_vm_prefix: publicVmPrefix, public_dns_servers: publicDnsServers, public_reserved_ips: publicReservedIps, }; @@ -1856,6 +1866,8 @@ function updateCreateAuthMode() { function updateCreateSource() { const cloud = selectedCreateSource() === "cloud"; const publicPool = configuredPublicPool(); + const guestPrefix = state.resources?.public_vm_prefix + ?? state.hostConfig?.public_vm_prefix ?? parsePublicPool(publicPool)?.prefix; const automaticPublicIp = cloud && Boolean(publicPool); byId("vm-iso-field").hidden = cloud; byId("vm-template-field").hidden = !cloud; @@ -1864,7 +1876,7 @@ function updateCreateSource() { byId("create-cloud-tip").hidden = !cloud; byId("vm-auto-public-pool").hidden = !automaticPublicIp; text("vm-auto-public-pool-description", publicPool - ? `创建时将从 ${publicPool} 中选择未使用的公网 IP,并自动配置宿主机保存的网关和 DNS。` + ? `创建时仅从 ${publicPool} 中选择未使用的公网 IP${guestPrefix ? `,虚拟机网卡使用 /${guestPrefix}` : ""},并自动配置宿主机保存的网关和 DNS。` : "创建时将从宿主机地址池中选择未使用的 IP,并自动写入网关和 DNS。"); byId("vm-manual-public-network").hidden = automaticPublicIp; @@ -2449,9 +2461,10 @@ 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", "host-public-pool-cidr", "host-public-gateway", "host-public-dns", "host-public-reserved"]) { +for (const id of ["host-region", "host-storage-pool", "host-iso-pool", "host-network", "host-public-pool-cidr", "host-public-gateway", "host-public-vm-prefix", "host-public-dns", "host-public-reserved"]) { byId(id).addEventListener("input", markHostTestStale); } +byId("host-public-pool-cidr").addEventListener("input", refreshPublicPoolPreview); byId("host-private-key").addEventListener("input", () => { if (state.uploadedPrivateKey) { state.uploadedPrivateKey = ""; @@ -2801,6 +2814,10 @@ function ipv4Number(parts) { return parts.reduce((accumulator, part) => ((accumulator << 8) | part) >>> 0, 0); } +function ipv4Text(number) { + return [number >>> 24, (number >>> 16) & 255, (number >>> 8) & 255, number & 255].join("."); +} + function validPublicIpCidr(value) { const match = /^([^/]+)\/(\d{1,2})$/.exec(value); if (!match) return false; @@ -2822,21 +2839,42 @@ function validPublicIpCidr(value) { return true; } -function validPublicPoolCidr(value) { - const match = /^([^/]+)\/24$/.exec(value); +function parsePublicPool(value) { + const match = /^([^/]+)\/(\d{1,2})$/.exec(value); const parts = match && ipv4Parts(match[1]); - if (!parts || parts[3] !== 0) return false; + const prefix = match && Number(match[2]); + if (!parts || prefix < 24 || prefix > 30) return null; 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`); + || (parts[0] === 203 && parts[1] === 0 && parts[2] === 113)) return null; + const mask = (0xffffffff << (32 - prefix)) >>> 0; + const inputAddress = ipv4Number(parts); + const network = (inputAddress & mask) >>> 0; + if (prefix === 24 && inputAddress !== network) return null; + const broadcast = (network | (~mask >>> 0)) >>> 0; + if (!validPublicIpCidr(`${ipv4Text(network + 1)}/${prefix}`) + || !validPublicIpCidr(`${ipv4Text(broadcast - 1)}/${prefix}`)) return null; + return { network, broadcast, prefix, cidr: `${ipv4Text(network)}/${prefix}` }; +} + +function refreshPublicPoolPreview() { + const value = byId("host-public-pool-cidr").value.trim(); + const pool = parsePublicPool(value); + const preview = byId("host-public-pool-preview"); + preview.hidden = !pool; + if (pool) { + preview.textContent = `实际网段:${pool.cidr};主机地址范围:${ipv4Text(pool.network + 1)}–${ipv4Text(pool.broadcast - 1)}。网关、保留和已用地址不会分配。`; + } else { + preview.textContent = ""; + } } 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); + const pool = parsePublicPool(publicPoolCidr); + if (!parts || !pool) return false; + const address = ipv4Number(parts); + return address > pool.network && address < pool.broadcast; } function validGatewayForCidr(gateway, publicIpCidr) { diff --git a/static/index.html b/static/index.html index ff1c6f4e..31f5628e 100644 --- a/static/index.html +++ b/static/index.html @@ -5,8 +5,8 @@