// 免费工具

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.

解码器就在你的浏览器里读取令牌的载荷,显示其过期时间以及是否只读。它不会验证签名,也不会把令牌发送到任何地方。

数据库 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 的信息: SQLly 适用于 libSQL.

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 环境变量。

这个工具会检查我的令牌吗?

它会在你的浏览器中解码令牌的载荷,以显示到期日期以及是否只读。它不会校验签名,也绝不会把令牌发送到任何地方。

// 完全跳过这些字符串

连接一次。之后只管写 SQL。

SQLly 是适用于 macOS、Windows 和 Linux 的原生 SQL 工作台。在连接编辑器中粘贴连接字符串,把密码保存在系统钥匙串里,并在 libSQL 等引擎上获得模式感知的 IntelliSense。