快速上手与安全连接配置
两分钟完成安装、系统钥匙串存密、SSH 跳板机与 TLS 校验配置,掌握「改表先审 SQL、单事务核对回滚」的日常安全工作流。
在 macOS、Windows 与 Linux 上安装启动 #
DataOmni 基于 Tauri 2 与 Rust 构建为单一原生桌面安装包,随包内置 Oracle Instant Client(Basic Light)、DuckDB 2.0 与 SQLite,无需安装 Java 运行时、Node.js 或注册任何云端账号。
| 平台 | 安装包 | 首次启动与凭据说明 |
|---|---|---|
| macOS 12+(Apple Silicon) | DataOmni_<ver>_aarch64.dmg | 将 DataOmni.app 拖入「应用程序」。当前构建启用 Hardened Runtime 但暂未接入付费公证,首次打开请在「系统设置 → 隐私与安全性」点一次「仍要打开」,或执行下方命令清除隔离标记。 |
| Windows 10 / 11(x64) | .exe(NSIS)或 .msi | 首次启动若遇 SmartScreen 提示,点「更多信息 → 仍要运行」。口令存入 Windows 凭据管理器;SQLite 与 DuckDB 原生支持超过 260 字符的长路径。 |
| Linux x86_64(glibc 2.34+) | .deb 或 .rpm | 支持 Ubuntu 22.04+、Fedora 42+。保存口令需桌面会话已解锁 Secret Service(如 gnome-keyring);未安装时可取消勾选「保存密码」按当次会话输入。 |
xattr -dr com.apple.quarantine /Applications/DataOmni.app
密码存在哪里,本地文件放在哪里 #
数据库密码、SSH 私钥口令与 AI API Key 一律写入操作系统钥匙串,绝不以明文或私有可逆编码写进本地配置文件。磁盘上的 connections.json 只保留主机、端口、库名、TLS 档位与环境标记,可放心做常规备份。
| 内容 | macOS | Linux | Windows |
|---|---|---|---|
| connections.json(不含口令) | ~/Library/Application Support/com.dataomni.app/ | ~/.config/com.dataomni.app/ | %APPDATA%\com.dataomni.app\ |
| 数据库口令与 SSH 口令 | macOS 系统钥匙串 | Secret Service(gnome-keyring) | Windows 凭据管理器 |
| 运行日志与 CLI 留痕 | ~/Library/Logs/com.dataomni.app/ | ~/.local/share/com.dataomni.app/logs/ | %LOCALAPPDATA%\com.dataomni.app\logs\ |
macOS 升级版本后的钥匙串授权提示
在接入 Apple Developer ID 团队签名之前,macOS 会按二进制摘要区分新旧版本。升级后首次读取已存密码时,输入开机密码并点「始终允许」,界面端与内置 CLI / MCP 即可共享同一授权。
TLS 证书校验档位与 SSH 跳板机隧道 #
所有网络数据库统一经 rustls 建立加密连接,三平台行为完全一致。数据库仅监听内网时,勾选「通过 SSH 隧道连接」即可在进程内直接打通跳板机转发,无需手工维护外部 ssh 隧道进程。
| 模式 | 是否加密 | 证书校验 | 适用场景 |
|---|---|---|---|
| 禁用 | 明文传输 | 不校验 | 本机 Docker 测试库,或无 ECDHE 加密套件的旧版 MySQL 5.7。 |
| 优先使用 TLS | 协商加密 | 不校验 | 服务端支持则加密,不支持则退回明文(SQL Server / TiDB / CockroachDB 默认档)。 |
| 要求 TLS | 强制加密 | 不校验 | 拒绝降级明文,但放行云厂商或内网自签证书(MySQL 新建连接默认档)。 |
| 校验证书颁发机构 | 强制加密 | 校验 CA 链 | 使用系统根证书或指定 CA PEM 文件验证服务端证书签发方。 |
| 校验证书和主机名 | 强制加密 | 校验 CA + 主机名 | 生产环境标准配置,同时核对证书链与连接地址域名 / IP。 |
- 双向 TLS(mTLS):服务端要求客户端证书时,「客户端证书路径」与「客户端私钥路径」必须成对填写(填数据库 TLS 证书,勿与 SSH 私钥混用)。
- SSH known_hosts 强校验:跳板机主机指纹严格核对 ~/.ssh/known_hosts(Windows 为 %USERPROFILE%\.ssh\known_hosts),未知或变更一律拒绝并回显 SHA256 指纹,不设「跳过校验」后门;首次连新跳板机前请先在终端 ssh 登录一次确认指纹。
- 逐层网络诊断:连不上时点击表单里的「网络诊断」,直接区分 DNS 解析失败、端口未监听、本机 TUN 代理闪断、TLS 握手告警或账号口令错误。
环境分级护栏、SQL 预览提交与常用快捷键 #
新建连接时即可指定「开发 / 测试 / 预发 / 生产」环境。预发与生产连接在侧边栏、查询标签与表数据页全程悬挂醒目标识,并对 DROP、TRUNCATE、FLUSHDB 及不带 WHERE 的改删语句执行分级二次拦截。
-
表格改动先进本地待提交队列
在表数据页或可编辑结果集里改单元格、新增行或标记删除,所有动作先进入待提交队列——鼠标点开单元格绝不会静默发出 UPDATE。
-
提交前审阅真实参数化 SQL
展开待提交预览面板,逐条核对即将执行的 INSERT / UPDATE / DELETE 语句;WHERE 子句自动附带修改前原值,防止静默覆盖他人刚改过的数据。
-
单事务执行并逐条核对影响行数
点击提交后,整批语句在同一个数据库事务内执行,逐条校验受影响行数恰好为 1;任一条不符立即整批 ROLLBACK,队列里的改动原样保留供刷新重试。
| 操作 | macOS | Windows / Linux |
|---|---|---|
| 打开命令面板(搜连接、搜表、调动作) | Cmd + K | Ctrl + K |
| 执行当前语句或选中语句 | Cmd + Enter | Ctrl + Enter |
| 新建查询标签 / 关闭当前标签 | Cmd + T / Cmd + W | Ctrl + T / Ctrl + W |
| 关闭整个应用窗口 | Cmd + Shift + W | Ctrl + Shift + W |
| 折叠或展开左侧对象树 | Cmd + B | Ctrl + B |