使用webpack-obfuscator进行代码混淆及报错解决过程_Vue.js

背景

随着前端技术的发展，特别是单页应用（spa）的普及，越来越多的应用逻辑和业务代码暴露在客户端浏览器中运行。

这使得应用代码容易被查看、复制甚至修改，从而可能引发安全问题或商业机密泄露。

可以通过浏览器控制台查看页面源码, 如下图:

webpack-obfuscator 介绍

webpack-obfuscator 是一个用于混淆 webpack 打包后的 javascript 代码的插件。它通过对代码进行混淆处理，使原始代码变得难以阅读和理解，从而保护代码的知识产权和业务逻辑。

这种混淆通常包括变量重命名、字符串加密、控制流扁平化等技术手段。webpack-obfuscator 可以在构建过程中对 javascript 代码进行混淆，使其在部署到生产环境时更加安全。

安装

npm install webpack-obfuscator@2.6.0 javascript-obfuscator@3.2.7 --save-dev
# 或者
yarn add webpack-obfuscator@2.6.0 javascript-obfuscator@3.2.7 --dev

注意: 上面安装的版本对应的 webpack 4.47.0版本, 如果是 webpack 是低版本,对应的插件版本也要降低

参数解析

混淆选项 (options)

compact (boolean): 是否压缩输出的代码，默认为 true。
controlflowflattening (boolean): 是否启用控制流扁平化，默认为 false。
controlflowflatteningthreshold (number): 控制流扁平化的阈值，默认为 0.75。
deadcodeinjection (boolean): 是否注入死代码，默认为 false。
deadcodeinjectionthreshold (number): 死代码注入的阈值，默认为 0.4。
debugprotection (boolean): 是否启用调试保护，默认为 false。
debugprotectioninterval (boolean): 是否启用调试保护间隔，默认为 false。
domainlock (array<string>): 锁定指定的域名，默认为空数组。
identifiernamesgenerator (string): 生成标识符名称的方式，默认为 'mangled'。
log (boolean): 是否记录混淆过程，默认为 false。
numberstoexpressions (boolean): 是否将数字转换为表达式，默认为 false。
renameglobals (boolean): 是否重命名全局变量，默认为 false。
rotatestringarray (boolean): 是否启用字符串数组旋转，默认为 false。
selfdefending (boolean): 是否启用自我防御，默认为 false。
simplify (boolean): 是否简化输出代码，默认为 true。
sourcemap (boolean | string): 是否生成源映射，默认为 false。
sourcemapmode (string): 源映射模式，默认为 'separate'。
splitstrings (boolean): 是否将字符串分割成多个较小的字符串，默认为 false。
stringarrayencoding (array<string>): 字符串数组编码方式，默认为空数组。
stringarrayencodingthreshold (number): 字符串数组编码的阈值，默认为 0.75。
stringarraythreshold (number): 字符串数组阈值，默认为 0.75。
stringarraywrapperscount (number): 字符串数组包装器的数量，默认为 2。
stringarraywrapperschainedcalls (number): 字符串数组包装器链式调用的数量，默认为 2。
stringarraywrappersparametersmaxcount (number): 字符串数组包装器参数的最大数量，默认为 2。
stringarraywrappersparametersmincount (number): 字符串数组包装器参数的最小数量，默认为 1。
stringarraywrapperstype (string): 字符串数组包装器的类型，默认为 ‘variable’。
stringarraywrappersvarnames (array<string>): 字符串数组包装器变量名称，默认为空数组。
stringarrayindexshift (boolean): 是否对字符串数组索引进行偏移，默认为 false。
shufflestringarray (boolean): 是否打乱字符串数组，默认为 false。
transformobjectkeys (boolean): 是否转换对象键，默认为 false。
transformobjectkeysblacklist (array<string>): 不转换的对象键黑名单，默认为空数组。
transformobjectkeysrecursive (boolean): 是否递归转换对象键，默认为 false。
transformobjectkeyswhitelist (array<string>): 转换的对象键白名单，默认为空数组。
unicodeescapesequence (boolean): 是否使用 unicode 逃逸序列，默认为 false。
usestrictsemicolons (boolean): 是否使用严格的分号，默认为 false。
wrapcode (boolean): 是否包裹代码，默认为 false。
wrapcomments (boolean): 是否包裹注释，默认为 false。

排除选项 (exclude)

exclude (array<string> | regexp): 排除不需要混淆的模块或文件。

请注意，上述配置示例包含了所有可用的参数，但在实际项目中，你可能只需要设置其中的一部分。

强烈建议根据项目需求调整这些选项，以达到最佳的混淆效果并保持代码的可维护性和性能。

配置示例

接下来，在你的 webpack.config.js 文件中配置 webpack-obfuscator 插件。

以下是一个简单的示例配置：

const path = require("path");

const terserplugin = require("terser-webpack-plugin");

const webpackobfuscator = require('webpack-obfuscator');

