feat(admin): 管理端最小后台（独立监听 + 白名单 + 2FA）tsk_SCMtcGF4F434

实现「一个二进制三个监听」中的管理端： - 独立监听 ADMIN_LISTEN（默认 127.0.0.1:9443，FromEnv 拒绝 0.0.0.0/:: 等公网绑定） - 中间件链：mw_ipallow（CIDR 白名单，仅信任 RemoteAddr，默认内网段）→ mw_session（HttpOnly+Secure+SameSite=Strict cookie，Redis 30min 滑动 TTL） - 登录双因素：argon2id 密码 + RFC6238 TOTP；失败限流与临时锁定； TOTP 密钥 AES-GCM 加密入库；migration 000008 增补 admins 表；首个管理员由 cmd/adminctl create 创建（终端输出 otpauth URI/Secret） - 功能三块（html/template + embed 静态资源，原生 JS 二次确认）： 1. 码批次：表单生成→明文仅在本次 CSV 下载出现（不落盘/不入日志）；批次列表 + 整批作废（复用 #3 codes，新增 Store.ListBatches/VoidBatch） 2. 节点操作：列表 + 近期 node_events；replace 经 #14 ProvisionService、 draining/up 经 #5 Lifecycle（二者未就绪→注入 stub，UI 置灰）；二次确认 + CSRF 3. audit_log 查看：actor/action/target/时间范围过滤分页；同页查 node_events - 所有写操作写 audit_log（actor=用户名，meta 不含明文）；管理端仅记安全事件（登录失败/锁定/白名单拦截），不记常规访问日志 - internal/totp 复用包（与 doc/05 用户中心 2FA 同算法，纯标准库）测试：totp RFC6238 向量、argon2/AES 往返、白名单放行/拦截、会话滑动过期、登录成功/密码错/TOTP 错/未知用户/锁定、批次 CSV 含明文且 audit 不泄露、作废/节点操作的二次确认与 CSRF 缺失被拒、mock 断言 service 调用参数、审计过滤。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-13 14:49:32 +08:00
parent 787151245e
commit 6e99e32285
36 changed files with 3695 additions and 2 deletions
@@ -0,0 +1,47 @@
+{{define "title"}}审计{{end}}
+{{define "content"}}
+<h1>审计日志</h1>
+<form method="get" action="/audit" class="filters">
+  <label>操作者<input type="text" name="actor" value="{{.Data.Filter.Actor}}"></label>
+  <label>动作<input type="text" name="action" value="{{.Data.Filter.Action}}"></label>
+  <label>目标<input type="text" name="target" value="{{.Data.Filter.Target}}"></label>
+  <label>起<input type="text" name="from" value="{{.Data.FromStr}}" placeholder="2006-01-02"></label>
+  <label>止<input type="text" name="to" value="{{.Data.ToStr}}" placeholder="2006-01-02"></label>
+  <button type="submit">筛选</button>
+</form>
+
+<table>
+  <thead><tr><th>ID</th><th>时间</th><th>操作者</th><th>动作</th><th>目标</th><th>meta</th></tr></thead>
+  <tbody>
+  {{range .Data.Entries}}
+    <tr><td>{{.ID}}</td><td>{{fmtTime .At}}</td><td>{{.Actor}}</td><td>{{.Action}}</td><td>{{.Target}}</td><td class="meta">{{.Meta}}</td></tr>
+  {{else}}
+    <tr><td colspan="6" class="muted">无匹配记录</td></tr>
+  {{end}}
+  </tbody>
+</table>
+<div class="pager">
+  {{if .Data.HasPrev}}<a href="{{.Data.PrevURL}}">上一页</a>{{end}}
+  <span class="muted">共 {{.Data.Total}} 条</span>
+  {{if .Data.HasNext}}<a href="{{.Data.NextURL}}">下一页</a>{{end}}
+</div>
+
+<h2>节点事件</h2>
+<form method="get" action="/audit" class="filters">
+  <input type="hidden" name="actor" value="{{.Data.Filter.Actor}}">
+  <input type="hidden" name="action" value="{{.Data.Filter.Action}}">
+  <input type="hidden" name="target" value="{{.Data.Filter.Target}}">
+  <label>节点 ID<input type="text" name="node_id" value="{{.Data.NodeIDStr}}"></label>
+  <button type="submit">查看节点事件</button>
+</form>
+<table>
+  <thead><tr><th>ID</th><th>时间</th><th>节点</th><th>事件</th><th>detail</th></tr></thead>
+  <tbody>
+  {{range .Data.NodeEvents}}
+    <tr><td>{{.ID}}</td><td>{{fmtTime .At}}</td><td>{{.NodeID}}</td><td>{{.Event}}</td><td class="meta">{{.Detail}}</td></tr>
+  {{else}}
+    <tr><td colspan="5" class="muted">输入节点 ID 查看其事件</td></tr>
+  {{end}}
+  </tbody>
+</table>
+{{end}}
@@ -0,0 +1,31 @@
+{{define "base"}}<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{{block "title" .}}控制台{{end}} · Pangolin 管理后台</title>
+<link rel="stylesheet" href="/static/style.css">
+</head>
+<body>
+<header class="topbar">
+  <span class="brand">Pangolin 管理后台</span>
+  <nav>
+    <a href="/" class="{{if eq .Active "dashboard"}}on{{end}}">概览</a>
+    <a href="/codes" class="{{if eq .Active "codes"}}on{{end}}">码批次</a>
+    <a href="/nodes" class="{{if eq .Active "nodes"}}on{{end}}">节点</a>
+    <a href="/audit" class="{{if eq .Active "audit"}}on{{end}}">审计</a>
+  </nav>
+  <span class="who">
+    {{.Username}}
+    <form method="post" action="/logout" class="inline">
+      <input type="hidden" name="csrf_token" value="{{.CSRF}}">
+      <button class="link" type="submit">退出</button>
+    </form>
+  </span>
+</header>
+{{if .Flash}}<div class="flash">{{.Flash}}</div>{{end}}
+<main>
+{{block "content" .}}{{end}}
+</main>
+</body>
+</html>{{end}}
@@ -0,0 +1,64 @@
+{{define "title"}}码批次{{end}}
+{{define "content"}}
+<h1>码批次</h1>
+
+<section class="card">
+  <h2>生成新批次</h2>
+  <p class="hint">明文激活码仅在本次 CSV 下载中出现一次，不落盘、不入日志。请妥善保存下载文件。</p>
+  <form method="post" action="/codes">
+    <input type="hidden" name="csrf_token" value="{{.CSRF}}">
+    <label>套餐
+      <select name="plan" required>
+        <option value="pro">pro</option>
+        <option value="team">team</option>
+        <option value="free">free</option>
+      </select>
+    </label>
+    <label>时长(天)<input type="number" name="duration_days" min="1" max="3650" value="30" required></label>
+    <label>数量<input type="number" name="count" min="1" max="5000" value="100" required></label>
+    <label>渠道
+      <select name="channel" required>
+        <option value="manual">manual</option>
+        <option value="store">store</option>
+        <option value="tg">tg</option>
+        <option value="line">line</option>
+      </select>
+    </label>
+    <label>备注<input type="text" name="note" maxlength="255" placeholder="可选"></label>
+    <button type="submit">生成并下载 CSV</button>
+  </form>
+</section>
+
+<section class="card">
+  <h2>批次列表</h2>
+  <table>
+    <thead><tr><th>ID</th><th>渠道</th><th>创建者</th><th>备注</th><th>创建时间</th><th>总数</th><th>已用</th><th>作废</th><th>未用</th><th>操作</th></tr></thead>
+    <tbody>
+    {{range .Data.Batches}}
+      <tr>
+        <td>{{.ID}}</td><td>{{.Channel}}</td><td>{{.CreatedBy}}</td><td>{{.Note}}</td>
+        <td>{{fmtTime .CreatedAt}}</td>
+        <td>{{.Total}}</td><td>{{.Redeemed}}</td><td>{{.Void}}</td><td>{{.Unused}}</td>
+        <td>
+          {{if gt .Unused 0}}
+          <form method="post" action="/codes/void" class="inline confirm" data-confirm="确认作废批次 {{.ID}} 的全部未使用激活码？此操作不可撤销。">
+            <input type="hidden" name="csrf_token" value="{{$.CSRF}}">
+            <input type="hidden" name="batch_id" value="{{.ID}}">
+            <input type="hidden" name="confirm" value="yes">
+            <button class="danger" type="submit">整批作废</button>
+          </form>
+          {{else}}<span class="muted">—</span>{{end}}
+        </td>
+      </tr>
+    {{else}}
+      <tr><td colspan="10" class="muted">暂无批次</td></tr>
+    {{end}}
+    </tbody>
+  </table>
+  <div class="pager">
+    {{if .Data.HasPrev}}<a href="/codes?offset={{.Data.PrevOffset}}">上一页</a>{{end}}
+    {{if .Data.HasNext}}<a href="/codes?offset={{.Data.NextOffset}}">下一页</a>{{end}}
+  </div>
+</section>
+<script src="/static/confirm.js"></script>
+{{end}}
@@ -0,0 +1,10 @@
+{{define "title"}}概览{{end}}
+{{define "content"}}
+<h1>概览</h1>
+<p>欢迎，{{.Username}}。请从上方导航选择操作。</p>
+<ul class="cards">
+  <li><a href="/codes"><strong>码批次</strong><span>生成 / 导出 / 作废</span></a></li>
+  <li><a href="/nodes"><strong>节点</strong><span>状态 / 替换 / 上下线</span></a></li>
+  <li><a href="/audit"><strong>审计</strong><span>操作与事件查询</span></a></li>
+</ul>
+{{end}}
@@ -0,0 +1,20 @@
+{{define "login"}}<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>登录 · Pangolin 管理后台</title>
+<link rel="stylesheet" href="/static/style.css">
+</head>
+<body class="centered">
+<form method="post" action="/login" class="card login">
+  <h1>管理后台登录</h1>
+  {{if .Flash}}<div class="error">{{.Flash}}</div>{{end}}
+  <label>用户名<input type="text" name="username" autocomplete="username" required autofocus></label>
+  <label>密码<input type="password" name="password" autocomplete="current-password" required></label>
+  <label>动态验证码 (TOTP)<input type="text" name="totp" inputmode="numeric" autocomplete="one-time-code" pattern="[0-9]*" maxlength="6" required></label>
+  <button type="submit">登录</button>
+  <p class="hint">仅限内网 / SSH 隧道访问。</p>
+</form>
+</body>
+</html>{{end}}
@@ -0,0 +1,52 @@
+{{define "title"}}节点{{end}}
+{{define "content"}}
+<h1>节点</h1>
+{{if not .Data.ProvisionReady}}<div class="warn">节点替换服务（#14）尚未接入，相关按钮已置灰。</div>{{end}}
+{{if not .Data.LifecycleReady}}<div class="warn">节点生命周期服务（#5）尚未接入，上/下线按钮已置灰。</div>{{end}}
+
+<table>
+  <thead><tr><th>ID</th><th>名称</th><th>地区</th><th>tier</th><th>权重</th><th>状态</th><th>厂商</th><th>近期事件</th><th>操作</th></tr></thead>
+  <tbody>
+  {{range .Data.Nodes}}
+    <tr>
+      <td>{{.ID}}</td>
+      <td>{{.NameZH}}<br><span class="muted">{{.UUID}}</span></td>
+      <td>{{.Region}}</td>
+      <td>{{.Tier}}</td>
+      <td>{{.Weight}}</td>
+      <td><span class="status status-{{.Status}}">{{.Status}}</span></td>
+      <td>{{.Provider}}</td>
+      <td>
+        {{range .RecentEvents}}<div class="ev">{{.Event}} <span class="muted">{{fmtTime .At}}</span></div>{{else}}<span class="muted">—</span>{{end}}
+      </td>
+      <td class="ops">
+        <form method="post" action="/nodes/op" class="inline confirm" data-confirm="确认替换节点 {{.ID}}（{{.NameZH}}）？将开通新节点并下线旧节点。">
+          <input type="hidden" name="csrf_token" value="{{$.CSRF}}">
+          <input type="hidden" name="node_id" value="{{.ID}}">
+          <input type="hidden" name="op" value="replace">
+          <input type="hidden" name="confirm" value="yes">
+          <button type="submit" {{if not $.Data.ProvisionReady}}disabled{{end}}>替换</button>
+        </form>
+        <form method="post" action="/nodes/op" class="inline confirm" data-confirm="确认将节点 {{.ID}} 置为 draining（停止接入新连接）？">
+          <input type="hidden" name="csrf_token" value="{{$.CSRF}}">
+          <input type="hidden" name="node_id" value="{{.ID}}">
+          <input type="hidden" name="op" value="draining">
+          <input type="hidden" name="confirm" value="yes">
+          <button type="submit" {{if not $.Data.LifecycleReady}}disabled{{end}}>draining</button>
+        </form>
+        <form method="post" action="/nodes/op" class="inline confirm" data-confirm="确认将节点 {{.ID}} 置为 up（恢复接入）？">
+          <input type="hidden" name="csrf_token" value="{{$.CSRF}}">
+          <input type="hidden" name="node_id" value="{{.ID}}">
+          <input type="hidden" name="op" value="up">
+          <input type="hidden" name="confirm" value="yes">
+          <button type="submit" {{if not $.Data.LifecycleReady}}disabled{{end}}>up</button>
+        </form>
+      </td>
+    </tr>
+  {{else}}
+    <tr><td colspan="9" class="muted">暂无节点</td></tr>
+  {{end}}
+  </tbody>
+</table>
+<script src="/static/confirm.js"></script>
+{{end}}