// 免費工具

libSQL 連線字串產生器

為 TypeScript、Python、Go 和環境變數建立 Turso 或 libSQL 資料庫 URL 及其驗證權杖,或貼上現有的,查看主機、TLS 是否開啟,以及權杖何時到期。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。

在 SQLly 中開啟此連線

開啟 SQLly 的連線編輯器,並自動填入內容。

設計即私密。 建構器和解碼器都是在此分頁中執行的純 JavaScript。頁面不會發送你輸入的任何請求,也不會儲存任何資料(甚至不在你的瀏覽器中),載入後可離線使用。開啟 SQLly 的連結會從你的瀏覽器直接進入你電腦上的應用程式。

libSQL 連線字串格式

一個 Turso 資料庫是透過 libsql://<database>-<organization>.turso.io URL 加上驗證權杖(JWT)。 libsql:// 表示 TLS;自己機器上自架的 sqld 通常監聽的是未加密的 http://127.0.0.1:8080.

解碼器會直接在你的瀏覽器中讀取權杖的 payload,顯示它的到期時間以及是否唯讀。它不會驗證簽章,也不會把權杖傳送到任何地方。

資料庫 URL Turso CLI、每個 libSQL SDK

libsql://mydb-myorg.turso.io

含驗證權杖的 URL Go database/sql, @libsql/client, SQLly

libsql://mydb-myorg.turso.io?authToken=your_auth_token

本機 sqld 自建 libSQL 伺服器

http://127.0.0.1:8080

預留位置,例如 your_password 就只是這個意思:用上面的表單組出你自己的字串。更多關於把 SQLly 連上 libSQL 的說明: 適用於 libSQL 的 SQLly.

libSQL URL 協定與選項

來自 @libsql/client 的原始碼與 Turso 的 SDK 參考文件。

關鍵字同義詞預設其作用
libsql:// - - TLS;用戶端會選 HTTPS 或安全的 WebSockets。
https:// / wss:// - - 在特定傳輸上的 TLS。
http:// / ws:// - - 純文字,供本機 sqld 使用。
file: - - 本機 libSQL/SQLite 檔案(嵌入式)。
authToken - - 攜帶認證權杖的查詢參數;或在 authToken / auth_token 在用戶端選項中傳遞。
tls - 1 ?tls=0 會停用 TLS 於 libsql://;需要明確指定連接埠。
TURSO_DATABASE_URL / TURSO_AUTH_TOKEN - - Turso 快速入門使用的環境變數名稱。

常見的 libSQL 連線錯誤

401 Unauthorized

原因: 認證權杖缺失、過期、被撤銷,或屬於其他資料庫或組織。

修正此問題: 用以下命令建立新權杖: turso db tokens create <database> 並將其貼入解碼器以檢查其到期時間。

Connection refused on 127.0.0.1:8080

原因: 沒有本機 sqld 正在執行,或者它正在監聽另一個連接埠。

修正此問題: 啟動 sqld(例如 turso dev 用於本機開發伺服器)並使用它列印的 URL。

libSQL 連線字串常見問題

什麼是 Turso 資料庫 URL?

libsql://<database>-<organization>.turso.io,顯示它的是 turso db show <database>。再搭配一個驗證權杖,用 turso db tokens create <database>.

將認證權杖放在 URL 中安全嗎?

它可以運作(?authToken=),但 URL 就變成一個會留在記錄檔和 shell 歷史裡的機密。建議把權杖分開傳遞,例如放在 TURSO_AUTH_TOKEN 環境變數。

這個工具會檢查我的 Token 嗎?

它會在你的瀏覽器中解碼 token 的 payload,顯示到期日以及是否為唯讀。它不會驗證簽章,也絕不會把 token 傳到任何地方。

// 完全跳過字串

連線一次。然後只需撰寫 SQL。

SQLly 是適用於 macOS、Windows 和 Linux 的原生 SQL 工作台。把連線字串貼進連線編輯器,密碼存在系統鑰匙圈裡,就能在 libSQL 及更多引擎上獲得結構描述感知的 IntelliSense。