匯出與匯入連線
功能性的移動伺服器、資料庫和登入資訊——有密碼或無密碼——以及標籤顏色和圖示到另一台機器的單一檔案中,精準選擇要包含的項目。
A 連線檔案 在一個步驟內把整套工作設定搬到另一台機器或交給同事:伺服器、伺服器上的資料庫、要用的登入,以及(如果你選擇)它們的密碼,還有這些連線所屬的客戶、專案與環境標籤,包括每個標籤的 顏色 和 圖示。兩種匯出寫出的是同一種檔案;唯一差別在於裡面含不含密碼。可以從 SQLly 匯出,也可以手寫一份來佈建團隊,然後在任何一份 SQLly 裡匯入。
匯出連線
選擇 檔案 → 匯出連線… ,可匯出不含密碼的檔案,或 檔案 → 匯出連線與憑證… 以獲取包含密碼的文件(這兩個命令在命令面板中也可以找到)。任一選項都會開啟一個選擇器,顯示每個已儲存的連線樹狀結構:每個 伺服器 (主機、連接埠和引擎),再搭配 資料庫 以及你儲存在其下的密碼。Export Conn w/ Creds 開啟時,頂端會顯示警告:檔案內將包含明文密碼。
- 選擇部分或全部伺服器 - 勾選伺服器即可選取其下所有資料庫,再勾選一次則取消。
- 選擇部分或全部資料庫 - 展開伺服器並個別勾選資料庫;伺服器那一列會顯示已選取幾個資料庫。
- 全選 / 清除 一次切換所有項目。一開始全部都是選取狀態。
- 只有你挑選的內容會跟著走 - 只會包含所選連線用到的共用登入、通道設定檔,以及客戶、專案和環境標籤,其他一概不含。
點擊 匯出 並選擇儲存位置。無論哪種方式,連線編輯器提供的每個設定都會一併帶上,包括每個連線的登入方法。若包含認證資訊,SQLly 會從你的鑰匙圈讀出每個密碼、通關密語和權杖寫入檔案;不包含的話,所有機密都不會寫入,且 SQLly 會在存檔前檢查檔案裡確實沒有任何機密。被多個匯出連線共用的登入會寫成一份共用登入;只被一個連線使用的登入則寫在該連線上。標籤圖示會內嵌在檔案裡,所以檔案本身自成一體。


