feat: 遮蔽后台静态产物中的 Taro 指纹

Traefik 把 wechat.app.que01.top 上除 /api、/media 以外的路径直接转发到 Admin 静态
服务器且没有鉴权,因此 /admin/assets/*.js 可以被任意下载。后台产物里的模板 renderer
glob 路径(packages/template-*/taro/index.tsx)与按钮尺寸令牌(--taro-button-height)
同样暴露技术栈,此前只遮蔽了 Taro 双端产物。

- mask-taro.cjs 增加 admin 目标,覆盖 apps/admin/dist,接入根脚本 build:admin:preview;
- deploy:package 在后台构建后校验 apps/admin/dist,命中指纹即中止打包;
- 补充遮蔽目标测试与文档(ADR 0025、README、部署说明、交付清单)。

验证:后台产物遮蔽后 glob key 与运行时查找同步改名;未遮蔽/已遮蔽产物用生产静态
服务器跑同一套后台浏览器测试,失败内容逐字节一致(既有失败与本改动无关);H5 预览
11 项浏览器回归全部通过;admin 构建、lint、typecheck、deploy 与 API 测试通过。
This commit is contained in:
que01 committed 2026-10-13 23:18:43 +08:00
1 parent 9ad2776515
commit 4d1cd8f365
8 files changed
+63 -8

No files matched your search

+2 -1
View File
@@ -37,10 +37,11 @@ TEMPLATE_KEY=linjing-editorial pnpm --filter @personal-brand/taro build:weapp
## 构建产物遮蔽
生产构建会调用构建后处理脚本 `config/mask-taro.cjs`,按 `config/mask.config.json` 替换产物里的 Taro 标识符(文件名与内容使用同一张表),遮蔽后仍命中 `forbidden` 词表时构建失败。`build:h5`、`build:weapp`、`build:preview` 都已接入;`dev:h5`、`dev:preview` 保持原始命名便于调试。改架构名只改 `config/mask.config.json`;复核某次产物是否干净用:
生产构建会调用构建后处理脚本 `config/mask-taro.cjs`,按 `config/mask.config.json` 替换产物里的 Taro 标识符(文件名与内容使用同一张表),遮蔽后仍命中 `forbidden` 词表时构建失败。`build:h5`、`build:weapp`、`build:preview` 都已接入,后台静态产物由根脚本 `pnpm build:admin:preview` 用 `admin` 目标覆盖;`dev:h5`、`dev:preview` 保持原始命名便于调试。改架构名只改 `config/mask.config.json`;复核某次产物是否干净用:
```sh
TEMPLATE_KEY=acheng-campus-food node config/mask-taro.cjs weapp --check
node config/mask-taro.cjs admin --check
```
由于产物名称与源码名称不同,产物契约测试用 `test/mask-names.mjs` 的 `unmask()` 还原后再断言,浏览器测试的选择器写成 `:is(<源码名>, <遮蔽名>)`。机制与取舍见 [docs/adr/0025-build-output-stack-masking.md](../../docs/adr/0025-build-output-stack-masking.md)。
+4 -1
View File
@@ -8,6 +8,7 @@
* node config/mask-taro.cjs weapp 处理后 dist/<template>/weapp
* node config/mask-taro.cjs h5 处理后 dist/<template>/h5
* node config/mask-taro.cjs h5 --preview 处理后 dist/template-preview/h5
* node config/mask-taro.cjs admin 处理后后台静态产物 apps/admin/dist
* node config/mask-taro.cjs weapp --check 只检查是否仍有指纹,不修改
*/
const fs = require("node:fs");
@@ -75,6 +76,8 @@ function maskFileName(name, replacements) {
function resolveTargets(envType, preview) {
if (preview) return [path.join(taroRoot, "dist/template-preview/h5")];
// 后台静态产物同样对外可达,其中的模板 renderer 路径与按钮尺寸变量也会带出指纹。
if (envType === "admin") return [path.resolve(taroRoot, "../admin/dist")];
const templateKey = process.env.TEMPLATE_KEY;
if (!templateKey) throw new Error("TEMPLATE_KEY is required for non-preview masking");
return [path.join(taroRoot, "dist", templateKey, envType)];
@@ -192,6 +195,6 @@ function main() {
if (failed) process.exit(1);
}
module.exports = { maskText, maskFileName, maskDirectory, findLeaks, loadConfig };
module.exports = { maskText, maskFileName, maskDirectory, findLeaks, loadConfig, resolveTargets };
if (require.main === module) main();
+28 -1
View File
@@ -7,7 +7,13 @@ import { createRequire } from "node:module";
import { maskConfig, masked, unmask } from "./mask-names.mjs";
const require = createRequire(import.meta.url);
const { maskText, maskFileName, maskDirectory, findLeaks } = require("../config/mask-taro.cjs");
const {
maskText,
maskFileName,
maskDirectory,
findLeaks,
resolveTargets,
} = require("../config/mask-taro.cjs");
const replacements = maskConfig.replacements;
/** 长度超过 40 的 base64/哈希片段,遮蔽时必须原样保留。 */
@@ -31,6 +37,27 @@ test("遮蔽表在测试与构建之间保持一致", () => {
);
});
test("遮蔽目标覆盖双端产物、预览与后台静态产物", () => {
const taroRoot = path.resolve(import.meta.dirname, "..");
const previous = process.env.TEMPLATE_KEY;
try {
process.env.TEMPLATE_KEY = "example-template";
assert.deepEqual(resolveTargets("weapp", false), [
path.join(taroRoot, "dist/example-template/weapp"),
]);
assert.deepEqual(resolveTargets("h5", false), [
path.join(taroRoot, "dist/example-template/h5"),
]);
assert.deepEqual(resolveTargets("h5", true), [path.join(taroRoot, "dist/template-preview/h5")]);
assert.deepEqual(resolveTargets("admin", false), [path.resolve(taroRoot, "../admin/dist")]);
delete process.env.TEMPLATE_KEY;
assert.throws(() => resolveTargets("weapp", false), /TEMPLATE_KEY/);
} finally {
if (previous === undefined) delete process.env.TEMPLATE_KEY;
else process.env.TEMPLATE_KEY = previous;
}
});
test("文本遮蔽改标识符但不损坏不透明数据段", () => {
const content = `var tmpl="taro_tmpl";var key="${opaqueRun}";const modifyTaroEvent=1;`;
const result = maskText(content, replacements);