notevault 帮助
notevault 是单用户端到端加密笔记系统:笔记在浏览器里加密后才上传到服务器,服务器只存密文。备份文件同样是加密的 JSON,只有用当初备份时的密码才能恢复。
⚠️ 密码丢失警告
主密码只存在你的脑子里,服务器不知道它,也无法帮你找回。一旦忘记主密码,所有笔记和备份都将永久无法解密,没有任何找回途径。请务必把主密码记在安全的地方(例如密码管理器或纸质记录)。修改密码后,旧备份仍需用旧密码才能恢复。
一、备份与恢复总览
应用内置两种备份目标,都在「设置」里配置:
| 目标 | 说明 |
|---|---|
| WebDAV | 备份到你自己的 WebDAV 服务器(NAS、自建服务或支持 WebDAV 的网盘)。应用通过同源中继代发请求,密码不会被记录。 |
| OneDrive | 备份到你的个人 OneDrive 的应用专属文件夹(Apps/<应用名>/)。应用只能读写这个文件夹,看不到网盘里的其他文件。需要你先在 Azure 注册一个应用(免费,见第二节)。 |
备份文件是加密 JSON,文件名形如 notevault-backup-20261117.json。同一天多次备份会覆盖同一文件。
备份步骤
- 在「设置」里配好 WebDAV 或 OneDrive(见下)。
- 点「立即备份」。成功后会弹出提示,包含文件名和大小。
- 建议定期备份,尤其是在修改密码或导入大量内容之前。
恢复步骤
- 在「设置」里选择备份来源:WebDAV(输入文件名)或 OneDrive(从备份列表里选一个)。
- 点「从备份恢复」,输入备份时的主密码(如果之后改过密码,这里填旧密码)。
- 恢复会把备份里的笔记本、笔记、标签和附件导入当前数据库,原有内容不受影响;同名内容会并存,不会覆盖。
恢复需要先解锁应用(登录状态),且备份文件里的附件会重新加密后上传;附件较多时请耐心等待。
二、OneDrive 设置(Azure 应用注册)
OneDrive 备份需要你用自己的微软帐户在 Azure 门户注册一个应用——这是微软的要求,注册免费,应用只属于你自己。本应用不会替你注册,你需要按下面步骤手动完成一次,以后就不用再管了。
第 1 步:新建应用注册
- 打开
portal.azure.com,用你的个人 Microsoft 帐户登录。 - 进入「Microsoft Entra ID」(也叫 Azure Active Directory)→ 左侧「应用注册」→「新注册」。
- 「名称」随便填,例如
notevault(这个名字会出现在 OneDrive 的Apps/文件夹里)。 - 「受支持的帐户类型」选择 「仅个人 Microsoft 帐户」(Accounts in any organizational directory…不要选)。
- 「重定向 URI」:平台选 「单页应用程序 (SPA)」,地址填本应用的完整地址(浏览器地址栏里显示的地址,例如
https://notevault-4hk.pages.dev/)。必须与地址栏完全一致,包括末尾的斜杠;平台一定要选 SPA,选成“Web”会导致登录后换令牌失败。 - 点「注册」。
第 2 步:复制应用程序(客户端) ID
- 注册成功后,在应用的「概述」页找到「应用程序(客户端) ID」(一串 GUID)。
- 把它复制到 notevault「设置 → OneDrive 设置」里的「Client ID」一栏,点保存。
- 不需要创建客户端密码(client secret)。本应用是公共客户端,使用 PKCE 授权码流程,不用、也不应生成 secret。
第 3 步:添加 API 权限
- 在应用注册页左侧点「API 权限」→「添加权限」→「Microsoft Graph」→「委托的权限」。
- 搜索并勾选
Files.ReadWrite.AppFolder(读写应用文件夹),点「添加权限」。 - 个人帐户不需要管理员同意,登录授权时你本人点「同意」即可。
offline_access是标准权限,登录时一并授权,不用单独添加。
第 4 步:在应用里连接
- 回到 notevault「设置 → OneDrive 设置」,点「连接 OneDrive」。
- 浏览器会跳转到 Microsoft 登录页:登录并确认授权(应用只能访问它自己的文件夹)。
- 授权后会自动跳回 notevault,显示已连接。之后点「立即备份」即可;备份文件会出现在你 OneDrive 的
Apps/notevault/文件夹里(文件夹名取自你在 Azure 填的应用名称)。
令牌存储说明:OneDrive 的访问令牌和刷新令牌只存在你本机浏览器的 localStorage 里(键名
nv_onedrive_tokens),不会发给 notevault 服务器。令牌过期后应用会自动用刷新令牌续期;点「断开连接」会清除本地令牌。如需彻底撤销授权,请到 account.microsoft.com 的「隐私 → 应用和服务」里移除该应用。令牌只能读写应用专属文件夹,即使泄露也看不到你网盘的其他内容,但仍请不要在公共电脑上保持连接状态。
常见问题
- 登录时报错 AADSTS50011(重定向 URI 不匹配):Azure 里填的重定向 URI 与当前应用地址不一致。请回到应用注册 →「身份验证」,把 SPA 重定向 URI 改成浏览器地址栏里的完整地址(注意末尾斜杠)。
- 换令牌时被浏览器报 CORS 错误:重定向 URI 的平台选错了(选成了 Web)。改成「单页应用程序 (SPA)」即可。
- 备份文件超过 4 MiB 时上传失败:这是 OneDrive 简单上传的限制。当前版本不支持分块上传,请改用 WebDAV 备份,或用「导出 JSON 备份」下载后手动上传到 OneDrive。
- 提示授权已过期:刷新令牌失效时会出现,点「断开连接」后再重新连接即可。
三、WebDAV 设置
- 在「设置 → WebDAV 设置」里填写服务器地址(例如你的 NAS 或网盘的 WebDAV 地址,须以
http://或https://开头)、用户名和密码。 - 点「测试连接」:成功会显示 HTTP 状态码;失败请检查地址、用户名、密码,以及服务器是否允许 PROPFIND 请求。
- 点「立即备份」上传;恢复时输入备份文件名(例如
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 导出的是明文内容,文件本身没有任何加密。不要把导出的文件发到不受信任的地方;用完请及时删除或加密保存。
五、令牌与数据存储说明
- 登录会话令牌存在 sessionStorage(键名
nv_token),关闭浏览器标签页即失效,有效期 24 小时。 - 主密码从不离开浏览器,也从不存储;服务器只存密码验证器(单向派生值),无法反推出密码。
- WebDAV:地址+用户名存 localStorage(
nv_webdav);密码默认不存,勾选「记住密码」才存(nv_webdav_pw)。 - OneDrive:Client ID 存 localStorage(
nv_onedrive);访问令牌+刷新令牌存 localStorage(nv_onedrive_tokens)。 - 备份文件是加密 JSON,只有用备份时的主密码才能解密;JEX / Markdown 导出是明文。
- 清理浏览器数据(localStorage)会丢失已保存的 WebDAV / OneDrive 设置和令牌,但不会影响服务器上的笔记(重新登录即可);OneDrive 断开后重新连接即可继续使用。