这个工具做什么
AES 是目前使用最广泛的对称加密算法。所谓对称,就是加密和解密用的是同一把密钥:发送方用密钥把明文变成密文,接收方用同一把密钥把密文还原成明文。它速度快、适合处理大量数据,几乎所有需要保护传输内容或存储内容的系统都会用到它。本工具把 AES 的两项常见工作放到浏览器里完成:用口令加密一段文字,或者用口令把本工具产生的密文解回文字。
必须先说清一个容易混淆的点:口令不是密钥本身。AES 需要的是长度固定、位分布均匀的密钥,而用户输入的口令通常长短不一、包含可预测的单词和习惯用词。把口令直接当密钥用,既不符合算法对长度的要求,也会让攻击者可以用字典快速尝试。因此本工具先用 PBKDF2-SHA256 做密钥派生(KDF):把口令、随机盐和迭代次数一起反复做哈希,输出一段符合长度要求的密钥材料。迭代 100000 次的作用是拉高单次尝试的计算成本,让暴力猜测变慢;盐的作用是让相同的口令在不同密文下派生出不同的密钥,从而避免「一次猜中、处处通用」。KDF 不是加密,它不可逆,只是把低熵的口令扩展成可用的密钥。
页面提供两种模式。AES-GCM 是带认证的加密模式,除了保密,还会为密文生成一段认证标签,解密时校验数据是否被改动;AES-CBC 只提供保密性,不检测篡改,需要调用方自己再加完整性保护。密钥长度可选 128、192、256 位,256 位是当前较稳妥的默认选择。两种模式都使用随机生成的 IV(初始化向量):GCM 为 12 字节,CBC 为 16 字节,盐固定为 16 字节,每次加密都重新生成,并与密文一起保存。
输出是一条自描述的单行 JSON,形如 {"v":1,"alg":"AES-256-GCM","kdf":"PBKDF2-SHA256","iter":100000,"salt":"…","iv":"…","ct":"…"}。它记录了解密所需的全部参数,所以可以直接整段粘回解密框,不需要另外记住模式与密钥长度。全部计算只发生在当前页面的内存里,不上传、不写存储。
怎么用
先在左侧选择模式与密钥长度,再输入口令。口令区分大小写,空格、全角半角、多一个换行都会导致派生结果不同,因此加密与解密必须使用完全一致的口令。日常使用时建议把口令单独记在一处,不要顺手改动。
加密时点「加密」按钮,按钮会高亮表示当前方向。在右侧输入框粘贴要保护的明文,再点一次「加密」执行;执行期间输入与按钮会短暂置灰,这是为了防止重复提交。完成后结果区显示一条单行 JSON,右侧状态栏会给出算法与密文字节数。点「复制」把整段 JSON 写入剪贴板,点「下载」保存为 aes-payload.json;需要继续处理别的文本时点「清空」,方向、模式与口令保持不变。
解密时先点「解密」切到解密方向。此时输入框的标签会变成「密文(JSON)」,把上一步得到的整段 JSON 原样粘进去,确认口令与加密时相同,再点「解密」。结果区会显示还原后的明文。若密文来自其他参数(例如别人用 AES-192-CBC 生成),页面会读取 JSON 里的 alg 与相关字段,按密文自己的参数解密,并把左侧选择同步过去,状态栏会说明这一点。
只要改动模式或密钥长度,页面就会立即清空上一次的结果并提示重新执行。这条规则是为了避免旧结果的参数与新选择混在一起,让人误以为新参数已经生效。切换加密与解密方向同样会清空结果,但输入框内容会保留,方便你先切方向再替换内容。
结果怎么解读
结果里的 JSON 各字段都有明确含义。v 是格式版本,当前固定为 1,用于将来兼容;alg 记录算法、密钥长度与模式,例如 AES-256-GCM;kdf 记录密钥派生方式,固定为 PBKDF2-SHA256;iter 是迭代次数 100000;salt 是 16 字节随机盐的 base64;iv 是本次随机 IV 的 base64;ct 是 Web Crypto 输出的原始密文字节的 base64。base64 只是一种把二进制转成可复制文本的编码,不提供任何保密性,任何人都能把它还原成字节。
盐和 IV 都不需要保密,它们本来就是随密文一起分发的参数。盐保证同一口令在不同次加密中得到不同密钥;IV 保证同样的明文在同样密钥下也得到不同的密文。反过来,如果丢了盐或 IV,解密就无法进行,因为派生密钥和分组链接都依赖它们。这也是本工具把两者写进同一个 JSON 的原因:密文自带还原所需的全部信息,减少人工记录参数出错的机会。
在 GCM 模式下,ct 里已经包含了解密时用于校验的 128 位认证标签,所以它比明文多 16 字节;任何一位被改动,解密都会直接失败,不会输出错误的明文。在 CBC 模式下,浏览器会按 PKCS#7 规则自动补齐最后一个分组,因此 ct 的长度总是 16 的整数倍。CBC 没有认证标签,口令错误时通常会在去补齐阶段失败,但也有较小概率解出乱码,本工具随后会用严格的 UTF-8 解码拦住这类结果,不会把乱码当明文展示。
解密得到的文本会按 UTF-8 严格还原。如果原始明文包含中文、表情符号等多字节字符,还原后应与原文完全一致;如果解码器报告非法 UTF-8,就说明这批字节不是本工具写入的合法文本,常见原因是口令不对或密文被截断,而不是编码设置选错了。
常见的几种情况
按钮全灰,提示需要安全上下文
这说明当前页面拿不到 crypto.subtle。最常见的原因是直接双击本地 HTML 文件打开,地址栏是文件路径;其次是用普通 http 地址访问。Web Crypto 属于高权限接口,浏览器只在安全上下文中暴露它,这是浏览器的策略,不是页面在等网络。此时所有输入与按钮都会置灰,并明确提示「需要安全上下文(https)才能使用浏览器加密接口」,不会出现点了没反应的情况。换成 https 地址访问本站即可恢复。
解密提示口令不正确或密文被修改
这是 GCM 认证失败或 CBC 去补齐失败时的统一提示。先核对口令:大小写、空格、全角字符、输入法残留都可能造成差异。再核对密文是否完整:复制时是否漏掉开头或结尾、聊天工具是否自动换行或改写了引号、是否只复制了 ct 而丢掉了 salt 与 iv。若密文确实被改动过分组内容,GCM 必然失败;CBC 可能报同样的错误,也可能解出无意义的字节后被 UTF-8 解码拦下。
解出来不是原来的文字
先确认密文是不是本工具生成的。其他库可能使用不同的 KDF、不同的迭代次数、不同的 IV 长度,甚至把认证标签单独存放,格式不匹配时本工具会在参数校验阶段直接说明哪个字段不受支持。其次确认没有在传输过程中被转义:例如把 JSON 放进 YAML 或多层字符串后,引号被加了反斜杠,粘回来就不是合法 JSON。最后确认口令没有在两次操作之间被改动。
想解密别处生成的 AES 密文
本工具只认自己这套约定:PBKDF2-SHA256、100000 次迭代、16 字节盐、GCM 12 字节或 CBC 16 字节 IV、ct 为原始字节的 base64。参数不同就不会成功,这是格式校验的正常结果。遇到这种情况,应在生成方确认实际参数,或直接用对应的服务端代码解密,不要在本工具里反复试错。
使用限制与提醒
IV 为什么必须每次随机:GCM 的安全性对 IV 唯一性要求极高。同一密钥下重复使用同一个 IV,会让攻击者有机会恢复出认证密钥,进而伪造密文,后果远超过普通的信息泄露;CBC 虽然不会因 IV 重复直接崩溃,但固定 IV 会让相同的明文开头产生相同的密文开头,泄露内容结构。所以本工具每次加密都重新取随机 IV,绝不复用。盐同理,每次重新生成,保证同一口令在不同密文下派生出不同的密钥。
CBC 与 GCM 的差别:GCM 是 AEAD 模式,加密的同时产出认证标签,解密时先验完整性再给明文,因此能明确拒绝被篡改的数据;CBC 只做分组链接,密文被改动时不一定报错,可能安静地解出错误内容。需要完整性时,CBC 必须额外配合 MAC,并注意「先加密再认证」的顺序与密钥分离,否则容易引入填充预言一类的问题。一般新项目应优先选 GCM;只有在对接只支持 CBC 的老系统时才使用 CBC,并自行补足完整性校验。
浏览器内加密不等于服务端密钥管理:页面能做的只是「用口令算一次密钥、加解密一段文本」。它没有密钥生命周期管理,没有密钥轮换、吊销、访问控制与操作审计,也没有硬件模块或密钥管理服务来隔离密钥。页面代码、浏览器扩展、输入法、剪贴板都可能接触到你输入的口令;一旦页面被注入脚本,口令与明文都可能被读走。因此本工具适合做配置示例、联调排查和教学演示,不适合存放生产主密钥,也不应作为生产数据的加密通道。
另外几点需要留意:PBKDF2 迭代 100000 次是常见下限,能提高猜测成本,但不能把弱口令变强,口令本身仍应有足够长度与随机性;本工具不提供口令强度评估,也不会阻止你使用短口令。密文与口令不要一起通过聊天工具、在线文档或工单系统传输。若需要长期保存重要数据,应使用成熟的服务端加密方案与受控的密钥管理设施,并保留审计记录。页面刷新后结果即消失,需要留用的内容请及时复制或下载。