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_health.worker_state|default:'' == 'stale'}采集数据已过期{elseif $abuse_health.worker_state|default:'' == 'degraded'}部分宿主机采集异常{else}监控采集暂不可用{/if}{$abuse_health.message|default:'当前没有可验证的监控数据;不会据此将实例判断为正常。'|escape}
+ {if $abuse_health.last_success_at|default:''}最后成功:{/if}
+
+ {/if}
+
+
+
+
+
+
+
+
实例网络滥用监控结果| 实例与用户 | 节点与线路 | 吞吐 / PPS | TCP / UDP Flow | 风险与方向 | 最近采样 | 详情 |
+ {foreach $abuse_monitoring_page.items|default:[] as $item}
+
+ | {$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} |
+ |
+
+ {foreachelse}
+ 没有符合条件的监控记录{if $abuse_health.worker_state|default:'unavailable' == 'healthy'}请调整筛选条件或等待下一个完整采样窗口。{else}采集恢复后,此处才会显示可验证的实例状态。{/if} |
+ {/foreach}
+
+
+
+
+
+
+
+
+
+
+{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 @@
+