自动同步机制
PowerWiki 启动时克隆或更新仓库,运行期间按配置间隔检查远端。同步间隔与缓存失效是两件事:没有新提交时,菜单和文章继续复用。
flowchart TD
A[启动或定时检查] --> B[更新 Git 仓库]
B --> C{有新提交?}
C -->|是| D[失效内容缓存]
D --> E[预热目录]
C -->|否| F[复用现有缓存]
E --> G[浏览器下次访问检查版本]
F --> G
配置同步间隔
{
"autoSyncInterval": 180000
}
单位为毫秒,默认 3 分钟。缩短间隔会增加远端 Git 检查频率,并不会提高缓存命中后的阅读速度。
提交后如何确认
- 将文档提交并推送到配置指定的分支。
- 等待一个同步周期,查看服务日志确认成功。
- 重新打开文章或刷新页面,浏览器会检查新版本。
docker logs --tail 100 powerwiki
重启也会触发启动同步,但日常更新不需要每次重启。仓库地址或分支修改需要重启。首次克隆仍受网络和仓库大小影响,建议保留 Git 缓存卷。
参见 性能与缓存。