Ubuntu环境下SQLAdmin搭建与配置指南

一、前置准备

在开始搭建前，请确保你的Ubuntu系统已完成基础更新，并安装了常用工具包：

sudo apt update && sudo apt upgrade -y
sudo apt install -y software-properties-common wget curl

二、主流安装方式

1. 通过APT仓库安装（推荐，简单快捷）

SQLAdmin官方提供了Ubuntu的APT仓库，可直接通过包管理器安装：

# 添加SQLAdmin官方APT仓库
sudo add-apt-repository ppa:sqladmin/stable
# 更新包列表
sudo apt update
# 安装SQLAdmin
sudo apt install -y sqladmin

2. 通过Docker容器安装（轻量灵活）

若你习惯使用Docker，可通过官方镜像快速部署：

# 拉取SQLAdmin Docker镜像
docker pull sqladmin/sqladmin
# 运行容器（映射80端口到宿主机）
docker run -d --name sqladmin -p 80:80 sqladmin/sqladmin

三、基础配置

1. 配置文件位置

安装完成后，主配置文件通常位于/etc/sqladmin/sqladmin.conf（APT方式）或/etc/sqladmin/config.yaml（Docker方式）。可通过以下命令编辑：

sudo nano /etc/sqladmin/sqladmin.conf  # 或 config.yaml

主要可配置项：

• 监听地址与端口：修改listen.address（默认0.0.0.0）和listen.port（默认8080）；
• 数据库连接：添加数据库URL（如MySQL的jdbc:mysql://localhost:3306/dbname?user=root&password=123456）。

2. 数据库连接设置

SQLAdmin需连接目标数据库（如MySQL）才能管理。以MySQL为例：

# 登录MySQL并创建专用用户（可选但推荐）
mysql -u root -p
CREATE USER 'sqladmin_user'@'%' IDENTIFIED BY 'StrongPassword123!';
GRANT ALL PRIVILEGES ON *.* TO 'sqladmin_user'@'%';
FLUSH PRIVILEGES;

然后在SQLAdmin配置文件中添加上述用户的连接信息。

四、启动与启用服务

# 启动SQLAdmin服务
sudo systemctl start sqladmin
# 设置开机自启动
sudo systemctl enable sqladmin
# 检查服务状态
sudo systemctl status sqladmin

五、安全加固

1. 更改默认端口

编辑配置文件，将listen.port从8080改为其他端口（如9090），避免被扫描攻击：

sudo nano /etc/sqladmin/sqladmin.conf
# 修改后重启服务
sudo systemctl restart sqladmin

2. 启用HTTPS

通过Let’s Encrypt免费获取SSL证书，配置Nginx反向隧道：

# 安装Certbot和Nginx
sudo apt install -y certbot python3-certbot-nginx
# 获取证书（替换your_domain.com为你的域名）
sudo certbot --nginx -d your_domain.com
# 自动配置Nginx反向隧道（将443端口流量转发到SQLAdmin的8080端口）

3. 防火墙设置

仅允许必要端口访问（如HTTP/HTTPS、SQLAdmin端口）：

sudo ufw allow 22/tcp    # SSH
sudo ufw allow 80/tcp    # HTTP（可选，若启用HTTPS可禁用）
sudo ufw allow 443/tcp   # HTTPS
sudo ufw allow 9090/tcp  # SQLAdmin端口（若更改过端口）
sudo ufw enable          # 启用防火墙

六、访问与验证

打开浏览器，输入http://your_server_ip:port（若启用HTTPS则为https://your_domain.com），即可看到SQLAdmin登录页面。首次登录需使用配置的管理员账号（默认可能为admin，具体以安装方式为准），登录后立即更改默认密码。

七、常见问题排查

• 无法访问：检查防火墙是否放行端口、Nginx反向隧道配置是否正确；
• 数据库连接失败：确认数据库用户权限、连接URL格式（如MySQL需包含端口号3306）；
• 服务无法启动：查看日志文件/var/log/sqladmin/error.log定位具体错误。

以上步骤覆盖了Ubuntu环境下SQLAdmin的主要搭建流程，具体配置可根据实际需求调整。若需更高级的功能（如集群管理、自定义插件），建议参考SQLAdmin官方文档。