feat(admin): add network abuse monitoring console

go
codex 1 week ago
parent bd103fc64b
commit e0ed03b044

@ -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 {

@ -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

@ -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');

@ -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');

@ -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; }
}

@ -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};

@ -0,0 +1,96 @@
{assign var=admin_title value='网络滥用监控'}
{assign var=admin_active value='abuse-monitoring'}
{include file='admin/static_header.tpl'}
<link rel="stylesheet" href="/cloud/admin-abuse-monitoring.css?v={$venix_asset_version}">
{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:[]}
<main data-admin-abuse-monitoring data-timezone="{$abuse_monitoring_timezone|default:'UTC'|escape}">
<div class="py-3 d-flex align-items-sm-center flex-sm-row flex-column gap-3">
<div class="flex-grow-1">
<p class="admin-eyebrow mb-1">Network observability</p>
<h1 class="fs-20 fw-semibold mb-1">网络滥用监控</h1>
<p class="text-muted mb-0">只读分析实例公网接口的聚合流量和连接模式;不读取通信正文,不会自动断网、限速或锁定实例。</p>
</div>
<div class="admin-abuse-heading-actions">
<span class="admin-config-status {if $abuse_health.worker_state|default:'unavailable' == 'healthy'}is-success{else}is-error{/if}" id="abuse-monitoring-notice" role="status" aria-live="polite">
{if $abuse_health.worker_state|default:'unavailable' == 'healthy'}采集正常{elseif $abuse_health.worker_state|default:'' == 'stale'}采集数据已过期{elseif $abuse_health.worker_state|default:'' == 'degraded'}部分采集异常{else}采集暂不可用{/if}
</span>
<button class="btn btn-light" id="abuse-monitoring-refresh" type="button"><i class="mdi mdi-refresh me-1" aria-hidden="true"></i>刷新</button>
</div>
</div>
<section class="row g-3 mb-3 admin-abuse-summary" aria-label="网络风险摘要">
<div class="col-6 col-xl"><a class="card admin-stat-card h-100 text-reset text-decoration-none" href="/admin/abuse-monitoring?risk=normal"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">正常</h2><strong class="admin-stat-value text-success">{$abuse_monitoring_page.summary.normal|default:0|escape}</strong><p class="text-muted fs-12 mb-0">样本完整且未触发规则</p></div><span class="admin-stat-icon text-success"><i class="mdi mdi-check-decagram-outline" aria-hidden="true"></i></span></div></a></div>
<div class="col-6 col-xl"><a class="card admin-stat-card h-100 text-reset text-decoration-none" href="/admin/abuse-monitoring?risk=observing"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">观察中</h2><strong class="admin-stat-value text-primary">{$abuse_monitoring_page.summary.observing|default:0|escape}</strong><p class="text-muted fs-12 mb-0">基线预热或单次异常</p></div><span class="admin-stat-icon text-primary"><i class="mdi mdi-eye-outline" aria-hidden="true"></i></span></div></a></div>
<div class="col-6 col-xl"><a class="card admin-stat-card h-100 text-reset text-decoration-none" href="/admin/abuse-monitoring?risk=suspicious"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">可疑</h2><strong class="admin-stat-value text-warning">{$abuse_monitoring_page.summary.suspicious|default:0|escape}</strong><p class="text-muted fs-12 mb-0">连续窗口触发低级规则</p></div><span class="admin-stat-icon text-warning"><i class="mdi mdi-alert-outline" aria-hidden="true"></i></span></div></a></div>
<div class="col-6 col-xl"><a class="card admin-stat-card h-100 text-reset text-decoration-none" href="/admin/abuse-monitoring?risk=high_risk"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">高风险</h2><strong class="admin-stat-value text-danger">{$abuse_monitoring_page.summary.high_risk|default:0|escape}</strong><p class="text-muted fs-12 mb-0">持续出现高强度异常连接</p></div><span class="admin-stat-icon text-danger"><i class="mdi mdi-shield-alert-outline" aria-hidden="true"></i></span></div></a></div>
<div class="col-6 col-xl"><a class="card admin-stat-card h-100 text-reset text-decoration-none" href="/admin/abuse-monitoring?risk=collection_anomaly"><div class="card-body"><div><h2 class="text-muted fs-14 fw-normal mb-1">采集异常</h2><strong class="admin-stat-value text-secondary">{$abuse_monitoring_page.summary.collection_anomaly|default:0|escape}</strong><p class="text-muted fs-12 mb-0">缺失数据不会按正常零值处理</p></div><span class="admin-stat-icon text-secondary"><i class="mdi mdi-access-point-network-off" aria-hidden="true"></i></span></div></a></div>
</section>
{if $abuse_health.worker_state|default:'unavailable' != 'healthy'}
<section class="alert {if $abuse_health.worker_state|default:'' == 'degraded' || $abuse_health.worker_state|default:'' == 'stale'}alert-warning{else}alert-danger{/if} admin-abuse-health" role="alert">
<div><strong>{if $abuse_health.worker_state|default:'' == 'stale'}采集数据已过期{elseif $abuse_health.worker_state|default:'' == 'degraded'}部分宿主机采集异常{else}监控采集暂不可用{/if}</strong><p class="mb-0">{$abuse_health.message|default:'当前没有可验证的监控数据;不会据此将实例判断为正常。'|escape}</p></div>
{if $abuse_health.last_success_at|default:''}<span>最后成功:<time data-abuse-time="{$abuse_health.last_success_at|escape}">{$abuse_health.last_success_at|escape}</time></span>{/if}
</section>
{/if}
<section class="card mb-3" aria-labelledby="abuse-monitoring-filter-title">
<div class="card-header"><h2 class="h5 card-title mb-1" id="abuse-monitoring-filter-title">筛选实例</h2><p class="text-muted fs-13 mb-0">入站攻击和对外可疑行为使用不同分类,避免把受攻击实例误判为滥用来源。</p></div>
<div class="card-body">
<form class="row g-2 align-items-end" id="abuse-monitoring-filter" method="get" action="/admin/abuse-monitoring">
<label class="col-xl-2 col-md-4" for="abuse-risk"><span class="form-label d-block">风险状态</span><select class="form-select" id="abuse-risk" name="risk"><option value="">全部状态</option><option value="normal"{if $abuse_filters.risk|default:'' == 'normal'} selected{/if}>正常</option><option value="observing"{if $abuse_filters.risk|default:'' == 'observing'} selected{/if}>观察中</option><option value="suspicious"{if $abuse_filters.risk|default:'' == 'suspicious'} selected{/if}>可疑</option><option value="high_risk"{if $abuse_filters.risk|default:'' == 'high_risk'} selected{/if}>高风险</option><option value="collection_anomaly"{if $abuse_filters.risk|default:'' == 'collection_anomaly'} selected{/if}>采集异常</option></select></label>
<label class="col-xl-2 col-md-4" for="abuse-direction"><span class="form-label d-block">行为方向</span><select class="form-select" id="abuse-direction" name="direction"><option value="">全部方向</option><option value="outbound"{if $abuse_filters.direction|default:'' == 'outbound'} selected{/if}>对外可疑行为</option><option value="inbound"{if $abuse_filters.direction|default:'' == 'inbound'} selected{/if}>正在遭受攻击</option><option value="both"{if $abuse_filters.direction|default:'' == 'both'} selected{/if}>双向异常</option><option value="none"{if $abuse_filters.direction|default:'' == 'none'} selected{/if}>未触发行为</option></select></label>
<label class="col-xl-2 col-md-4" for="abuse-host"><span class="form-label d-block">计算节点</span><select class="form-select" id="abuse-host" name="host_id"><option value="">全部节点</option>{foreach $abuse_monitoring_page.options.hosts|default:[] as $host}<option value="{$host.id|escape}"{if $abuse_filters.host_id|default:'' == $host.id} selected{/if}>{$host.name|escape}</option>{/foreach}</select></label>
<label class="col-xl-2 col-md-4" for="abuse-line"><span class="form-label d-block">线路</span><select class="form-select" id="abuse-line" name="line_id"><option value="">全部线路</option>{foreach $abuse_monitoring_page.options.lines|default:[] as $line}<option value="{$line.id|escape}"{if $abuse_filters.line_id|default:'' == $line.id} selected{/if}>{$line.name|escape}</option>{/foreach}</select></label>
<label class="col-xl-2 col-md-4" for="abuse-ip-version"><span class="form-label d-block">开放告警协议族</span><select class="form-select" id="abuse-ip-version" name="ip_version"><option value="">IPv4 与 IPv6</option><option value="ipv4"{if $abuse_filters.ip_version|default:'' == 'ipv4'} selected{/if}>IPv4</option><option value="ipv6"{if $abuse_filters.ip_version|default:'' == 'ipv6'} selected{/if}>IPv6</option></select></label>
<label class="col-xl-2 col-md-4" for="abuse-query"><span class="form-label d-block">实例、用户或编号</span><input class="form-control" id="abuse-query" name="query" type="search" maxlength="120" value="{$abuse_filters.query|default:''|escape}" placeholder="名称、用户或 ID"></label>
<div class="col-12 d-flex justify-content-end gap-2 pt-2"><a class="btn btn-light" href="/admin/abuse-monitoring">清除</a><button class="btn btn-primary" type="submit"><i class="mdi mdi-filter-outline me-1" aria-hidden="true"></i>应用筛选</button></div>
</form>
</div>
</section>
<section class="card" aria-labelledby="abuse-monitoring-list-title">
<div class="card-header d-flex justify-content-between align-items-center gap-2 flex-wrap"><div><h2 class="h5 card-title mb-1" id="abuse-monitoring-list-title">实例网络状态</h2><p class="text-muted fs-13 mb-0">展示最近一个完整窗口;不完整、溢出和冷启动窗口不会用于风险判定。</p></div><span class="badge text-bg-light">共 {$abuse_monitoring_page.pagination.total|default:0|escape} 台</span></div>
<div class="card-body">
<div class="table-responsive admin-abuse-table-wrap">
<table class="table table-hover align-middle mb-0 admin-abuse-table"><caption class="visually-hidden">实例网络滥用监控结果</caption><thead><tr><th scope="col">实例与用户</th><th scope="col">节点与线路</th><th scope="col">吞吐 / PPS</th><th scope="col">TCP / UDP Flow</th><th scope="col">风险与方向</th><th scope="col">最近采样</th><th scope="col" class="text-end">详情</th></tr></thead><tbody>
{foreach $abuse_monitoring_page.items|default:[] as $item}
<tr data-abuse-monitoring-row data-instance-id="{$item.instance_id|escape}">
<td data-label="实例与用户"><strong>{$item.instance_name|default:'未命名实例'|escape}</strong><span class="admin-abuse-cell-note">{$item.user_name|default:'未知用户'|escape} · 用户 #{$item.user_id|default:'-'|escape}</span></td>
<td data-label="节点与线路"><span>{$item.host_name|default:'节点未记录'|escape}</span><span class="admin-abuse-cell-note">{$item.line_name|default:'线路未记录'|escape}</span></td>
<td data-label="吞吐 / PPS"><span class="admin-abuse-metric-pair"><strong>↓ {$item.metrics.rx_bps_display|default:'不可用'|escape}</strong><strong>↑ {$item.metrics.tx_bps_display|default:'不可用'|escape}</strong></span><span class="admin-abuse-cell-note">RX {$item.metrics.rx_pps_display|default:'不可用'|escape} · TX {$item.metrics.tx_pps_display|default:'不可用'|escape}</span></td>
<td data-label="TCP / UDP Flow"><span class="admin-abuse-metric-pair"><strong>TCP {$item.metrics.tcp_active_flows|default:'不可用'|escape}</strong><strong>UDP {$item.metrics.udp_active_flows|default:'不可用'|escape}</strong></span><span class="admin-abuse-cell-note">新建 {$item.metrics.tcp_new_flows|default:'不可用'|escape} / {$item.metrics.udp_new_flows|default:'不可用'|escape}</span></td>
<td data-label="风险与方向"><span class="admin-abuse-risk is-{$item.risk_state|default:'collection_anomaly'|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}</span><span class="admin-abuse-direction is-{$item.direction|default:'none'|escape}">{if $item.direction|default:'' == 'outbound'}对外可疑行为{elseif $item.direction|default:'' == 'inbound'}正在遭受攻击{elseif $item.direction|default:'' == 'both'}双向异常{else}未触发行为{/if}</span></td>
<td data-label="最近采样"><time data-abuse-time="{$item.sample.sampled_at|default:''|escape}">{$item.sample.sampled_at|default:'时间未记录'|escape}</time><span class="admin-abuse-quality is-{$item.sample.quality|default:'incomplete'|escape}">{$item.sample.quality_label|default:'样本不完整'|escape}</span></td>
<td data-label="详情" class="text-end"><button class="btn btn-light btn-sm" type="button" data-abuse-detail="{$item.instance_id|escape}" aria-haspopup="dialog" aria-controls="abuse-monitoring-detail">查看详情</button></td>
</tr>
{foreachelse}
<tr><td colspan="7"><div class="admin-abuse-empty"><i class="mdi mdi-radar" aria-hidden="true"></i><strong>没有符合条件的监控记录</strong><span>{if $abuse_health.worker_state|default:'unavailable' == 'healthy'}请调整筛选条件或等待下一个完整采样窗口。{else}采集恢复后,此处才会显示可验证的实例状态。{/if}</span></div></td></tr>
{/foreach}
</tbody></table>
</div>
<nav class="admin-abuse-pagination" aria-label="监控结果分页">
<span>第 {$abuse_monitoring_page.pagination.page|default:1|escape} / {$abuse_monitoring_page.pagination.total_pages|default:1|escape} 页</span>
<div class="d-flex gap-2"><a class="btn btn-light btn-sm {if $abuse_monitoring_page.pagination.page|default:1 <= 1}disabled{/if}" href="{$abuse_monitoring_page.pagination.previous_url|default:'#'|escape}"{if $abuse_monitoring_page.pagination.page|default:1 <= 1} aria-disabled="true" tabindex="-1"{/if}>上一页</a><a class="btn btn-light btn-sm {if $abuse_monitoring_page.pagination.page|default:1 >= $abuse_monitoring_page.pagination.total_pages|default:1}disabled{/if}" href="{$abuse_monitoring_page.pagination.next_url|default:'#'|escape}"{if $abuse_monitoring_page.pagination.page|default:1 >= $abuse_monitoring_page.pagination.total_pages|default:1} aria-disabled="true" tabindex="-1"{/if}>下一页</a></div>
</nav>
</div>
</section>
</main>
<dialog data-admin-instance-drawer id="abuse-monitoring-detail" aria-labelledby="abuse-monitoring-detail-title">
<header class="admin-instance-drawer-header"><div><p class="text-muted fs-13 mb-1">实例网络观测</p><h2 class="h4 fw-semibold mb-0" id="abuse-monitoring-detail-title">监控详情</h2></div><button class="admin-modal-close position-static flex-shrink-0" id="abuse-monitoring-detail-close" type="button" aria-label="关闭监控详情" autofocus><i class="mdi mdi-close" aria-hidden="true"></i></button></header>
<div class="admin-instance-drawer-body">
<div id="abuse-monitoring-detail-state" class="alert alert-info" role="status" aria-live="polite">请选择实例查看最近趋势和触发规则。</div>
<section class="admin-abuse-direction-banner" id="abuse-monitoring-detail-direction" hidden></section>
<dl class="admin-instance-details" id="abuse-monitoring-detail-overview"></dl>
<h3 class="h6 mt-4 mb-2">最近窗口指标</h3><div class="admin-abuse-detail-metrics" id="abuse-monitoring-detail-metrics"></div>
<h3 class="h6 mt-4 mb-2">最近趋势</h3><div class="admin-abuse-trend" id="abuse-monitoring-detail-trend" aria-label="最近网络趋势"></div>
<h3 class="h6 mt-4 mb-2">触发规则</h3><div class="admin-abuse-findings" id="abuse-monitoring-detail-findings"></div>
</div>
</dialog>
<script>window.__VENIX_ABUSE_MONITORING__ = { detailApiUrl: '/api/v1/admin/abuse-monitoring/instances' };</script>
<script type="module" src="/cloud/admin-abuse-monitoring.js?v={$venix_asset_version}"></script>
{include file='admin/static_footer.tpl'}

