ubuntu上sqladmin插件安装教程

Ubuntu 上 SQLAdmin 安装教程

一 前置准备

• 更新系统并安装数据库：sudo apt update && sudo apt install -y mysql-server
• 启动并设置开机自启：sudo systemctl start mysql && sudo systemctl enable mysql
• 运行安全脚本（可选但推荐）：sudo mysql_secure_installation
• 创建用于登录 SQLAdmin 的数据库用户（避免使用 root 远程登录）：
  • mysql -u root -p
  • CREATE USER ‘sqladmin’@‘localhost’ IDENTIFIED BY ‘YourStrongPassword!’;
  • GRANT ALL PRIVILEGES ON . TO ‘sqladmin’@‘localhost’;
  • FLUSH PRIVILEGES;
  • EXIT; 说明：SQLAdmin 是 MySQL 的 Web 管理工具，需确保 MySQL 正常运行并可被本机访问。

二 安装方式

• 方式一 APT 安装（推荐）

  • 添加仓库并安装：sudo apt update && sudo apt install -y software-properties-common && sudo add-apt-repository ppa:sqladmin/stable && sudo apt update && sudo apt install -y sqladmin
  • 验证：sqladmin --version
  • 说明：部分系统仓库可能未收录该包，若 apt 找不到包，请改用方式二或方式三。

• 方式二 源码/发布包部署（PHP 项目形态）

  • 安装 Web 与 PHP 运行环境（以 Ubuntu 20.04/22.04 常见组合为例）：sudo apt install -y nginx php-fpm php-mysql
  • 下载并解压 SQLAdmin 发布包（示例文件名，请替换为实际版本）：wget https://www.sqladmin.org/downloads/sqladmin4.8.2.tar.gz && tar xvf sqladmin4.8.2.tar.gz && cd sqladmin4.8.2
  • 配置数据库连接：编辑解压目录中的配置文件（常见为 config.inc.php 或 config.sample.php 复制为 config.inc.php），设置
    • $cfg[‘Servers’][$i][‘host’] = ‘localhost’;
    • $cfg[‘Servers’][$i][‘port’] = ‘3306’;
    • $cfg[‘Servers’][$i][‘user’] = ‘sqladmin’;
    • $cfg[‘Servers’][$i][‘password’] = ‘YourStrongPassword!’;
    • $cfg[‘Servers’][$i][‘auth_type’] = ‘cookie’;（建议用 cookie，避免在文件中明文保存密码）
  • 说明：SQLAdmin 在 Linux 上常见为 PHP 应用，需配合 Nginx/Apache + PHP-FPM 使用。

• 方式三 Docker 部署（最快速）

  • 安装 Docker：sudo apt update && sudo apt install -y docker.io
  • 拉取并运行（示例映射主机 8080 端口）：docker run -d --name sqladmin -p 8080:80 sqladmin/sqladmin
  • 访问：http://<服务器IP>:8080
  • 说明：镜像与端口以实际镜像说明为准，生产环境请挂载数据卷并配置持久化与反向代理。

三 配置与启动

• APT 安装

  • 配置文件路径：/etc/sqladmin/sqladmin.conf（或 sqladmin.ini）
  • 常用参数示例：
    • [database]
    • host = localhost
    • port = 3306
    • user = sqladmin
    • password = YourStrongPassword!
  • 启动与开机自启：sudo systemctl start sqladmin && sudo systemctl enable sqladmin。

• 源码/发布包部署（PHP）

  • 配置 Nginx 站点（/etc/nginx/sites-available/sqladmin）：
    • server {
      • listen 80;
      • server_name your_domain_or_ip;
      • root /path/to/sqladmin; index index.php;
      • location ~ .php$ {
        • include snippets/fastcgi-php.conf;
        • fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 依据实际 PHP 版本调整
      • }
      • location ~ /.ht { deny all; }
    • }
  • 启用站点并重启服务：sudo ln -s /etc/nginx/sites-available/sqladmin /etc/nginx/sites-enabled/ && sudo systemctl reload nginx && sudo systemctl restart php7.4-fpm
  • 访问：http://<服务器IP> 或 http://your_domain。

四 访问与登录

• APT 安装常见监听端口为 9000；源码/PHP 形态常见为 8080；Docker 示例映射为 8080:80。
• 浏览器访问：http://<服务器IP>:<端口>，使用前述创建的 sqladmin 用户登录。
• 若无法访问，请确认服务已启动、监听端口与防火墙策略正确。

五 安全加固

• 限制访问来源：仅允许可信 IP 访问管理端口（如使用 ufw/云安全组仅放行内网或跳板机网段）。
• 启用 HTTPS：为域名配置 Let’s Encrypt 证书，使用 Nginx/Apache 终止 TLS，避免明文传输口令。
• 避免口令明文：PHP 形态建议将 auth_type 设为 cookie，不要把数据库口令写入配置文件。
• 更改默认端口：将服务端口从 8080/9000 调整为非标准端口，降低被扫描概率。
• 最小权限原则：SQLAdmin 数据库用户遵循最小权限，必要时按库/表细化授权，而非使用 ALL PRIVILEGES ON .。
• 及时更新：关注 SQLAdmin 与系统组件的安全更新，定期升级。