在 Debian 上迁移 SQLAdmin 的可执行方案
一、迁移目标与准备
- 明确迁移对象：SQLAdmin 作为数据库管理工具，迁移通常包含两部分——其自身的配置与连接信息，以及它所管理的数据库（如 MySQL/MariaDB 或 PostgreSQL）的数据与权限。
- 准备与评估：
- 备份所有数据库与配置文件（全量逻辑备份或物理备份）。
- 尽量保持新旧环境的 操作系统版本、数据库版本、依赖库 一致，减少兼容性问题。
- 选择低峰时段执行，避免业务中断；先在测试环境演练全流程。
二、迁移数据库数据（SQLAdmin所管理的库）
- 逻辑迁移（通用、跨版本友好）：
- 源库导出：
- 单库：mysqldump -u username -p database_name > database_name.sql
- 全库：mysqldump --all-databases > all_databases.sql
- 传输到目标 Debian：scp backup.sql user@new_server_ip:/path/
- 目标库导入：mysql -u username -p database_name < /path/backup.sql
- 大表与停机敏感场景可用物理备份工具（如 Percona XtraBackup）以减少锁表时间。
- 物理迁移（同版本、同平台更快）：
- 停库并拷贝数据目录：rsync -av /var/lib/mysql/ /new_storage/mysql/
- 修改 my.cnf 中 datadir=/new_storage/mysql，修正权限：chown -R mysql:mysql /new_storage/mysql
- 如使用 AppArmor，更新 /etc/apparmor.d/usr.sbin.mysqld 对新数据目录的授权
- 重启数据库并校验数据完整性。
三、迁移 SQLAdmin 本身（工具与连接配置）
- 安装与仓库（Debian 系）：
- 更新索引并安装依赖：sudo apt update && sudo apt install -y mysql-client 等
- 添加官方仓库并安装（示例）：
- wget -qO - https://packages.sqladmin.io/debian/public.key | sudo apt-key add -
- echo “deb https://packages.sqladmin.io/debian/ $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/sqladmin.list
- sudo apt update && sudo apt install -y sqladmin
- 配置与启动：
- 启动服务：sudo systemctl start sqladmin；开机自启：sudo systemctl enable sqladmin
- 访问地址：http://localhost:8080（默认端口 8080）
- 远程访问需开放防火墙端口（如 8080/9000）并配置安全策略（见下一节）。
四、迁移后的验证与网络访问
- 连通性与权限验证：
- 在 SQLAdmin 中添加/修改数据库连接，使用类似 JDBC URL：jdbc:mysql://new_db_host:3306/dbname?user=username&password=password
- 在数据库中校验用户权限与可远程访问范围（如仅允许管理网段）。
- 功能与数据验证：
- 抽查核心表数据量与样本记录，执行关键查询与业务回放，确认无报错与性能异常。
- 核对视图、存储过程、触发器、外键与字符集/排序规则一致性。
- 安全与网络：
- 建议更改默认端口（如 9000）、启用 HTTPS（Nginx/Apache + Let’s Encrypt），并限制可访问 IP。
五、常见问题与排障要点
- 兼容性与依赖：
- 优先使用 Debian LTS 版本；缺失共享库（如 libssl1.1、libldap-2.4-2）时，按官方包或可信仓库安装对应 .deb 后重试。
- 服务与日志：
- 检查服务状态：sudo systemctl status sqladmin
- 查看日志定位问题：/var/log/sqladmin.log 或 journalctl -u sqladmin；常见为端口冲突、权限拒绝、配置错误。
- 防火墙与端口：
- 开放访问端口（如 8080/9000），并仅对可信来源放行，避免暴露管理界面。