1.9 KiB
1.9 KiB
同步服务端部署指南(Docker + Caddy 自动 HTTPS)
一、部署同步服务
-
上传 server 目录到服务器(如 ~/internlog-sync/)
-
启动:
cd ~/internlog-sync docker compose up -d --build -
验证:curl http://127.0.0.1:3780/api/health 应返回 {"ok":true}
数据保存在 ./data/(用户注册表 + 每用户数据文件),整目录复制即备份。
二、Caddy 反向代理(自动申请与续期 HTTPS 证书)
方式一:独立子域名(推荐)
先在 DNS 添加 A 记录:sync.linyux.cn → 124.221.192.176
Caddyfile:
sync.linyux.cn {
reverse_proxy 127.0.0.1:3780
}
客户端同步地址填:https://sync.linyux.cn
方式二:复用现有域名路径(不新增 DNS 记录)
在 gitea.linyux.cn 现有 Caddy 站点块中加入 handle_path(原有 Gitea 反代配置保持不变):
gitea.linyux.cn {
handle_path /sync-api/* {
reverse_proxy 127.0.0.1:3780
}
# ...原有 Gitea 配置
}
客户端同步地址填:https://gitea.linyux.cn/sync-api
启动 Caddy
- 宿主机已运行 Caddy:修改 Caddyfile 后 caddy reload 即可(参考 server/Caddyfile.example)
- 未运行 Caddy:docker compose 里已附注释掉的 caddy 服务段,取消注释后 docker compose up -d
注意:证书自动申请要求 80/443 端口公网可达,且域名已解析到本服务器。
三、客户端配置
应用 → 设置 → 多端数据同步:
- 同步服务地址:https://sync.linyux.cn(或方式二的 https://gitea.linyux.cn/sync-api)
- 注册云端账号(或填写已注册的账号密码)
- 立即同步;此后登录状态下每 5 分钟自动同步
四、接口
- POST /api/auth/register {username, password}
- POST /api/auth/login {username, password}
- POST /api/sync Authorization: Bearer ,body: {tables, tombstones}
- GET /api/health