面板右上角“更新”按钮失效说明已脱离常规升级路径，需通过命令行强刷并备份；v9.0.0不可直升v11.4，必须重装+数据迁移。
面板右上角“更新”按钮点不动，说明已脱离常规升级路径
这不是按钮坏了，而是旧版本（如 v7.9.0、v8.2.2）的 Python 运行环境或面板内核已不兼容新版本协议。内置更新功能会直接失效，反复点击无效，还可能留下锁文件或触发重复下载。
- 先执行
bt命令回车，看第一行输出确认当前版本；若低于v9.0.0，基本需命令行强刷 - 别跳过备份：哪怕只做一次服务器快照，也比升级失败后手动抢救强得多
- 升级脚本本身不碰网站数据，但极老版本（2021 年前安装）存在
pyenv初始化异常风险，可能导致面板启动失败
执行 update_panel.sh 报 “No such file or directory” 怎么办
最常见错误是 mv: cannot stat '/www/server/panel/pyenv': No such file or directory —— 这不代表操作失败，只是你压根没用 pyenv 管理 Python，属于早期安装方式，那步备份可以跳过。
- 直接运行升级命令：
curl http://download.bt.cn/install/update_panel.sh|bash - 如果提示
curl: command not found，先装依赖：yum install -y curl（CentOS）或apt install -y curl（Ubuntu/Debian） - 若网络不稳定，换阿里云镜像：
curl -k https://mirrors.aliyun.com/bt/install/update6.sh | bash
升级后插件不显示、计划任务失效、PHP 路径报错
这不是升级失败，而是新版面板（v9.0+）清除了非标准配置：它不会自动迁移手动装的插件、自定义脚本路径、或源码编译的 MySQL 二进制。
-
Nginx 防火墙、网站监控等依赖内核的插件，需进软件商店点“修复”或重装 - 所有 Shell 类计划任务，检查 PHP 调用路径是否还是
/usr/bin/php；新版默认走/www/server/php/81/bin/php（以你实际安装的 PHP 版本号为准） - MySQL 从 5.6 升到 5.7+ 后，
sql_mode默认值变更，老程序可能报Invalid default value for 'xxx'
v9.0.0 不能直升 v11.4，跨架构升级必出问题
官方明确不支持 v9.0.0 → v11.4 的覆盖升级。两者底层架构差异大，强行执行会导致面板白屏、API 失效、甚至登录页 CSS 加载失败。
-
v9.0.0是稳定版，只修 bug，不加新功能；v11.4是正式版，含全新前端与权限模型 - 真要升到
v11.4，必须重装 + 数据迁移，不是“升级”，而是“重建” - 重装前务必导出全部站点配置、数据库用户、SSL 证书、计划任务内容 —— 面板不帮你记这些
