升级新版本的正确姿势与数据备份
升级本身不难，难的是「升级前别忘了备份」。
升级前备份什么
程序目录下的 data 文件夹就是全部家当：数据库（账号、存储配置）、config.json、日志。停服务后整个 data 目录拷一份，升级出问题随时回滚。
各部署方式的升级方法
| 部署方式 | 升级操作 |
|---|---|
| 一键脚本 | 重新执行官方更新命令，或用管理面板菜单选更新 |
| 手动二进制 | 下载新版替换旧文件（保留 data 目录） |
| Docker cli | 停容器删容器，拉新镜像，重新运行（数据在卷里不丢） |
| Docker compose | docker-compose pull 后 up -d |
| 桌面版 | 客户端内更新或按官方渠道提示 |
版本兼容注意
- 一般情况下直接替换二进制即可升级；但官方更新日志里标注不兼容的版本要先按说明迁移，不能硬替换。
- 跨大版本（v2 → v3）数据不互通，存储需要全部重新添加。
- 想确认当前版本：命令行
alist version，或后台「设置 → 站点 → 版本」。
Docker 升级后还是旧版
十有八九是镜像加速器缓存：改加速配置或直接把标签指定为具体版本号拉取，见Docker 部署。
升级后小检查
- 打开首页确认能登录、目录正常；
- 抽查一个网盘目录能不能刷新出文件；
- WebDAV 客户端重连一次——大版本升级可能引入权限要求变化（例如 v3.42.0 对 WebDAV 权限位的调整），见WebDAV 总览。