feat: 登录会话持久化 + Caddy 反代部署方案

server/DEPLOY.md

@@ -1,6 +1,6 @@
-# 同步服务端部署指南
+# 同步服务端部署指南（Docker + Caddy 自动 HTTPS）
 
-## 部署（在 124.221.192.176 上执行）
+## 一、部署同步服务
 
 1. 上传 server 目录到服务器（如 ~/internlog-sync/）
 2. 启动：
@@ -10,21 +10,51 @@
 
 3. 验证：curl http://127.0.0.1:3780/api/health 应返回 {"ok":true}
 
-数据保存在 ./data/（用户注册表 + 每用户数据文件），直接打包该目录即备份。
+数据保存在 ./data/（用户注册表 + 每用户数据文件），整目录复制即备份。
 
-## 建议：启用 HTTPS
+## 二、Caddy 反向代理（自动申请与续期 HTTPS 证书）
 
-客户端在手机浏览器使用时，建议用 nginx 反向代理复用现有证书：
+### 方式一：独立子域名（推荐）
 
-    location /sync-api/ {
-        proxy_pass http://127.0.0.1:3780/;
-        proxy_set_header Host $host;
+先在 DNS 添加 A 记录：sync.linyux.cn → 124.221.192.176
+
+Caddyfile：
+
+    sync.linyux.cn {
+        reverse_proxy 127.0.0.1:3780
     }
 
-客户端同步地址填 https://gitea.linyux.cn/sync-api 即可全程加密。
-不加代理时客户端可临时填 http://124.221.192.176: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}