服务器跑起来之后,剩下的都在 Obsidian 里完成。同一个人的每台设备,用的都是同一个用户密钥。
1. 拿到用户密钥
Section titled “1. 拿到用户密钥”用户密钥(ck_...)代表一个人,他的每台设备都用这同一把。桌面端最省事,命令行发的是同一个请求。
- 打开 Courier 桌面端,进密钥管理页,点新建密钥。
- 名称填谁用就写谁,有效期和额度保持默认,点创建密钥。
- 弹窗里会出现一串
ck_开头的密钥,复制它。
在服务器上执行,会创建一个密钥并把完整内容显示一次(请求用的 ak_ 管理密钥就是部署时那个):
curl -sS -X POST https://YOUR_IP:8443/api/users \ -H "Authorization: Bearer ak_xxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"name":"Alice"}'返回里的 "key" 就是要复制的 ck_...。name 是这把密钥归谁,也是唯一必填的字段。
2. 安装插件
Section titled “2. 安装插件”Courier 还没有进 Obsidian 的插件市场,所以通过 BRAT 安装——BRAT 是按仓库装插件的插件:
- 设置 → 第三方插件 → 浏览,搜索 BRAT,装上并启用。
- 打开命令面板(Ctrl/Cmd+P),运行 BRAT: Add a beta plugin for testing。
- 填
ah-yu/courier,确认。 - 回到设置 → 第三方插件,启用 Courier。
如果 Obsidian 提示第三方插件被限制,先关闭安全模式。
3. 登录服务器
Section titled “3. 登录服务器”- 在 Obsidian 里打开 设置 → Courier。
- 服务器地址填部署完成时显示的那个,例如
https://YOUR_IP:8443。 - 用户密钥填刚才复制的
ck_...。 - 点登录。
4. 创建远程库
Section titled “4. 创建远程库”- 登录后点创建远程库。
- 起一个名字。
- 设一个库密码:它用来加密笔记,不会上传。丢了笔记就解不开——你也解不开,服务器也解不开。
5. 连上这个库
Section titled “5. 连上这个库”- 填一次库密码。
- 打开记住密码,下次打开 Obsidian 会自动解锁。
- 确认设备名称,例如
Windows PC、iPhone,它只用来在同步历史里区分设备。 - 排除的文件夹先留空。
- 点开始同步。右下角出现 Courier 图标并显示同步中,这台设备就接上了。
6. 再连一台设备
Section titled “6. 再连一台设备”到另一台设备(比如手机)上,重复第 2、3、5 步:
- 装插件,填同一个服务器地址和用户密钥;
- 在远程库列表里选择已有的那个库,输入同一个库密码,点开始同步。
区别只有一处:第一台设备点的是创建远程库,之后每台设备都是选择已有的远程库。
两台都连上后,在任意一台改一篇笔记,另一台几乎立刻就能看到。