DataOmni icon DataOmni v1.1.0
EN GitHub

快速上手与安全连接配置

两分钟完成安装、系统钥匙串存密、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);未安装时可取消勾选「保存密码」按当次会话输入。
macOS 清除 Gatekeeper 隔离属性(可选)
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 隧道进程。

五档 TLS 模式含义对照
模式 是否加密 证书校验 适用场景
禁用 明文传输 不校验 本机 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 的改删语句执行分级二次拦截。

  1. 表格改动先进本地待提交队列

    在表数据页或可编辑结果集里改单元格、新增行或标记删除,所有动作先进入待提交队列——鼠标点开单元格绝不会静默发出 UPDATE。

  2. 提交前审阅真实参数化 SQL

    展开待提交预览面板,逐条核对即将执行的 INSERT / UPDATE / DELETE 语句;WHERE 子句自动附带修改前原值,防止静默覆盖他人刚改过的数据。

  3. 单事务执行并逐条核对影响行数

    点击提交后,整批语句在同一个数据库事务内执行,逐条校验受影响行数恰好为 1;任一条不符立即整批 ROLLBACK,队列里的改动原样保留供刷新重试。

高频快捷键(Windows / Linux 将 Cmd 换为 Ctrl)
操作 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