Debian 上 SQLAdmin 更新步骤
一 确认安装来源与当前版本
- 查看是否为第三方 APT 仓库安装（Debian 官方仓库通常不包含名为 sqladmin 的包）：
- 检查是否存在源文件：ls /etc/apt/sources.list.d/ | grep -i sqladmin
- 查看包信息：apt policy sqladmin
- 查看服务运行状态与日志定位实例：
- 状态：sudo systemctl status sqladmin
- 日志：sudo journalctl -u sqladmin -n 50 --no-pager 或查看 /var/log/sqladmin/ 目录下的日志文件
- 如通过第三方仓库安装，优先使用该仓库的更新通道，避免与系统仓库混用导致依赖冲突。
二 标准更新流程（通过官方 APT 仓库）
- 更新索引并优先执行安全/小版本升级：
- sudo apt update
- sudo apt upgrade
- 如仓库提供新版，执行发行版升级（大版本/跨版本）：
- 重启服务或系统：
- sudo systemctl restart sqladmin
- 如有内核/库更新：sudo reboot
- 验证版本与运行状态：
- 查看服务：sudo systemctl status sqladmin
- 查看应用日志：sudo journalctl -u sqladmin -n 50 --no-pager
- 说明：SQLAdmin 为第三方 Web 管理工具，更新方式与常规 APT 软件一致；若仓库提供 .deb 新版本，上述流程即可完成升级。
三 使用官方仓库时的更新（若最初通过 SQLAdmin 官方 APT 源安装）
- 导入/更新 GPG 公钥（如仓库提供）：
- wget -qO - https://packages.sqladmin.io/debian/public.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/sqladmin-archive-keyring.gpg >/dev/null
- 确保源文件使用 Signed-By（Debian 11+ 推荐）：
- echo “deb [signed-by=/usr/share/keyrings/sqladmin-archive-keyring.gpg] https://packages.sqladmin.io/debian/ $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/sqladmin.list
- 更新索引并升级：
- sudo apt update
- sudo apt upgrade sqladmin
- 重启服务并验证：
- sudo systemctl restart sqladmin
- sudo systemctl status sqladmin
- 提示：若 lsb_release -cs 在你的 Debian 版本上不可用，可手动替换为对应代号（如 bookworm、bullseye）。
四 故障排查与回滚建议
- 升级后无法启动：
- 查看状态与日志：sudo systemctl status sqladmin；sudo journalctl -u sqladmin -n 50 --no-pager
- 检查端口占用：ss -ltnp | grep 8080（默认端口通常为 8080）
- 核对配置：/etc/sqladmin/config.yaml 中的监听地址与端口
- 防火墙放行：sudo ufw allow 8080/tcp
- 依赖或配置损坏的修复思路：
- 重新安装：sudo apt install --reinstall sqladmin
- 极端情况可备份配置与数据后清理重装（先停服务、备份 /etc/sqladmin 与 /var/lib/sqladmin，再恢复）
- 回滚策略：
- 优先使用 APT 历史版本回退：sudo apt install sqladmin=<旧版本号>
- 若通过第三方仓库升级导致不稳定，可暂时注释该仓库、降级相关包，或等待仓库修复后再升级。
