Files
persionalBrand/apps/taro/config/mask-taro.cjs
T
que01 4d1cd8f365 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 测试通过。
2026-10-13 23:18:43 +08:00

201 lines
6.9 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 构建后处理:把产物里的 Taro 指纹替换成中性标识。
*
* 同一张替换表同时作用于「文件名」和「文本内容」,因此 taro.js 会连文件名带引用
* 一起变成 appkit.js,模板名 taro_tmpl 与页面里的引用也会同步,无需分别维护。
*
* 用法:
* 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");
const path = require("node:path");
const taroRoot = path.resolve(__dirname, "..");
const configPath = path.join(__dirname, "mask.config.json");
/** 需要做文本替换的扩展名,二进制文件一律跳过。 */
const textExtensions = new Set([
".js",
".mjs",
".cjs",
".json",
".wxml",
".wxss",
".wxs",
".css",
".html",
]);
function loadConfig() {
return JSON.parse(fs.readFileSync(configPath, "utf8"));
}
/** 长键优先,避免 `@tarojs` 被 `taro` 抢先替换成 `@appkitjs` 这种半成品。 */
function orderedReplacements(replacements) {
return Object.entries(replacements ?? {}).sort(([a], [b]) => b.length - a.length);
}
function escapeRegExp(value) {
return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
}
/** 连续的长 base64/哈希片段:可能是内嵌图片、密钥或摘要,替换进去会损坏数据。 */
const opaqueRun = /[A-Za-z0-9+/=]{40,}/;
const opaqueRunSplit = /([A-Za-z0-9+/=]{40,})/;
/**
* 把内容切成「可替换区段」和「受保护区段」,只在前者做替换。
* 这样既能命中边界处的 `taro_tmpl`,也能命中 camelCase 的 `modifyTaroEvent`,
* 又不会动到内嵌的 base64 数据。
*/
function maskText(content, replacements) {
const entries = orderedReplacements(replacements);
return content
.split(opaqueRunSplit)
.map((segment) =>
opaqueRun.test(segment)
? segment
: entries.reduce(
(result, [from, to]) => result.replace(new RegExp(escapeRegExp(from), "g"), to),
segment,
),
)
.join("");
}
function maskFileName(name, replacements) {
return orderedReplacements(replacements).reduce(
(result, [from, to]) => result.replace(new RegExp(escapeRegExp(from), "g"), to),
name,
);
}
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)];
}
function walk(directory) {
const files = [];
for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
const full = path.join(directory, entry.name);
if (entry.isDirectory()) files.push(...walk(full));
else if (entry.isFile()) files.push(full);
}
return files;
}
function maskProjectConfig(directory, config) {
const target = path.join(directory, "project.config.json");
if (!fs.existsSync(target)) return;
const current = JSON.parse(fs.readFileSync(target, "utf8"));
const next = { ...current, ...(config.project ?? {}) };
fs.writeFileSync(target, `${JSON.stringify(next, null, 2)}\n`);
}
function renameFiles(directory, files, replacements) {
const renamed = [];
for (const file of files) {
const currentName = path.basename(file);
const nextName = maskFileName(currentName, replacements);
if (nextName === currentName) continue;
const next = path.join(path.dirname(file), nextName);
if (fs.existsSync(next)) throw new Error(`遮蔽后文件名冲突:${next}`);
fs.renameSync(file, next);
renamed.push([currentName, nextName]);
}
return renamed;
}
function maskDirectory(directory, config, { check = false } = {}) {
if (!fs.existsSync(directory)) throw new Error(`产物目录不存在:${directory}`);
const replacements = config.replacements ?? {};
const files = walk(directory);
let rewritten = 0;
for (const file of files) {
if (!textExtensions.has(path.extname(file))) continue;
const content = fs.readFileSync(file, "utf8");
const masked = maskText(content, replacements);
if (masked === content) continue;
rewritten += 1;
if (!check) fs.writeFileSync(file, masked);
}
const renamed = check ? [] : renameFiles(directory, files, replacements);
if (!check) maskProjectConfig(directory, config);
return {
directory,
scanned: files.length,
rewritten,
renamed,
leaked: findLeaks(directory, config),
};
}
/** 扫描整个产物目录,返回仍然含有指纹的位置,用于守卫。 */
function findLeaks(directory, config) {
const forbidden = config.forbidden ?? [];
if (!forbidden.length) return [];
const leaks = [];
for (const file of walk(directory)) {
const name = path.basename(file);
if (forbidden.some((token) => name.includes(token))) {
leaks.push(`${path.relative(directory, file)} :: 文件名`);
continue;
}
if (!textExtensions.has(path.extname(file))) continue;
const content = fs.readFileSync(file, "utf8");
for (const token of forbidden) {
if (content.includes(token)) {
leaks.push(`${path.relative(directory, file)} :: 内容包含 ${token}`);
break;
}
}
}
return leaks;
}
function main() {
const args = process.argv.slice(2);
const envType = args.find((arg) => !arg.startsWith("--")) ?? "weapp";
const preview = args.includes("--preview");
const check = args.includes("--check");
const config = loadConfig();
if (!config.enabled && !check) {
console.log("[mask] 配置为 enabled: false,跳过遮蔽");
return;
}
let failed = false;
for (const directory of resolveTargets(envType, preview)) {
const result = maskDirectory(directory, config, { check });
const relative = path.relative(taroRoot, result.directory);
console.log(
`[mask] ${relative}:扫描 ${result.scanned} 个文件,改写 ${result.rewritten} 个` +
(result.renamed.length ? `,重命名 ${result.renamed.length} 个` : ""),
);
for (const [from, to] of result.renamed) console.log(`[mask] 重命名 ${from} -> ${to}`);
if (result.leaked.length) {
failed = true;
console.error(`[mask] ${relative} 仍存在技术栈指纹:`);
for (const leak of result.leaked.slice(0, 20)) console.error(` - ${leak}`);
}
}
if (failed) process.exit(1);
}
module.exports = { maskText, maskFileName, maskDirectory, findLeaks, loadConfig, resolveTargets };
if (require.main === module) main();