加密/哈希

AES 加密/解密

AES-GCM 对称加密与解密,支持密码派生密钥

明文
密码

什么是 AES-GCM?

AES-GCM(Advanced Encryption Standard - Galois/Counter Mode)是一种带认证的对称加密模式。它既提供机密性(加密),又提供完整性校验(防篡改),广泛应用于 TLS、磁盘加密和敏感数据存储。

本工具说明

  • 密钥派生:使用 PBKDF2 和 SHA-256 从您输入的密码派生 AES-256 密钥,迭代次数 100000
  • 密文格式:加密结果为 Base64 编码,内含盐值、IV 和密文,解密时需使用相同密码
  • 本地运行:加解密均在浏览器内完成,数据不会上传到服务器

使用场景

  • 敏感配置加密:将配置中的敏感信息加密后存储
  • 端到端加密:在客户端加密后再上传或传输
  • 本地数据保护:对本地存储的敏感数据进行加密

安全建议

请使用强密码(足够长度、包含大小写、数字和符号),并妥善保管。解密时需使用加密时相同的密码。

在浏览器内用 AES-GCM 做对称加解密:以 PBKDF2 从口令派生 256 位密钥,每次加密生成新的盐与 IV,输出含盐、IV、密文、认证标签的 Base64URL 串。适合加密敏感配置值,或核对另一端能否解开。

输出的不是密文,而是按位置拼接的四段

加密结果里没有裸密文。工具先生成 16 字节随机盐和 12 字节随机 IV,按「盐、IV、密文、标签」的顺序拼接到 GCM 输出前,再整体编码为 Base64URL。字段间没有分隔符,只靠位置识别:0–15 字节是盐,16–27 字节是 IV,末尾 16 字节是认证标签。由此得出 44 字节(16+12+16)的最小长度,正是解密路径执行的长度校验。字母表省略填充,解码端却同时接受标准 Base64、缺失的 = 与夹杂的空白。布局不匹配的载荷,不是解出乱码就是卡在标签校验。

每次加密的盐和 IV 为什么都要换

口令本身不是密钥。PBKDF2 以 SHA-256 迭代 100000 次把它拉伸成 256 位 AES 密钥,每条消息独立的盐让派生只对当前密文成立,两人用同一句口令也得不到同一把密钥。12 字节 IV 是 GCM 的原生 nonce 长度,该模式围绕 96 位设计。同一把密钥复用同一个 IV,损失的远不止机密性——由两段密文可推出认证密钥,进而伪造标签。每次点击都用 crypto.getRandomValues 重新取值,同一句话连加两次结果自然毫无关联。

口令错和密文被改,报的是同一个错误

GCM 属于 AEAD:解密要先校验 128 位认证标签才输出明文,而 Web Crypto 对「密钥不对」和「密文被改」抛的是同一种错误。因此本工具统一提示检查密码,即使真实原因是粘贴被截断或对方参数不同。这种一致性是有意为之——能区分两种失败的报错本身就是信息泄露——代价是错误文本无法指出真实成因。两个推论:Base64 串的任何改动(重新折行、大小写变化、混入全角字符)都会让标签校验失败;口令必须逐字节一致,工具不做 Unicode、空白或大小写的归一化。

实操示例

解开一段本工具生成的密文

输入
ChssPU5fYHGCk6S1xtfo-aGyw9Tl9gcYKTpLXLmfVzH6RV8Xj3QDOCZFugbRjP7fOz9WNv-ah8GgosfSkXzIZqanupn5knI4rpckSTbr
输出
Nonce reuse breaks GCM completely.

口令是 devtoolbox-aes。Base64 解码后的缓冲区共 78 字节:16 字节盐、12 字节 IV、34 字节密文、16 字节标签。78 能被 3 整除,所以上面的 Base64URL 恰好 104 个字符且没有 = 填充;原文是纯 ASCII,34 个字符即 34 个字节。

边界与常见误用

  • 组件只接入 AES-GCM,没有 CBC、CTR 或 ECB 选项,来自这些模式系统的密文即使密钥正确也无法在此解开。
  • 唯一可输入的秘密是口令,没有直接填入二进制密钥的入口,也不支持附加认证数据(AAD),与使用 AAD 的实现互通时会在标签校验处失败。
  • Base64 解码后不足 44 字节的输入会直接报错,因为 16 字节盐 + 12 字节 IV + 16 字节标签之后已无密文空间。
  • 派生出的密钥不缓存,每次加密或解密都会重新跑满 100000 次 PBKDF2 迭代,重复操作要反复付这份计算开销。
  • 不做任何持久化:刷新或关闭页面即丢失文本与口令,口令一旦忘记没有任何找回途径,也没有密钥提示或托管。

相关工具

出问题时先看这里

在手机上用 http://192.168.1.20 打开,点加密只弹出一句 Cannot read properties of undefined(读 importKey)。

原因Web Crypto 只在安全上下文里存在,纯 http 源上 crypto.subtle 是 undefined,第一次 importKey 调用就抛异常。本该提醒这点的黄色警告条不会出现,因为 cryptoAvailable 初始化为 true,之后再没有被赋值。

处理换 https 打开,或在本机用 localhost、127.0.0.1 访问。先看一眼地址栏协议再动输入框——在解密模式下,同一个故障会伪装成「密码错误」提示。

