Ubuntu下sqladmin故障排查指南

Ubuntu 下 SQLAdmin 故障排查指南

一 快速定位与最小检查

• 明确症状：是页面打不开、登录失败、连接数据库超时还是500 错误，先记录报错关键词与时间点。
• 服务状态：查看 Web 前端与后端服务是否运行（如 Apache/Nginx 与 sqladmin 单元），必要时尝试启动并观察提示。
• 日志优先：先看 /var/log/syslog 与 /var/log/sqladmin/ 下的最新日志，定位启动失败、连接拒绝、权限校验等关键线索。
• 端口连通：确认 Web 端口（常见 80/443 或自定义 8080）与数据库端口 3306 是否在监听并可达。
• 防火墙与安全组：核对 UFW 规则与云厂商安全组是否放行对应端口。
• 资源与磁盘：用 df -h / du -sh 检查磁盘空间，避免因磁盘满导致写入失败。
• 依赖与配置：确认 PHP、数据库驱动与配置文件语法正确，修改后重载服务。

二 服务与端口检查

• 服务状态与启动
  • 查看状态：sudo systemctl status sqladmin
  • 启动/重启：sudo systemctl start|restart sqladmin
• 端口监听与占用
  • 查看监听：ss -tulpen | grep -E ‘(:80|:443|:8080|:3306)’
  • 定位占用：sudo lsof -iTCP:80 -sTCP:LISTEN 或 sudo ss -lptn | grep 3306
• 防火墙放行
  • UFW：sudo ufw status；sudo ufw allow 80,443,8080,3306/tcp
  • 云安全组：放行对应 TCP 端口（入站/出站）
• 连通性测试
  • 本机：curl -I http://127.0.0.1:8080 或 http://localhost
  • 远程：curl -I http://服务器IP:端口；必要时用 telnet 或 nc 测试端口可达性
• 浏览器侧
  • 打开开发者工具（F12）查看 Console/Network 报错，关注 HTTP 状态码、CORS、重定向与 TLS 提示。

三 数据库连通性与权限

• 数据库服务
  • 状态：sudo systemctl status mysql
  • 启动：sudo systemctl start mysql
• MySQL 绑定地址
  • 编辑配置（路径可能为 /etc/mysql/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf）
  • 允许远程：bind-address = 0.0.0.0（或注释掉该行）
  • 重启：sudo systemctl restart mysql
• 用户权限
  • 登录 MySQL：mysql -uroot -p
  • 授权示例：GRANT ALL PRIVILEGES ON . TO ‘your_user’@‘%’ IDENTIFIED BY ‘your_password’; FLUSH PRIVILEGES;
• SSL 连接
  • 若启用 SSL，确保 SQLAdmin 中 SSL 选项与服务器端 证书/密钥路径配置正确。

四 日志与配置文件

• 系统日志
  • 实时查看：sudo tail -f /var/log/syslog
  • 内核/驱动：dmesg | tail -n 50
• 应用日志
  • SQLAdmin 日志：sudo tail -n 50 /var/log/sqladmin/*.log
  • Web 服务日志：/var/log/apache2/error.log 或 /var/log/nginx/error.log
• 配置文件
  • 核对数据库连接参数：主机、端口、用户名、密码、套接字/SSL
  • 语法检查：php -l /path/to/config.inc.php（若为 phpMyAdmin 类工具）
  • 修改后重载：sudo systemctl reload apache2|nginx 或 sudo systemctl restart sqladmin
• 文件权限
  • Web 目录属主通常为 www-data：sudo chown -R www-data:www-data /usr/share/sqladmin /var/lib/sqladmin

五 常见症状与修复对照表