Files
daywork/server/DEPLOY.md
T

1.9 KiB
Raw Blame History

同步服务端部署指南(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 ,body: {tables, tombstones}
  • GET /api/health