从 AList V3 迁移到 OpenList：解授权、备数据、换程序的完整流程

还在跑 AList V3？迁到 OpenList 主要图两样：社区长期维护的安全更新，与持续演进的功能。迁移不复杂，但顺序很重要。

第 0 步：先确认版本兼容性

平滑迁移不兼容 AList v3.46 及更高版本——如果你已经升到了新版，直接替换二进制的路走不通，需要走「备份 + 恢复」路线（第 5 步）。老版本（低于 v3.46）可以保留 data 文件夹直接换程序。

第 1 步：解除各网盘的 AList 授权（重要）

原作者提供的 API 服务存在被第三方接管的可能，迁移时顺手把旧授权撤掉，再在 OpenList 里重新授权。各平台解绑入口速查：

官方迁移文档对每个平台都配了截图，照着点即可。这一步与数据无关，做的是「账号安全卫生」。

第 2 步：备份配置

• 用旧站的备份功能导出配置到本地（或直接拷贝整个 data 文件夹）
• data 里是站点设置 + 数据库 + 你的全部存储配置，是迁移的核心资产（详见 备份与恢复）

第 3 步：卸载旧程序

按原来的安装方式卸载 AList；Docker 用户记下原有的端口、目录映射，马上要用。

第 4 步：安装 OpenList

按本站 安装部署 装好新站。Docker 用户的关键动作：卷映射路径要从 /opt/alist/data 改成 /opt/openlist/data——不改的后果是升级重建容器后配置全丢。官方建议删除旧容器重建而不是原地改。

第 5 步：恢复配置

• 旧版本低于 v3.46：data 文件夹原样放好，直接换二进制即可，存储和用户都在
• 其他情况：用「备份 & 恢复」功能把第 2 步导出的配置文件恢复进新站

第 6 步：重置默认设置

进新站后台，在每个设置页点底部「加载默认设置」再「保存」——把 AList 时代的旧默认值刷新成 OpenList 的当前默认，补齐新功能的配置项。最后重建一次 搜索索引，迁移完成。