SQLAdmin数据库连接配置指南
一、先确认所指的 SQLAdmin 类型
- Web 管理面板：如 phpMyAdmin（常被口语称作“SQLAdmin”）、Adminer，通过浏览器访问，配置集中在 PHP 配置文件或 Web 服务器环境。
- Python 库：SQLAdmin（基于 FastAPI/Starlette），在 Python 代码中以 SQLAlchemy 引擎连接数据库，并挂载到 FastAPI 应用。
- 桌面客户端：如 MySQL Workbench、pgAdmin，在 GUI 中新建连接，填写主机、端口、账户等参数。
二、Web 管理面板 phpMyAdmin 的配置步骤
- 安装与准备
- 安装 Apache/Nginx、PHP 与数据库（如 MySQL/MariaDB），确保服务运行。
- 核心配置文件
- 编辑 config.inc.php，设置数据库连接与安全项，例如：
- 指定服务器：$cfg[‘Servers’][$i][‘host’] = ‘localhost’;
- 端口（可选）：$cfg[‘Servers’][$i][‘port’] = ‘3306’;
- 认证方式：常见为 cookie 或 config（生产建议 cookie）
- 若使用 config 方式，直接配置账户密码：
- $cfg[‘Servers’][$i][‘user’] = ‘your_db_user’;
- $cfg[‘Servers’][$i][‘password’] = ‘your_db_password’;
- 安全增强：$cfg[‘blowfish_secret’] = ‘随机长字符串’;
- Web 服务器示例（Nginx，PHP-FPM）
- 将 phpMyAdmin 目录挂载到站点路径，并代理 .php 到 PHP-FPM（socket 路径按实际 PHP 版本调整）。
- 访问与测试
- 浏览器访问站点路径（如 /phpmyadmin），使用数据库账户登录验证。
- 远程访问提示
- 若需远程管理，确保数据库允许远程（如 MySQL 的 bind-address 与授权），并开放服务器防火墙端口（如 3306/tcp）。
三、Python 库 SQLAdmin 的配置步骤（FastAPI 集成）
- 安装依赖
- 建议 Python ≥ 3.8：pip 安装 sqladmin[fastapi] 及对应驱动（如 mysql-connector-python、psycopg2-binary）。
- 最小可用示例（以 SQLite 为例，生产可替换为 MySQL/PostgreSQL）
- 代码示例：
- from fastapi import FastAPI
- from sqladmin import Admin
- from sqlalchemy import create_engine
- app = FastAPI(title=“My Admin”)
- engine = create_engine(“sqlite:///example.db”, pool_pre_ping=True, echo=True)
- admin = Admin(app=app, engine=engine, base_url=“/admin”, title=“数据库管理后台”)
- 定义 SQLAlchemy 模型与 ModelView，注册到 admin：admin.add_view(YourModelAdmin)
- 启动：uvicorn main:app --reload --host 0.0.0.0 --port 8000
- 数据库 URL 参考
- PostgreSQL：postgresql+psycopg2://user:password@host:5432/dbname
- MySQL：mysql+mysqlconnector://user:password@host:3306/dbname
- 认证与安全
- 默认基于会话的简单认证；可继承 AuthenticationBackend 实现自定义登录校验与会话管理。
四、桌面客户端 MySQL Workbench 与 pgAdmin 的连接要点
- MySQL Workbench
- 菜单 Database → Manage Connections → +，选择 Standard (TCP/IP)；填写 Hostname（服务器 IP/域名）、Port（默认 3306）、Username、Password，点击 Test Connection 验证后保存连接。
- pgAdmin
- 左侧 Browser → Servers → Create → Server，在 Connection 选项卡填写 Host、Port（默认 5432）、Maintenance database（常用 postgres）、Username，保存后连接。
- 通用排查
- 确认数据库服务在目标主机运行；如需远程，确保数据库配置允许远程、服务器防火墙放行对应端口（如 3306/5432），账户与密码正确。