更新

自动更新

面板默认开启自动更新，每天凌晨 2 点左右会自动检测并更新。 更新期间面板会短暂不可用（通常不超过 1 分钟）。

要关闭自动更新：「设置」->「安全」->「自动更新」。

手动更新

Web 界面

在首页点击版本或 更新。 对话框会比较当前版本和目标版本，显示更新日志，并实时输出各更新阶段。 失败或超时信息会保留，便于复制错误。

开始前下载近期面板备份，确认重要网站和数据库有各自备份，并保留独立 SSH 会话。 迁移、恢复、应用安装或其他关键后台任务运行期间不要更新。

更新过程中面板服务会重启，浏览器连接将暂时断开。 部分更新还可能要求重启服务器，这会中断网站、数据库、项目、容器、SSH 和其他服务。 仅重启面板且更新成功后，对话框会自动关闭或刷新页面。

命令行

acepanel update

Web 界面不可用时使用命令行， 并保持终端打开、阅读完整输出。

更新失败

首页显示数据库或更新健康告警，或更新后面板无法使用时，运行：

acepanel fix

重试前检查 acepanel status、可用磁盘空间、更新源网络连接和失败阶段日志。 acepanel fix 仍无法恢复时，保留备份和错误输出，并到社区求助。