OpsxDB 文档 v0.1

新建连接

更新于 2026-09-20

本章说明各数据库类型的连接表单、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 隧道,再把数据库连接走隧道转发,无需把库端口暴露到公网。

Redis 哨兵与集群

  • 哨兵:模式选 Sentinel,填写 Sentinel 节点列表(host:port,多行)和主节点名 masterName;
  • 集群:模式选 Cluster,填写至少一个种子节点。对象树只显示 DB 0(Cluster 无 SELECT);
  • 单机模式只填 host/port,与原先一致。

字段细节与键浏览见 Redis 工作台。

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