# 同步服务端部署指南（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