63 lines
1.9 KiB
Markdown
63 lines
1.9 KiB
Markdown
# 同步服务端部署指南（Docker + Caddy 自动 HTTPS）
|
||
|
||
## 一、部署同步服务
|
||
|
||
1. 上传 server 目录到服务器（如 ~/internlog-sync/）
|
||
2. 启动：
|
||
|
||
cd ~/internlog-sync
|
||
docker compose up -d --build
|
||
|
||
3. 验证：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 端口公网可达，且域名已解析到本服务器。
|
||
|
||
## 三、客户端配置
|
||
|
||
应用 → 设置 → 多端数据同步：
|
||
|
||
1. 同步服务地址：https://sync.linyux.cn（或方式二的 https://gitea.linyux.cn/sync-api）
|
||
2. 注册云端账号（或填写已注册的账号密码）
|
||
3. 立即同步；此后登录状态下每 5 分钟自动同步
|
||
|
||
## 四、接口
|
||
|
||
- POST /api/auth/register {username, password}
|
||
- POST /api/auth/login {username, password}
|
||
- POST /api/sync Authorization: Bearer <token>，body: {tables, tombstones}
|
||
- GET /api/health
|