升级与浏览器缓存
这一篇覆盖什么
AsterDrive 的页面和服务端由同一个程序提供——正常升级就是升级同一个镜像或同一个二进制，不需要单独部署一套静态资源。 出现"页面还是旧的、服务已经是新的"这种半更新状态时，翻到 如果你做过自定义打包或替换。
AsterDrive 的页面、公开分享页和服务端由同一个程序提供。
正常部署时，只要升级同一个镜像或同一个二进制，页面和服务端就会一起更新。
推荐做法
- Docker 部署：直接升级到新的镜像版本
- systemd 或单二进制部署：直接替换成新的
aster_drive - 升级后刷新浏览器页面，再测试登录、上传、分享、WebDAV 和你正在使用的外部打开方式
什么情况会出现版本不一致
如果你没有直接使用同一版本的官方镜像或同一版本的二进制，而是手动混用了不同版本的页面资源和服务端，就可能出现“页面还是旧的，服务已经是新的”这种半更新状态。
常见现象：
- 页面能打开，但按钮报错
- 新版本功能入口在页面里看不到
- 某些弹窗能打开，但提交失败
- WOPI 或外部预览入口显示异常，或者点开后行为和后端版本对不上
如果你做过自定义打包或替换
如果你不是直接用现成镜像或二进制，而是自己构建或覆盖过页面资源，升级时要保证页面资源和服务端来自同一版本。
推荐顺序：
- 备份
data/config.toml、数据库和上传目录 - 停止旧服务
- 一次性替换新的服务端和新的页面资源
- 启动服务
- 刷新浏览器缓存并做一次完整验收
浏览器页面不需要单独部署
浏览器页面、公开分享页和静态资源都由同一个 AsterDrive 服务返回。
反向代理通常只需要把整个站点代理到 AsterDrive，不需要再单独部署一套静态资源服务。
升级后页面看起来不对时先做这几步
- 先确认服务已经升级到预期版本
- 强制刷新浏览器页面
- 如果你走的是 Docker，再确认容器是不是用了最新镜像
- 如果你做过自定义页面替换，确认页面和服务端来自同一个版本