← 返回应用

notevault 帮助

notevault 是单用户端到端加密笔记系统:笔记在浏览器里加密后才上传到服务器,服务器只存密文。备份文件同样是加密的 JSON,只有用当初备份时的密码才能恢复。

⚠️ 密码丢失警告

主密码只存在你的脑子里,服务器不知道它,也无法帮你找回。一旦忘记主密码,所有笔记和备份都将永久无法解密,没有任何找回途径。请务必把主密码记在安全的地方(例如密码管理器或纸质记录)。修改密码后,旧备份仍需用旧密码才能恢复。

一、备份与恢复总览

应用内置两种备份目标,都在「设置」里配置:

目标说明
WebDAV备份到你自己的 WebDAV 服务器(NAS、自建服务或支持 WebDAV 的网盘)。应用通过同源中继代发请求,密码不会被记录。
OneDrive备份到你的个人 OneDrive 的应用专属文件夹(Apps/<应用名>/)。应用只能读写这个文件夹,看不到网盘里的其他文件。需要你先在 Azure 注册一个应用(免费,见第二节)。

备份文件是加密 JSON,文件名形如 notevault-backup-20261117.json。同一天多次备份会覆盖同一文件。

备份步骤

  1. 在「设置」里配好 WebDAV 或 OneDrive(见下)。
  2. 点「立即备份」。成功后会弹出提示,包含文件名和大小。
  3. 建议定期备份,尤其是在修改密码或导入大量内容之前。

恢复步骤

  1. 在「设置」里选择备份来源:WebDAV(输入文件名)或 OneDrive(从备份列表里选一个)。
  2. 点「从备份恢复」,输入备份时的主密码(如果之后改过密码,这里填旧密码)。
  3. 恢复会把备份里的笔记本、笔记、标签和附件导入当前数据库,原有内容不受影响;同名内容会并存,不会覆盖。
恢复需要先解锁应用(登录状态),且备份文件里的附件会重新加密后上传;附件较多时请耐心等待。

二、OneDrive 设置(Azure 应用注册)

OneDrive 备份需要你用自己的微软帐户在 Azure 门户注册一个应用——这是微软的要求,注册免费,应用只属于你自己。本应用不会替你注册,你需要按下面步骤手动完成一次,以后就不用再管了。

第 1 步:新建应用注册

  1. 打开 portal.azure.com,用你的个人 Microsoft 帐户登录。
  2. 进入「Microsoft Entra ID」(也叫 Azure Active Directory)→ 左侧「应用注册」→「新注册」。
  3. 「名称」随便填,例如 notevault(这个名字会出现在 OneDrive 的 Apps/ 文件夹里)。
  4. 「受支持的帐户类型」选择 「仅个人 Microsoft 帐户」(Accounts in any organizational directory…不要选)。
  5. 「重定向 URI」:平台选 「单页应用程序 (SPA)」,地址填本应用的完整地址(浏览器地址栏里显示的地址,例如 https://notevault-4hk.pages.dev/)。必须与地址栏完全一致,包括末尾的斜杠;平台一定要选 SPA,选成“Web”会导致登录后换令牌失败。
  6. 点「注册」。

第 2 步:复制应用程序(客户端) ID

  1. 注册成功后,在应用的「概述」页找到「应用程序(客户端) ID」(一串 GUID)。
  2. 把它复制到 notevault「设置 → OneDrive 设置」里的「Client ID」一栏,点保存。
  3. 不需要创建客户端密码(client secret)。本应用是公共客户端,使用 PKCE 授权码流程,不用、也不应生成 secret。

第 3 步:添加 API 权限

  1. 在应用注册页左侧点「API 权限」→「添加权限」→「Microsoft Graph」→「委托的权限」。
  2. 搜索并勾选 Files.ReadWrite.AppFolder(读写应用文件夹),点「添加权限」。
  3. 个人帐户不需要管理员同意,登录授权时你本人点「同意」即可。offline_access 是标准权限,登录时一并授权,不用单独添加。

第 4 步:在应用里连接

  1. 回到 notevault「设置 → OneDrive 设置」,点「连接 OneDrive」。
  2. 浏览器会跳转到 Microsoft 登录页:登录并确认授权(应用只能访问它自己的文件夹)。
  3. 授权后会自动跳回 notevault,显示已连接。之后点「立即备份」即可;备份文件会出现在你 OneDrive 的 Apps/notevault/ 文件夹里(文件夹名取自你在 Azure 填的应用名称)。
令牌存储说明:OneDrive 的访问令牌和刷新令牌只存在你本机浏览器的 localStorage 里(键名 nv_onedrive_tokens),不会发给 notevault 服务器。令牌过期后应用会自动用刷新令牌续期;点「断开连接」会清除本地令牌。如需彻底撤销授权,请到 account.microsoft.com 的「隐私 → 应用和服务」里移除该应用。令牌只能读写应用专属文件夹,即使泄露也看不到你网盘的其他内容,但仍请不要在公共电脑上保持连接状态。

常见问题

三、WebDAV 设置

  1. 在「设置 → WebDAV 设置」里填写服务器地址(例如你的 NAS 或网盘的 WebDAV 地址,须以 http:// 或 https:// 开头)、用户名和密码。
  2. 点「测试连接」:成功会显示 HTTP 状态码;失败请检查地址、用户名、密码,以及服务器是否允许 PROPFIND 请求。
  3. 点「立即备份」上传;恢复时输入备份文件名(例如 notevault-backup-20261117.json),点「从 WebDAV 恢复」。
密码存储说明:WebDAV 地址和用户名存在本机浏览器 localStorage(键名 nv_webdav)。密码默认不保存,每次备份/恢复都要重新输入;只有勾选「记住密码」时,密码才会存入本机 localStorage(键名 nv_webdav_pw),取消勾选或点「清除已记住的密码」即可删除。备份请求经应用服务器中继转发,中继不记录密码和请求内容。建议使用 HTTPS 的 WebDAV 地址。

四、导入与导出

在主界面的「导入/导出」菜单里:

功能说明
导出 JEX导出为 Joplin 交换格式(.jex,tar 包),可在 Joplin 里直接导入。内容是解密后的明文,请妥善保管导出的文件。
导出 Markdown按笔记本分文件夹导出 .md 文件(.tar 包),每篇笔记带 YAML front matter(标题、创建时间、更新时间、标签),附件随附在旁,适合归档或迁移到其他工具。内容是明文。
导出 JSON 备份导出加密 JSON 备份(与一键备份相同格式),下载到本地。恢复时需要备份时的主密码。
导入 JEX导入 Joplin 导出的 .jex 文件,或本应用导出的 JEX。笔记本、笔记、标签和附件会一并导入;资源通过笔记正文里的引用关联到笔记。
导入 Markdown导入本应用导出的 Markdown tar 包,或单个 .md 文件(导入为当前笔记本里的一篇笔记)。
导入 JSON 备份导入加密 JSON 备份文件,需要输入备份时的主密码。
注意:JEX 和 Markdown 导出的是明文内容,文件本身没有任何加密。不要把导出的文件发到不受信任的地方;用完请及时删除或加密保存。

五、令牌与数据存储说明

← 返回应用