使用手册 / 第 02 章
连接
只连接你有权访问的数据库和服务器。排查问题优先使用只读或最小权限账号;写入、删除和覆盖之前先核对目标并做好备份。
数据库:配置、测试与连接
- 打开「连接 → 数据库」,点「新建连接」。在「配置」中填写名称和类型:SQLite 选择本机数据库文件;MySQL、PostgreSQL、Redis 和 MongoDB 填主机、端口与所需的认证信息。
- 网络数据库可在「SSH 隧道」选择「直连」或已保存的服务器。使用隧道时填 SSH 服务器能访问的数据库地址,不是笔记本的本地地址。SSH 账号需允许 TCP 转发,数据库账号仍须有目标库相应权限。
- 点「测试」验证当前配置,不会保存连接条目或保留浏览会话。「保存」只保存配置;「连接」会先保存新增或修改的配置,再建立会话。连接失败时,配置可能已经保存。
- 连接后进入「浏览」核对数据库、表、集合或键。修改已连接的配置后,按提示重新连接。
SQLite 需要对应文件权限,选择已有数据库时建议关闭「文件不存在时创建」:开启后连「测试」也可能创建目录和空库,关闭它也不代表只读。MySQL 和 PostgreSQL 的默认端口分别为 3306 和 5432;直连优先尝试 TLS,但可能回退,不能把它视为强制加密连接。
已有保存密码时,留空通常表示保留原值;要移除请用「清除已存密码」。删除连接只移除本机条目和对应保存的凭据,不会删除服务端数据。
SQL:浏览表、运行查询与导出结果
- 连上 SQLite、MySQL 或 PostgreSQL 后,在「浏览」选择表或视图,查看属性和分页结果;也可填写
WHERE条件缩小预览范围。 - 切到「查询」编辑 SQL。点「执行」或按 ⌘/Ctrl + Enter:有选区时优先执行选中内容,没有选区则执行整个编辑器。批量 SQL 会按驱动返回的结果分段显示。
- 检查结果、耗时及截断提示。行结果可「导出 CSV」或「导出 JSON」;写入语句可显示受影响行数。预览默认每页 100 行,查询默认最多显示 200 行,可在模块设置调整。
显示上限不会限制写入范围。 批量执行或危险语句会提示确认;没有 WHERE 的更新或删除可能影响整表。执行失败、取消或超时都不保证回滚;先核对库名、选区和事务状态,导出有敏感字段的结果时注意保存位置。
Redis:查找键并核对过期时间
默认端口为 6379,「库编号」留空为 0;实际可用编号由服务器决定。连接后在「浏览」切换库,用 *、? 匹配键名,点「加载更多」继续扫描。点键名可查看类型、值和 TTL。Redis 不使用 SQL 查询页。
可新建或编辑字符串、哈希、列表、集合和有序集合;内容超过 1 MB 或 1000 项时会截断并禁止保存。「删除键」确认后会删除服务器上的数据,无法在界面恢复。
MongoDB:区分只读查询和脚本执行
配置单个主机,默认端口为 27017、默认数据库为 test,认证库固定为 admin。仅当服务端允许匿名访问时才同时留空用户名和密码。不支持 SRV、TLS 或副本集连接配置;需要时可使用受信任的 SSH 隧道。「测试通过」只表示 ping 通,不代表已验证目标集合的读写权限。
只读 JSON 查询
- 核对目标数据库。在「浏览」选择集合,查看文档或用 JSON 条件筛选。
- 在「查询」选「只读 JSON 查询」,输入包含集合名及可选筛选、排序的 JSON,点「执行」。例如在有读取权限的示例库中查询
products集合:
{"collection":"products","filter":{},"sort":{"_id":1}}
结果以文档 JSON 显示,受行数和 8 MiB 结果大小限制。只读模式无需安装 Shell,只接受 collection、filter 和 sort,不提供投影、聚合、写入或任意命令。
MongoDB 语句
- 选择「MongoDB 语句」并准备可信的 mongosh 脚本。首次缺少组件时,按提示同意联网下载官方 MongoDB Shell;不需另装 Node.js 或配置 PATH。受管组件支持 macOS(Apple 芯片和 Intel)和 Windows x64。
- 组件安装后重新点「执行」,核对目标数据库和脚本,再点「确认执行脚本」。需要看到结果时,可在脚本中用
printjson(...)输出;界面会显示输出、退出码、耗时及截断提示。
脚本不是沙箱。 它可执行有权限的写入、聚合和索引操作,并拥有当前用户的本机文件、网络和进程权限。只运行可信脚本,写入前备份;取消或超时不会回滚已执行的操作。离线缺少 Shell 时仍可用只读 JSON 模式查询可达的数据库。
SSH:连接并核对服务器身份
- 打开「连接 → 终端连接 → 远程服务器」,点「新建服务器」,填名称、主机、端口(默认
22)和用户。 - 选择密码、私钥或 SSH Agent。私钥方式需本机可读的私钥文件,有口令才填;SSH Agent 需要已启动并加载密钥的 Agent,Windows 上请使用密码或私钥。需要跳转时,在「跳板机」选择已保存的服务器。
- 点「测试」查看进度;测试结束会断开临时会话。保存后点「连接」,成功时可见远端主机名。在「概况」核对身份与资源,再到「终端」打开远程 Shell;可开多个远程终端标签。
「导入 SSH 配置」可依赖系统 SSH 读取 ~/.ssh/config 的部分配置,不是完整移植;同名项、通配别名、ProxyCommand 和无法映射的跳板配置会跳过。首次成功验证(包括测试)可记录主机密钥指纹。指纹变化时连接会被拒绝;先通过可信渠道核对服务器指纹,确认是合法更换后再「清除主机密钥」并重新连接。删除服务器条目不会删除远端文件。
SFTP:预览和传输远程文件
- SSH 连接后切到「文件」。服务器需启用 SFTP,且当前账号需要相应目录权限。输入远端路径点「打开」,或用「上级」和刷新定位文件。
- 点文件查看预览;支持的文本最多 2 MiB,图片最多 20 MiB。目录最多显示 2000 项,列表没出现的项目不一定不存在。
- 点「下载」,选择本机保存位置并查看进度。下载完成前不会替换旧文件;进入最后提交阶段后可能无法取消。「上传」一次选择一个本机文件,确认前核对远端完整路径。
上传同名文件可能覆盖远端文件。 「重命名」和「删除」会直接改变远端文件系统;删除目录要求目录为空,不会递归清理,也没有应用内回收站。
本机终端
要操作当前电脑而非远端,在「终端连接」中切到「本机终端」。它使用本机 Shell,右侧是只读文件浏览区,不会连接 SSH;切换视图不结束已有会话。参见本机终端的使用与会话限制。
凭据管理:在「密码库」查看和维护密码
- 打开「连接 → 凭据管理」,通过「搜索名称或地址」定位数据库密码、服务器密码或私钥口令、Hosts 管理员密码及手动记录。在其他模块刚保存过凭据时,可点「刷新密码」。
- 手动记录可点「新增密码」,填写名称和密码,可选填写网址或说明、用户名,再点「保存」。手动条目不会自动绑定到连接。
- 密码默认遮住。「显示密码」后可立即点「隐藏密码」,默认也会在 30 秒后隐藏;离开页面或切换条目也会隐藏。「复制」不必先显示。可按需开启复制后清空剪贴板;它不会清除剪贴板历史或已粘贴的副本。
应用凭据保存在当前用户的系统凭据库(macOS 钥匙串或 Windows 凭据管理器);手动条目保存在加密文件中,密钥由系统凭据库保护。不要假定导出结果、查询历史或终端输出享有相同保护。显示密码前先停止不必要的屏幕共享;应用没有额外的 Touch ID 或 Windows Hello 验证步骤。
删除应用凭据会保留连接条目,但重新认证时不能再使用已存值。 这不会修改远端密码;删除手动条目也不能在界面恢复。