升级与迁移

在线升级（推荐）

后台左下角会显示当前版本号，点它就能检测新版本并一键升级。整个过程不用碰服务器。

升级前先备份数据库。宝塔用户在 数据库 → 备份 点一下就行，几秒钟的事，出问题能救命。

Docker 用户同样可以在后台在线升级，不需要换镜像 —— 程序文件在数据卷里。

手动升级

在线升级失败时才用这个。必须从你当前的版本开始，一个一个往上升，不能跳版本。

每个升级包解压后是这样：

内容	怎么处理
file/ 文件夹	里面的文件复制到网站根目录，覆盖同名文件
update.sql	有这个文件才需要执行，见下

update.sql 的处理：

1. 用编辑器打开，把里面的 __PREFIX__ 全部替换成你的数据库表前缀（默认是 acg_）
2. 到 phpMyAdmin 或数据库工具里执行这个 SQL

全部升完后，把 config/app.php 里的 version 改成升级后的版本号。

手动升级很容易出错，能用在线升级就别手动。

站点搬家

把整个网站搬到另一台服务器：

1. 打包源码 —— 整个网站目录打包带走
2. 导出数据库 —— 用 phpMyAdmin 或 mysqldump 导出
3. 在新服务器上按 宝塔安装 装好环境（PHP 版本、扩展要对得上）
4. 源码解压到新站点根目录，数据库导入
5. 改 config/database.php —— 换成新服务器的数据库地址、账号、密码
6. 重新配置伪静态和目录权限

搬完打不开，按这个顺序查：

检查项	说明
config/database.php	数据库连接信息是不是还是旧的
Redis	旧站如果用了 Redis 存会话，新服务器也得装上，或者把 PHP 的 session 存储改回文件
PHP 扩展	bcmath 别漏了
目录权限	config、runtime、kernel/Install、assets/cache 要可写
伪静态	新服务器要重新配

Docker 换镜像

docker pull ghcr.io/lizhipay/acg-faka:latest
docker stop faka && docker rm faka
docker run -d --name faka -p 80:80 -v acg_data:/data --restart unless-stopped ghcr.io/lizhipay/acg-faka:latest

只要 -v acg_data:/data 这个卷名没变，数据、配置、已装的插件全都还在。

升级后出问题

先看网站根目录的 runtime.log，绝大多数问题的真实原因都在里面。