# 旧系统持续同步进程

此目录用于在新系统服务器安装 5 秒增量同步进程。旧 IIS 读取桥必须先按
[`legacy-sync-bridge/README.md`](../../legacy-sync-bridge/README.md) 部署并通过外部
`/xiaoshu-sync/v1/health`、签名 manifest 和增量读取测试。

1. 把仓库部署到 `/opt/xiaoshu-angular`。
2. 将 `legacy-sync-worker.env.example` 复制到
   `/etc/xiaoshu/legacy-sync-worker.env`，填写专用超级管理员会话令牌并设置权限为
   `0600`。
3. 将 `xiaoshu-legacy-sync.service` 复制到 `/etc/systemd/system/`，执行
   `systemctl daemon-reload && systemctl enable --now xiaoshu-legacy-sync`。
4. 用 `curl http://127.0.0.1:9087/health` 检查进程。最近一次成功超过 15 秒或连续失败时返回 503；单轮超过 10 秒会写入 journald 警告。
5. 用运营后台同步状态核对每个数据集的游标、失败队列和旧库／新库数量，再开放前端实时状态。

云函数环境需配置 `XIAOSHU_LEGACY_SYNC_BASE_URL`、
`XIAOSHU_LEGACY_SYNC_KEY_ID`、`XIAOSHU_LEGACY_SYNC_SECRET`。首次上线保持
`XIAOSHU_LEGACY_SYNC_WRITES_ENABLED` 关闭。