匯入連線
選擇 檔案 → 匯入連線… 然後選擇檔案。同一個命令可讀取含密碼或不含密碼的檔案,也能讀取舊版 SQLly「匯出連線」儲存的檔案。它會在動任何內容之前先檢查整個檔案;只要有任何一項有錯,就列出所有問題且完全不匯入,所以不可能只匯入一半。設定名稱打錯會被回報,而不是默默略過。匯入的連線會立刻出現在伺服器總管中。
- 密碼會存入你的鑰匙圈 - macOS 上的鑰匙圈,Windows 上的憑證管理員,Linux 上的 Secret Service —— 永遠不會進入 SQLly 的已儲存連線檔案。狀態列會顯示有多少被匯入。
- 標籤依名稱合併 - 現有的客戶、專案或環境會保留檔案未設定的任何內容,只有檔案列出的安全設定會被更改。
- 共用登入會即時更新 - 具有相同名稱和使用者名稱的已儲存登入會獲得新密碼,因此每個已使用它的連線仍然可正常運作。
- 無密碼也沒問題 - 沒有密碼的登入(在未含憑證的檔案中匯出的每個登入)照樣會匯入,SQLly 會在你第一次連線時要求輸入密碼。
從 Redis Insight 匯入
在 Redis Insight 中,選取你的資料庫,然後選擇 匯出 (勾選 包含密碼 如果你想把它們一併帶過去)。在 SQLly 中選擇 從其他工具匯入… 並選擇匯出的檔案(純 JSON,或 Redis Insight 也接受的 base64 格式)。每個資料庫都會變成一個 Redis 連線,帶有其主機、連接埠、邏輯資料庫、ACL 使用者名稱,以及 SSH 通道與 TLS 設定。
- TLS 永遠不會被拿掉 - 匯出時帶有 TLS(或 CA 或客戶端憑證)的資料庫會以加密方式匯入: 驗證 CA 當 Redis Insight 驗證了伺服器憑證, 需要 當它實際上沒有時。憑證與金鑰內容會以 PEM 檔案儲存在 SQLly 的資料資料夾中(金鑰僅你能讀取),連線會指向這些檔案。
- 機密會存到你的鑰匙圈 - 匯出檔裡的密碼、SSH 密碼和金鑰通關密語,儲存方式與連線檔完全相同,絕不會寫進已儲存的連線檔。匯出後請把檔案刪掉:裡面的內容是明文。
- Azure Entra 資料庫 使用 Microsoft Entra 登入匯入;在連線編輯器中選擇 Azure 帳戶。
- 叢集資料庫 匯入為 Redis Cluster 連線,並以其中指名的節點作為種子(或當 Redis Insight 被設定強制單機時,匯入為單一節點); 哨兵 資料庫會匯入成 Sentinel 連線,帶著主節點群組、Sentinel 的密碼(移到鑰匙圈)與主節點本身的登入資訊;狀態列會列出所有無法轉移的項目。
連線檔案可以包含的內容
| 區段 | 它所承載的內容 |
|---|---|
| 連線 | 任意數量的伺服器,且每台伺服器上可有任意數量的資料庫:引擎、主機、連接埠、資料庫、環境、客戶與專案、登入方式與(有認證資訊時的)密碼、TLS 模式與憑證檔案、連線與陳述式逾時、應用程式名稱、啟動 SQL、每個連線的安全開關、我的最愛星號、遮罩規則、中繼路由,以及內嵌的 SSH 通道、Proxy 或 Kubernetes 連接埠轉送。 |
| 共用登入 | 多個具名登入(使用者名稱,密碼存放在憑證檔中),可供多條連線使用。 |
| 通道設定檔 | 具名 SSH(含跳板主機)、Proxy 與 Kubernetes 連線鏈,以及存放在憑證檔中的 SSH 密碼與金鑰密碼。 |
| 客戶、專案、環境 | 名稱、顏色、圖示圖片(內嵌於檔案中),以及任意的查詢保護設定。 |
SQLly 支援的每一種登入方式都能描述:使用者名稱與密碼、Windows 整合安全性、Microsoft Entra(瀏覽器或裝置碼)、AWS RDS IAM、Google Cloud SQL IAM,以及 libSQL / Turso 權杖。SQLite 和 DuckDB 檔案不需登入。
手動撰寫一個
連線檔案就是純 JSON,管理員可以寫一份,交給團隊一個現成的設定。只有連線的 name, engine,而且
server ——其他所有項目都會退回連線編輯器給的相同預設值。這個檔案在同一台伺服器上加了兩個共用唯讀登入的資料庫、一台有自己密碼的第二台伺服器,以及一個有圖示、設了顏色的用戶端:
{
"format": "sqlly-credentials",
"version": 1,
"clients": [
{ "name": "Acme", "color": "#1E88E5", "image": "data:image/png;base64,iVBORw0KGgo…" }
],
"sql_auth_accounts": [
{ "name": "Reader", "username": "ro", "password": "ro-secret" }
],
"connections": [
{ "name": "Sales", "engine": "postgresql", "server": "pg1.acme.internal", "database": "sales",
"client": "Acme", "environment": "production",
"authentication": { "type": "sql-login", "account": "Reader" },
"tls": { "mode": "verify-full" } },
{ "name": "HR", "engine": "postgresql", "server": "pg1.acme.internal", "database": "hr",
"client": "Acme", "authentication": { "type": "sql-login", "account": "Reader" } },
{ "name": "Ops", "engine": "sql-server", "server": "sql01.acme.internal", "database": "ops",
"authentication": { "type": "sql-login", "username": "ops", "password": "ops-secret" } }
]
}
- 引擎 可以隨意編寫——
postgres,PostgreSQL,mssql,sql-server,mysql,sqlite,duckdb,clickhouse,redis,依此類推。 - 顏色 是
#RGB,#RRGGBB,或#RRGGBBAA. - 圖示 是 base64 —— 一個
data:image/…;base64,URI 或純 base64——PNG、JPEG、GIF、WebP、BMP、ICO 或 SVG 圖片,最大 1 MB。 - 環境 是
local,dev,test,staging,或production.
預先設定的連線(Docker、Kubernetes、受管理的機器)
與其只匯入檔案一次,不如讓 SQLly 佈建 啟動時都會讀取連線——在桌面應用程式裡、在 sqlly-cli 代理指令,以及自行託管的 sqlly-bridge embedded 伺服器。點
SQLLY_PROVISIONED_CONNECTIONS_FILE 指向某個檔案(或把
provisioned-connections.json 位於 SQLly 的設定資料夾中,旁邊就是
connections.json),和/或設定一個 SQLLY_CONNECTION_<NAME>
每個連線各有一個變數來存放其 URL。檔案採用上述的連線檔案格式(format 和 version 可以省略,而只有
connections 讀取之後),而且任何連線都能給出 url 而不是引擎、伺服器、連接埠、資料庫與登入欄位:
{
"connections": [
{ "name": "Cache",
"url": "redis+sentinel://app:${REDIS_PASSWORD}@sentinel-0:26379,sentinel-1:26379/mymaster/0?sentinelPassword=${SENTINEL_PASSWORD}",
"environment": "production" },
{ "name": "Orders", "engine": "postgres", "server": "${PGHOST}", "database": "orders",
"authentication": { "type": "sql-login", "username": "app", "password": "${PGPASSWORD}" },
"tls": { "mode": "verify-full" } }
]
}
# docker run / Kubernetes env
SQLLY_PROVISIONED_CONNECTIONS_FILE=/etc/sqlly/connections.json
REDIS_PASSWORD=... # from a Secret
SENTINEL_PASSWORD=...
SQLLY_CONNECTION_SESSIONS=rediss+sentinel://:${REDIS_PASSWORD}@sentinel-0,sentinel-1/sessions
- Sentinel 網址 -
redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>],並且rediss+sentinel://用於 TLS 和valkey+sentinel:///valkeys+sentinel://對 Valkey 也有效嗎??sentinelPassword=設定哨兵自己的密碼並?preferReplica=true會將唯讀腳本傳送給副本。未指定連接埠的哨兵使用 26379。這些 URL 也可以用在連線編輯器的「貼上 URL」。 ${VARIABLE}在檔案中的任何位置(或在一個SQLLY_CONNECTION_URL)會換成該環境變數;寫成$${,來表示字面上的${.- 密碼不寫進檔案 - 密碼、權杖,
redis_sentinel_password、URL 密碼,或sentinelPassword若完全寫成${VARIABLE}每次 SQLly 連線時都會從環境中讀取,並且永遠不會複製到設定檔或儲存到任何地方。 - 受管理、唯讀 - 佈建的連線會與你自己的連線並列顯示,但永遠不會寫入
connections.json,而且不能對它們儲存或刪除:請直接改檔案或變數,或使用 複製 來建立你可編輯的副本。 - 一個錯誤的項目不會拖垮其餘項目 - 未知的設定、未設定的變數或無法讀取的 URL 只會略過該連線,並輸出警告說明是哪一個以及原因;之後名稱重複的連線也會以同樣方式略過。
- 在橋接上 -
sqlly-bridge embedded以唯讀設定檔提供它們provisioned(也可以透過--provisioned-connections <file>);啟動權杖可以像其他設定檔一樣指名使用它,而且它絕不會寫入狀態目錄。