From e0ed03b044ea31e5cfd93b88356ef1f17ddac8b0 Mon Sep 17 00:00:00 2001 From: codex Date: Sun, 8 Nov 2026 23:31:00 +0800 Subject: [PATCH] feat(admin): add network abuse monitoring console --- .../Controllers/Admin/CloudPageController.php | 45 ++++ web/app/Middleware/CloudApi.php | 1 + web/config/routes.php | 2 + web/config/routes_cloud.php | 4 + web/public/cloud/admin-abuse-monitoring.css | 247 ++++++++++++++++++ web/public/cloud/admin-abuse-monitoring.js | 197 ++++++++++++++ .../venix/admin/cloud/abuse_monitoring.tpl | 96 +++++++ .../views/venix/admin/static_header.tpl | 1 + .../AdminAbuseMonitoringBehaviorTest.mjs | 51 ++++ .../CloudAdminAbuseMonitoringApiTest.php | 87 ++++++ ...udAdminAbuseMonitoringPageContractTest.php | 94 +++++++ ...loudAdminAbuseMonitoringUiContractTest.php | 111 ++++++++ 12 files changed, 936 insertions(+) create mode 100644 web/public/cloud/admin-abuse-monitoring.css create mode 100644 web/public/cloud/admin-abuse-monitoring.js create mode 100644 web/resources/views/venix/admin/cloud/abuse_monitoring.tpl create mode 100644 web/tests/AdminAbuseMonitoringBehaviorTest.mjs create mode 100644 web/tests/CloudAdminAbuseMonitoringApiTest.php create mode 100644 web/tests/CloudAdminAbuseMonitoringPageContractTest.php create mode 100644 web/tests/CloudAdminAbuseMonitoringUiContractTest.php diff --git a/web/app/Controllers/Admin/CloudPageController.php b/web/app/Controllers/Admin/CloudPageController.php index a210c2be..c9781244 100644 --- a/web/app/Controllers/Admin/CloudPageController.php +++ b/web/app/Controllers/Admin/CloudPageController.php @@ -4,6 +4,7 @@ namespace App\Controllers\Admin; use App\Controllers\AdminController; use App\Services\Cloud\CloudAccess; +use App\Services\Cloud\CloudAdminAbuseMonitoringService; use App\Services\Cloud\CloudAdminBillingService; use App\Services\Cloud\CloudAdminInstanceService; use App\Services\Cloud\CloudAdminOperationsService; @@ -231,6 +232,50 @@ final class CloudPageController extends AdminController return $response->withStatus($status)->withHeader('Cache-Control', 'private, no-store'); } + public function abuseMonitoring($request, $response, $args) + { + try { + $actor = CloudAccess::actor(false); + } catch (CloudError $exception) { + return $response->withStatus($exception->httpStatus) + ->withHeader('Cache-Control', 'private, no-store'); + } + if (!($actor['is_admin'] ?? false)) { + return $response->withStatus(403) + ->withHeader('Cache-Control', 'private, no-store'); + } + + $payload = null; + $error = ''; + $status = 200; + try { + $payload = (new CloudAdminAbuseMonitoringService())->page( + $actor, + $request->getQueryParams() + ); + } catch (CloudError $exception) { + $error = $exception->getMessage(); + $status = $exception->httpStatus; + } catch (\Throwable $exception) { + error_log('Admin abuse monitoring snapshot failed: ' + . get_class($exception)); + $error = '网络监控数据暂时无法读取,请稍后重试。'; + $status = 503; + } + $smarty = $this->view()->assign([ + 'abuse_monitoring_page' => $payload, + 'abuse_monitoring_error' => $error, + // Service timestamps are UTC ISO-8601 values. The browser renders + // them in its own locale; the data attribute documents that source. + 'abuse_monitoring_timezone' => 'UTC', + ]); + $response->getBody()->write( + $smarty->fetch('admin/cloud/abuse_monitoring.tpl') + ); + return $response->withStatus($status) + ->withHeader('Cache-Control', 'private, no-store'); + } + public function maintenanceNotices($request, $response, $args) { try { diff --git a/web/app/Middleware/CloudApi.php b/web/app/Middleware/CloudApi.php index 55228a87..1afa497b 100644 --- a/web/app/Middleware/CloudApi.php +++ b/web/app/Middleware/CloudApi.php @@ -19,6 +19,7 @@ final class CloudApi || preg_match('#^/api/v1/admin/billing(?:/|$)#D', $path) === 1 || preg_match('#^/api/v1/admin/instances(?:/|$)#D', $path) === 1 || preg_match('#^/api/v1/admin/operations(?:/|$)#D', $path) === 1 + || preg_match('#^/api/v1/admin/abuse-monitoring(?:/|$)#D', $path) === 1 || preg_match('#^/api/v1/admin/maintenance-notices(?:/|$)#D', $path) === 1 || preg_match('#^/api/v1/admin/service-compensations(?:/|$)#D', $path) === 1 || preg_match('#^/api/v1/admin/system-logs(?:/|$)#D', $path) === 1 diff --git a/web/config/routes.php b/web/config/routes.php index 9b4da374..cf800c6c 100644 --- a/web/config/routes.php +++ b/web/config/routes.php @@ -201,6 +201,8 @@ $app->group('/admin', function () { $this->get('/cloud/templates', 'App\Controllers\Admin\CloudPageController:templates'); $this->get('/cloud/rescue', 'App\Controllers\Admin\CloudPageController:rescue'); $this->get('/cloud/instances', 'App\Controllers\Admin\CloudPageController:instances'); + $this->get('/abuse-monitoring', + 'App\Controllers\Admin\CloudPageController:abuseMonitoring'); $this->get('/billing', 'App\Controllers\Admin\CloudPageController:billing'); $this->get('/cloud/orders', 'App\Controllers\Admin\CloudPageController:orders'); $this->get('/operations', 'App\Controllers\Admin\CloudPageController:operations'); diff --git a/web/config/routes_cloud.php b/web/config/routes_cloud.php index 900d98ad..8449ff92 100644 --- a/web/config/routes_cloud.php +++ b/web/config/routes_cloud.php @@ -173,6 +173,10 @@ $app->group('/api/v1', function () { 'App\Controllers\CloudAdminServiceCompensationController:detail'); $this->get('/admin/operations', 'App\Controllers\CloudAdminOperationsController:index'); $this->get('/admin/operations/health', 'App\Controllers\CloudAdminRuntimeController:index'); + $this->get('/admin/abuse-monitoring', + 'App\Controllers\CloudAdminAbuseMonitoringController:index'); + $this->get('/admin/abuse-monitoring/instances/{id:[1-9][0-9]*}', + 'App\Controllers\CloudAdminAbuseMonitoringController:detail'); $this->get('/admin/system-logs', 'App\Controllers\CloudAdminSystemLogsController:index'); $this->get('/admin/system-logs/detail', 'App\Controllers\CloudAdminSystemLogsController:detail'); $this->get('/admin/operations/jobs/{id:[0-9]+}', 'App\Controllers\CloudAdminOperationsController:detail'); diff --git a/web/public/cloud/admin-abuse-monitoring.css b/web/public/cloud/admin-abuse-monitoring.css new file mode 100644 index 00000000..92623aec --- /dev/null +++ b/web/public/cloud/admin-abuse-monitoring.css @@ -0,0 +1,247 @@ +[data-admin-abuse-monitoring] .admin-abuse-heading-actions { + align-items: center; + display: flex; + flex-wrap: wrap; + gap: 10px; +} + +[data-admin-abuse-monitoring] .admin-abuse-summary .admin-stat-card .card-body { + min-height: 126px; +} + +[data-admin-abuse-monitoring] .admin-abuse-health { + align-items: center; + display: flex; + justify-content: space-between; + gap: 16px; +} + +[data-admin-abuse-monitoring] .admin-abuse-health p { + margin-top: 4px; +} + +[data-admin-abuse-monitoring] .admin-abuse-health > span { + flex-shrink: 0; + font-size: 12px; +} + +[data-admin-abuse-monitoring] .admin-abuse-table-wrap { + overflow: auto; +} + +[data-admin-abuse-monitoring] .admin-abuse-table { + min-width: 1180px; +} + +[data-admin-abuse-monitoring] .admin-abuse-table thead th { + background: #f8fafc; + color: #667085; + font-size: 12px; + letter-spacing: .02em; + position: sticky; + top: 0; + white-space: nowrap; + z-index: 1; +} + +[data-admin-abuse-monitoring] .admin-abuse-table td { + vertical-align: middle; +} + +[data-admin-abuse-monitoring] .admin-abuse-cell-note, +[data-admin-abuse-monitoring] .admin-abuse-direction, +[data-admin-abuse-monitoring] .admin-abuse-quality { + color: #667085; + display: block; + font-size: 12px; + margin-top: 5px; +} + +[data-admin-abuse-monitoring] .admin-abuse-metric-pair { + display: flex; + flex-wrap: wrap; + gap: 4px 12px; +} + +[data-admin-abuse-monitoring] .admin-abuse-metric-pair strong { + font-size: 13px; + white-space: nowrap; +} + +[data-admin-abuse-monitoring] .admin-abuse-risk { + border-radius: 999px; + display: inline-flex; + font-size: 12px; + font-weight: 800; + padding: 5px 10px; + white-space: nowrap; +} + +[data-admin-abuse-monitoring] .admin-abuse-risk.is-normal { background: #e8f8f1; color: #12805c; } +[data-admin-abuse-monitoring] .admin-abuse-risk.is-observing { background: #eaf2ff; color: #2f6bb2; } +[data-admin-abuse-monitoring] .admin-abuse-risk.is-suspicious { background: #fff4da; color: #9b6800; } +[data-admin-abuse-monitoring] .admin-abuse-risk.is-high_risk { background: #feecef; color: #b4233d; } +[data-admin-abuse-monitoring] .admin-abuse-risk.is-collection_anomaly { background: #eef1f5; color: #475467; } + +[data-admin-abuse-monitoring] .admin-abuse-direction.is-outbound { color: #b4233d; font-weight: 700; } +[data-admin-abuse-monitoring] .admin-abuse-direction.is-inbound { color: #9b6800; font-weight: 700; } +[data-admin-abuse-monitoring] .admin-abuse-direction.is-both { color: #7a271a; font-weight: 800; } +[data-admin-abuse-monitoring] .admin-abuse-quality.is-complete { color: #12805c; } +[data-admin-abuse-monitoring] .admin-abuse-quality:not(.is-complete) { color: #b54708; font-weight: 700; } + +[data-admin-abuse-monitoring] .admin-abuse-empty { + align-items: center; + color: #667085; + display: flex; + flex-direction: column; + gap: 6px; + justify-content: center; + min-height: 220px; + padding: 28px; + text-align: center; +} + +[data-admin-abuse-monitoring] .admin-abuse-empty i { color: #98a2b3; font-size: 34px; } +[data-admin-abuse-monitoring] .admin-abuse-empty strong { color: #344054; } + +[data-admin-abuse-monitoring] .admin-abuse-pagination { + align-items: center; + color: #667085; + display: flex; + font-size: 13px; + justify-content: space-between; + margin-top: 18px; +} + +#abuse-monitoring-detail .admin-abuse-direction-banner { + border-radius: 10px; + font-size: 13px; + font-weight: 700; + margin-bottom: 18px; + padding: 12px 14px; +} + +#abuse-monitoring-detail .admin-abuse-direction-banner.is-outbound { background: #feecef; color: #9f1239; } +#abuse-monitoring-detail .admin-abuse-direction-banner.is-inbound { background: #fff4da; color: #854d0e; } +#abuse-monitoring-detail .admin-abuse-direction-banner.is-both { background: #f4ebff; color: #6941c6; } +#abuse-monitoring-detail .admin-abuse-direction-banner.is-none { background: #e8f8f1; color: #116149; } + +#abuse-monitoring-detail .admin-abuse-detail-metrics { + display: grid; + gap: 10px; + grid-template-columns: repeat(2, minmax(0, 1fr)); +} + +#abuse-monitoring-detail .admin-abuse-detail-metric { + background: #f8fafc; + border: 1px solid #e5ebf2; + border-radius: 10px; + padding: 12px; +} + +#abuse-monitoring-detail .admin-abuse-detail-metric span { color: #667085; display: block; font-size: 12px; } +#abuse-monitoring-detail .admin-abuse-detail-metric strong { color: #1d2939; display: block; margin-top: 4px; } + +#abuse-monitoring-detail .admin-abuse-trend { + border: 1px solid #e5ebf2; + border-radius: 10px; + min-height: 170px; + overflow: auto; + padding: 14px; +} + +#abuse-monitoring-detail .admin-abuse-trend-chart { + align-items: end; + display: grid; + gap: 5px; + grid-auto-columns: minmax(14px, 1fr); + grid-auto-flow: column; + min-height: 132px; + min-width: 360px; +} + +#abuse-monitoring-detail .admin-abuse-trend-column { + align-items: stretch; + display: flex; + gap: 2px; + height: 118px; + justify-content: center; + position: relative; +} + +#abuse-monitoring-detail .admin-abuse-trend-bar { + align-self: end; + background: #18a87f; + border-radius: 3px 3px 0 0; + min-height: 2px; + width: 45%; +} + +#abuse-monitoring-detail .admin-abuse-trend-bar.is-packets { background: #7a5af8; } +#abuse-monitoring-detail .admin-abuse-trend-column.is-incomplete { opacity: .3; } + +#abuse-monitoring-detail .admin-abuse-findings { + display: grid; + gap: 10px; +} + +#abuse-monitoring-detail .admin-abuse-finding { + border: 1px solid #e5ebf2; + border-left: 4px solid #f79009; + border-radius: 8px; + padding: 12px 14px; +} + +#abuse-monitoring-detail .admin-abuse-finding.is-high { border-left-color: #d92d20; } +#abuse-monitoring-detail .admin-abuse-finding.is-suspicious { border-left-color: #f79009; } +#abuse-monitoring-detail .admin-abuse-finding.is-info { border-left-color: #2e90fa; } +#abuse-monitoring-detail .admin-abuse-finding header { align-items: center; display: flex; gap: 10px; justify-content: space-between; } +#abuse-monitoring-detail .admin-abuse-finding p { color: #667085; font-size: 13px; margin: 8px 0 0; } +#abuse-monitoring-detail .admin-abuse-empty-detail { color: #667085; font-size: 13px; padding: 18px; text-align: center; } + +@media (max-width: 767.98px) { + [data-admin-abuse-monitoring] .admin-abuse-heading-actions, + [data-admin-abuse-monitoring] .admin-abuse-heading-actions .btn { width: 100%; } + [data-admin-abuse-monitoring] .admin-abuse-heading-actions { align-items: stretch; } + [data-admin-abuse-monitoring] .admin-abuse-health { align-items: flex-start; flex-direction: column; } + [data-admin-abuse-monitoring] .admin-abuse-table-wrap { overflow: visible; } + [data-admin-abuse-monitoring] .admin-abuse-table { min-width: 0; } + [data-admin-abuse-monitoring] .admin-abuse-table thead { display: none; } + [data-admin-abuse-monitoring] .admin-abuse-table, + [data-admin-abuse-monitoring] .admin-abuse-table tbody, + [data-admin-abuse-monitoring] .admin-abuse-table tr, + [data-admin-abuse-monitoring] .admin-abuse-table td { display: block; width: 100%; } + [data-admin-abuse-monitoring] .admin-abuse-table tr[data-abuse-monitoring-row] { + border: 1px solid #e5ebf2; + border-radius: 12px; + margin-bottom: 12px; + overflow: hidden; + padding: 8px 14px; + } + [data-admin-abuse-monitoring] .admin-abuse-table td { + border: 0; + border-bottom: 1px solid #eef2f6; + min-height: 46px; + padding: 10px 0 10px 38%; + position: relative; + text-align: left !important; + } + [data-admin-abuse-monitoring] .admin-abuse-table td:last-child { border-bottom: 0; } + [data-admin-abuse-monitoring] .admin-abuse-table td::before { + color: #667085; + content: attr(data-label); + font-size: 12px; + font-weight: 700; + left: 0; + position: absolute; + top: 12px; + } + [data-admin-abuse-monitoring] .admin-abuse-table tr:not([data-abuse-monitoring-row]) td { + padding-left: 0; + } + [data-admin-abuse-monitoring] .admin-abuse-table tr:not([data-abuse-monitoring-row]) td::before { + display: none; + } + [data-admin-abuse-monitoring] .admin-abuse-table td .btn { width: 100%; } + #abuse-monitoring-detail .admin-abuse-detail-metrics { grid-template-columns: 1fr; } +} diff --git a/web/public/cloud/admin-abuse-monitoring.js b/web/public/cloud/admin-abuse-monitoring.js new file mode 100644 index 00000000..f16fe26a --- /dev/null +++ b/web/public/cloud/admin-abuse-monitoring.js @@ -0,0 +1,197 @@ +const root = document.querySelector('[data-admin-abuse-monitoring]'); +const config = window.__VENIX_ABUSE_MONITORING__ || {detailApiUrl: '/api/v1/admin/abuse-monitoring/instances'}; +const byId = id => document.getElementById(id); +const requestRuntime = window.VenixAdminRequestRuntime?.create?.(); +const state = {request: null, opener: null, scroll: null}; +const directions = new Set(['none', 'inbound', 'outbound', 'both']); +const severities = new Set(['info', 'suspicious', 'high']); + +function text(value, fallback = '未记录') { + return value === null || value === undefined || String(value).trim() === '' ? fallback : String(value); +} + +function number(value) { + if (value === null || value === undefined || value === '') return null; + const parsed = Number(value); + return Number.isFinite(parsed) && parsed >= 0 ? parsed : null; +} + +function count(value) { + const parsed = number(value); + return parsed === null ? '不可用' : Math.round(parsed).toLocaleString('zh-CN'); +} + +function rate(value, unit) { + const parsed = number(value); + if (parsed === null) return '不可用'; + if (unit === 'pps') return `${Math.round(parsed).toLocaleString('zh-CN')} pps`; + const units = ['bps', 'Kbps', 'Mbps', 'Gbps']; + let scaled = parsed; let index = 0; + while (scaled >= 1000 && index < units.length - 1) { scaled /= 1000; index += 1; } + return `${scaled >= 100 || Number.isInteger(scaled) ? scaled.toFixed(0) : scaled.toFixed(1)} ${units[index]}`; +} + +function trendScales(series) { + return { + maxBps: Math.max(...series.map(point => number(point.tx_bps) || 0), 1), + maxPps: Math.max(...series.map(point => number(point.tx_pps) || 0), 1), + }; +} + +function date(value) { + if (!value) return '时间未记录'; + const parsed = new Date(String(value)); + return Number.isFinite(parsed.getTime()) ? parsed.toLocaleString('zh-CN', {hour12: false}) : '时间未记录'; +} + +function directionLabel(direction) { + return direction === 'outbound' ? '对外可疑行为:该实例正在主动产生异常连接模式。' + : direction === 'inbound' ? '正在遭受攻击:异常流量来自外部,不应将该实例标记为滥用来源。' + : direction === 'both' ? '双向异常:同时存在入站攻击与对外可疑连接证据,请分别核查。' + : '未触发行为:最近完整窗口没有形成持续风险证据。'; +} + +function normalize(payload) { + const source = payload?.data && typeof payload.data === 'object' ? payload.data : payload; + if (!source || typeof source !== 'object') throw new Error('监控详情响应格式无效。'); + const item = source.item && typeof source.item === 'object' ? source.item : source; + if (!item.instance_id) throw new Error('监控详情缺少实例标识。'); + const normalizedFindings = Array.isArray(source.findings) ? source.findings.map(finding => ({ + ...(finding && typeof finding === 'object' ? finding : {}), + severity: severities.has(finding?.severity) ? finding.severity : 'info', + })) : []; + return { + ...item, + direction: directions.has(item.direction) ? item.direction : 'none', + metrics: item.metrics && typeof item.metrics === 'object' ? item.metrics : {}, + sample: item.sample && typeof item.sample === 'object' ? item.sample : {}, + series: Array.isArray(source.series) ? source.series : [], + findings: normalizedFindings, + }; +} + +function openDrawer(dialog, opener) { + if (!dialog) return; + state.opener = opener; + if (!dialog.open) { + state.scroll = {x: window.scrollX || 0, y: window.scrollY || 0}; + document.body.style.setProperty('--admin-instance-scroll-top', `${-state.scroll.y}px`); + document.documentElement.classList.add('admin-instance-detail-open'); + } + if (typeof window.VenixDrawerMotion?.openDrawerWithMotion === 'function') { + try { if (window.VenixDrawerMotion.openDrawerWithMotion(dialog) !== false) return; } catch {} + } + if (!dialog.open) typeof dialog.showModal === 'function' ? dialog.showModal() : dialog.setAttribute('open', 'open'); + dialog.classList.add('is-drawer-visible'); +} + +function closeDrawer() { + state.request?.abort('closed'); state.request = null; + const dialog = byId('abuse-monitoring-detail'); + const finish = () => { + document.documentElement.classList.remove('admin-instance-detail-open'); + document.body.style.removeProperty('--admin-instance-scroll-top'); + if (state.scroll) window.scrollTo({left: state.scroll.x, top: state.scroll.y, behavior: 'auto'}); + state.scroll = null; + if (state.opener?.isConnected) state.opener.focus({preventScroll: true}); + state.opener = null; + }; + if (!dialog?.open) { finish(); return; } + if (typeof window.VenixDrawerMotion?.closeDrawerWithMotion === 'function') { + try { window.VenixDrawerMotion.closeDrawerWithMotion(dialog).then(finish); return; } catch {} + } + dialog.close?.(); dialog.removeAttribute('open'); dialog.classList.remove('is-drawer-visible'); finish(); +} + +function appendDetail(list, label, value) { + const dt = document.createElement('dt'); dt.textContent = label; + const dd = document.createElement('dd'); dd.textContent = value; + list.append(dt, dd); +} + +function renderMetrics(item) { + const target = byId('abuse-monitoring-detail-metrics'); target.replaceChildren(); + const metrics = item.metrics; + [ + ['下载吞吐', rate(metrics.rx_bps, 'bps')], ['上传吞吐', rate(metrics.tx_bps, 'bps')], + ['下载 PPS', rate(metrics.rx_pps, 'pps')], ['上传 PPS', rate(metrics.tx_pps, 'pps')], + ['TCP 活跃 / 新建', `${count(metrics.tcp_active_flows)} / ${count(metrics.tcp_new_flows)}`], + ['UDP 活跃 / 新建', `${count(metrics.udp_active_flows)} / ${count(metrics.udp_new_flows)}`], + ].forEach(([label, value]) => { + const card = document.createElement('div'); card.className = 'admin-abuse-detail-metric'; + const title = document.createElement('span'); title.textContent = label; + const strong = document.createElement('strong'); strong.textContent = value; + card.append(title, strong); target.append(card); + }); +} + +function renderTrend(item) { + const target = byId('abuse-monitoring-detail-trend'); target.replaceChildren(); + if (!item.series.length) { + const empty = document.createElement('p'); empty.className = 'admin-abuse-empty-detail'; empty.textContent = '尚无足够的完整窗口用于展示趋势。'; target.append(empty); return; + } + const {maxBps, maxPps} = trendScales(item.series); + const chart = document.createElement('div'); chart.className = 'admin-abuse-trend-chart'; + item.series.forEach((point, index) => { + const column = document.createElement('div'); column.className = `admin-abuse-trend-column${point.quality === 'complete' ? '' : ' is-incomplete'}`; + const throughput = document.createElement('span'); throughput.className = 'admin-abuse-trend-bar'; throughput.style.height = `${Math.max(2, ((number(point.tx_bps) || 0) / maxBps) * 100)}%`; + const packets = document.createElement('span'); packets.className = 'admin-abuse-trend-bar is-packets'; packets.style.height = `${Math.max(2, ((number(point.tx_pps) || 0) / maxPps) * 100)}%`; + column.title = `${date(point.bucket_start)} · TX ${rate(point.tx_bps, 'bps')} · ${rate(point.tx_pps, 'pps')} · ${text(point.quality, 'incomplete')}`; + column.setAttribute('aria-label', column.title); column.append(throughput, packets); chart.append(column); + }); + target.append(chart); +} + +function renderFindings(item) { + const target = byId('abuse-monitoring-detail-findings'); target.replaceChildren(); + if (!item.findings.length) { + const empty = document.createElement('p'); empty.className = 'admin-abuse-empty-detail'; empty.textContent = '最近没有持续触发的风险规则。'; target.append(empty); return; + } + item.findings.forEach(finding => { + const card = document.createElement('article'); card.className = `admin-abuse-finding is-${text(finding.severity, 'suspicious')}`; + const header = document.createElement('header'); const title = document.createElement('strong'); title.textContent = text(finding.label, text(finding.type, '风险规则')); + const time = document.createElement('span'); time.className = 'text-muted fs-12'; time.textContent = date(finding.last_seen_at); header.append(title, time); + const evidence = document.createElement('p'); evidence.textContent = text(finding.evidence_summary, '仅记录聚合证据摘要,不保存远端地址或端口明细。'); + card.append(header, evidence); target.append(card); + }); +} + +function renderDetail(item) { + byId('abuse-monitoring-detail-title').textContent = `${text(item.instance_name, '实例')} · 网络监控`; + const direction = byId('abuse-monitoring-detail-direction'); direction.hidden = false; direction.className = `admin-abuse-direction-banner is-${text(item.direction, 'none')}`; direction.textContent = directionLabel(item.direction); + const overview = byId('abuse-monitoring-detail-overview'); overview.replaceChildren(); + appendDetail(overview, '实例', `${text(item.instance_name)} (#${text(item.instance_id, '-')})`); + appendDetail(overview, '用户', `${text(item.user_name, '未知用户')} (#${text(item.user_id, '-')})`); + appendDetail(overview, '计算节点', text(item.host_name, '节点未记录')); + appendDetail(overview, '线路', text(item.line_name, '线路未记录')); + appendDetail(overview, '最近采样', date(item.sample.sampled_at || item.sample.bucket_start)); + appendDetail(overview, '样本质量', text(item.sample.quality_label, text(item.sample.quality, '样本不完整'))); + renderMetrics(item); renderTrend(item); renderFindings(item); +} + +async function loadDetail(instanceId, opener) { + const dialog = byId('abuse-monitoring-detail'); openDrawer(dialog, opener); + state.request?.abort('replaced'); const controller = new AbortController(); state.request = controller; + const status = byId('abuse-monitoring-detail-state'); status.hidden = false; status.className = 'alert alert-info'; status.textContent = '正在读取实例网络监控详情…'; + try { + if (!requestRuntime) throw new Error('只读请求组件不可用,请刷新页面。'); + const payload = await requestRuntime.read(`${config.detailApiUrl}/${encodeURIComponent(instanceId)}`, {signal: controller.signal, timeoutMs: 10000}); + if (state.request !== controller) return; + renderDetail(normalize(payload)); status.hidden = true; + } catch (error) { + if (controller.signal.aborted) return; + status.className = 'alert alert-danger'; status.textContent = error?.message || '监控详情暂不可读取。'; + } finally { if (state.request === controller) state.request = null; } +} + +if (root) { + root.querySelectorAll('[data-abuse-time]').forEach(element => { + element.textContent = date(element.dataset.abuseTime); + }); + document.querySelectorAll('[data-abuse-detail]').forEach(button => button.addEventListener('click', () => loadDetail(button.dataset.abuseDetail, button))); + byId('abuse-monitoring-detail-close')?.addEventListener('click', closeDrawer); + byId('abuse-monitoring-detail')?.addEventListener('cancel', event => { event.preventDefault(); closeDrawer(); }); + byId('abuse-monitoring-refresh')?.addEventListener('click', () => byId('abuse-monitoring-filter')?.requestSubmit?.()); +} + +export {normalize, directionLabel, rate, count, trendScales}; diff --git a/web/resources/views/venix/admin/cloud/abuse_monitoring.tpl b/web/resources/views/venix/admin/cloud/abuse_monitoring.tpl new file mode 100644 index 00000000..a197e400 --- /dev/null +++ b/web/resources/views/venix/admin/cloud/abuse_monitoring.tpl @@ -0,0 +1,96 @@ +{assign var=admin_title value='网络滥用监控'} +{assign var=admin_active value='abuse-monitoring'} +{include file='admin/static_header.tpl'} + +{if !$abuse_monitoring_page} + {assign var=abuse_monitoring_page value=['summary'=>['normal'=>0,'observing'=>0,'suspicious'=>0,'high_risk'=>0,'collection_anomaly'=>0,'total'=>0,'last_sample_at'=>''],'filters'=>['risk'=>'','direction'=>'','host_id'=>'','line_id'=>'','user_id'=>'','query'=>'','ip_version'=>'','page'=>1,'per_page'=>20],'options'=>['hosts'=>[],'lines'=>[]],'health'=>['worker_state'=>'unavailable','last_success_at'=>'','error_code'=>'','message'=>'监控数据暂不可用。'],'items'=>[],'pagination'=>['page'=>1,'per_page'=>20,'total'=>0,'total_pages'=>1,'from'=>0,'to'=>0]]} +{/if} +{assign var=abuse_filters value=$abuse_monitoring_page.filters|default:[]} +{assign var=abuse_health value=$abuse_monitoring_page.health|default:[]} +
+
+
+

Network observability

+

网络滥用监控

+

只读分析实例公网接口的聚合流量和连接模式;不读取通信正文,不会自动断网、限速或锁定实例。

+
+
+ + {if $abuse_health.worker_state|default:'unavailable' == 'healthy'}采集正常{elseif $abuse_health.worker_state|default:'' == 'stale'}采集数据已过期{elseif $abuse_health.worker_state|default:'' == 'degraded'}部分采集异常{else}采集暂不可用{/if} + + +
+
+ +
+ + + + + +
+ + {if $abuse_health.worker_state|default:'unavailable' != 'healthy'} + + {/if} + +
+

筛选实例

入站攻击和对外可疑行为使用不同分类,避免把受攻击实例误判为滥用来源。

+
+
+ + + + + + +
清除
+
+
+
+ +
+

实例网络状态

展示最近一个完整窗口;不完整、溢出和冷启动窗口不会用于风险判定。

共 {$abuse_monitoring_page.pagination.total|default:0|escape} 台
+
+
+ + {foreach $abuse_monitoring_page.items|default:[] as $item} + + + + + + + + + + {foreachelse} + + {/foreach} +
实例网络滥用监控结果
实例与用户节点与线路吞吐 / PPSTCP / UDP Flow风险与方向最近采样详情
{$item.instance_name|default:'未命名实例'|escape}{$item.user_name|default:'未知用户'|escape} · 用户 #{$item.user_id|default:'-'|escape}{$item.host_name|default:'节点未记录'|escape}{$item.line_name|default:'线路未记录'|escape}↓ {$item.metrics.rx_bps_display|default:'不可用'|escape}↑ {$item.metrics.tx_bps_display|default:'不可用'|escape}RX {$item.metrics.rx_pps_display|default:'不可用'|escape} · TX {$item.metrics.tx_pps_display|default:'不可用'|escape}TCP {$item.metrics.tcp_active_flows|default:'不可用'|escape}UDP {$item.metrics.udp_active_flows|default:'不可用'|escape}新建 {$item.metrics.tcp_new_flows|default:'不可用'|escape} / {$item.metrics.udp_new_flows|default:'不可用'|escape}{if $item.risk_state|default:'' == 'normal'}正常{elseif $item.risk_state|default:'' == 'observing'}观察中{elseif $item.risk_state|default:'' == 'suspicious'}可疑{elseif $item.risk_state|default:'' == 'high_risk'}高风险{else}采集异常{/if}{if $item.direction|default:'' == 'outbound'}对外可疑行为{elseif $item.direction|default:'' == 'inbound'}正在遭受攻击{elseif $item.direction|default:'' == 'both'}双向异常{else}未触发行为{/if}{$item.sample.quality_label|default:'样本不完整'|escape}
没有符合条件的监控记录{if $abuse_health.worker_state|default:'unavailable' == 'healthy'}请调整筛选条件或等待下一个完整采样窗口。{else}采集恢复后,此处才会显示可验证的实例状态。{/if}
+
+ +
+
+
+ + +

实例网络观测

监控详情

+
+
请选择实例查看最近趋势和触发规则。
+ +
+

最近窗口指标

+

最近趋势

+

触发规则

+
+
+ + +{include file='admin/static_footer.tpl'} diff --git a/web/resources/views/venix/admin/static_header.tpl b/web/resources/views/venix/admin/static_header.tpl index 19db1f8c..3d28e548 100644 --- a/web/resources/views/venix/admin/static_header.tpl +++ b/web/resources/views/venix/admin/static_header.tpl @@ -170,6 +170,7 @@
  • 云镜像模板
  • 救援镜像
  • 虚拟机管理
  • +
  • 网络滥用监控
  • 维护通知
  • 实例补偿
  • 系统运行与异常任务
  • diff --git a/web/tests/AdminAbuseMonitoringBehaviorTest.mjs b/web/tests/AdminAbuseMonitoringBehaviorTest.mjs new file mode 100644 index 00000000..49bc8915 --- /dev/null +++ b/web/tests/AdminAbuseMonitoringBehaviorTest.mjs @@ -0,0 +1,51 @@ +import fs from 'node:fs'; + +globalThis.document = { + querySelector: () => null, + getElementById: () => null, + querySelectorAll: () => [], +}; +globalThis.window = {}; + +const source = fs.readFileSync(new URL( + '../public/cloud/admin-abuse-monitoring.js', + import.meta.url, +), 'utf8'); +const module = await import( + `data:text/javascript;base64,${Buffer.from(source).toString('base64')}` +); + +const assert = (condition, message) => { + if (!condition) throw new Error(message); +}; + +assert(module.directionLabel('outbound').startsWith('对外可疑行为'), + 'Outbound behavior lost its canonical label.'); +assert(module.directionLabel('inbound').startsWith('正在遭受攻击'), + 'Inbound victim traffic lost its canonical label.'); +assert(module.directionLabel('both').startsWith('双向异常'), + 'Bidirectional evidence was collapsed into a one-sided label.'); + +const normalized = module.normalize({ + item: { + instance_id: '1', + direction: 'future_value', + metrics: {}, + sample: {}, + }, + series: [], + findings: [{severity: 'future_value'}, {severity: 'info'}], +}); +assert(normalized.direction === 'none' + && normalized.findings[0].severity === 'info' + && normalized.findings[1].severity === 'info', +'Unknown server enums must not become dynamic CSS classes.'); + +const scales = module.trendScales([ + {tx_bps: 10_000_000, tx_pps: 10}, + {tx_bps: 100, tx_pps: 2_000}, +]); +assert(scales.maxBps === 10_000_000 && scales.maxPps === 2_000, + 'Throughput and packet-rate trends must use independent scales.'); + +console.log('Administrator abuse-monitoring JavaScript behavior passed.'); diff --git a/web/tests/CloudAdminAbuseMonitoringApiTest.php b/web/tests/CloudAdminAbuseMonitoringApiTest.php new file mode 100644 index 00000000..b6c48df8 --- /dev/null +++ b/web/tests/CloudAdminAbuseMonitoringApiTest.php @@ -0,0 +1,87 @@ + 'GET', + 'REQUEST_URI' => $uri, + 'QUERY_STRING' => parse_url($uri, PHP_URL_QUERY) ?: '', + ]))->withAttribute('cloud_actor', $actor); +}; + +$controller = new CloudAdminAbuseMonitoringController(); +$readonly = [ + 'user_id' => 88, + 'is_admin' => true, + 'is_super_admin' => false, + 'can_manage' => false, +]; + +$index = $controller->index( + $request('/api/v1/admin/abuse-monitoring', $readonly, [ + 'per_page' => '2', + ]), + new Response() +); +$listed = json_decode((string) $index->getBody(), true, + flags: JSON_THROW_ON_ERROR); +$assert($index->getStatusCode() === 200 + && $index->getHeaderLine('Cache-Control') === 'private, no-store' + && is_array($listed['items'] ?? null) + && count($listed['items']) <= 2, + 'Read-only administrator list lost its response or cache boundary.'); + +$detail = $controller->detail( + $request('/api/v1/admin/abuse-monitoring/instances/2', $readonly), + new Response(), + ['id' => '2'] +); +$detailBody = (string) $detail->getBody(); +$decoded = json_decode($detailBody, true, flags: JSON_THROW_ON_ERROR); +$assert($detail->getStatusCode() === 200 + && $detail->getHeaderLine('Cache-Control') === 'private, no-store' + && ($decoded['item']['instance_id'] ?? '') === '2' + && count($decoded['series'] ?? []) <= 60 + && !str_contains($detailBody, 'metrics_json') + && !str_contains($detailBody, 'evidence_json') + && !str_contains($detailBody, '"remote_addresses"') + && !str_contains($detailBody, '"remote_ports"'), + 'Detail API leaked raw observation data or lost its bounded contract.'); + +try { + $controller->index( + $request('/api/v1/admin/abuse-monitoring', [ + 'user_id' => 89, + 'is_admin' => false, + ]), + new Response() + ); + throw new RuntimeException('Non-administrator monitoring access succeeded.'); +} catch (CloudError $error) { + $assert($error->httpStatus === 403, + 'Non-administrator monitoring access returned the wrong status.'); +} + +echo "Administrator abuse-monitoring API behavior passed.\n"; diff --git a/web/tests/CloudAdminAbuseMonitoringPageContractTest.php b/web/tests/CloudAdminAbuseMonitoringPageContractTest.php new file mode 100644 index 00000000..a44e1ed4 --- /dev/null +++ b/web/tests/CloudAdminAbuseMonitoringPageContractTest.php @@ -0,0 +1,94 @@ +.*?)\n \}/s', + $method, + $matches +) === 1) { + $throwableBlock = (string) ($matches['body'] ?? ''); +} +$assert(str_contains($method, 'CloudAccess::actor(false)') + && str_contains($method, '!($actor[\'is_admin\'] ?? false)') + && str_contains($method, 'CloudAdminAbuseMonitoringService())->page(') + && str_contains($method, "'private, no-store'") + && str_contains($method, "'abuse_monitoring_timezone' => 'UTC'") + && !str_contains($method, 'bootstrap_json') + && str_contains($method, "'网络监控数据暂时无法读取,请稍后重试。'") + && $throwableBlock !== '' + && !str_contains($throwableBlock, '$exception->getMessage()'), + 'Administrator first paint lost its authorization, safe fallback or cache boundary.'); + +$assert(str_contains($apiController, "'Cache-Control', 'private, no-store'") + && str_contains($service, "throw new CloudError('需要管理员权限', 403)") + && !preg_match( + '/->(?:insert|update|delete|lockForUpdate)\\s*\\(/', + $service . $apiController . $method + ), + 'Read-only monitoring gained a mutation or lost API authorization.'); + +$assert(str_contains($sidebar, 'href="/admin/abuse-monitoring"') + && str_contains($sidebar, + "admin_active|default:'' == 'abuse-monitoring'") + && strpos($sidebar, 'href="/admin/cloud/instances"') + < strpos($sidebar, 'href="/admin/abuse-monitoring"'), + 'Network monitoring is missing beside virtual-machine administration.'); + +echo "Administrator abuse-monitoring page contracts passed.\n"; diff --git a/web/tests/CloudAdminAbuseMonitoringUiContractTest.php b/web/tests/CloudAdminAbuseMonitoringUiContractTest.php new file mode 100644 index 00000000..4ce48449 --- /dev/null +++ b/web/tests/CloudAdminAbuseMonitoringUiContractTest.php @@ -0,0 +1,111 @@ +