Files
opsxdb/apps/server/internal/docs/content/04-connect.md
T
logan a9510235bb
CI / Go server (push) Canceled after 0s
CI / Web + core packages (push) Canceled after 0s
CI / Desktop (Tauri) cargo check (push) Canceled after 0s
feat: 18 引擎驱动全家桶 + 驱动管理/离线包 + 设置中心 + 工作台交互打磨
驱动接入(全部本机真实例验收):
- Elasticsearch 原生 SQL API、InfluxDB 原生 HTTP+Flux(官方 JDBC 付费许可,实测弃用)
- ZooKeeper/MongoDB JVM agent(连接时自动下载官方驱动 jar,sha256 钉版本到 ~/.opsxdb/drivers/)
- 达梦 JDBC agent 桥就绪(待厂商 jar+实例);TiDB 真实例验收
- 协议族代码审查放行 PolarDB/TDSQL/OceanBase/Kingbase/GaussDB/Oracle
- 驱动能力模型:按驱动开关对象树分组/右键菜单/行编辑,NoSQL 树拍平(对象直挂库节点)

驱动管理:
- 驱动管理弹框(状态/预装/离线包导入/JDK 检测)+ /api/drivers/* 三接口
- opsxdb-driver 驱动商店仓库(清单/fetch.sh/pack.sh 离线包/import.sh)
- 连接时懒加载:DMG 零 Java 产物,首连自动下载(实测 ZK 九件套 1.35s),离线包自动回退

UI/交互:
- 设置中心(⚙):常规/执行/结果/驱动/快捷键/关于,左导航+右面板(对标 opsxshell)
- 实例级展开箭头(行首 SVG chevron,替代字体回退失真的 Unicode 三角)
- 树内嵌套渲染修复:对象树挂在激活连接下;工具栏窄窗口不断行(按钮 nowrap+整颗换行)
- 侧栏连接行精简(图标+连接名)、SQLite SSH 守卫、Oracle 死参数清理

质量:
- Go 协议层/离线回退单测、E2E 门控测试(ES/ZK/Influx/Mongo/TiDB/JDBC 桥)
- 驱动注册表单一事实来源 connection-types.json,README/BACKLOG/AGENTS 同步
2026-09-22 01:07:46 +08:00

2.2 KiB
Raw Blame History

本章说明各数据库类型的连接表单、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,账密不会随每次请求上送;密码在本机混淆存储。