opsxdb/apps/server/internal/docs/content/04-connect.md

本章说明各数据库类型的连接表单、URL 格式与高级选项（SSL / SSH 隧道）。

通用流程

1. 连接选择器点「新建」或选某个数据库类型；
2. 填写表单（不同驱动表单不同，见下表）；
3. 测试 → 通过后 保存并连接。

支持直接粘贴 URL 自动填表：

mysql://root:pass@127.0.0.1:3306/shop
postgres://opsx:pass@127.0.0.1:5432/app

各驱动表单

驱动	表单	特有字段
MySQL / PostgreSQL / SQL Server	standard	host · port · user · password · database · ssl · ssh
Oracle	oracle	host · port · user · password · service（如 ORCL）
SQLite	file	database 填本地文件路径（如 ~/data/demo.sqlite）
Redis	redis	host · port · password · database 序号

表单只收集服务端实际消费的字段；历史遗留的死参数不会出现在表单里。

MySQL 族与 PostgreSQL 族

协议兼容的国产库无需单独驱动，直接复用家族驱动：

• MySQL 族：MariaDB（3307）、TiDB（4000）、OceanBase（2881）、PolarDB / TDSQL（3306）—— 表单里选对应类型即可；
• PostgreSQL 族：GaussDB / openGauss、人大金仓 Kingbase（54321）—— 走 postgres 表单，注意默认库与用户名差异。

SSL / TLS

连接表单中开启 ssl 即可；按连接独立配置，互不影响。内网自签证书场景按需放宽校验策略。

SSH 隧道

数据库在跳板机后面时，开启 ssh 字段组，填写跳板机地址与凭据：OpsxDB 会先建 SSH 隧道，再把数据库连接走隧道转发，无需把库端口暴露到公网。

提示：连接保存后，后续查询仅携带 sessionId，账密不会随每次请求上送；密码在本机混淆存储。