CentOS 上升级 SQL Admin 的实用步骤
一 升级前准备
- 明确当前部署形态:SQL Admin 在 CentOS 上通常是以 PHP Web 应用 形式,部署在 Apache/Nginx + PHP 环境,通过浏览器访问;因此“升级”主要是替换程序目录并保留配置与数据。若你实际使用的是 MySQL Workbench、phpMyAdmin、Adminer 等工具,操作方式不同。
- 备份关键资产:
- 程序目录(如:/var/www/html/sqladmin)整目录备份;
- 配置文件(如:config.inc.php)单独备份;
- 如有上传/导出目录(如配置中的 UploadDir/SaveDir),一并备份;
- 数据库全量备份(例如使用 mysqldump)。
- 检查环境版本:确认 CentOS 版本、Apache/Nginx 与 PHP 版本满足新版本 SQL Admin 的要求;必要时先在测试环境验证。
- 可选:将站点置于维护模式(维护页或 Nginx 返回 503),避免升级过程被用户写入。
二 标准升级流程(适用于 PHP Web 版 SQL Admin)
- 进入维护模式(可选):
- Nginx 示例:在 server 块内添加 return 503; 并配置维护页 location,升级完成后再恢复。
- 停止 Web 服务:
- 使用 systemctl:
sudo systemctl stop httpd 或 sudo systemctl stop nginx
- 备份当前程序与配置:
sudo cp -a /var/www/html/sqladmin /var/www/html/sqladmin.bak_$(date +%F)
sudo cp /var/www/html/sqladmin/config.inc.php /root/sqladmin_config_bak.php
- 下载并解压新版本:
- 从官方站点获取最新压缩包(示例文件名形如:sqladmin4.8.2.tar.gz),上传至服务器后解压:
tar xvf sqladmin4.8.2.tar.gz -C /var/www/html/
- 如压缩包内含顶层目录,将其内容移动到 /var/www/html/sqladmin(覆盖前确认已备份)。
- 恢复配置与目录权限:
- 将备份的 config.inc.php 拷回新目录;
- 确保上传/保存目录存在且可写(与配置中的 UploadDir/SaveDir 一致);
- 设置属主属组(示例):
sudo chown -R apache:apache /var/www/html/sqladmin(若用 Nginx+PHP-FPM,可能为 nginx:nginx)。
- 启动 Web 服务并取消维护模式:
sudo systemctl start httpd 或 sudo systemctl start nginx
- 验证升级:
- 访问
http://服务器IP/sqladmin,登录并检查版本号与关键功能;
- 查看 PHP 错误日志(如:/var/log/php-errors.log)与 Web 服务错误日志(如:/var/log/httpd/error_log 或 /var/log/nginx/error.log)。
三 常见问题与回滚
- 访问出现 404:检查 DocumentRoot、目录别名(Alias)与 index.php 配置是否正确,确认文件已放置在正确路径。
- 页面样式/JS 加载异常:确认 PHP 模块(如 php-mbstring、php-xml)已安装,静态资源可访问,浏览器缓存已刷新。
- 无法连接数据库:核对 config.inc.php 中的 host、port、user、password,确认 MySQL 服务运行且防火墙放行 3306 端口(如需远程)。
- 升级异常需回滚:
- 停止 Web 服务;
- 将程序目录恢复为备份:
sudo rm -rf /var/www/html/sqladmin && sudo mv /var/www/html/sqladmin.bak_YYYY-MM-DD /var/www/html/sqladmin;
- 恢复配置文件:
sudo cp /root/sqladmin_config_bak.php /var/www/html/sqladmin/config.inc.php;
- 启动 Web 服务并验证。
四 安全与维护建议
- 使用 HTTPS(为域名配置 TLS 证书),避免凭据明文传输;
- 为 SQL Admin 创建最小权限的数据库账户,避免使用 root;
- 通过 防火墙仅开放必要端口(如 80/443),限制管理源 IP;
- 定期更新 CentOS 与 PHP 相关组件,关注 SQL Admin 官方发布的安全修复;
- 建立定期备份与恢复演练流程,确保可快速回滚与恢复。