/* ============================================================================
制品缓存管理页(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 '' + IP.esc(z.eco || z.zone) + " ";
}).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:
'",
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(); });
})();