function el(tag, className = '', text) { const node = document.createElement(tag); node.className = className; if (text !== undefined) node.textContent = String(text); return node; } function text(...values) { return values.find(value => value !== null && value !== undefined && String(value).trim() !== '') ?? '—'; } function copyButton(value, label = '复制') { const button = el('button', 'btn btn-light btn-sm'); button.type = 'button'; button.dataset.copy = String(value); button.setAttribute('aria-label', `${label} ${value}`); const icon = el('i', 'mdi mdi-content-copy'); icon.setAttribute('aria-hidden', 'true'); button.append(icon); return button; } function parseIPv4(value) { const parts = String(value ?? '').trim().split('.'); if (parts.length !== 4 || parts.some(part => !/^\d{1,3}$/.test(part))) return null; const octets = parts.map(Number); return octets.every(part => part >= 0 && part <= 255) ? octets : null; } function ipv4Number(octets) { return (((octets[0] << 24) >>> 0) + (octets[1] << 16) + (octets[2] << 8) + octets[3]) >>> 0; } function normalizeCidr(value, fallbackPrefix = 24) { const raw = String(value ?? '').trim(); if (!raw) return null; const parts = raw.split('/'); if (parts.length > 2 || (parts.length === 2 && !/^\d+$/.test(parts[1]))) return null; const octets = parseIPv4(parts[0]); if (!octets) return null; const prefix = parts.length === 2 && parts[1] !== '' ? Number(parts[1]) : Number(fallbackPrefix); if (!Number.isInteger(prefix) || prefix < 1 || prefix > 30) return null; return { address: octets.join('.'), prefix, value: `${octets.join('.')}/${prefix}` }; } function cidrContains(cidr, address) { const network = normalizeCidr(cidr, null); const ip = parseIPv4(address); if (!network || !ip) return false; const mask = network.prefix === 32 ? 0xffffffff : (0xffffffff << (32 - network.prefix)) >>> 0; return (ipv4Number(parseIPv4(network.address)) & mask) === (ipv4Number(ip) & mask); } function publicPoolKey(value) { const key = String(value ?? '').trim(); return /^[a-f0-9]{32}$/.test(key) ? key : ''; } function parseIPv6(value) { const raw = String(value ?? '').trim().toLowerCase(); if (!raw || raw.includes('%') || !/^[0-9a-f:]+$/.test(raw) || (raw.match(/::/g) || []).length > 1) return null; const halves = raw.split('::'); const left = halves[0] ? halves[0].split(':') : []; const right = halves.length === 2 && halves[1] ? halves[1].split(':') : []; if ([...left, ...right].some(part => !/^[0-9a-f]{1,4}$/.test(part))) return null; const missing = 8 - left.length - right.length; if ((halves.length === 1 && missing !== 0) || (halves.length === 2 && missing < 1)) return null; const words = [...left, ...Array(Math.max(0, missing)).fill('0'), ...right].map(part => Number.parseInt(part, 16)); return words.length === 8 && words.every(part => Number.isInteger(part) && part >= 0 && part <= 0xffff) ? words : null; } function ipv6Number(words) { return words.reduce((value, word) => (value << 16n) | BigInt(word), 0n); } function normalizeIPv6Cidr(value, fallbackPrefix = 64) { const raw = String(value ?? '').trim(); if (!raw) return null; const parts = raw.split('/'); if (parts.length > 2 || (parts.length === 2 && !/^\d+$/.test(parts[1]))) return null; const words = parseIPv6(parts[0]); const prefix = parts.length === 2 ? Number(parts[1]) : Number(fallbackPrefix); if (!words || !Number.isInteger(prefix) || prefix < 1 || prefix > 128) return null; return { address: parts[0].toLowerCase(), prefix, value: `${parts[0].toLowerCase()}/${prefix}`, number: ipv6Number(words) }; } function ipv6CidrContains(cidr, address) { const network = normalizeIPv6Cidr(cidr, null); const target = parseIPv6(String(address ?? '').split('/')[0]); if (!network || !target) return false; const shift = 128n - BigInt(network.prefix); return (network.number >> shift) === (ipv6Number(target) >> shift); } function normalizeAddressCidr(value, family, fallbackPrefix = family === 4 ? 24 : 64) { return family === 4 ? normalizeCidr(value, fallbackPrefix) : normalizeIPv6Cidr(value, fallbackPrefix); } function currentNetworkFromVm(vm = {}) { const source = vm.public_network && typeof vm.public_network === 'object' ? vm.public_network : {}; const ipv4 = normalizeCidr(source.ipv4?.address_cidr || vm.public_ipv4_cidr || vm.public_ip_cidr || vm.public_ipv4 || vm.public_ip, 24); const ipv6 = normalizeIPv6Cidr(source.ipv6?.address_cidr || vm.public_ipv6_cidr || vm.public_ipv6, 64); return { ipv4: { pool_key: publicPoolKey(source.ipv4?.pool_key), address_cidr: ipv4?.value || '' }, ipv6: { pool_key: publicPoolKey(source.ipv6?.pool_key), address_cidr: ipv6?.value || '' }, }; } function normalizePool(value, family) { if (!value || typeof value !== 'object' || Array.isArray(value)) return null; const poolKey = publicPoolKey(value.pool_key || value.public_pool_key); const poolCidr = normalizeAddressCidr(value.pool_cidr || value.cidr, family, null); const guestPrefix = Number(value.guest_prefix ?? value.prefix_length ?? poolCidr?.prefix); if (!poolKey || !poolCidr || !Number.isInteger(guestPrefix) || guestPrefix !== poolCidr.prefix || guestPrefix > (family === 4 ? 30 : 120)) return null; const pool = { pool_key: poolKey, pool_cidr: poolCidr.value, guest_prefix: guestPrefix, gateway: String(value.gateway || '').trim(), dns_servers: Array.isArray(value.dns_servers) ? value.dns_servers.map(item => String(item).trim()).filter(Boolean) : [], sparse: family === 6 && value.sparse === true, allocation_start: '', allocation_end: '', allocation_start_number: null, allocation_end_number: null, excluded_addresses: [], excluded_address_numbers: [], available_options: [], }; if (family === 4) { const seen = new Set(); for (const option of Array.isArray(value.available_options) ? value.available_options : []) { const cidr = normalizeCidr(option?.address_cidr || option?.public_ip_cidr, guestPrefix); if (!cidr || cidr.prefix !== guestPrefix || !cidrContains(pool.pool_cidr, cidr.address) || seen.has(cidr.value)) continue; seen.add(cidr.value); pool.available_options.push({ address_cidr: cidr.value }); } } else { const start = parseIPv6(value.allocation_start); const end = parseIPv6(value.allocation_end); const excluded = Array.isArray(value.excluded_addresses) ? value.excluded_addresses.map(item => parseIPv6(item)) : null; if (!pool.sparse || !start || !end || !excluded || excluded.some(item => !item) || !ipv6CidrContains(pool.pool_cidr, value.allocation_start) || !ipv6CidrContains(pool.pool_cidr, value.allocation_end)) return null; pool.allocation_start_number = ipv6Number(start); pool.allocation_end_number = ipv6Number(end); if (pool.allocation_start_number > pool.allocation_end_number) return null; pool.allocation_start = String(value.allocation_start).trim().toLowerCase(); pool.allocation_end = String(value.allocation_end).trim().toLowerCase(); pool.excluded_addresses = value.excluded_addresses.map(item => String(item).trim().toLowerCase()); pool.excluded_address_numbers = excluded.map(ipv6Number); } return pool; } function normalizeAttachment(value, currentAttachmentId) { if (!value || typeof value !== 'object' || Array.isArray(value)) return null; const attachmentId = String(value.attachment_id ?? '').trim(); if (!/^[1-9]\d*$/.test(attachmentId)) return null; const families = {}; for (const [name, family] of [['ipv4', 4], ['ipv6', 6]]) { const pools = []; for (const poolValue of Array.isArray(value[name]?.pools) ? value[name].pools : []) { const pool = normalizePool(poolValue, family); if (pool) pools.push(pool); } families[name] = { pools }; } return { attachment_id: attachmentId, label: String(value.label || value.network_selector || `网络接入 #${attachmentId}`).trim(), current: value.current === true || attachmentId === currentAttachmentId, ...families, }; } function networkOptionsFromVm(vm = {}) { return { current_public_network: currentNetworkFromVm(vm), current_attachment_id: '', attachments: [], configuration_state: 'not_configured', can_change: false, active_job: vm.active_job || null, message: '', }; } export function normalizeAdminNetworkOptions(payload, vm = {}) { const source = payload?.network_options || payload?.network || payload || {}; const fallback = networkOptionsFromVm(vm); const snapshot = source.current_public_network && typeof source.current_public_network === 'object' ? source.current_public_network : (source.public_network || {}); const current = currentNetworkFromVm({ ...vm, public_network: snapshot }); const requestedCurrent = String(source.current_attachment_id ?? '').trim(); const rawAttachments = Array.isArray(source.attachments) ? source.attachments : []; let currentAttachmentId = /^[1-9]\d*$/.test(requestedCurrent) ? requestedCurrent : ''; let attachments = rawAttachments.map(value => normalizeAttachment(value, currentAttachmentId)).filter(Boolean); if (!currentAttachmentId) currentAttachmentId = attachments.find(value => value.current)?.attachment_id || ''; attachments = attachments.map(value => ({ ...value, current: value.attachment_id === currentAttachmentId })); const state = ['ready', 'not_configured', 'invalid', 'drift', 'unavailable'] .includes(source.configuration_state) ? source.configuration_state : 'unavailable'; const hasCandidate = attachments.some((attachment) => { const hasIpv4 = attachment.ipv4.pools.some(pool => pool.available_options.length > 0); const hasIpv6 = attachment.ipv6.pools.some(pool => pool.sparse); return attachment.current ? (hasIpv4 || hasIpv6) : (hasIpv4 && hasIpv6); }); return { ...fallback, current_public_network: current, current_attachment_id: currentAttachmentId, attachments, configuration_state: state, can_change: source.can_change === true && state === 'ready' && hasCandidate, active_job: source.active_job || fallback.active_job, message: String(source.message || ''), }; } function encodedIpv4Target(poolKey, cidr) { return `${poolKey}|${cidr}`; } function attachmentById(options, id) { return (options.attachments || []).find(value => value.attachment_id === String(id)); } export function buildAdminNetworkTargets(options, values = {}) { if (options?.can_change !== true || options.configuration_state !== 'ready') { throw new Error('宿主机网络配置尚未就绪,暂不能更换公网地址。'); } const attachment = attachmentById(options, values.attachment_id); if (!attachment) throw new Error('请选择有效的目标网络接入。'); const crossAttachment = attachment.attachment_id !== options.current_attachment_id; const targets = {}; const ipv4Value = String(values.ipv4_target || '').trim(); if (ipv4Value) { const separator = ipv4Value.indexOf('|'); const poolKey = publicPoolKey(ipv4Value.slice(0, separator)); const cidr = normalizeCidr(ipv4Value.slice(separator + 1), null); const pool = attachment.ipv4.pools.find(item => item.pool_key === poolKey); const available = pool && cidr && pool.available_options.some(item => item.address_cidr === cidr.value); if (!pool || !cidr || !available) throw new Error('请选择列表中的可用 IPv4 地址。'); if (cidr.value === options.current_public_network.ipv4.address_cidr) throw new Error('新 IPv4 与当前地址相同。'); targets.ipv4 = { pool_key: poolKey, address_cidr: cidr.value }; } const ipv6PoolKey = publicPoolKey(values.ipv6_pool_key); const ipv6Raw = String(values.ipv6_address_cidr || '').trim(); if (ipv6PoolKey || ipv6Raw) { if (!ipv6PoolKey || !ipv6Raw) throw new Error('选择 IPv6 地址池后必须填写完整的 IPv6 CIDR。'); const pool = attachment.ipv6.pools.find(item => item.pool_key === ipv6PoolKey); const cidr = normalizeIPv6Cidr(ipv6Raw, pool?.guest_prefix); if (!pool || !pool.sparse || !cidr || cidr.prefix !== pool.guest_prefix || !ipv6CidrContains(pool.pool_cidr, cidr.address)) { throw new Error('IPv6 地址必须属于所选地址池,并使用该地址池的前缀。'); } if (cidr.number < pool.allocation_start_number || cidr.number > pool.allocation_end_number) { throw new Error('IPv6 地址必须位于所选地址池的可分配范围内。'); } if (pool.excluded_address_numbers.some(value => value === cidr.number)) { throw new Error('IPv6 地址属于网关、DNS、保留或管理地址,不能分配。'); } const current = normalizeIPv6Cidr(options.current_public_network.ipv6.address_cidr, cidr.prefix); if (current && current.number === cidr.number && current.prefix === cidr.prefix) throw new Error('新 IPv6 与当前地址相同。'); targets.ipv6 = { pool_key: ipv6PoolKey, address_cidr: cidr.value }; } if (crossAttachment && (!targets.ipv4 || !targets.ipv6)) { throw new Error('切换网络接入时必须同时指定新的 IPv4 和 IPv6。'); } if (!targets.ipv4 && !targets.ipv6) throw new Error('请至少选择一项要更换的公网地址。'); return { attachment, targets }; } export function createAdminInstanceConfiguration({ byId, actions, onNotice, onRefresh, } = {}) { if (typeof byId !== 'function' || typeof actions?.enqueue !== 'function') { throw new TypeError('Instance configuration dependencies are incomplete'); } const { read, enqueue, blockMessage } = actions; const state = { currentId: null, networkRequest: null, networkOptionsRequest: null, networkObserver: null, networkSerial: 0, settingsRequest: null, settingsObserver: null, settingsSerial: 0, }; function setNetworkFeedback(section, message, tone = 'muted') { const node = section?.querySelector('.admin-instance-network-feedback'); if (!node) return; node.hidden = !message; node.className = `admin-instance-network-feedback text-${tone} fs-13 mb-2`; node.textContent = message || ''; } function setSettingsFeedback(section, message, tone = 'muted') { const node = section?.querySelector('[data-settings-feedback]'); if (!node) return; node.hidden = !message; node.className = `admin-instance-settings-feedback text-${tone} fs-13 mb-2`; node.textContent = message || ''; } function cancelNetwork(reason = 'cancelled') { state.networkOptionsRequest?.abort(reason); state.networkRequest?.abort(reason); state.networkOptionsRequest = null; state.networkRequest = null; state.networkObserver?.stop(reason); state.networkObserver = null; state.networkSerial += 1; } function cancelSettings(reason = 'cancelled') { state.settingsRequest?.abort(reason); state.settingsRequest = null; state.settingsObserver?.stop(reason); state.settingsObserver = null; state.settingsSerial += 1; } function cancel(reason = 'cancelled') { cancelNetwork(reason); cancelSettings(reason); state.currentId = null; } function settingsFormValues(form) { const hostname = String(form.elements.namedItem('hostname')?.value || '').trim().toLowerCase(); const password = String(form.elements.namedItem('root_password')?.value || ''); const confirmation = String(form.elements.namedItem('root_password_confirmation')?.value || ''); const publicKey = String(form.elements.namedItem('ssh_public_key')?.value || '').trim(); if (!hostname && !password && !publicKey) throw new Error('请至少填写一项要修改的实例设置。'); if (hostname && !/^(?=.{1,253}$)[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)*$/.test(hostname)) { throw new Error('主机名只能包含英文、数字、连字符和点,每段不能以连字符开头或结尾,最多 253 个字符。'); } if (password || confirmation) { if (!password) throw new Error('请输入新的实例密码。'); if (password !== confirmation) throw new Error('两次输入的实例密码不一致。'); if (password.length < 12 || password.length > 128 || !/^[\x21-\x7e]+$/.test(password) || !/[A-Z]/.test(password) || !/[a-z]/.test(password) || !/[0-9]/.test(password) || !/[^A-Za-z0-9]/.test(password)) { throw new Error('实例密码需为 12 至 128 位可打印字符,并包含大写、小写、数字和符号。'); } } if (publicKey) { if (publicKey.length > 16384 || /[\r\n\x00-\x1f\x7f]/.test(publicKey)) { throw new Error('SSH 公钥必须是一行且不能包含控制字符。'); } if (!/^(?:ssh-ed25519|ssh-rsa|ecdsa-sha2-nistp256|ecdsa-sha2-nistp384|ecdsa-sha2-nistp521)\s+[A-Za-z0-9+/]+={0,3}(?:\s+[^\r\n]*)?$/.test(publicKey)) { throw new Error('请输入有效的单行 OpenSSH 公钥,不要粘贴私钥。'); } } const body = { confirm_restart: true }; if (hostname) body.hostname = hostname; if (password) body.root_password = password; if (publicKey) body.ssh_public_key = publicKey; return body; } function settingsSetBusy(form, busy) { for (const control of form.querySelectorAll('input, textarea, button')) control.disabled = busy; } function unlockSettingsForm(form, activeJob = false) { if (!form) return; for (const control of form.querySelectorAll('input, textarea, button')) control.disabled = activeJob; } function pollSettingsJob(vm, section, result) { const serial = state.settingsSerial; const jobId = result?.task_id ?? ''; const handle = actions.watch(result, { title: '修改实例设置', onUpdate: () => { if (serial === state.settingsSerial && state.currentId === String(vm.id)) { setSettingsFeedback(section, `任务 #${jobId} 正在后台执行。`, 'muted'); } }, onResult: ({ succeeded, message }) => { if (serial !== state.settingsSerial || state.currentId !== String(vm.id)) return; state.settingsObserver = null; void (async () => { await onRefresh?.(vm.id); onNotice?.(message, !succeeded); })(); }, onStop: reason => { if (state.settingsObserver === handle) state.settingsObserver = null; if (reason === 'pagehide' || serial !== state.settingsSerial) return; void (async () => { await onRefresh?.(vm.id); onNotice?.(`任务 #${jobId} 自动观察已停止,已按服务端最新状态更新设置入口;请在任务记录刷新最终结果。`, true); })(); }, }); if (!handle.url) { setSettingsFeedback(section, '任务已接收,但任务回执协议无效。请勿再次提交,并联系管理员核查。', 'danger'); return; } state.settingsObserver = handle; } function settingsEditor(vm) { const template = byId('admin-instance-settings-controls'); const controls = template?.content?.cloneNode(true); const section = controls?.querySelector('[data-instance-settings]'); if (!section) return el('section'); const form = section.querySelector('[data-instance-settings-form]'); const current = section.querySelector('[data-settings-current-hostname]'); if (current) current.textContent = `当前主机名:${text(vm.guest_hostname, vm.hostname, '未记录')}`; if (!form) return section; if (vm.instance_settings_supported !== true) { form.remove(); const description = section.querySelector('.admin-instance-settings-heading p'); if (description) { description.className = 'text-warning fs-13 mb-0'; description.textContent = vm.instance_status && vm.instance_status !== 'active' ? `当前实例处于“${text(vm.display?.lifecycle, vm.instance_status)}”状态,暂不能修改主机名、密码或 SSH 公钥。` : '当前实例缺少已验证的面板云镜像元数据,暂不能修改主机名、密码或 SSH 公钥。请先核对实例元数据。'; } return section; } const mutationBlocked = vm.active_job?.blocks_mutation === true; if (mutationBlocked) { unlockSettingsForm(form, true); setSettingsFeedback(section, blockMessage(vm.active_job, '修改实例设置'), 'warning'); } form.addEventListener('submit', async event => { event.preventDefault(); if (state.settingsRequest || mutationBlocked) return; let body; try { body = settingsFormValues(form); if (!form.elements.namedItem('confirm_restart')?.checked) throw new Error('请先确认实例会重启。'); } catch (error) { setSettingsFeedback(section, error.message, 'danger'); return; } const controller = new AbortController(); state.settingsRequest = controller; settingsSetBusy(form, true); setSettingsFeedback(section, '正在创建实例设置任务,请勿重复提交…', 'muted'); try { const result = await enqueue(`/api/v1/admin/instances/${encodeURIComponent(vm.id)}/settings`, body, controller); const jobId = result?.task_id; form.elements.namedItem('root_password').value = ''; form.elements.namedItem('root_password_confirmation').value = ''; form.elements.namedItem('ssh_public_key').value = ''; form.elements.namedItem('confirm_restart').checked = false; setSettingsFeedback(section, `任务 #${jobId || '—'} 已接收,运行中的实例将在后台重启并应用设置。`, 'muted'); onNotice?.('实例设置任务已接收,可在任务记录查看结果。'); pollSettingsJob(vm, section, result); } catch (error) { if (controller.signal.aborted && controller.signal.reason !== 'timeout') return; setSettingsFeedback(section, error.message, 'danger'); if (error?.mutationMayHaveApplied === true) { await onRefresh?.(vm.id); onNotice?.(error.message, true); } else unlockSettingsForm(form); } finally { if (state.settingsRequest === controller) state.settingsRequest = null; } }); form.addEventListener('reset', () => window.setTimeout(() => setSettingsFeedback(section, ''), 0)); for (const control of form.querySelectorAll('input, textarea')) { control.addEventListener('input', () => { const feedback = section.querySelector('[data-settings-feedback]'); if (feedback?.classList.contains('text-danger')) setSettingsFeedback(section, ''); }); } return section; } function networkOptionsView(section, options) { const status = section.querySelector('[data-network-options-status]'); if (status) { status.textContent = options.message || '已读取双栈地址账本;提交时会再次锁定并校验精确目标。'; status.className = 'text-muted fs-12 mb-0'; } const values = section.querySelector('[data-network-options-values]'); if (!values) return; values.replaceChildren(); const currentAttachment = attachmentById(options, options.current_attachment_id); const ipv4Count = (options.attachments || []).reduce((total, attachment) => total + attachment.ipv4.pools.reduce((count, pool) => count + pool.available_options.length, 0), 0); const ipv6Pools = (options.attachments || []).reduce((total, attachment) => total + attachment.ipv6.pools.filter(pool => pool.sparse).length, 0); [['当前接入', currentAttachment?.label || '未记录'], ['候选接入', `${options.attachments.length} 个`], ['可用 IPv4', `${ipv4Count} 个`], ['可选 IPv6 池', `${ipv6Pools} 个`]].forEach(([label, value]) => { values.append(el('dt', '', label), el('dd', 'admin-mono', value)); }); const attachmentSelect = section.querySelector('[name="attachment_id"]'); const submit = section.querySelector('button[type="submit"]'); const canChange = options.can_change === true && options.configuration_state === 'ready'; if (attachmentSelect instanceof HTMLSelectElement) { attachmentSelect.replaceChildren(new Option( options.attachments.length ? '请选择目标网络接入' : '当前没有可用网络接入', '' )); for (const attachment of options.attachments) { attachmentSelect.add(new Option( `${attachment.label}${attachment.current ? ' · 当前' : ''}`, attachment.attachment_id )); } attachmentSelect.value = options.current_attachment_id; attachmentSelect.disabled = !canChange; } populateNetworkTargetControls(section, options); if (submit instanceof HTMLButtonElement) submit.disabled = !canChange; const empty = section.querySelector('[data-network-options-empty]'); if (empty) { empty.id = 'network-options-empty'; const blockingJob = options.active_job?.blocks_mutation === true ? options.active_job : null; empty.textContent = blockingJob ? blockMessage(blockingJob, '更换公网 IP') : (!canChange ? ({ invalid: '宿主机公网地址池配置无效,暂不能更换;请先修正宿主机配置。', drift: '实例当前网络与宿主机地址池不一致,暂不能更换;请先核对网络配置。', }[options.configuration_state] || '当前宿主机网络配置未就绪或实例已有任务,暂不能更换。') : '当前网络接入可以只更换一个地址族;切换到其他接入时必须同时指定 IPv4 和 IPv6。'); empty.className = `form-text mb-2${canChange ? '' : ' text-warning'}`; } } function populateNetworkTargetControls(section, options) { const attachmentSelect = section.querySelector('[name="attachment_id"]'); const ipv4Select = section.querySelector('[name="ipv4_target"]'); const ipv6PoolSelect = section.querySelector('[name="ipv6_pool_key"]'); const ipv6Input = section.querySelector('[name="ipv6_address_cidr"]'); const attachment = attachmentById(options, attachmentSelect?.value); const isCurrent = attachment?.attachment_id === options.current_attachment_id; if (ipv4Select instanceof HTMLSelectElement) { ipv4Select.replaceChildren(new Option( isCurrent ? '保持当前 IPv4' : '请选择新的 IPv4', '' )); for (const pool of attachment?.ipv4.pools || []) { for (const option of pool.available_options) { ipv4Select.add(new Option( `${option.address_cidr} · ${pool.pool_cidr}`, encodedIpv4Target(pool.pool_key, option.address_cidr) )); } } ipv4Select.disabled = !attachment || attachment.ipv4.pools.every(pool => pool.available_options.length === 0); ipv4Select.required = !isCurrent; } if (ipv6PoolSelect instanceof HTMLSelectElement) { ipv6PoolSelect.replaceChildren(new Option( isCurrent ? '保持当前 IPv6' : '请选择 IPv6 地址池', '' )); for (const pool of attachment?.ipv6.pools || []) { if (!pool.sparse) continue; ipv6PoolSelect.add(new Option( `${pool.pool_cidr} · 地址 /${pool.guest_prefix}`, pool.pool_key )); } ipv6PoolSelect.disabled = !attachment || ipv6PoolSelect.options.length === 1; ipv6PoolSelect.required = !isCurrent; } if (ipv6Input instanceof HTMLInputElement) { ipv6Input.value = ''; ipv6Input.disabled = !ipv6PoolSelect?.value; ipv6Input.required = !isCurrent; ipv6Input.placeholder = '例如 2404:c140:156:3a::20/64'; } updateIpv6TargetHelp(section, options); } function updateIpv6TargetHelp(section, options) { const attachment = attachmentById(options, section.querySelector('[name="attachment_id"]')?.value); const poolKey = publicPoolKey(section.querySelector('[name="ipv6_pool_key"]')?.value); const pool = attachment?.ipv6.pools.find(item => item.pool_key === poolKey); const hint = section.querySelector('[data-ipv6-target-help]'); if (!hint) return; if (pool) { hint.textContent = `可分配范围 ${pool.allocation_start} – ${pool.allocation_end},必须使用 /${pool.guest_prefix};网关、DNS、保留和管理地址不可用。`; return; } hint.textContent = attachment?.attachment_id === options.current_attachment_id ? '如只更换 IPv4,可保持 IPv6 不变;选择 IPv6 地址池后填写完整 CIDR。' : '切换网络接入时 IPv4 和 IPv6 都是必填项。'; } function networkOptionsErrorView(section, message) { section._networkOptions = null; section.querySelector('[data-network-options-values]')?.replaceChildren(); const status = section.querySelector('[data-network-options-status]'); if (status) { status.textContent = message; status.className = 'text-warning fs-12 mb-0'; } const edit = section.querySelector('[data-network-edit="open"]'); if (edit instanceof HTMLButtonElement) { edit.disabled = true; edit.setAttribute('aria-expanded', 'false'); edit.title = message; } const form = section.querySelector('.admin-instance-network-form'); if (form) { form.hidden = true; for (const control of form.querySelectorAll('select, input, button')) control.disabled = true; } } async function loadNetworkOptions(vm, section) { const serial = state.networkSerial; const controller = new AbortController(); state.networkOptionsRequest = controller; try { const payload = await read(`/api/v1/admin/instances/${encodeURIComponent(vm.id)}/network-options`, controller); if (serial !== state.networkSerial || controller.signal.aborted) return; const options = normalizeAdminNetworkOptions(payload, vm); if (state.currentId !== String(vm.id)) return; section._networkOptions = options; networkOptionsView(section, options); } catch (error) { if (controller.signal.aborted && controller.signal.reason !== 'timeout') return; if (serial !== state.networkSerial || state.currentId !== String(vm.id)) return; networkOptionsErrorView(section, error.status === 409 ? error.message : '无法读取宿主机地址池,暂不能选择新的公网 IP。'); } finally { if (state.networkOptionsRequest === controller) state.networkOptionsRequest = null; } } function targetNetworkValue(section, vm) { const options = section._networkOptions || networkOptionsFromVm(vm); return buildAdminNetworkTargets(options, { attachment_id: section.querySelector('[name="attachment_id"]')?.value, ipv4_target: section.querySelector('[name="ipv4_target"]')?.value, ipv6_pool_key: section.querySelector('[name="ipv6_pool_key"]')?.value, ipv6_address_cidr: section.querySelector('[name="ipv6_address_cidr"]')?.value, }); } function makeNetworkConfirmation(section, vm, target, options) { const confirmation = section.querySelector('[data-network-confirmation]'); const summary = confirmation?.querySelector('[data-network-confirm-summary]'); const check = confirmation?.querySelector('[data-network-confirm-check]'); const submit = confirmation?.querySelector('[data-network-confirm-submit]'); if (!confirmation || !summary || !check || !submit) return null; const changes = []; const currentAttachment = attachmentById(options, options.current_attachment_id); changes.push(target.attachment.attachment_id === options.current_attachment_id ? `网络接入:保持 ${target.attachment.label}` : `网络接入:${currentAttachment?.label || '当前接入'} → ${target.attachment.label}`); if (target.targets.ipv4) changes.push(`IPv4:${options.current_public_network.ipv4.address_cidr || '未记录'} → ${target.targets.ipv4.address_cidr}`); if (target.targets.ipv6) changes.push(`IPv6:${options.current_public_network.ipv6.address_cidr || '未记录'} → ${target.targets.ipv6.address_cidr}`); summary.textContent = `${changes.join(';')}。运行中的实例会受控关机并重新启动,已关机实例保持关机;运行中连接会短暂中断。`; check.checked = false; submit.disabled = true; confirmation.hidden = false; return { confirmation, check, submit }; } function pollNetworkJob(vm, section, result) { const serial = state.networkSerial; const jobId = result?.task_id ?? ''; const handle = actions.watch(result, { title: '更换实例网络', onUpdate: () => { if (serial === state.networkSerial && state.currentId === String(vm.id)) { setNetworkFeedback(section, `任务 #${jobId} 正在后台执行。`, 'muted'); } }, onResult: ({ succeeded, message }) => { if (serial !== state.networkSerial || state.currentId !== String(vm.id)) return; state.networkObserver = null; void (async () => { await onRefresh?.(vm.id); onNotice?.(message, !succeeded); })(); }, onStop: reason => { if (state.networkObserver === handle) state.networkObserver = null; if (reason === 'pagehide' || serial !== state.networkSerial) return; void (async () => { await onRefresh?.(vm.id); onNotice?.(`任务 #${jobId} 自动观察已停止,已按服务端最新状态更新网络入口;请在任务记录刷新最终结果。`, true); })(); }, }); if (!handle.url) { setNetworkFeedback(section, '任务已接收,但任务回执协议无效。请勿再次提交,并联系管理员核查。', 'danger'); return; } state.networkObserver = handle; } function networkEditor(vm) { const section = el('section', 'admin-instance-network-settings mt-4'); section.setAttribute('aria-labelledby', 'instance-network-title'); const heading = el('div', 'd-flex align-items-start justify-content-between gap-3 flex-wrap'); const copy = el('div'); const title = el('h3', 'h6 fw-semibold mb-1', '网络配置'); title.id = 'instance-network-title'; copy.append(title, el('p', 'text-muted fs-13 mb-0', '运行中的实例会受控重启,已关机实例保持关机;地址池、网关和 DNS 由宿主机最终校验。')); heading.append(copy); const template = byId('admin-instance-network-controls'); const controls = template?.content?.cloneNode(true); const edit = controls?.querySelector('[data-network-edit="open"]'); if (edit && vm.network_change_supported === true) heading.append(edit); section.append(heading); const current = el('div', 'admin-instance-network-current mt-3'); const current4 = el('span', 'admin-instance-network-current-value'); current4.append(el('strong', 'admin-mono', text(vm.public_ipv4_cidr, vm.public_ip_cidr, vm.public_ipv4, vm.public_ip, '未记录'))); if (vm.public_ipv4 || vm.public_ip) current4.append(copyButton(vm.public_ipv4 || vm.public_ip, '复制当前 IPv4')); const current6 = el('span', 'admin-instance-network-current-value'); current6.append(el('strong', 'admin-mono', text(vm.public_ipv6_cidr, vm.public_ipv6, '未记录'))); if (vm.public_ipv6) current6.append(copyButton(vm.public_ipv6, '复制当前 IPv6')); current.append( el('span', 'text-muted fs-13', '当前 IPv4'), current4, el('span', 'text-muted fs-13', '当前 IPv6'), current6 ); section.append(current); if (!edit) { if (controls) section.append(controls); return section; } if (vm.network_change_supported !== true) { section.append(el('p', 'text-warning fs-13 mt-3 mb-0', vm.instance_status && vm.instance_status !== 'active' ? `当前实例处于“${text(vm.display?.lifecycle, vm.instance_status)}”状态,暂不能更换公网 IP。` : '当前实例缺少已验证的面板云镜像元数据,暂不能更换公网 IP。请先核对实例元数据。')); return section; } const optionsBox = el('div', 'admin-instance-network-options-box mt-3'); optionsBox.append(el('p', 'text-muted fs-13 mb-2', '宿主机网络约束')); const optionsValues = el('dl', 'admin-instance-network-options'); optionsValues.dataset.networkOptionsValues = ''; optionsBox.append(optionsValues, el('p', 'text-muted fs-12 mb-0', '正在读取地址池配置…')); optionsBox.lastChild.dataset.networkOptionsStatus = ''; optionsBox.lastChild.setAttribute('role', 'status'); section.append(optionsBox); if (controls) section.append(controls); const form = section.querySelector('.admin-instance-network-form'); if (!form) return section; const attachmentSelect = form.elements.namedItem('attachment_id'); const ipv4Select = form.elements.namedItem('ipv4_target'); const ipv6PoolSelect = form.elements.namedItem('ipv6_pool_key'); const ipv6Input = form.elements.namedItem('ipv6_address_cidr'); const feedback = section.querySelector('.admin-instance-network-feedback'); const submit = form.querySelector('button[type="submit"]'); const cancelButton = form.querySelector('[data-network-edit="cancel"]'); for (const control of [attachmentSelect, ipv4Select, ipv6PoolSelect, ipv6Input]) { if (control) { control.value = ''; control.disabled = true; } } submit.disabled = true; const confirmation = el('div', 'admin-instance-network-confirmation mt-3'); confirmation.hidden = true; confirmation.dataset.networkConfirmation = ''; confirmation.setAttribute('role', 'alertdialog'); confirmation.setAttribute('aria-labelledby', `network-confirm-title-${vm.id}`); confirmation.append(el('h4', 'h6 fw-semibold mb-2', '确认更换公网 IP')); confirmation.lastChild.id = `network-confirm-title-${vm.id}`; const summary = el('p', 'text-muted fs-13 mb-2'); summary.dataset.networkConfirmSummary = ''; confirmation.append(summary); const checkLabel = el('label', 'admin-instance-network-confirm-check'); const check = document.createElement('input'); check.type = 'checkbox'; check.dataset.networkConfirmCheck = ''; checkLabel.append(check, document.createTextNode('我确认运行中的实例会短暂重启(已关机实例保持关机),并确认目标公网 IP 无误。')); confirmation.append(checkLabel); const confirmActions = el('div', 'd-flex justify-content-end gap-2 flex-wrap mt-3'); const back = el('button', 'btn btn-light btn-sm', '返回修改'); back.type = 'button'; back.dataset.networkConfirmCancel = ''; const confirmSubmit = el('button', 'btn btn-primary btn-sm', '确认并提交'); confirmSubmit.type = 'button'; confirmSubmit.dataset.networkConfirmSubmit = ''; confirmSubmit.disabled = true; confirmActions.append(back, confirmSubmit); confirmation.append(confirmActions); section.append(confirmation); const mutationBlocked = vm.active_job?.blocks_mutation === true; if (mutationBlocked) { edit.disabled = true; edit.title = blockMessage(vm.active_job, '更换公网 IP'); setNetworkFeedback(section, edit.title, 'warning'); } edit.addEventListener('click', () => { if (edit.disabled) return; form.hidden = false; edit.setAttribute('aria-expanded', 'true'); feedback.hidden = true; attachmentSelect?.focus(); }); attachmentSelect?.addEventListener('change', () => { populateNetworkTargetControls(section, section._networkOptions || networkOptionsFromVm(vm)); if (!feedback.hidden) setNetworkFeedback(section, ''); }); ipv6PoolSelect?.addEventListener('change', () => { if (ipv6Input) { ipv6Input.disabled = !ipv6PoolSelect.value; ipv6Input.value = ''; if (!ipv6Input.disabled) ipv6Input.focus(); } updateIpv6TargetHelp(section, section._networkOptions || networkOptionsFromVm(vm)); if (!feedback.hidden) setNetworkFeedback(section, ''); }); form.addEventListener('submit', event => { event.preventDefault(); if (state.networkRequest || mutationBlocked) return; let target; try { target = targetNetworkValue(section, vm); } catch (error) { setNetworkFeedback(section, error.message, 'danger'); attachmentSelect?.focus(); return; } const options = section._networkOptions || networkOptionsFromVm(vm); form.hidden = true; edit.hidden = true; setNetworkFeedback(section, ''); makeNetworkConfirmation(section, vm, target, options); section._networkTarget = target; section.querySelector('[data-network-confirm-check]')?.focus(); }); for (const control of [ipv4Select, ipv6Input]) { control?.addEventListener('input', () => { if (!feedback.hidden) setNetworkFeedback(section, ''); }); } cancelButton?.addEventListener('click', () => { form.hidden = true; confirmation.hidden = true; edit.hidden = false; edit.setAttribute('aria-expanded', 'false'); populateNetworkTargetControls(section, section._networkOptions || networkOptionsFromVm(vm)); section._networkTarget = null; setNetworkFeedback(section, ''); }); check.addEventListener('change', () => { confirmSubmit.disabled = !check.checked; }); back.addEventListener('click', () => { confirmation.hidden = true; form.hidden = false; edit.hidden = false; edit.setAttribute('aria-expanded', 'true'); attachmentSelect?.focus(); }); confirmSubmit.addEventListener('click', async () => { if (!check.checked || state.networkRequest || mutationBlocked) return; const target = section._networkTarget; const controller = new AbortController(); state.networkRequest = controller; check.disabled = true; confirmSubmit.disabled = true; back.disabled = true; setNetworkFeedback(section, '正在创建网络变更任务,请勿重复提交…', 'muted'); try { const result = await enqueue(`/api/v1/admin/instances/${encodeURIComponent(vm.id)}/network`, { targets: target.targets, confirm_restart: true, }, controller); const jobId = result?.task_id; confirmation.hidden = true; setNetworkFeedback(section, `任务 #${jobId || '—'} 已接收,实例将在后台重启并应用新地址。`, 'muted'); onNotice?.('网络变更任务已接收,可在任务记录查看结果。'); edit.hidden = true; edit.disabled = true; state.networkRequest = null; pollNetworkJob(vm, section, result); } catch (error) { if (controller.signal.aborted && controller.signal.reason !== 'timeout') return; setNetworkFeedback(section, error.message, 'danger'); if (error?.mutationMayHaveApplied === true) { await onRefresh?.(vm.id); onNotice?.(error.message, true); } else { confirmation.hidden = false; check.disabled = false; confirmSubmit.disabled = !check.checked; back.disabled = false; } } finally { if (state.networkRequest === controller) state.networkRequest = null; } }); void loadNetworkOptions(vm, section); return section; } function render(vm) { state.currentId = String(vm.id); return [networkEditor(vm), settingsEditor(vm)]; } return Object.freeze({ render, cancel, dispose: cancel }); }