@ -170,6 +170,7 @@
<li><a class="{if $admin_active|default:'' == 'cloud-templates'}active{/if}" href="/admin/cloud/templates"><i class="mdi mdi-disc"></i><span>云镜像模板</span></a></li>
<li><a class="{if $admin_active|default:'' == 'cloud-rescue'}active{/if}" href="/admin/cloud/rescue"><i class="mdi mdi-lifebuoy"></i><span>救援镜像</span></a></li>
<li><a class="{if $admin_active|default:'' == 'cloud-instances'}active{/if}" href="/admin/cloud/instances"><i class="mdi mdi-server"></i><span>虚拟机管理</span></a></li>
<li><a class="{if $admin_active|default:'' == 'abuse-monitoring'}active{/if}" href="/admin/abuse-monitoring"><i class="mdi mdi-radar"></i><span>网络滥用监控</span></a></li>
<li><a class="{if $admin_active|default:'' == 'maintenance-notices'}active{/if}" href="/admin/maintenance-notices"><i class="mdi mdi-email-alert-outline"></i><span>维护通知</span></a></li>
<li><a class="{if $admin_active|default:'' == 'service-compensations'}active{/if}" href="/admin/service-compensations"><i class="mdi mdi-clock-plus-outline"></i><span>实例补偿</span></a></li>
<li><a class="{if $admin_active|default:'' == 'cloud-operations'}active{/if}" href="/admin/operations"><i class="mdi mdi-clipboard-pulse-outline"></i><span>系统运行与异常任务</span></a></li>