想加密的内容只有一个空格或一个换行,加密按钮始终是灰的,点不动。

原因按钮的 disabled 绑定和 encrypt() 开头的校验都用 inputText.trim() 判空,纯空白被当成空输入。口令框的规则恰好相反:单个空格能通过,因为只判断了真值,而且派生时不做 trim,那个空格会真的进密钥。

处理正文里至少放一个可见字符,把空白保留在更长的内容中间。不要为了让输入框通过而给口令末尾补空格,那一个字节会改变 PBKDF2 派生出的密钥。

解密提示成功,但原文变成一串菱形问号,中文或带重音的字母全没了。

原因128 位标签已经校验通过,说明密钥和布局都对。问题在 TextDecoder 没开 fatal: true,非法 UTF-8 字节被静默替换成 U+FFFD——原文大概率是 GBK、Shift-JIS、Latin-1,或干脆是文件二进制。

处理先在源头转成 UTF-8 再拿来加密。若载荷真是二进制,这个工具不适合承担它:输出区是文本,来回一趟必然失真。

把模式切到「解密」,刚生成的密文连同结果框一起消失了,示例按钮也不再填任何东西。

原因组件对 mode 挂了 watcher,每次切换都会清空 outputText;而 loadExample 只在 encrypt 模式下写入原文和口令,解密分支是显式赋空字符串。

处理切换模式前先点复制,清掉以后拿不回来。想研究内置示例,就在加密模式点「示例」、留住生成的那串密文,再切到解密粘贴回去。

从 URL 查询串里抠出来的密文,或连引号一起粘进来的密文,还没开始解密就被判成无效密文。

原因base64ToBytes 只把 - 和 _ 换回 + 和 /、去掉空白、补齐 = 填充。%2B 这类百分号转义和引号字符会原样留下,atob 遇到它们直接抛错,于是输入先被判成不是 Base64。

处理先做一次 URL 解码、剥掉首尾引号再粘。折行和空格不用管,解码前所有空白都会被清掉。

口令派生的 AES-GCM 单串,什么时候不该用

判断点本工具(AES 加密/解密)替代方案
对方拿不到事先约定的秘密这条路走不通:加解密两端必须已经持有同一句口令,因为 256 位密钥每次都由 PBKDF2-SHA256 现场派生,工具不接受别的密钥来源。用本站 RSA 工具加密一把一次性 AES 密钥给对方,或任何混合加密方案——这样传输的只有公钥和密文,共享秘密不必上路。
手头是 32 字节随机密钥,不是人记的口令唯一能输入的秘密是口令,输入什么都会被丢进 PBKDF2 跑 100000 次迭代,把现成的十六进制密钥粘进来,它只会被当成普通文本再拉伸一遍。写十几行 Python,用 cryptography 的 AESGCM 直接喂密钥字节:密钥原样使用,IV 和附加数据都能自己指定。
这串值要塞进 .env 的一行或 JSON 的某个字段输出就是一条 Base64URL:16 字节盐、12 字节 IV、密文、16 字节标签依次拼接,无填充、无空白,复制进单行不会断行也不会被转义。gpg --symmetric 或 age 更适合加密整份文件,但产出的是二进制或带首部行的 armored 文本,放进 JSON 得先转义或重新折行。
后端服务要能解开同一段密文只有后端逐字节复刻这套布局才通:盐 16、IV 12、密文、标签 16,密钥来自 PBKDF2-SHA256 的 100000 次迭代,且不带附加认证数据。后端若已经在用 AES-CBC + PKCS#7,或把盐存在单独的列里,就继续用它自己的库;本工具既读不了也造不出那种格式。
只要防篡改,内容本身还得让人看见用错了方向:GCM 的输出离开口令就是乱码,两份配置无法 diff,日志里的人也没法复核值有没有被改。改用本站 HMAC 工具:同样是共享密钥模型,但明文照常摆着、旁边附一个标签,改一个字节就能发现,值又始终可读。
只是不想让人一眼读出明文属于过度设计:要另编一句口令来保管,每次点击还要跑满 100000 次迭代,口令丢了值也就没了。直接上 Base64 工具:没有密钥、谁都能还原,当目标只是防止误读而不是控制权限时,这才是对等的取舍。

常见问题

AES 加密结果每次都不一样,是出错了吗?
不是。现代加密模式(CBC、GTR、GCM)每次加密都会生成随机 IV(初始向量),同一段明文每次密文都不同——这正是安全性的来源。解密时用密文中携带的 IV 即可还原出完全相同的明文。
密钥长度 128 位和 256 位怎么选?
目前两者都没有已知的可行攻击,128 位对绝大多数场景足够且略快;256 位为"数据要保密几十年"或合规要求预留余量。真正的短板从来不是密钥长度,而是密钥管理——密钥怎么存、怎么传比选哪个长度重要得多。
AES-GCM 和 AES-CBC 有什么区别?
GCM 在加密的同时生成认证标签(AEAD),能检测密文是否被篡改,是新系统的首选;CBC 只提供机密性,配合不当的填充方式历史上导致过多起_padding oracle_攻击。Web Crypto API 两者都支持,本工具均可使用。

内容复核: