Files
opsxdb/apps/server/internal/docs/content/04-connect.md
T
logan 26f459d1b8 fix: 顶栏文案去重与文档/连库体验更新
顶栏定为:连接 · 新建连接 · 新建查询 · 查询历史 · 快捷键;
同步 docs/落地页、对象树与 connection-types 注册表整理。
2026-09-20 16:32:29 +08:00

43 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
本章说明各数据库类型的连接表单、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`,账密不会随每次请求上送;密码在本机混淆存储。