纯前端笔记加密只能实现“防小白”级保护,必须用web crypto api的derivekey+decrypt配合用户密码、盐值和iv,且密钥派生iterations≥100000;localstorage明文存储、弱算法或未引入cryptojs均不安全,后端参与才是真加密。

HTML 本身无法实现真正的笔记加密
浏览器里纯 HTML/CSS/JS 没有加密能力,localStorage、sessionStorage 存的都是明文,哪怕加了“密码提示”也只是障眼法。用户按 F12 就能直接看到所有 JS 逻辑和密钥处理过程,atob()、btoa() 或简单异或根本挡不住任何有基础的人。
常见错误现象:Uncaught TypeError: Cannot read property 'decrypt' of undefined 这类报错往往来自强行套用 CryptoJS 但没引入库,或用了 Web Crypto API 却没处理 SubtleCrypto 的 Promise 异步链。
- 真正加密必须后端参与(比如用 AES-GCM 加密后存服务端),前端只做解密展示
- 如果坚持纯前端,只能接受“防小白”级别保护:用
Web Crypto API的deriveKey+decrypt,但密钥派生必须依赖用户输入的密码 + 盐值(salt) - 别用
md5或sha1当密钥——它们不可逆但不抗穷举,密码短就秒破
Web Crypto API 实现密码派生与解密的关键步骤
现代浏览器支持的 SubtleCrypto 是目前唯一靠谱的纯前端加密路径,但它不是“输密码→自动解密”,而是一整套需要手动串联的操作。
使用场景:用户输入密码 → 派生出对称密钥 → 解密已加密的笔记内容(base64 编码的 ciphertext)
- 必须用
importKey把派生出的密钥转成CryptoKey对象,不能直接传字符串 - 加密时用的算法、IV(初始化向量)、盐值(salt)必须和解密时完全一致,否则
decrypt返回空 ArrayBuffer -
deriveKey的iterations建议 ≥ 100000,太低会被暴力破解;但太高又卡 UI(可用setTimeout或requestIdleCallback拆分) - IV 和 salt 必须和密文一起存储(比如拼在 base64 前面),否则每次解密都失败
简短示例(仅核心逻辑):
const salt = new Uint8Array([/* 来自存储的 salt */]);
const iv = new Uint8Array([/* 来自存储的 iv */]);
const keyMaterial = await window.crypto.subtle.importKey(
'raw', new TextEncoder().encode(password), { name: 'PBKDF2' }, false, ['deriveKey']
);
const key = await window.crypto.subtle.deriveKey(
{ name: 'PBKDF2', salt, iterations: 100000, hash: 'SHA-256' },
keyMaterial, { name: 'AES-GCM', length: 256 }, false, ['decrypt']
);
const decrypted = await window.crypto.subtle.decrypt(
{ name: 'AES-GCM', iv }, key, ciphertext
);
“请牢记密码”警告的实际作用与局限
这个提示不是功能组件,只是个 UI 提醒,但它的位置和触发时机影响很大。
容易踩的坑:
- 在用户第一次输入密码后就弹出,而不是等加密完成、密文真正写入
localStorage后再提示——结果用户以为“已保存”,关掉页面才发现没存上 - 把提示文字写成“密码丢失将无法恢复”,但没说明“恢复”指的是解密失败,而非账号找回,造成误解
- 用
alert()阻塞式弹窗,打断操作流;应改用非模态提示(如固定在编辑区下方的 红色小字) - 没做密码强度反馈:用户输
123也允许通过,实际等于没加密
建议做法:只有当 encrypt() 成功返回密文并写入存储后,才显示 “请牢记此密码:解密笔记必需,服务器不保存”,且该提示持续到用户主动关闭或跳转页面。
本地存储加密笔记的兼容性与性能现实
不是所有浏览器都默认开全 Web Crypto API 功能,尤其 iOS Safari 对 deriveKey 的 iterations 上限更保守,设 500000 可能直接报 OperationError。
- 必须做运行时检测:
if (!window.crypto?.subtle)要 fallback 到提示“不支持加密,请换 Chrome/Firefox” - 加密大文本(>1MB)时,
encrypt可能阻塞主线程超 500ms,iOS 上易被系统 kill;应拆分成 chunk,逐段加密 + 合并 -
localStorage容量上限约 5–10MB,但加密后体积略增(base64 膨胀 ~33%),存几百条笔记就可能溢出 - 别把 salt/iv 存在 URL 或
location.hash—— 分享链接会泄露关键参数
真正难的不是写对那几行 decrypt(),而是让整个流程在各种设备上不崩、不丢数据、不误导用户。密码输错一次,笔记就永远打不开——这个责任不在代码,在你是否把边界条件都试过。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











