Notesnook 忘记密码后如何恢复账号:数据恢复密钥、备份文件与重置流程全指南
Notesnook 忘记密码后如何恢复账号:数据恢复密钥、备份文件与重置流程全指南
Notesnook 是少数支持"忘记密码后仍能恢复账号"的端到端加密笔记应用。本文以官方帮助文档《Recovering your account》为主线,结合仓库中 packages/core/src/api/user-manager.ts 的源码实现与 packages/core/__tests__/password-change.test.ts 的测试用例,系统讲解恢复链接的申请、三种恢复方式(数据恢复密钥、备份文件、清空并重置)的取舍、新密码的重新设置以及常见报错的排查方法。读完本文,你将掌握在遗忘密码场景下最大化保住笔记数据、并能理解底层密钥重封装原理的完整实战方案。
恢复前必须知道的事
Notesnook 的所有数据都是端到端加密的,因此"忘记密码"在大多数加密应用中意味着数据永久不可读。Notesnook 之所以例外,是因为它提供了一条经过设计的账号恢复通道:数据恢复密钥(data recovery key)与备份文件(.nnbackup)都允许你在不掌握旧密码的情况下重新获得数据的解密能力。
最终能保住哪些笔记,取决于你手里还留着什么:
- 有数据恢复密钥:恢复时用旧密钥解密全部数据,再用新密码重新加密,笔记全部保留;
- 没有恢复密钥但有备份文件:从之前保存的
.nnbackup文件恢复,保留至该备份生成时的数据,备份之后新增的内容无法找回; - 两者都没有:只能清空账号重新开始,账号内全部数据被删除。
::: danger 注意:恢复过程会强制登出 为保证恢复可靠,开始恢复后你所有设备都会被强制登出。建议在继续之前,先在其它设备上完成数据的保存与备份(导出方式见 备份与恢复笔记指南)。 :::
第一步:申请账号恢复链接
恢复的第一步是申请一封恢复邮件,Notesnook 会把恢复链接发送到你的注册邮箱。
::: info 新的登录流程 近期版本的 Notesnook 更新了登录流程:在申请恢复链接之前,必须先完成 2FA 验证。双因素认证的相关设置见 双重认证指南。 :::
桌面端 / Web 端
- 打开 Notesnook 登录页;
- 输入邮箱并继续;
- 完成 2FA 验证并继续;
- 在下一页点击
{{forgotPassword}}(忘记密码)链接; - 下一页中邮箱应已自动填充,若没有请手动填写;
- 点击
{{sendRecoveryEmail}}(发送恢复邮件); - 一切顺利的话,你会在收件箱收到来自 Notesnook 的恢复邮件;
- 点击邮件中的
Reset your password(重置密码)按钮,进入账号恢复页面。
移动端
移动端只能发起恢复邮件的申请,真正的恢复过程是在邮件所链接的网页上完成的:
- 打开 Notesnook App 并进入登录页;
- 输入邮箱并继续;
- 完成 2FA 验证并继续;
- 点击密码输入框下方的
{{forgotPassword}}; - 在弹出的面板中确认邮箱并发送恢复邮件,此时会看到
{{recoveryEmailSent}}(恢复邮件已发送)提示; - 在任意设备上打开该邮件,点击
Reset your password,在浏览器中继续恢复流程。
没收到邮件怎么办?
先检查垃圾邮件/广告文件夹;如果仍未找到,请联系官方支持(support@streetwriters.co)。
源码视角:恢复链接背后的接口
从源码看,恢复链接的申请对应 UserManager.recoverAccount(email) 方法,它向认证服务发送一次 POST 请求:
// packages/core/src/api/user-manager.ts
const ENDPOINTS = {
...
recoverAccount: "/account/recover",
...
};
recoverAccount(email: string) {
return http.post(`${constants.AUTH_HOST}${ENDPOINTS.recoverAccount}`, {
email,
client_id: "notesnook"
});
}
服务端据此向注册邮箱下发恢复邮件,邮件中的链接引导用户进入 apps/web/src/views/recovery.tsx 实现的恢复流程页面。
第二步:选择恢复方式
进入恢复页面后,Notesnook 会依据你手头持有的凭据,提供三种恢复方式,并按"能保留多少数据"排序展示:
| 方式 | 原理 | 你的笔记 |
|---|---|---|
{{recoveryKeyMethod}}(使用恢复密钥) |
用旧密钥解密数据,再以新密码重新加密 | 保留 |
{{backupFileMethod}}(使用备份文件) |
从之前保存的 .nnbackup 文件恢复 |
保留,截至该备份的日期 |
{{clearDataAndResetMethod}}(清空数据并重置账号) |
清空账号,一切从头开始 | 全部删除 |
从源码结构看,恢复流程对应 RecoveryRoutes 定义的 5 个路由(packages/core 上层 Web 实现见 apps/web/src/views/recovery.tsx):
type RecoveryRoutes =
| "methods" // 选择恢复方式
| "method:key" // 输入恢复密钥
| "method:reset" // 清空并重置
| "new" // 设置新密码
| "final"; // 完成
方式一:使用恢复密钥(推荐,零数据丢失)
这是最安全的方式:恢复过程用你的旧密钥解密全部数据,然后用新密码重新加密,没有任何数据丢失。
操作步骤:
- 点击第一个选项(按钮文字为
{{recoveryKeyMethod}},即"使用恢复密钥"); - 在输入框中输入你的恢复密钥,点击
{{startAccountRecovery}}(开始账号恢复); - 数据下载完成后,点击
{{downloadBackupFile}}(下载备份文件)。请务必将该文件保存到安全的地方,它是你新账号的第一份备份; - 后续步骤见下文 重置账号密码 一节。
源码视角:为什么恢复密钥能"零丢失"
恢复密钥本质上是旧密码派生的主密钥(master key)的可持久化形态。在 UserManager.updatePassword 的 "reset" 分支中,核心逻辑是密钥重封装(rewrap):
// packages/core/src/api/user-manager.ts(updatePassword,type === "reset")
const newMasterKey = await this.db
.storage()
.generateCryptoKey(new_password, salt); // 用新密码派生新主密钥
if (user.dataEncryptionKey)
updateUserPayload.dataEncryptionKey = await this.keyManager.rewrapKey(
user.dataEncryptionKey,
data.encryptionKey, // 恢复密钥 = 旧主密钥
newMasterKey // 新主密钥
);
rewrapKey 先用旧主密钥解包(unwrap)出底层的数据加密密钥(DEK),再立即用新主密钥重新包裹。因此 DEK 从头到尾保持不变,所有用它加密的笔记密文无需任何改动即可继续被解密——这就是"用旧密钥解密、用新密钥重新加密、数据零丢失"的底层实现。attachmentsKey、monographPasswordsKey、inboxKeys、legacyDataEncryptionKey 也都会执行同样的重封装(见 user-manager.ts 中 updatePassword 的完整逻辑)。
值得注意的是,恢复前代码会调用 verifyEncryptionKey,依次尝试用提供的密钥解密 attachmentsKey、monographPasswordsKey、legacyDataEncryptionKey、dataEncryptionKey 以及 inboxKeys.private 中的每一个:
// packages/core/src/api/user-manager.ts
for (const verifier of verifiers) {
const decryptedData = await this.db
.storage()
.decrypt(key, verifier)
.then(() => true)
.catch(() => false);
if (!decryptedData)
throw new Error(
"Your data cannot be decrypted using the provided encryption key."
);
}
也就是说,错误的恢复密钥在真正改动任何数据之前就会被拦截。packages/core/__tests__/password-change.test.ts 中 reset with wrong encryption key throws during verification 等测试用例也验证了这一行为。
方式二:使用备份文件
如果你没有恢复密钥,但手头有之前导出的备份文件,可以改用备份恢复。你能拿回的是备份生成那一刻账号里的全部内容;备份之后新增/修改的内容不在文件里,也无法找回。
操作步骤:
- 点击第二个选项(按钮文字为
{{backupFileMethod}},即"使用备份文件"); - 选择你保存的
.nnbackup文件; - 后续步骤见下文 重置账号密码 一节。
源码视角:备份文件与加密边界
.nnbackup 是 Notesnook 导出的端到端加密备份文件,与账号数据采用同一套加密体系。正因为备份也是加密的,"能恢复到什么程度"完全取决于文件本身包含的数据:恢复结果不可能超越备份文件生成时点的账号状态。这从加密设计的角度解释了文档中"备份之后的内容无法恢复"的结论——详情可参考 我的数据是如何加密的 与 备份与恢复。
方式三:清空数据并重置账号
::: danger 此方式会删除账号内的一切 该方式会清空你的全部数据——笔记、笔记本、提醒、标签和附件。此操作不可逆;由于数据是端到端加密的,Notesnook 之后也无法为你恢复其中任何内容。仅当恢复密钥和备份文件都没有、且你愿意从零开始时,才应使用此方式。 :::
操作步骤:
- 点击第三个选项(按钮文字为
{{clearDataAndResetMethod}},即"清空数据并重置账号"); - 后续步骤见下文 重置账号密码 一节。
源码视角:清空重置的底层行为
清空重置走的是另一条完全不同的代码路径 resetPasswordWithoutRecoveryKey(见 user-manager.ts):
async resetPasswordWithoutRecoveryKey(newPassword: string) {
const newMasterKey = await this.db
.storage()
.generateCryptoKey(newPassword, user.salt);
updateUserPayload.dataEncryptionKey = await this.keyManager.wrapKey(
await this.db.crypto().generateRandomKey(), // 生成全新的 DEK
newMasterKey
);
if (!(await this.resetUser())) throw new Error("Failed to reset user.");
// 随后向 /users/password/reset 提交新密码哈希与新的 userKeys
// 并将 attachmentsKey、monographPasswordsKey、inboxKeys、
// legacyDataEncryptionKey 全部置空
}
可以清楚看到它与恢复密钥方式的关键差异:这里生成的是一个全新的随机 DEK,而不是用旧密钥解包出来的原 DEK;同时 resetUser()(对应端点 /users/reset)会在服务端清空该账号的数据,attachmentsKey、monographPasswordsKey、inboxKeys、legacyDataEncryptionKey 全部被移除。这就是"旧数据彻底作废、不可恢复"的源码级证据。
第三步:重置账号密码
无论选择哪种恢复方式,最后一步都是设置新密码:
- 选择一个强且好记的密码(官方建议配合 1Password 或 Bitwarden 等密码管理器,避免再次丢失);
- 点击
{{continue}}(继续),等待整个流程完成; - 系统提示时,将新的恢复密钥保存到安全的地方。
完成后账号即恢复成功。之后在你的其它设备上重新登录,即可再次同步并阅读你的笔记。
::: info 为什么重置密码必须重新保存恢复密钥
新密码会派生出一个与旧密码完全不同的新主密钥(generateCryptoKey(new_password, salt)),因此基于旧主密钥的旧恢复密钥将不再有效。重置流程的测试用例(packages/core/__tests__/password-change.test.ts 中 "new master key can unwrap all rewrapped keys"、"old master key can no longer unwrap")明确验证了:新主密钥能解开所有重封装后的密钥,而旧主密钥再也无法解包。
:::
Troubleshooting:常见报错排查
同步时报错 "ciphertext cannot be decrypted using this key"
这通常意味着你的一部分数据仍是用更早版本的旧密钥加密的。该情况非常罕见。文档给出的结论是:这种损坏只能通过重置账号来恢复。
结合源码可以进一步理解原因:Notesnook 支持同时存在 dataEncryptionKey 与 legacyDataEncryptionKey(见 getDataEncryptionKeys,它会把 legacy 版本与当前 DEK 一并返回用于解密)。若某条数据的密文对应一个既不在用户密钥列表、也无法由任何现存密钥解开的密钥版本,就会触发该错误——此时除清空重置外没有其它解密路径。
报错 "Sync server is not responding. Please check your internet connection..."
该错误的主要原因是:服务端在清空你的数据时超时。如果你的数据量很大(达到 GB 级别),就可能遇到这个问题。
临时解决方法:换一台笔记本,并使用 Google Chrome 或 Mozilla Firefox 浏览器重试。如果仍然失败,请联系官方支持(support@streetwriters.co)——体量特别大的账号可能需要服务端协助清空。
相关文档
- 账号设置 — 邮箱、密码与个人资料
- 双重认证 — 登录时的第二重验证
- 我的数据是如何加密的 — 每条笔记背后的加密机制
- 备份与恢复 — 保存属于你自己的加密副本