@ -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.');

@ -0,0 +1,87 @@
<?php
declare(strict_types=1);
require dirname(__DIR__) . '/vendor/autoload.php';
use App\Controllers\CloudAdminAbuseMonitoringController;
use App\Services\Cloud\CloudError;
use Slim\Http\Environment;
use Slim\Http\Request;
use Slim\Http\Response;
ob_start();
require __DIR__ . '/CloudAdminAbuseMonitoringServiceTest.php';
ob_end_clean();
$assert = static function (bool $condition, string $message): void {
if (!$condition) {
throw new RuntimeException($message);
}
};
$request = static function (string $path, array $actor,
array $query = []): Request {
$uri = $path;
if ($query !== []) {
$uri .= '?' . http_build_query($query, '', '&', PHP_QUERY_RFC3986);
}
return Request::createFromEnvironment(Environment::mock([
'REQUEST_METHOD' => '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";

@ -0,0 +1,94 @@
<?php
$root = dirname(__DIR__);
$read = static function (string $path) use ($root): string {
$source = file_get_contents($root . '/' . $path);
if (!is_string($source)) {
throw new RuntimeException('Unable to read ' . $path);
}
return $source;
};
$assert = static function (bool $condition, string $message): void {
if (!$condition) {
throw new RuntimeException($message);
}
};
$pageRoutes = $read('config/routes.php');
$apiRoutes = $read('config/routes_cloud.php');
$middleware = $read('app/Middleware/CloudApi.php');
$pageController = $read('app/Controllers/Admin/CloudPageController.php');
$apiController = $read('app/Controllers/CloudAdminAbuseMonitoringController.php');
$service = $read('app/Services/Cloud/CloudAdminAbuseMonitoringService.php');
$sidebar = $read('resources/views/venix/admin/static_header.tpl');
$assert(str_contains(
$pageRoutes,
"get('/abuse-monitoring',\n 'App\\Controllers\\Admin\\CloudPageController:abuseMonitoring')"
) && str_contains($pageController, 'public function abuseMonitoring('),
'Administrator abuse-monitoring page route is not connected.');
$assert(str_contains(
$apiRoutes,
"get('/admin/abuse-monitoring',\n 'App\\Controllers\\CloudAdminAbuseMonitoringController:index')"
) && str_contains(
$apiRoutes,
"get('/admin/abuse-monitoring/instances/{id:[1-9][0-9]*}',\n 'App\\Controllers\\CloudAdminAbuseMonitoringController:detail')"
) && !preg_match(
"#(?:post|put|patch|delete|map)\\([^\\n]*'/admin/abuse-monitoring#i",
$apiRoutes
),
'Abuse-monitoring API must expose exactly read-only GET surfaces.');
$assert(str_contains(
$middleware,
"#^/api/v1/admin/abuse-monitoring(?:/|$)#D"
) && str_contains($middleware, 'CloudAccess::actor(!$databaseOnly)'),
'Database-only abuse-monitoring reads must not require an Agent session.');
$methodStart = strpos(
$pageController,
'public function abuseMonitoring('
);
$methodEnd = $methodStart === false ? false : strpos(
$pageController,
'public function maintenanceNotices(',
$methodStart
);
$method = $methodStart === false || $methodEnd === false
? '' : substr($pageController, $methodStart, $methodEnd - $methodStart);
$throwableBlock = '';
if (preg_match(
'/catch \(\\\\Throwable \$exception\) \{(?<body>.*?)\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";

@ -0,0 +1,111 @@
<?php
$root = dirname(__DIR__);
$read = static function (string $path): string {
$source = file_get_contents($path);
if (!is_string($source)) {
throw new RuntimeException('Unable to read ' . $path);
}
return $source;
};
$assert = static function (bool $condition, string $message): void {
if (!$condition) {
throw new RuntimeException($message);
}
};
$template = $read($root . '/resources/views/venix/admin/cloud/abuse_monitoring.tpl');
$script = $read($root . '/public/cloud/admin-abuse-monitoring.js');
$styles = $read($root . '/public/cloud/admin-abuse-monitoring.css');
$assert(str_contains($template, "admin_active value='abuse-monitoring'")
&& str_contains($template, '只读分析实例公网接口的聚合流量和连接模式')
&& str_contains($template, '不会自动断网、限速或锁定实例')
&& str_contains($template, 'data-admin-abuse-monitoring'),
'The page must be an explicitly read-only administrator-only monitoring surface.');
$assert(str_contains($template, '对外可疑行为')
&& str_contains($template, '正在遭受攻击')
&& str_contains($template, '双向异常')
&& str_contains($template, '避免把受攻击实例误判为滥用来源')
&& str_contains($script, "direction === 'outbound'")
&& str_contains($script, "direction === 'inbound'")
&& str_contains($script, "direction === 'both'")
&& !str_contains($template, 'outbound_abuse')
&& !str_contains($template, 'inbound_attack')
&& !str_contains($script, 'outbound_abuse')
&& !str_contains($script, 'inbound_attack'),
'Outbound abuse and inbound victim evidence must be presented as different states.');
$assert(str_contains($template, '采集异常')
&& str_contains($template, '缺失数据不会按正常零值处理')
&& str_contains($template, '不完整、溢出和冷启动窗口不会用于风险判定')
&& str_contains($script, "return parsed === null ? '不可用'")
&& !str_contains($script, "return parsed === null ? '0'"),
'Missing or incomplete observations must never be rendered as a healthy zero.');
$assert(str_contains($template, 'name="risk"')
&& str_contains($template, 'name="direction"')
&& str_contains($template, 'name="host_id"')
&& str_contains($template, 'name="line_id"')
&& str_contains($template, 'name="ip_version"')
&& str_contains($template, '开放告警协议族')
&& str_contains($template, 'name="query"'),
'The administrator list must expose the complete first-phase filter set.');
$assert(str_contains($template, '{$item.instance_name|default:')
&& str_contains($template, '{$item.user_name|default:')
&& str_contains($template, '{$item.host_name|default:')
&& str_contains($template, '{$item.line_name|default:')
&& str_contains($template, '{$item.metrics.rx_bps_display|default:')
&& str_contains($template, '{$item.metrics.tx_pps_display|default:')
&& str_contains($template, '{$item.metrics.tcp_active_flows|default:')
&& str_contains($template, '{$item.metrics.udp_active_flows|default:'),
'The list must provide identity, placement, throughput, PPS, and flow information.');
$assert(str_contains($template, '{$item.instance_name|default:\'未命名实例\'|escape}')
&& str_contains($template, '{$item.user_name|default:\'未知用户\'|escape}')
&& str_contains($template, '{$item.sample.quality_label|default:\'样本不完整\'|escape}')
&& !str_contains($template, ' nofilter'),
'SSR values must be escaped and must not expose unneeded raw bootstrap JSON.');
$assert(str_contains($script, 'window.VenixAdminRequestRuntime?.create?.()')
&& str_contains($script, 'requestRuntime.read(')
&& str_contains($script, "timeoutMs: 10000")
&& !preg_match('/requestRuntime\.(?:mutate|commit|enqueue)\s*\(/', $script),
'The details drawer must reuse the shared read runtime and expose no mutation path.');
$assert(str_contains($script, 'evidence_summary')
&& str_contains($script, '不保存远端地址或端口明细')
&& !str_contains($template, 'remote_ip')
&& !str_contains($template, 'remote_port'),
'The UI must show only bounded evidence summaries, never remote connection details.');
$assert(str_contains($styles, '@media (max-width: 767.98px)')
&& str_contains($styles, "content: attr(data-label)")
&& str_contains($styles,
'tr:not([data-abuse-monitoring-row]) td')
&& str_contains($styles, '.admin-abuse-detail-metrics')
&& str_contains($styles, '.admin-abuse-trend-chart')
&& str_contains($styles, '.admin-abuse-finding'),
'The list, detail metrics, trend, and findings must have responsive presentation contracts.');
$assert(str_contains($template, 'aria-disabled="true" tabindex="-1"'),
'Disabled pagination links must leave the keyboard tab order.');
$assert(str_contains($script, 'function trendScales(series)')
&& str_contains($script, 'maxBps: Math.max(')
&& str_contains($script, 'maxPps: Math.max(')
&& str_contains($styles, '.admin-abuse-finding.is-high')
&& str_contains($styles, '.admin-abuse-finding.is-info')
&& !str_contains($styles, '.admin-abuse-finding.is-medium')
&& !str_contains($styles, '.admin-abuse-finding.is-low')
&& str_contains($styles, '.admin-abuse-direction-banner.is-both'),
'Trend units, finding severity, and canonical direction styles must remain distinct.');
$assert(str_contains($template, 'data-abuse-time=')
&& str_contains($script,
"root.querySelectorAll('[data-abuse-time]')"),
'UTC service timestamps must be converted by the browser for display.');
echo "Administrator network-abuse monitoring UI contracts passed.\n";
Loading…
Cancel
Save