自建云同步部署指南

③ 前台试运行

node server.js
# [sync] 数据目录: /www/wwwroot/cognote-sync/data
# [sync] 已同步文件数: 0, 版本: 1

另一个终端验证连通性（替换成你的 Token）：

curl "http://127.0.0.1:8600/api/ping?token=你的TOKEN"
# {"ok":true,"serverTime":...,"version":1,"fileCount":0}

看到 "ok":true 即成功，Ctrl+C 停止，进入下一步。

3. systemd 守护（开机自启 + 崩溃自动重启）

cat > /etc/systemd/system/cognote-sync.service <<'UNIT'
[Unit]
Description=Cognote Cloud Sync Server
After=network.target

[Service]
Type=simple
WorkingDirectory=/www/wwwroot/cognote-sync
ExecStart=/usr/bin/node /www/wwwroot/cognote-sync/server.js
Restart=always
RestartSec=3
User=www
Group=www

[Install]
WantedBy=multi-user.target
UNIT

systemctl daemon-reload
systemctl enable --now cognote-sync
systemctl status cognote-sync    # 应显示 active (running)

说明：ExecStart 中的 node 路径用 which node 查询后填入（宝塔 Node 版本管理器通常为 /www/server/nodejs/vXX/bin/node）；用 node 直接运行而非 systemd 托管也可以， 但不保证断线重连与开机自启。

4. nginx 反向代理（走 80 端口）

推荐通过 nginx 把同步服务挂到 /knowledge-sync/ 子路径，客户端只填一个 HTTP 地址，后续加 HTTPS 也只需改这一处：

cat > /www/server/panel/vhost/nginx/cognote-sync.conf <<'NGINX'
server {
    listen 80;
    server_name 你的服务器IP或域名;

    client_max_body_size 100m;   # 同步与附件上传大小

    location = /knowledge-sync { return 301 /knowledge-sync/; }

    location /knowledge-sync/ {
        proxy_pass http://127.0.0.1:8600/;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_connect_timeout 30s;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }
}
NGINX

nginx -t && nginx -s reload    # 宝塔: /www/server/nginx/sbin/nginx -t && ... -s reload

5. 客户端配置（Cognote 应用内）

启动 Cognote → 右上角「⚙️ 设置」→「☁️ 云端同步」：

保存后目录树会出现「☁️ 云端同步」根分类：在它下面新建的分类与笔记会自动上传； 其它电脑用相同地址 + Token、相同的本地同步目录，即可同步同一份云端笔记。

6. 验证

1. 设备 A：在「☁️ 云端同步」下新建一条笔记，等待一个同步周期（或手动点同步）；
2. 打开服务器数据目录确认文件已落盘：ls -R /www/wwwroot/cognote-sync/data/files/；
3. 设备 B：配置相同地址与 Token → 目录树应出现同一条笔记；
4. 断网/冲突场景：双方同时修改同一笔记时，修改时间新者胜出，落败方自动保存为「冲突副本」，数据不丢。

笔记分享

同步服务端同时承担分享能力（依赖云端目录中的笔记）。在 Cognote 中右键笔记或目录 → 分享：

• 生成「链接 + 查看密码」的公开阅读页，无需账号即可在手机浏览器打开；
• 有效期可选 1 / 7 / 30 天或长期，可随时停用（410）、恢复或删除；
• 密码错误 10 次锁定同 IP 10 分钟；附带浏览统计（打开次数、按天、每篇笔记阅读数）；
• 分享链接格式：http://你的服务器IP/knowledge-sync/s/viewer?id=<分享id>

安全建议

• Token 即密码：不要提交到公开仓库、不要写进截图；泄露后改 config.json 的 token 并 systemctl restart cognote-sync；
• 建议 HTTPS：公网上 HTTP 传输可被窃听。宝塔可一键申请证书，启用后客户端地址改为 https://域名/knowledge-sync；
• 防火墙 / 安全组：只需放行 80（或你选择的端口），保持 host: 127.0.0.1 不直接暴露 8600；
• 备份：定期打包 data/ 目录即完成全部备份；
• 系统与 Node.js 保持更新；不要把服务端目录放进 nginx 可直接下载的静态站点根（本部署为反代，不涉及）。

常见问题