頁面上的 SQLly:中繼代理模式

功能性的

透過你自己控管的中繼,在你的資料庫上執行瀏覽器版——憑證由中繼保管,網頁本身永遠看不到密碼。

這 瀏覽器版本 的 SQLly 通常在你的分頁裡對範例資料執行,因為網頁無法開啟資料庫通訊端。 中繼代理模式 為它提供真實的伺服器: sqlly-relay 你執行的時候會拿到一份 認證資訊檔案,以及用該中繼位址開啟的瀏覽器版——接著查詢檔案中的每個伺服器與資料庫,物件總管、IntelliSense、執行計畫和資料列編輯全都在,而密碼從不離開中繼主機。

適用對象。 想把零安裝的 SQLly 放進頁面、內部入口網站、支援主控台或教室,對準管理員控管的一組固定資料庫的團隊。它是 不 桌面應用程式的 透過中繼 路徑:那個是端對端加密的,因此中繼無法讀取你的流量。在這裡,中繼故意持有憑證,因此瀏覽器分頁永遠不需要持有。

整體如何搭配運作

browser (SQLly on a page)  --wss-->  sqlly-relay proxy  --local-->  SQLly engine  --TDS / PG / MySQL / ...-->  your databases
                                     holds the credential file        one per browser session
  • 中繼會提供一份憑證檔案。 其中的每個連線,包括伺服器、資料庫、登入和密碼、共用登入、SSH 通道和代理,以及用戶端、專案和環境標籤——都是瀏覽器可以存取的。沒有其他內容。
  • 每個工作階段一個引擎。 每個瀏覽器工作階段在中繼主機上都會獲得自己的 SQLly 引擎,以鎖定模式啟動,只開啟來自檔案的連線。任何自帶伺服器名稱或密碼的請求都會被拒絕。
  • 瀏覽器取得的是名稱,而非機密。 它收到的連線清單已移除密碼、通道設定和權杖,而且它絕不儲存這份清單——每次載入頁面時,中繼伺服器都會重新傳送一次。
  • 中繼的另一項工作不受影響。 這個代理是獨立且需另行啟用的監聽器。未啟用它的中繼,Via Relay 流量的轉發方式與以往完全相同。

設定中繼

在能連上資料庫、且具有 sqlly-cli ,旁邊也裝了 sqlly-relay,寫入一個憑證檔案(從桌面應用程式匯出,使用 檔案 → 匯出連線與憑證…,其他擴充值顯示為

sqlly-relay \
  --tls-cert /certs/relay.crt --tls-key /certs/relay.key \
  --proxy-credentials /etc/sqlly/browser-connections.json \
  --proxy-token 'a-long-random-secret' \
  --proxy-bind 0.0.0.0:8444 \
  --proxy-allowed-origins https://sqlly.app
旗標其作用
--proxy-credentials憑證檔案。設定它就會啟用代理。這個檔案會在每個新的瀏覽器工作階段重新讀取,因此修改後立即生效,不必重新啟動。
--proxy-token瀏覽器必須出示的共用密鑰。必要:沒有它,中繼就會拒絕啟動,除非你傳入 --proxy-insecure-no-token,它把列出的每一個資料庫都提供給連得上該連接埠的任何人。
--proxy-bind代理監聽的位置;預設為連接埠 8444。它使用中繼站的 TLS 憑證來 wss://; --proxy-plain 提供 ws:// 用於本機測試或在終止 TLS 的反向代理後面。
--proxy-allowed-origins允許開啟工作階段的網站來源,以逗號分隔,因此只有你代管的頁面才能使用這個代理。留空則允許任何來源(權杖仍然有效)。
--proxy-max-sessions同時最多可開啟幾個瀏覽器工作階段(每個是一個引擎處理程序);預設為 32。代理滿載時會請新的工作階段稍後再試。
--proxy-engine-binary位置 sqlly-cli 在哪裡;如果它不在 sqlly-relay 或在 PATH.

每個旗標都有環境變數形式(RELAY_PROXY_CREDENTIALS, RELAY_PROXY_TOKEN,等等)用於容器部署。當使用 --build-arg WITH_PROXY_ENGINE=1.

兩條規則與桌面版匯入不同:共用登入和通道設定檔必須定義在同一個檔案裡(中繼沒有已儲存的連線可以退回),而且 via-relay 路由會被忽略,因為中繼主機會自行連上每台伺服器。

開啟瀏覽器版並連上它

將 Proxy 位址與權杖加入瀏覽器建置版本的 URL:

https://sqlly.app/app/?proxy=wss://relay.example.com:8444/proxy&token=a-long-random-secret

嵌入此建置版本的頁面可以設定 SQLLY_PROXY_URL 和 SQLLY_PROXY_TOKEN 以全域變數的形式在應用程式啟動前就設定好,而不是放在網址列。載入時應用程式會連上中繼,狀態列會顯示中繼的名稱和它服務的連線數,這些連線會直接出現在物件總管裡可用。在此模式下完全不會下載範例資料庫。

自行託管頁面。 瀏覽器只允許網頁對安全性原則允許的來源開啟通訊端。sqlly.app 提供的建置允許自己的來源;位於其他主機上的代理需要放寬該原則,或改從中繼自己的網域提供建置。如果頁面載入了卻回報無法連上中繼代理,這是第一個要檢查的地方。

應用程式中有什麼變更

  • 連線為唯讀。 這份清單來自中繼服務。「新增伺服器」、「建立副本」、「刪除」和「匯入連線」皆已停用;連線管理員的新增、移除與建立副本按鈕,以及它的用戶端、專案和環境編輯器都被鎖定;開啟連線時,它會顯示為 檢視連線 且儲存功能被停用,並有一個提示說明中繼儲存了其憑證。要改變使用者看到的內容,請修改中繼上的憑證檔案。
  • 測試連線仍然可用 - 它會像任何查詢一樣經由代理伺服器執行,所有查詢功能、物件總管、IntelliSense 目錄同步、執行計畫、腳本產生與資料列編輯也都是如此。
  • 標籤一併帶入。 檔案中的客戶、專案與環境名稱、顏色及安全開關,會像桌面版一樣為總管提供分組;為保持頁面輕量,圖示予以省略。
  • 如果中繼消失 - 狀態列會註明這一點,而且在頁面重新載入前,透過代理的連線執行查詢都會失敗並顯示清楚的訊息。