无界面同步

Courier 的同步通常在 Obsidian 里进行。它也可以在一台从不打开 Obsidian 的机器上同步一个库——一台常开的小服务器、一台 NAS，或者白天基本不开 Obsidian 的电脑：装上 Courier 的命令行工具，它就在后台替你看住这个文件夹。

什么情况下用

• 库放在一台常开的机器上，那台机器不跑 Obsidian，但它的内容应该一直是最新的。
• 有脚本、备份任务或 AI 助手在那台机器上直接改文件，改动也要传到其他设备。
• 你的电脑很少开着 Obsidian，但白天在手机上改的东西，晚上应该已经在电脑上了。

怎么开始

按你习惯的方式来：桌面端替你装好并运行，或者在 Linux / macOS、Windows 上用命令行。每个分页都是完整的一条路。

桌面端

1. 安装工具。 在命令行 CLI 页面点安装，它会下载并校验版本。
2. 登录。 填服务器地址和一把用户密钥——和 Obsidian 插件用的是同一类密钥。
3. 添加 Vault。 选远程库、本地文件夹、库密码，再给这台机器起一个设备名。
4. 启动。 每个库一行、各有自己的启动按钮；关掉桌面端它也继续在后台跑。

Linux / macOS

# 安装（只需一次）
curl -fL https://github.com/ah-yu/courier/raw/main/install.sh | sh

# 登录：换成你的服务器地址和用户密钥
courier-cli register --server https://YOUR_IP:8443 \
  --user-key ck_xxx -n "NAS"

# 绑定：Vault ID 在桌面端的 Vault 列表里，路径换成你的文件夹
courier-cli vault connect --id YOUR_VAULT_ID --path ~/vault \
  --password YOUR_VAULT_PASSWORD

# 开始同步
courier-cli run --vault YOUR_VAULT_ID

Windows

# 安装（只需一次）
irm https://github.com/ah-yu/courier/raw/main/install.ps1 | iex

# 登录：换成你的服务器地址和用户密钥
courier-cli register --server https://YOUR_IP:8443 `
  --user-key ck_xxx -n "NAS"

# 绑定：Vault ID 在桌面端的 Vault 列表里，路径换成你的文件夹
courier-cli vault connect --id YOUR_VAULT_ID --path "$HOME\vault" `
  --password YOUR_VAULT_PASSWORD

# 开始同步
courier-cli run --vault YOUR_VAULT_ID

courier-cli status 会列出每个已绑定的库、它自己的进程和冲突副本。一个进程只管一个库，三个库就是三个进程。

和 Obsidian 的分工

它和插件跑的是同一个同步引擎，所以规则完全一样：改动实时推送；冲突时远端版本留下，本地那份在旁边存成 *.conflict.*。

它不碰 Obsidian 的设置：.obsidian 文件夹只有 Obsidian 能读，所以设置同步仍然只发生在插件里。

同一个库同时只有一个写者。如果 Obsidian 正开着这个库，你又启动了命令行工具，那么先启动的那个继续同步，另一个等着——不报错，前一个停下后它自动接手。

桌面端还会记住每个库的开关：之前没停掉的库，重启桌面端后会自己恢复。