在终端中打开
功能的直接进入 psql、mysql、sqlcmd、redis-cli 等工具,连接信息已经填写好。
右键单击 服务器 在对象资源管理器中选择 在终端中打开,或者运行 在终端中打开连接 从命令面板使用当前连接。SQLly 会打开一个新的终端窗口,运行引擎自带的命令行客户端并已连上:主机、端口、数据库、用户和 TLS 模式都取自连接配置文件。
| 引擎 | 客户 | 密码的传递方式 |
|---|---|---|
| PostgreSQL 及其兼容数据库 | psql | PGPASSWORD 环境变量。TLS 模式放在 PGSSLMODE,配置文件的 CA 文件、客户端证书和密钥放在 PGSSLROOTCERT, PGSSLCERT,以及 PGSSLKEY。没有 CA 文件的验证型配置会使用 PGSSLROOTCERT=system,系统信任存储(psql 16 或更高版本)。 |
| MySQL / MariaDB | mysql | MYSQL_PWD 环境变量。CA 文件和客户端证书放在 --ssl-ca, --ssl-cert,以及 --ssl-key中。MySQL 客户端只能依据 CA 文件来验证证书,因此没有提供 CA 文件的验证配置会改用系统 CA 捆绑包;如果没有系统捆绑包(Windows 上就没有),会话虽已加密但未经验证,SQLly 会如实说明。 |
| SQL Server | sqlcmd | SQLCMDPASSWORD 环境变量。集成身份验证使用 -E。SQLly 会读取已安装的 sqlcmd 的 -? 横幅来区分 go-sqlcmd 和微软的 ODBC sqlcmd,并按该版本接受的方式书写加密选项: -Nm (必需,加上 -C 来切换 -No (可选,用于未加密的配置文件,因为 sqlcmd 18 否则会坚持要求加密)适用于 go-sqlcmd 1.4 或更新版本以及 ODBC sqlcmd 18 或更新版本; -Ntrue / -Nfalse 适用于旧版 go-sqlcmd;以及一个空 -N 用于 ODBC sqlcmd 17 或更早版本,默认未加密。 |
| Redis | redis-cli | REDISCLI_AUTH 环境变量。Unix 套接字配置文件使用 -s。CA 文件和客户端证书放在 --cacert, --cert,以及 --key. |
| ClickHouse | clickhouse-client | CLICKHOUSE_PASSWORD 环境变量。 clickhouse-client ,它说的是 ClickHouse 的原生协议,而不是 SQLly 用的 HTTP 协议,因此它使用连接的 原生端口 (连接编辑器中的 ClickHouse 专用字段) 在设置了该字段时使用。否则连接配置里的 HTTP 端口会映射到原生端口:8123 映射到 9000,8443 映射到 9440;其他端口 SQLly 一律按 9000(TLS 时为 9440)处理,并在启动后说明。自定义 CA 或客户端证书必须在 clickhouse-client 自己的配置文件里设置。 |
| DuckDB / SQLite | duckdb / sqlite3 | 无需密码。数据库文件会被直接打开。 |
| Oracle | sqlplus,或者如果未安装 SQL*Plus,则使用 SQLcl | 两个客户端都不会从环境中读取密码,因此会在终端提示输入密码。 |

密码绝不出现在命令行上
命令行上的任何内容都可能被其他用户通过 ps,因此 SQLly 构建的参数绝不会包含机密。密码只在客户端进程的环境中传递。在 Linux 和 Windows 上,终端会直接继承该环境,所以密码永远不会写入磁盘。macOS 上的 Terminal.app 不继承环境,所以 SQLly 会改为写一个简短的启动脚本。该脚本只有你能读,存放在只有你能打开的文件夹里。它的第一行会自我删除,然后启动客户端。如果终端始终没有运行它,SQLly 会在五分钟后将其删除。
主机、用户和数据库名称无论包含什么字符,都不会被当作 shell 命令来解读:Linux 把它们作为独立参数传给客户端,macOS 为 shell 加上引号,Windows 则把它们写入一个小的启动器脚本,并转义所有命令提示符特殊字符。Windows 脚本中不含密码。
Cloud IAM 登录(AWS RDS 和 Google Cloud SQL)会在 SQLly 连接时生成令牌,而令牌不会交给终端,因此客户端会要求输入密码;请在那里粘贴一个新令牌。
SSH 隧道和中继
SSH 隧道连接经由隧道的本地端口接入。由于客户端之后连的是 127.0.0.1,按服务器名称校验证书就需要额外处理:psql 通过 PGHOSTADDR 同时仍在验证真实主机名,并且 redis-cli 将真实名称作为 SNI 发送。sqlcmd 获取 -F 当安装的版本具有该开关(go-sqlcmd 1.9 或更新版本,ODBC sqlcmd 18 或更新版本)时,应使用真实主机名(证书中期望的主机名)。MySQL 客户端只检查证书链(MariaDB 的客户端在加密连接时不检查证书),而较旧的 sqlcmd 可能会拒绝该证书;SQLly 会在启动后提示这些情况。对于 ClickHouse,其隧道承载 SQLly 使用的 HTTP 端口,“在终端中打开”会通过相同的 SSH 跳点(或代理)打开第二个转发到原生端口(连接的原生端口,或 9000 / 9440),并指向 clickhouse-client。该转发会保持打开,直到你断开连接或退出 SQLly;断开连接会关闭它并结束终端会话。通过隧道,clickhouse-client 会将经过验证的证书与 127.0.0.1 进行检查,因此 SQLly 会提示它可能会被拒绝。Kubernetes 端口转发仅携带连接自身的端口,因此在 Kubernetes 上的 ClickHouse 无法打开终端。通过中继桥接的连接根本无法打开终端:客户端必须直接从这台机器访问数据库。

打开哪个终端
- macOS: Terminal.app,通过 Launch Services 打开。不会弹出自动化权限提示。
- Linux:
$TERMINAL如果你设置了它,那么x-terminal-emulator,GNOME Terminal、Konsole、Xfce Terminal、kitty、Alacritty、WezTerm,以及xterm。SQLly 会使用其中第一个能启动的。而$TERMINAL指名使用其中一个,就会按那个终端自己的方式运行命令。客户端退出后窗口保持打开,方便你查看任何错误;按回车关闭。 - Windows:一个新的控制台窗口,在客户端退出后保持打开;按任意键关闭它。
SQLly 以与查找转储工具相同的方式查找客户端。在“偏好设置”中设置的路径覆盖在这里也适用。如果客户端未安装,菜单项将被禁用并显示需要安装的内容。对于终端客户端无法接管的连接,它也会被禁用并显示原因:内存中的 DuckDB 和 SQLite、通过 HTTP 的 libSQL/Turso、SQL Server 上的 Entra 登录以及中继连接。DuckDB 仅允许一个程序同时使用文件,因此当 SQLly 打开 DuckDB 文件时,“在终端中打开”会要求你先断开连接。密码仍保存在密钥环中的配置文件会先解析出密码。如果没有密码,客户端会提示输入密码。浏览器版本无法打开终端。