Notesnook 忘记密码后如何恢复账号:数据恢复密钥、备份文件与重置流程全指南

原创2026-09-21 17:38:211,833 阅读
文章标签:知识管理知识库富文本前端桌面应用移动开发跨平台密码学应用安全

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 端

  1. 打开 Notesnook 登录页;
  2. 输入邮箱并继续;
  3. 完成 2FA 验证并继续;
  4. 在下一页点击 {{forgotPassword}}(忘记密码)链接;
  5. 下一页中邮箱应已自动填充,若没有请手动填写;
  6. 点击 {{sendRecoveryEmail}}(发送恢复邮件);
  7. 一切顺利的话,你会在收件箱收到来自 Notesnook 的恢复邮件;
  8. 点击邮件中的 Reset your password(重置密码)按钮,进入账号恢复页面。

移动端

移动端只能发起恢复邮件的申请,真正的恢复过程是在邮件所链接的网页上完成的:

  1. 打开 Notesnook App 并进入登录页;
  2. 输入邮箱并继续;
  3. 完成 2FA 验证并继续;
  4. 点击密码输入框下方的 {{forgotPassword}};
  5. 在弹出的面板中确认邮箱并发送恢复邮件,此时会看到 {{recoveryEmailSent}}(恢复邮件已发送)提示;
  6. 在任意设备上打开该邮件,点击 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";       // 完成

方式一:使用恢复密钥(推荐,零数据丢失)

这是最安全的方式:恢复过程用你的旧密钥解密全部数据,然后用新密码重新加密,没有任何数据丢失。

操作步骤:

  1. 点击第一个选项(按钮文字为 {{recoveryKeyMethod}},即"使用恢复密钥");
  2. 在输入框中输入你的恢复密钥,点击 {{startAccountRecovery}}(开始账号恢复);
  3. 数据下载完成后,点击 {{downloadBackupFile}}(下载备份文件)。请务必将该文件保存到安全的地方,它是你新账号的第一份备份;
  4. 后续步骤见下文 重置账号密码 一节。

源码视角:为什么恢复密钥能"零丢失"

恢复密钥本质上是旧密码派生的主密钥(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 等测试用例也验证了这一行为。

方式二:使用备份文件

如果你没有恢复密钥,但手头有之前导出的备份文件,可以改用备份恢复。你能拿回的是备份生成那一刻账号里的全部内容;备份之后新增/修改的内容不在文件里,也无法找回。

操作步骤:

  1. 点击第二个选项(按钮文字为 {{backupFileMethod}},即"使用备份文件");
  2. 选择你保存的 .nnbackup 文件;
  3. 后续步骤见下文 重置账号密码 一节。

源码视角:备份文件与加密边界

.nnbackup 是 Notesnook 导出的端到端加密备份文件,与账号数据采用同一套加密体系。正因为备份也是加密的,"能恢复到什么程度"完全取决于文件本身包含的数据:恢复结果不可能超越备份文件生成时点的账号状态。这从加密设计的角度解释了文档中"备份之后的内容无法恢复"的结论——详情可参考 我的数据是如何加密的 与 备份与恢复。

方式三:清空数据并重置账号

::: danger 此方式会删除账号内的一切 该方式会清空你的全部数据——笔记、笔记本、提醒、标签和附件。此操作不可逆;由于数据是端到端加密的,Notesnook 之后也无法为你恢复其中任何内容。仅当恢复密钥和备份文件都没有、且你愿意从零开始时,才应使用此方式。 :::

操作步骤:

  1. 点击第三个选项(按钮文字为 {{clearDataAndResetMethod}},即"清空数据并重置账号");
  2. 后续步骤见下文 重置账号密码 一节。

源码视角:清空重置的底层行为

清空重置走的是另一条完全不同的代码路径 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 全部被移除。这就是"旧数据彻底作废、不可恢复"的源码级证据。

第三步:重置账号密码

无论选择哪种恢复方式,最后一步都是设置新密码:

  1. 选择一个强且好记的密码(官方建议配合 1Password 或 Bitwarden 等密码管理器,避免再次丢失);
  2. 点击 {{continue}}(继续),等待整个流程完成;
  3. 系统提示时,将新的恢复密钥保存到安全的地方。

完成后账号即恢复成功。之后在你的其它设备上重新登录,即可再次同步并阅读你的笔记。

::: 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)——体量特别大的账号可能需要服务端协助清空。

相关文档

登录后查看全文
notesnook