/* ============================================================================ 制品缓存管理页(cache.html) 数据源单一:`GET /api/admin/cache` 一次返回「上游表 + 是否生效 + 下游接入 命令 + 命中计数 + 变量契约」。UI 不做任何拼接——下游命令文案由后端 `config::CLIENT_HINTS` 下发(前缀与路由强耦合,写在前端必然漂移)。 交互:编辑(弹窗)/ 测试连通性 / 删除 / 一键复制接入命令。 ========================================================================== */ (function () { "use strict"; var D = null; // 最近一次快照(/api/admin/cache 的 data) var loading = false; function load(scan) { if (loading) return Promise.resolve(); loading = true; // scan=1 → 顺带盘点磁盘(秒级,大 zone 慎点);默认只读 nginx 记账(O(1)) return IP.api("GET", "/api/admin/cache" + (scan ? "?scan=1" : "")) .then(function (r) { D = r.data; render(); }) .catch(function (e) { IP.toast(e.message, true); }) .finally(function () { loading = false; }); } // ---------------- 渲染 ---------------- function render() { if (!D) return; var items = IP.arr(D.items); IP.$("cacheEntry").innerHTML = "网关入口:" + IP.esc(D.entry) + " · " + "已配置 " + D.configured + " / " + D.count + " 个路由 · " + "生效中 " + D.active + " · " + "连通性探针:" + IP.esc(D.probe_prefix) + "<route>(仅内网可达)"; IP.$("cacheBody").innerHTML = items.map(row).join(""); renderCapacity(); renderStats(); renderVars(); } function row(it) { var status; if (it.active) { status = '生效中'; } else if (!it.configured) { status = '未配置'; } else if (!it.enabled) { status = '已停用'; } else { status = '未生效'; } // 「一键复制」只给主路由(route == eco)显示:cargo-dl / pypi-files 属于 // cargo / pypi 生态,客户端配置同一条,重复给按钮只会让人以为要配两遍。 var isPrimary = it.route === it.eco; var down; if (isPrimary && it.client) { down = '
' + IP.esc(D.entry + it.uri) + '
' + ''; } else if (isPrimary) { down = '
' + IP.esc(D.entry + it.uri) + '
'; } else { down = '
' + IP.esc(D.entry + it.uri) + '
' + '计入 ' + IP.esc(it.eco) + ' 生态'; } var keyCell = it.key_set ? '' + IP.esc(it.key_masked) + '' : '无(不注入鉴权头)'; var ops = ' ' + (it.active ? ' ' : "") + (it.configured ? '' : ""); return "" + "" + IP.esc(it.eco) + "" + (isPrimary ? "" : "
" + IP.esc(it.route) + "") + "" + "" + IP.esc(it.uri) + "
" + down + "" + "" + (it.base ? "" + IP.esc(it.base) + "" : '未配置') + (it.base && it.base !== it.default_base ? '
官方源:' + IP.esc(it.default_base) + "" : "") + "" + "" + keyCell + "" + "" + status + "" + "" + ops + "" + ""; } // ---------------- 容量与淘汰 ---------------- /// 字节人类可读。保留一位小数——「50 GB 与 49.8 GB」这种差别要看得出来。 function fmtBytes(n) { n = Number(n) || 0; if (n < 1024) return n + " B"; var u = ["KB", "MB", "GB", "TB", "PB"], i = -1; do { n /= 1024; i++; } while (n >= 1024 && i < u.length - 1); return (Math.round(n * 10) / 10) + " " + u[i]; } function fmtSecs(s) { s = Number(s) || 0; if (s >= 86400) return Math.round(s / 86400) + " 天"; if (s >= 3600) return Math.round(s / 3600) + " 小时"; return s + " 秒"; } /// 水位条。颜色只看后端下发的 `level`——若在这里再比一遍阈值, /// 总览页与这页迟早会出现「一个绿一个红」,而数据是同一份。 function capBar(pct, level) { var color = level === "crit" ? "#dc2626" : (level === "warn" ? "#f59e0b" : "#16a34a"); var w = Math.max(0, Math.min(100, Number(pct) || 0)); return '
' + '
'; } function renderCapacity() { var c = D.capacity || {}; var zones = IP.arr(c.zones); var body = IP.$("capBody"); if (!c.available) { IP.$("capSummary").innerHTML = '容量读数不可用:' + IP.esc(c.reason || ""); body.innerHTML = '读不到 proxy_cache 区'; return; } var t = c.totals || {}; var diskTxt = (t.disk_bytes === null || t.disk_bytes === undefined) ? "" : " · 磁盘实测 " + fmtBytes(t.disk_bytes) + ""; IP.$("capSummary").innerHTML = "共 " + zones.length + " 个缓存区 · nginx 记账占用 " + fmtBytes(t.used_bytes) + " / " + fmtBytes(t.limit_bytes) + "(" + t.pct + "%)" + diskTxt + " · 条目 " + t.entries + " · 偏高 " + (t.warn || 0) + " · 严重 " + (t.crit || 0) + " · " + (c.scanned ? '已含磁盘实测:两者差额 = nginx 尚未回收的条目(手工清过缓存时会滞后,见下)' : '超上限按 LRU 自动淘汰;改容量需改 conf 的 max_size 后 reload'); body.innerHTML = zones.map(capRow).join(""); // 「按制品失效」的下拉跟容量表同源:不硬编码生态列表, // 免得加了 zone 之后这里少一项、只能靠「全部」兜着。 var sel = IP.$("capZone"); var keep = sel.value || "all"; sel.innerHTML = '' + zones.map(function (z) { return '"; }).join(""); sel.value = IP.arr(zones).some(function (z) { return z.zone === keep; }) ? keep : "all"; } function capRow(z) { var lv = z.level; var badge, note = ""; if (!z.dir_exists) { badge = '目录缺失'; note = '
磁盘目录不存在。nginx 只在启动时创建这些目录、运行期不自愈,' + '此后每次写缓存都会失败并断开客户端 —— 需 restart(reload 不够)'; } else if (z.index_pressure) { badge = '索引吃紧'; note = '
keys_zone 曾被打满,nginx 已改按条目数强制回收 —— 建议扩大 keys_zone'; } else if (z.cold || z.loading) { badge = '装载中'; note = '
正在从磁盘重建索引(条目数会一路上涨,属正常)'; } else if (lv === "crit") { badge = '接近上限'; } else if (lv === "warn") { badge = '占用偏高'; } else { badge = '正常'; } var routes = IP.arr(z.routes); var routeNote = routes.length > 1 ? '
' + IP.esc(routes.join(" / ")) + " 共用本区" : ""; var zoneNote = z.eco && z.eco !== z.zone ? '
zone ' + IP.esc(z.zone) + "" : ""; // 磁盘实测(点了「盘点磁盘」才有)。差额 = nginx 还没回收的条目: // 手工清过缓存文件时它会明显偏大(节点要等再被访问或到期才释放), // 所以这个差**如实显示**,而不是替用户抹平。 var diskLine = ""; if (z.disk_bytes !== null && z.disk_bytes !== undefined) { var lag = z.used_bytes - z.disk_bytes; var lagPct = z.used_bytes > 0 ? Math.abs(lag) / z.used_bytes : 0; var lagTxt = lagPct > 0.02 ? ' 账比盘多 ' + fmtBytes(lag) + "" : ""; diskLine = '
磁盘实测 ' + fmtBytes(z.disk_bytes) + " / " + z.disk_files + " 文件" + (z.disk_truncated ? "(已截断)" : "") + lagTxt + "
"; } return "" + "" + IP.esc(z.eco || z.zone) + "" + routeNote + zoneNote + "" + "" + IP.esc(z.dir) + "" + '
块 ' + fmtBytes(z.bsize) + " · inactive " + fmtSecs(z.inactive_secs) + "" + "" + capBar(z.pct, lv) + '
nginx 记账 ' + fmtBytes(z.used_bytes) + " / " + fmtBytes(z.limit_bytes) + " " + z.pct + "%
" + diskLine + "" + "" + z.entries + "" + "" + fmtBytes(z.keys_zone_bytes) + '
上限约 ' + (z.entries_cap_est || "-") + " 条" + "" + badge + note + "" + '' + ""; } /// 清空一个缓存区(`all` = 全部)。 /// /// 删除必须由后端做——**只删文件、不删目录**。手工 `rm -rf cache/` 会让 /// 该路由此后每次写缓存都 [crit] mkdir 失败并断开客户端(直到 restart), /// 这个坑在脚本里踩过一次。 function purge(zone) { var z = IP.arr((D.capacity || {}).zones).filter(function (x) { return x.zone === zone; })[0]; var what = zone === "all" ? "全部缓存区" : ("「" + ((z && (z.eco || z.zone)) || zone) + "」"); var detail = z ? "\n将删除 " + z.entries + " 个条目(约占 " + fmtBytes(z.used_bytes) + ")" : ""; if (!window.confirm("确定清空 " + what + " 的磁盘缓存?" + detail + "。\n" + "目录本身保留;清空后下次请求重新回源,不影响正确性。\n" + "(nginx 的容量记账要等下一轮 cache manager 才回落,刚清完可能仍显示旧值)")) return; IP.api("POST", "/api/admin/cache/purge", { zone: zone }).then(function (r) { var t = r.data.total || {}; IP.toast(r.msg + " 释放 " + fmtBytes(t.bytes)); load(); }).catch(function (e) { IP.toast(e.message, true); }); } // ---------------- 按制品失效(两步:预览 → 确认) ---------------- var lastPreview = null; // 上一次预览的结果,用于「确认失效」时复述删什么 /// 把缓存的命中结果渲染出来。命中为空也要明说 —— 最常见的情况其实是 /// 「关键字拼错了 / 记错了 key 形态」,沉默会让人以为功能坏了。 function showInval(r, applied) { var sum = IP.$("capInvalResult"); var box = IP.$("capInvalKeys"); var d = (r && r.data) || {}; var t = d.total || {}; var lines = []; if (!t.matched) { box.style.display = "none"; box.textContent = ""; sum.innerHTML = '没有命中任何条目' + ' · 请确认关键字;cache key 形如 <路由>:<URI><方法><Accept>' + ',例如 npm:/npm/lodashGET*/*(可先填 * 预览一遍看全部形态)'; return; } IP.arr(d.items).forEach(function (it) { if (!it.matched) return; lines.push("# " + it.zone + ":" + (applied ? ("已删除 " + it.deleted + " 个") : (it.matched + " 个命中")) + " " + fmtBytes(it.bytes)); IP.arr(it.keys).forEach(function (k) { lines.push(" → " + k); }); if (it.matched > IP.arr(it.keys).length) { lines.push(" …另有 " + (it.matched - IP.arr(it.keys).length) + " 个同类条目"); } }); sum.innerHTML = (applied ? '已失效 ' : '预览(未删除) ') + "共 " + t.matched + " 个 / " + fmtBytes(t.bytes) + (d.truncated ? ' ⚠️ 已达单次上限,数字是下界' + (applied ? "" : ";请把关键字写窄一些再执行") + "" : ""); box.textContent = lines.join("\n"); box.style.display = ""; } function invalidate(apply) { var pat = (IP.$("capMatch").value || "").trim(); if (!pat) { IP.toast("先填要失效的制品关键字", true); return Promise.resolve(); } var zone = IP.$("capZone").value || "all"; if (apply) { var t = (lastPreview && lastPreview.total) || {}; // 二次确认:把「删什么、删多少」复述清楚,而不是一句「确定吗」 if (!window.confirm("确定失效「" + pat + "」?\n" + "范围:" + (zone === "all" ? "全部缓存区" : zone) + "\n" + "将删除 " + (t.matched || "?") + " 个条目(约 " + fmtBytes(t.bytes || 0) + ")\n" + "目录本身保留;删掉的只是磁盘副本,下次请求重新回源,不影响正确性。")) { return Promise.resolve(); } } IP.$("capApply").disabled = true; return IP.api("POST", "/api/admin/cache/invalidate", { zone: zone, match: pat, apply: apply ? 1 : 0 }) .then(function (r) { if (apply) { lastPreview = null; IP.toast(r.msg); load(); } else { lastPreview = r.data; // 只有真的命中了才允许进入「确认」——否则按钮会诱人误点 IP.$("capApply").disabled = !((r.data.total || {}).matched > 0); } showInval(r, apply); }) .catch(function (e) { IP.toast(e.message, true); IP.$("capApply").disabled = true; }); } function renderStats() { var s = (D.stats && D.stats.by_ecosystem) || {}; var order = ["go", "cargo", "pypi", "npm", "maven", "docker", "global"]; IP.$("statsBody").innerHTML = order.map(function (eco) { var m = s[eco]; if (!m) return ""; var hit = m.HIT || 0; var miss = m.MISS || 0; var denom = hit + miss; var rate = denom ? Math.round((hit / denom) * 1000) / 10 + "%" : "-"; var cls = eco === "global" ? ' style="font-weight:600"' : ""; return "" + "" + IP.esc(eco) + "" + "" + hit + "" + miss + "" + "" + (m.BYPASS || 0) + "" + (m.EXPIRED || 0) + "" + "" + (m.REVALIDATED || 0) + "" + (m.UPDATING || 0) + "" + "" + (m.STALE || 0) + "" + "" + rate + ""; }).join(""); } function renderVars() { IP.$("varBody").innerHTML = IP.arr(D.variables).map(function (v) { return "" + IP.esc(v.name) + "" + IP.esc(v.desc) + ""; }).join(""); } // ---------------- 编辑弹窗 ---------------- /// 凭据字段刻意用「勾选才提交」:JSON body 里 key 字段**不出现** = 保留原值, /// 出现空串 = 清空。若默认提交空串,打开弹窗改个备注就会把上游凭据抹掉。 function edit(route) { var it = (D.items || []).filter(function (x) { return x.route === route; })[0] || {}; IP.modal({ title: "上游配置 · " + route, wide: true, submitText: "保存", html: '
' + '
' + '
' + '
' + '' + '' + '
必须带 http:// 或 https://,不要带尾斜杠。转发的目标 = 本地址 + location 前缀之后的路径。
' + '
' + '' + '' + '
填完整的 Authorization 头值(如 Bearer xxx / Basic yyy),不是只填 token —— 换成上游就换一套,模块不去猜 scheme。' + '留空则透传客户端自带的 Authorization(Docker Hub 的短期 Bearer token 走这条);' + '无论哪种,本网关自己的 sk_ 都会被剔除,不会传给上游。
' + '
' + '
' + '
' + '
' + '
' + '
' + '
' + '
' + "
", onMount: function (card, close) { var setKey = card.querySelector("#setKey"); var keyInput = card.querySelector('input[name="key"]'); setKey.addEventListener("change", function () { keyInput.disabled = !setKey.checked; if (setKey.checked) keyInput.focus(); }); card.querySelector("#fillDefault").addEventListener("click", function () { card.querySelector('input[name="base"]').value = it.default_base || ""; }); card.querySelector("form").addEventListener("submit", function (e) { e.preventDefault(); var f = e.target; var body = { route: route, base: f.base.value.trim(), name: f.name.value.trim(), desc: f.desc.value.trim(), note: f.note.value.trim(), enabled: card.querySelector("#enabled").checked }; // 只有勾了「修改凭据」才带 key 字段(空串 = 清空) if (setKey.checked) body.key = keyInput.value; IP.api("POST", "/api/admin/cache/save", body).then(function (r) { close(); IP.toast("已保存:" + r.data.route + (r.data.active ? "(生效中)" : "(未生效)")); load(); }).catch(function (err) { IP.toast(err.message, true); }); }); } }); } // ---------------- 连通性测试 ---------------- /// 走 `/_cache_test/`:与真实转发同一套「拼目标 + 换凭据」逻辑, /// 所以这里通了 = 真实请求能到上游。上游响应原样返回,故用原生 fetch 读文本 /// (不能走 IP.api:它假定响应是 ipass 的 JSON 信封)。 function test(route) { IP.toast("正在测试 " + route + " …"); fetch("/api/admin/cache/test?route=" + encodeURIComponent(route), { method: "POST", credentials: "same-origin", headers: { "Content-Type": "application/json" }, body: "{}" }).then(function (res) { return res.text().then(function (t) { var brief = t.replace(/\s+/g, " ").slice(0, 200); IP.toast(route + " → HTTP " + res.status + " " + brief, !res.ok); }); }).catch(function (e) { IP.toast(route + " 测试失败:" + e.message, true); }); } // ---------------- 删除 ---------------- function del(route) { if (!window.confirm("确定删除路由 " + route + " 的上游配置?\n删除后该生态立即返回 503,已缓存的制品在磁盘上仍可命中。")) return; IP.api("POST", "/api/admin/cache/delete", { route: route }).then(function () { IP.toast("已删除 " + route); load(); }).catch(function (e) { IP.toast(e.message, true); }); } // ---------------- 事件委托 ---------------- document.addEventListener("click", function (e) { var t = e.target; if (!t || !t.getAttribute) return; var copy = t.getAttribute("data-copy"); var edit_ = t.getAttribute("data-edit"); var test_ = t.getAttribute("data-test"); var del_ = t.getAttribute("data-del"); var purge_ = t.getAttribute("data-purge"); if (copy) { var it = (D.items || []).filter(function (x) { return x.route === copy; })[0]; var cmd = it && it.client && it.client.command; if (cmd) IP.copyText(cmd, "「" + copy + "」接入命令"); else IP.toast("该路由没有独立的客户端配置", true); return; } if (edit_) return edit(edit_); if (test_) return test(test_); if (del_) return del(del_); if (purge_) return purge(purge_); }); IP.$("cRefresh").addEventListener("click", function () { load().then(function () { IP.toast("已刷新"); }); }); IP.$("capRefresh").addEventListener("click", function () { load().then(function () { IP.toast("容量读数已刷新"); }); }); IP.$("capScan").addEventListener("click", function () { IP.toast("正在盘点磁盘…"); load(true).then(function () { IP.toast("磁盘盘点完成"); }); }); IP.$("capPurgeAll").addEventListener("click", function () { purge("all"); }); IP.$("capPreview").addEventListener("click", function () { invalidate(false); }); IP.$("capApply").addEventListener("click", function () { invalidate(true); }); // 改了关键字就把上一次的预览作废 —— 否则「确认失效」会拿着旧结果去删 IP.$("capMatch").addEventListener("input", function () { lastPreview = null; IP.$("capApply").disabled = true; IP.$("capInvalResult").innerHTML = ""; IP.$("capInvalKeys").style.display = "none"; IP.$("capInvalKeys").textContent = ""; }); IP.$("capMatch").addEventListener("keydown", function (e) { if (e.key === "Enter") invalidate(false); }); // 页面入口:boot 会先确认管理会话、装外壳,再调本回调 IP.boot("cache", function () { load(); }); })();