module.exports = {
  configurewebpack: (config) => {
      config.resolve = {
        ...config.resolve,
        alias: {
          "@": resolve("src"),
        }
      },
      config.optimization = {
        ...config.minimizer,
        minimizer: [
          new terserplugin({
            terseroptions: {
              compress: {
                drop_console: true,
              },
            },
          }),
        ]
      }

    if (process.env.node_env === 'production') {
      config.plugins.push(
        new webpackobfuscator({
          // 压缩代码
          compact: true,
          // 是否启用控制流扁平化(降低1.5倍的运行速度)
          controlflowflattening: false,
          // 随机的死代码块(增加了混淆代码的大小)
          deadcodeinjection: false,
          // 此选项几乎不可能使用开发者工具的控制台选项卡
          debugprotection: false,
          // 如果选中，则会在“控制台”选项卡上使用间隔强制调试模式，从而更难使用“开发人员工具”的其他功能。
          debugprotectioninterval: false,
          // 通过用空函数替换它们来禁用console.log，console.info，console.error和console.warn。这使得调试器的使用更加困难。
          disableconsoleoutput: true,
          // 标识符的混淆方式 hexadecimal(十六进制) mangled(短标识符)
          identifiernamesgenerator: 'hexadecimal',
          log: false,
          // 是否启用全局变量和函数名称的混淆
          renameglobals: false,
          // 通过固定和随机（在代码混淆时生成）的位置移动数组。这使得将删除的字符串的顺序与其原始位置相匹配变得更加困难。如果原始源代码不小，建议使用此选项，因为辅助函数可以引起注意。
          rotatestringarray: true,
          // 混淆后的代码,不能使用代码美化,同时需要配置 cpmpat:true;
          selfdefending: true,
          // 删除字符串文字并将它们放在一个特殊的数组中
          stringarray: true,
          rotateunicodearray: true,
          //  stringarrayencoding: 'base64',
          stringarrayencoding: ['base64'],
          stringarraythreshold: 0.75,
          // 允许启用/禁用字符串转换为unicode转义序列。unicode转义序列大大增加了代码大小，并且可以轻松地将字符串恢复为原始视图。建议仅对小型源代码启用此选项。
          unicodeescapesequence: false,
          // 允许启用/禁用字符串转换为unicode转义序列。unicode转义序列大大增加了代码大小，并且可以轻松地将字符串恢复为原始视图。建议仅对小型源代码启用此选项。
          transformobjectkeys: true,

		  // 排除选项
      	  exclude: [/node_modules/, /\.min\.js$/]
        })
      )
    }
  },
}

代码混淆后

运行 npm run dev 报错 error: the number of constructor arguments in the derived class t must be >= than the number of constructor arguments of its base class.

上述报错说明项目的 webpack 版本对应的 webpack-obfuscator 和 javascript-obfuscator 版本过低导致报错

运行 npm run dev 报错 typeerror: cannot read property ‘tap’ of undefined

上述报错说明项目的 webpack 版本对应的 webpack-obfuscator 和 javascript-obfuscator 版本过高导致报错

查看 webpack 对应 webpack-obfuscator 版本可以去 git 官网的 tags 的 package.json 上进行详细查看

git 官网: https://github.com/javascript-obfuscator/webpack-obfuscator/tags

运行npm run build 打包时出现错误 typeerror: cannot read property ‘sourceandmap’ of undefined

npm官网文档也写到了 warning: right now plugin does not support sourcemap and sourcemapmode options!

解决方法:

修改 configurewebpack 配置, 将configurewebpack的对象模式改成函数形式

配置如下:

module.exports = {
  configurewebpack: (config) => {
    if (process.env.node_env === 'production') {
      config.plugins.push(
        new webpackobfuscator({
          // 压缩代码
          compact: true,
          // 是否启用控制流扁平化(降低1.5倍的运行速度)
          controlflowflattening: false,
          // 随机的死代码块(增加了混淆代码的大小)
          deadcodeinjection: false,
          // 此选项几乎不可能使用开发者工具的控制台选项卡
          debugprotection: false,
          // 如果选中，则会在“控制台”选项卡上使用间隔强制调试模式，从而更难使用“开发人员工具”的其他功能。
          debugprotectioninterval: false,
          // 通过用空函数替换它们来禁用console.log，console.info，console.error和console.warn。这使得调试器的使用更加困难。
          disableconsoleoutput: true,
          // 标识符的混淆方式 hexadecimal(十六进制) mangled(短标识符)
          identifiernamesgenerator: 'hexadecimal',
          log: false,
          // 是否启用全局变量和函数名称的混淆
          renameglobals: false,
          // 通过固定和随机（在代码混淆时生成）的位置移动数组。这使得将删除的字符串的顺序与其原始位置相匹配变得更加困难。如果原始源代码不小，建议使用此选项，因为辅助函数可以引起注意。
          rotatestringarray: true,
          // 混淆后的代码,不能使用代码美化,同时需要配置 cpmpat:true;
          selfdefending: true,
          // 删除字符串文字并将它们放在一个特殊的数组中
          stringarray: true,
          rotateunicodearray: true,
          //  stringarrayencoding: 'base64',
          stringarrayencoding: ['base64'],
          stringarraythreshold: 0.75,
          // 允许启用/禁用字符串转换为unicode转义序列。unicode转义序列大大增加了代码大小，并且可以轻松地将字符串恢复为原始视图。建议仅对小型源代码启用此选项。
          unicodeescapesequence: false,
          // 允许启用/禁用字符串转换为unicode转义序列。unicode转义序列大大增加了代码大小，并且可以轻松地将字符串恢复为原始视图。建议仅对小型源代码启用此选项。
          transformobjectkeys: true,
        })
      )
    }
  },
}