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 测试通过。
4.3 KiB
4.3 KiB
0025 构建产物技术栈遮蔽
Context
模板预览(H5)与微信小程序产物都是外部可获取的材料:预览页面可以打开 DevTools 查看 DOM 与资源,小程序包也能从微信侧下载后反编译。Taro 的指纹在产物中大量出现且没有官方开关:taro_tmpl、base.wxml、utils.wxs、comp.*、taro.js、taro-*-core 自定义元素、taroWindowProvider、taro_tabbar_page、--taro-button-height、project.config.json 的 projectname 等。竞争对手据此可以判断预览与小程序都由 Taro 生成。
后台静态站点同样对外可达:Traefik 把 wechat.app.que01.top 上除 /api、/media 以外的全部路径直接转发到 Admin 静态服务器,没有鉴权中间件,因此 https://…/admin/assets/*.js 可以直接下载。后台产物里带有模板 renderer 的 glob 路径(packages/template-*/taro/index.tsx)和按钮尺寸令牌(--taro-button-height),同样会暴露技术栈。
Taro 4.3 没有隐藏这些名称的配置项。名称分别硬编码在 @tarojs/plugin-platform-weapp、@tarojs/vite-runner、@tarojs/runtime 内部;官方 hook(modifyBuildAssets、modifyMiniConfigs、modifyRunnerOpts)只能改写构建产物与配置,覆盖不到运行时内部硬编码的标识符。
Decision
- 在
apps/taro的生产构建脚本末尾增加构建后处理:apps/taro/config/mask-taro.cjs读取apps/taro/config/mask.config.json,对dist/<templateKey>/weapp、dist/<templateKey>/h5、dist/template-preview/h5做确定性改名;后台静态产物apps/admin/dist通过admin目标覆盖,接入根脚本build:admin:preview。 - 同一张替换表同时作用于文件名和文本内容,因此
taro.js与其引用会一起变成appkit.js,taro_tmpl与页面里的引用也保持同步,不需要维护两份映射。 - 只遮蔽 Taro 相关标识符;vite、rollup、rolldown 等通用打包工具的名称属于行业通用信息,不做处理。
- 长度 ≥ 40 的不透明串(内嵌 base64、摘要)保持原样,避免误改数据。
- 遮蔽后仍存在
forbidden词表命中时构建失败(退出码 1),因此产物不会静默泄露。 project.config.json的projectname、description由配置中性化。pnpm deploy:package在build:admin:preview之后对apps/admin/dist做一次指纹校验,命中即中止打包(scripts/deploy/package-release.mjs)。- 源码与开发构建不改名:
dev:h5、dev:preview输出保留 Taro 原始命名,便于本地调试;只有build:h5、build:weapp、build:preview产物会遮蔽。
Alternatives
- 用
pnpm patch修改@tarojs/*包内硬编码名称:升级即失效,且改动面覆盖多包,维护成本高。 - 只使用官方 hook 改产物:无法覆盖运行时内部标识符,指纹仍会残留。
- fork Taro 并发行私有包:收益有限,却把框架升级变成长期负担。
- 完全隐藏以“这是前端工程”为目标的其它工具:与目标无关,徒增维护面。
Consequences
- 产物中的名称与源码名称不一致,因此产物契约测试必须先
unmask()再断言,浏览器测试的选择器使用:is(<源码名>, <遮蔽名>)同时接受两种命名。 - 新增会出现在产物里的 Taro 标识符时,需要同时更新
mask.config.json的replacements与forbidden,否则构建会因为forbidden命中而失败(这是期望行为)。 - 必须通过
pnpm --filter @personal-brand/taro build:*构建。直接执行taro build不经过遮蔽。 - 后台静态产物必须通过
pnpm build:admin:preview(或pnpm deploy:package)构建;单独运行pnpm --filter @personal-brand/admin build不会遮蔽。 - 改架构名只改
mask.config.json,不需要改构建脚本、测试或文档中的映射。
Migration Plan
- 默认
enabled: true;出现遮蔽引起的问题时可临时置为false让构建脚本跳过处理,产物回到未遮蔽状态。 - 新增模板或升级 Taro 后先跑一次
build:weapp与build:preview,确认构建脚本的指纹检查通过。 - 需要复核某次产物是否干净时执行
TEMPLATE_KEY=<key> node config/mask-taro.cjs weapp --check(后台产物用node apps/taro/config/mask-taro.cjs admin --check);它只检查、不修改。