Ubuntu 22.04 安装 Turso 1.0.34 指南
Ubuntu 22.04 从零安装 Turso CLI v1.0.34:官方 get.tur.so 脚本与 GitHub Release 手动安装双方案实测、sha256 校验、PATH 与补全配置、turso dev/sqld 离线本地开发、升级与多版本并存、卸载清理与排障 FAQ
Ubuntu 22.04 安装 Turso 1.0.34 指南
目标:在 Ubuntu 22.04 服务器上从零安装 Turso CLI v1.0.34(含随装的 libSQL 服务器组件 sqld),覆盖官方脚本安装、GitHub Release 手动安装两种方案,以及 PATH 机制、离线本地开发(turso dev / sqld 独立运行)、升级与多版本并存、卸载清理与常见问题排障。全文命令与回显均在 Ubuntu 22.04 x86_64 实测环境逐条验证通过。
一、环境信息
本章记录实测环境与版本基准,读者可据此判断自己环境与本文的差异。
- 操作系统:Ubuntu 22.04(x86_64,GNU/Linux 5.15 内核系列)
- 安装对象与版本:Turso CLI v1.0.34(2026-10-07 发布,GitHub Releases 查询日期 2026-10-18 的最新稳定版)
- 随装组件:libSQL 服务器 sqld 0.24.32 (40c272de 2025-02-14)(官方安装脚本自动从 libSQL Releases 拉取最新版)
- 安装位置:
- 官方脚本方案:
~/.turso/(含turso与sqld两个二进制),PATH 追加到~/.bashrc - 手动方案:自选目录(本文演示
/usr/local/bin/turso与/opt/turso-versions/<版本>/)
- 官方脚本方案:
- 配置与缓存位置:
~/.config/turso/(settings.json 与 shell 历史缓存) - 前置软件:
curl、tar(Ubuntu 22.04 最小安装自带 tar;curl 需apt install curl) - 网络说明:安装脚本从 GitHub(
github.com/tursodatabase/homebrew-tap、github.com/tursodatabase/libsql)下载二进制;本环境访问国外资源经代理http://192.168.1.62:7897,读者无此需求可直连。
二、前置条件
安装前逐项确认,避免中途失败:
# 确认系统与架构(安装脚本支持 x86_64 与 aarch64)
uname -m
实测回显:
x86_64
# 确认 curl 可用(官方脚本依赖 curl 下载)
curl --version | head -1
实测回显:
curl 7.81.0 (x86_64-pc-linux-gnu) libcurl/7.81.0 OpenSSL/3.0.2 zlib/1.0.1 brotli/1.0.18 zstd/1.4.8 libidn2/2.3.2 libpsl/0.21.0 (+libidn2/2.3.2) libssh/0.9.6/openssl/zlib nghttp2/1.43.0 librtmp/2.4.3 OpenLDAP/2.5.19 (SASL/CYRUS)
# 若 curl 缺失则先安装
apt-get update -qq && apt-get install -y -qq curl xz-utils sqlite3
实测回显(节选):
Running hooks in /etc/ca-certificates/update.d...
done.
⚠️ 说明:
xz-utils仅手动校验/解压部分 libSQL 包时需要;sqlite3命令行客户端非 Turso 依赖,本文仅用它在验证环节直接读取数据库文件做对照,可不安装。
三、版本选型说明
安装前先明确「装哪个版本」。Turso CLI 的版本发布与获取渠道如下(2026-10-18 查询):
| 渠道 | 版本/形式 | 说明 |
|---|---|---|
| GitHub Releases(tursodatabase/turso-cli) | v1.0.34(2026-10-07) | 最新稳定版;近五版 v1.0.30(07-15)→ v1.0.31(07-27)→ v1.0.32(08-17)→ v1.0.33(09-29)→ v1.0.34(10-07),约每 2~6 周一版 |
| 官方安装脚本 get.tur.so | 始终装最新版 | 不支持指定版本;同时自动安装最新 sqld |
| homebrew-tap Releases | 与 Release 同步的打包件 | 脚本实际下载源:homebrew-tap_Linux_x86_64.tar.gz |
turso update 自升级 | 升级到最新版 | 已装后的一键升级命令 |
关键差异与选型建议:常规服务器直接用官方脚本(方案 A)装最新版;需要固定版本、离线安装或做版本回退时用 GitHub Release 手动安装(方案 B)。两条方案安装的是同一个 turso 二进制,可并存切换(见第八章多版本管理)。
如何查最新版本(发布清单接口):
curl -s https://api.github.com/repos/tursodatabase/turso-cli/releases/latest | grep -m1 '"tag_name"'
实测回显:
"tag_name": "v1.0.34",
四、在线安装方案 A:官方安装脚本
4.1 方案说明
官方文档(docs.turso.tech/cli)给出的 Linux 标准安装方式是一行脚本:curl -sSfL https://get.tur.so/install.sh | bash。脚本依次完成三件事:从 libSQL Releases 下载最新 sqld 服务端到 ~/.turso/、从 homebrew-tap Releases 下载最新 turso CLI 到 ~/.turso/、向 shell profile(实测写入 ~/.bashrc)追加 PATH。
4.2 安装步骤
curl -sSfL https://get.tur.so/install.sh | bash
实测回显(ASCII Logo 部分节略,实测首尾节选):
Welcome to the Turso installer!
.:
.$$. $$: .$$$: $$$^ $$: ~$^
...(Turso ASCII Logo 约 40 行,此处节略)...
.. : :. :
######################################################################## 100.0%
Installing libsql-server to /root/.turso
Downloading Linux_x86_64 ...
######################################################################## 100.0%
Installing to /root/.turso
Updating profile /root/.bashrc
Turso will be available when you open a new terminal.
If you want to make Turso available in this terminal, please run:
source /root/.bashrc
Turso CLI installed!
If you are a new user, you can sign up with turso auth signup.
If you already have an account, please login with turso auth login.
安装完成后查看安装产物:
ls -la /root/.turso/
实测回显:
total 80916
drwxr-xr-x 2 root root 4096 Oct 18 12:55 .
drwx------ 1 root root 4096 Oct 18 12:54 ..
-rwxr-xr-x 1 1001 127 45368728 Feb 14 2025 sqld
-rwxr-xr-x 1 1001 1001 37470500 Oct 7 22:39 turso
profile 追加内容(grep -n turso /root/.bashrc 实测):
102:# Turso
103:export PATH="$PATH:/root/.turso"
⚠️ 排障实录:本环境第一次执行该脚本时,sqld 下载成功但 turso CLI 下载阶段报
curl: (7) Failed to connect to github.com port 443 after 21054 ms: Connection refused——脚本因set -e中止,~/.bashrc未被修改。解决:让脚本走代理重跑(脚本内的 curl 会读取http_proxy/https_proxy环境变量):export http_proxy=http://192.168.1.62:7897 https_proxy=http://192.168.1.62:7897 curl -sSfL https://get.tur.so/install.sh | bash重跑后全部成功。该脚本是幂等的覆盖安装,重复执行安全(详见第八章升级)。
4.3 安装结果验证
新开一个交互 shell(或先 source /root/.bashrc),验证版本与帮助:
source /root/.bashrc
turso --version
实测回显:
turso version v1.0.34
turso --help
实测回显:
Turso CLI
Usage:
turso [command]
Available Commands:
auth Authenticate with Turso
config Manage your CLI configuration
db Manage databases
dev starts a local development server for Turso
group Manage your database groups
help Help about any command
org Manage your organizations
plan Manage your organization plan
quickstart New to Turso? Start here!
relax Sometimes you feel like you're working too hard... relax!
update Update the CLI to the latest version
Flags:
-c, --config-path string Path to the directory with config file
-h, --help help for turso
-v, --version version for turso
Use "turso [command] --help" for more information about a command.
同时确认随装的 sqld 可执行:
/root/.turso/sqld --version
实测回显:
sqld sqld 0.24.32 (40c272de 2025-02-14)
⚠️ 注意:查版本必须用
turso --version或turso -v。不带横杠的turso version不是合法子命令,实测报错如下(新版本变更,网上旧教程常写错):Error: unknown command "version" for "turso" Run 'turso --help' for usage.
五、备用安装方案 B:GitHub Release 手动下载
5.1 方案说明
适用场景:脚本下载不稳需要离线重试、需要锁定/回退特定版本、或不希望脚本自动改写 profile。 turso-cli 每个版本发布 4 个平台包与 1 个校验文件,Linux x86_64 对应 turso-cli_Linux_x86_64.tar.gz 与 checksums.txt。
5.2 下载与校验
mkdir -p /opt/turso-manual && cd /opt/turso-manual
export http_proxy=http://192.168.1.62:7897 https_proxy=http://192.168.1.62:7897
curl -sSfL -O https://github.com/tursodatabase/turso-cli/releases/download/v1.0.34/turso-cli_Linux_x86_64.tar.gz \
-O https://github.com/tursodatabase/turso-cli/releases/download/v1.0.34/checksums.txt
sha256sum -c checksums.txt
实测回显:
turso-cli_Darwin_arm64.tar.gz: FAILED open or read
turso-cli_Darwin_x86_64.tar.gz: FAILED open or read
turso-cli_Linux_arm64.tar.gz: FAILED open or read
turso-cli_Linux_x86_64.tar.gz: OK
sha256sum: WARNING: 4 computed checksums did NOT match
解读:checksums.txt 包含全部 4 个平台的包,本机只下载了 Linux x86_64 包,其余三行 FAILED open or read 属预期;关键看目标包一行 turso-cli_Linux_x86_64.tar.gz: OK,说明文件完整无损。
5.3 解压与安装
cd /opt/turso-manual
tar -xzf turso-cli_Linux_x86_64.tar.gz
ls -la
实测回显:
total 49864
drwxr-xr-x 3 root root 4096 Oct 18 13:07 .
drwxr-xr-x 1 root root 4096 Oct 18 13:07 ..
-rw-r--r-- 1 root root 384 Oct 18 13:07 checksums.txt
drwxr-xr-x 2 root root 4096 Oct 18 13:07 completions
-rwxr-xr-x 1 1001 1001 37470500 Oct 7 22:40 turso
-rw-r--r-- 1 root root 13567907 Oct 18 13:07 turso-cli_Linux_x86_64.tar.gz
包内除 turso 主程序外还有 completions/ 目录(bash/zsh/fish 补全脚本,见 5.4)。安装到系统路径并验证:
install -m 0755 turso /usr/local/bin/turso
/usr/local/bin/turso --version
实测回显:
turso version v1.0.34
⚠️ 说明:方案 B 只装 CLI 本体,不含 sqld。若需要离线本地开发服务器(
turso dev/ 独立 sqld),需按 7.3 节从 libSQL Releases 手动补装libsql-server-x86_64-unknown-linux-gnu.tar.xz并解出sqld放入 PATH。
5.4 配置命令补全(可选)
Release 包内附三份补全脚本,安装 bash 补全并验证:
mkdir -p /etc/bash_completion.d
install -m 0644 /opt/turso-manual/completions/turso.bash /etc/bash_completion.d/turso
bash -c 'source /etc/bash_completion.d/turso && complete -p turso'
实测回显:
complete -o default -F __start_turso turso
回显出现 complete -o default -F __start_turso turso 即补全注册成功,新交互 shell 中输入 turso 后按两下 Tab 可补全子命令。
六、方案对比与选择建议
| 维度 | 方案 A:官方脚本 | 方案 B:GitHub Release 手动 |
|---|---|---|
| 版本 | 固定最新版(不可选) | 任意历史版本可选(改下载 URL) |
| 联网要求 | 在线(脚本内两次 curl) | 在线下载一次,之后可离线复制部署 |
| 安装物 | turso + sqld 两个二进制 | 仅 turso(sqld 需另取) |
| PATH | 脚本自动写 ~/.bashrc | 自行 install 到 /usr/local/bin 或配 PATH |
| 补全 | 不含(需另取 Release 包) | 包内自带 completions/ |
| 卸载 | 删 ~/.turso + 清理 profile 行 | 删对应安装目录即可 |
| 适用 | 常规在线服务器 | 固定版本/离线包分发/审计要求 |
选择建议:可联网的常规服务器选方案 A 一步到位;内网隔离、版本固化、需要审计校验和的场景选方案 B;两者可共存(PATH 靠前的生效,见 7.1)。
七、安装后基础配置
7.1 PATH 与 profile 机制
官方脚本把 export PATH="$PATH:/root/.turso" 追加到 ~/.bashrc(实测见 4.2),效果是:交互式 shell 中直接可用 turso(实测 bash -ic 'which turso' 回显 /root/.turso/turso)。但要注意 Ubuntu 默认 ~/.bashrc 开头有非交互早退守卫(case $- in *i*) ;; *) return;; esac),因此cron、systemd 服务、bash script.sh 等非交互场景不会加载这行 PATH,需显式写全路径(如 /root/.turso/turso)或自行在 /etc/environment、服务单元里补 PATH。
验证两类场景的差异(实测):
# 交互 shell:生效
bash -ic 'which turso && turso --version'
实测回显:
/root/.turso/turso
turso version v1.0.34
# 非交互 shell:不读 .bashrc 的追加行,需用全路径
bash -c 'turso --version' 2>&1; /root/.turso/turso --version
实测回显:
bash: line 1: turso: command not found
turso version v1.0.34
7.2 配置文件与缓存目录
CLI 的配置与缓存位于 ~/.config/turso/。首次运行(含未登录状态下执行命令)后实测目录结构:
cat /root/.config/turso/settings.json
ls -la /root/.config/turso/.turso/
实测回显:
{
"config-path": ""
}
total 8
drwxr-xr-x 2 root root 4096 Oct 18 12:59 .
drwxr-xr-x 3 root root 4096 Oct 18 12:56 ..
-rw-r--r-- 1 root root 0 Oct 18 12:57 .127.0.0.1:8080_shell_history
-rw-r--r-- 1 root root 0 Oct 18 12:59 .127.0.0.1:9999_shell_history
-rw-r--r-- 1 root root 0 Oct 18 12:56 .localdemo_shell_history
逐项说明:settings.json 当前仅一个键 config-path(自定义配置目录时由 -c/--config-path 写入,默认空串表示用默认位置);.turso/ 子目录按「目标 URL」缓存每条 turso db shell 会话的历史(文件名形如 .<地址>_shell_history),清空这些文件即清空 shell 历史。登录 Turso Cloud 后,凭据同样保存在该配置目录中——备份机器时连同目录一起迁移即可。
CLI 级常用配置命令(均为顶层 config 子命令):
turso config path # 查询配置文件路径
turso config set autoupdate on|off # 开关 CLI 自动更新
turso config set token <jwt> # 以令牌方式配置凭据(自动化/CI 场景)
turso config cache clear # 清理本地缓存
⚠️ 实测提示:未登录状态下,
turso config path、turso config cache clear等多数 config 操作同样被登录门槛拦截,报You are not logged in, please login with turso auth login before running other commands.;turso config set的两个子命令查看帮助(--help)不受影响。
7.3 离线与本地 libSQL 用法(无需云账号)
安装产物自带 sqld(libSQL 服务器),无需注册 Turso Cloud 即可完成本地开发闭环。官方提供两种用法:
用法一:turso dev 一键本地开发服务器(推荐)
cd /root
turso dev --db-file demo.db
实测启动回显:
sqld listening on port 8080.
Use the following URL to configure your libSQL client SDK for local development:
http://127.0.0.1:8080
By default, no auth token is required when sqld is running locally. If you want to require authentication, use --auth-jwt-key-file to specify a file containing the JWT key.
Using database file demo.db.
另开一个终端连接并写数据:
turso db shell http://127.0.0.1:8080 "SELECT 1+1 AS result;"
实测回显:
RESULT
2
printf "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, username TEXT, created_at TEXT);\nINSERT INTO users (username, created_at) VALUES ('alice', '2026-10-18'), ('bob', '2026-10-18'), ('carol', '2026-10-18');\nSELECT * FROM users;\n" | turso db shell http://127.0.0.1:8080
实测回显:
⣾ Connecting to database
ID USERNAME CREATED AT
1 alice 2026-10-18
2 bob 2026-10-18
3 carol 2026-10-18
dev 常用参数(turso dev --help 实测):-p/--port(默认 8080)、-f/--db-file(持久化文件)、-a/--auth-jwt-key-file(启用 JWT 鉴权)、-v(显示 sqld 版本,实测回显 sqld sqld 0.24.32 (40c272de 2025-02-14))。不指定 --db-file 时使用临时内存库,帮助原文与实测回显明确提示数据不落盘:
This server is using an ephemeral database. Changes will be lost when this server stops.
--db-file 的持久化效果已实测验证:写入 3 行数据并完全重启机器后,再次以同一文件启动 turso dev --db-file demo.db,数据完整可查:
turso db shell http://127.0.0.1:8080 "SELECT * FROM users;"
实测回显:
ID USERNAME CREATED AT
1 alice 2026-10-18
2 bob 2026-10-18
3 carol 2026-10-18
数据文件本体是标准 SQLite 格式(WAL 模式),可用 sqlite3 直接读取对照:
sqlite3 /root/demo.db "SELECT count(*) FROM users;"
实测回显:
3
用法二:独立运行 sqld(不经 turso 包装)
~/.turso/sqld 是自包含的 libSQL 服务器,可直接运行(示例监听 8085,数据目录 /opt/data/demo-sqld):
nohup /root/.turso/sqld --no-welcome --http-listen-addr 127.0.0.1:8085 --db-path /opt/data/demo-sqld > /tmp/sqld-direct.log 2>&1 &
实测启动日志(节选):
2026-10-18T13:26:20.609548Z INFO sqld: listening for incoming user HTTP connection on 127.0.0.1:8085
2026-10-18T13:26:20.613312Z INFO restore: libsql_server::namespace::meta_store: restoring meta store
2026-10-18T13:26:20.614224Z INFO libsql_server: Server sending heartbeat to URL <not supplied> every 30s
连接与查询(CLI 对本地 sqld 与云端数据库使用同一 shell):
turso db shell http://127.0.0.1:8085 "SELECT 40+2 AS answer;"
实测回显:
ANSWER
42
sqld 常用启动参数(sqld --help 实测):-d/--db-path(数据目录,默认 data.sqld)、--http-listen-addr(HTTP 监听地址,默认 127.0.0.1:8080)、-e/--extensions-path(受信任扩展目录)、--enable-http-console(在 /console 路由启用 Web 控制台)。
💡 技术拓展:「本地起一个 SQL 服务」还有第三条路——若你的应用用 libSQL 客户端 SDK(Go/JS/Python 等),SDK 可直接以
file:URL 打开本地 SQLite 文件,连 sqld 都不必启动(官方turso dev --help原文亦如此提示)。sqld 的价值在于提供与 Turso Cloud 完全一致的网络协议(HTTP/v2/pipeline、WebSocket Hrana),用于联调云端行为。
7.4 命令自动补全
方案 B 的 Release 包自带补全脚本(bash/zsh/fish 三份:turso.bash、turso.zsh、turso.fish),按 5.4 安装 bash 补全后即可 Tab 补全子命令与参数。方案 A 用户可从任一版本 Release 包中取得同一目录,或直接手动下载:
curl -sSfL -O https://github.com/tursodatabase/turso-cli/releases/download/v1.0.34/turso-cli_Linux_x86_64.tar.gz
tar -xzf turso-cli_Linux_x86_64.tar.gz turso-cli_Linux_x86_64/completions 2>/dev/null || tar -xzOf turso-cli_Linux_x86_64.tar.gz --wildcards '*/completions/*' > /dev/null
⚠️ 补全脚本与 CLI 版本对应,升级 CLI 后建议同步更新
/etc/bash_completion.d/turso。
八、升级与多版本管理
8.1 turso update 自升级(官方推荐)
turso update
实测回显(当前已是最新版时):
Current version: v1.0.34, latest version: v1.0.34
version v1.0.34 is already latest
有新版本时该命令会下载最新二进制覆盖安装位(方案 A 为 ~/.turso/turso)。另可通过 turso config set autoupdate on 让 CLI 自动保持最新。
8.2 重跑安装脚本升级
官方脚本为幂等覆盖安装:重跑 curl -sSfL https://get.tur.so/install.sh | bash 即把 turso 与 sqld 都刷新到最新版(本文排障与重装过程即多次复跑该脚本,均成功覆盖)。手动方案(方案 B)的升级 = 用新版本 URL 重复 5.2/5.3 两步。
8.3 多版本并存与指定版本安装
turso 不内置版本切换器,多版本并存的标准做法是「各版本目录 + PATH 切换」。实测下载 v1.0.33 与已装的 v1.0.34 并存:
mkdir -p /opt/turso-versions/1.0.33 && cd /opt/turso-versions/1.0.33
curl -sSfL -O https://github.com/tursodatabase/turso-cli/releases/download/v1.0.33/turso-cli_Linux_x86_64.tar.gz
tar -xzf turso-cli_Linux_x86_64.tar.gz turso
./turso --version
实测回显:
turso version v1.0.33
# 并存确认:同一台机器两个版本按路径各自可用
/root/.turso/turso --version
/opt/turso-versions/1.0.33/turso --version
实测回显:
turso version v1.0.34
turso version v1.0.33
需要临时切版本时调整 PATH 顺序即可(PATH 靠前目录中的 turso 生效):
export PATH=/opt/turso-versions/1.0.33:$PATH # 临时改用 v1.0.33
turso --version
8.4 降级
没有 turso downgrade 命令;降级等同「手动安装旧版本」:按 8.3 把目标旧版本目录放到 PATH 最前,或直接用旧版本二进制覆盖 ~/.turso/turso。降级后建议 turso config cache clear 清理缓存。
九、常见问题(FAQ)
Q1:安装时报 curl: (7) Failed to connect to github.com port 443 ... Connection refused 怎么办?
脚本需访问 github.com 下载两个二进制。网络受限环境给脚本配代理后重跑即可(脚本内的 curl 读取标准代理环境变量):
export http_proxy=http://192.168.1.62:7897 https_proxy=http://192.168.1.62:7897
curl -sSfL https://get.tur.so/install.sh | bash
本文实测中该错误出现于首次安装,配代理重跑后成功。
Q2:下载时报 curl: (35) error:0A000126:SSL routines::unexpected eof while reading?
TLS 连接被中途截断,多为代理/网络瞬时抖动。实测将「下载脚本」与「执行」分两步并重试即可恢复:
for i in 1 2 3 4 5; do
curl -sSfL https://get.tur.so/install.sh -o /tmp/install.sh && break
sleep 3
done
bash /tmp/install.sh
Q3:turso version 报 Error: unknown command "version" for "turso"?
v1.0.x 的版本查询是 turso --version 或 turso -v;turso version 子命令不存在(实测报错见 4.3)。
Q4:cron/脚本里执行 turso 提示 command not found?
安装脚本只把 PATH 写进 ~/.bashrc,非交互 shell 不加载它(实测对照见 7.1)。脚本中改用全路径 /root/.turso/turso,或在 /etc/environment 与服务单元中显式声明 PATH。
Q5:turso db shell 打不开本地文件(如 turso db shell demo.db)?
官方预编译 CLI 关闭了 CGO,直接打开本地文件路径会报错(实测):
Error: Binary was compiled with 'CGO_ENABLED=0', go-sqlite3 requires cgo to work. This is a stub
本地文件的标准访问路径有两条:给本地 sqld 起服务后用 turso db shell http://127.0.0.1:8080(7.3 用法一);或在应用侧用 libSQL 客户端 SDK 的 file: URL。file:// 协议在 CLI 中同样不支持,实测报错:
Error: invalid sqld protocol. valid protocols are libsql://, wss://, ws://, https:// and http://
Q6:执行 turso db list 等命令提示 You are not logged in, please login with turso auth login before running other commands.?
除 dev、本地 shell 连接、update、config set 帮助等少数本地能力外,云资源类命令(db/group/org/plan/quickstart/relax、auth 大部分、config path 等)都要求先登录 Turso Cloud。登录需要注册账号(https://turso.tech);本文档体系约定不在文中记录云端操作回显,云端命令形态见《Turso 1.0.34 常用 CLI 命令与工具详解》并注意其 ⚠️ 前置标注。
Q7:turso db shell http://127.0.0.1:9999 连不上本地服务报什么错?
端口未监听时报(实测,可用于排障时确认「服务没起」还是「SQL 错」):
Error: failed to execute SQL:
Post "http://127.0.0.1:9999/v2/pipeline": dial tcp 127.0.0.1:9999: connect: connection refused
同理,SQL 本身有错时报(实测):
Error: failed to execute SQL:
SQLite error: no such table: nonexistent_table
Q8:升级后 sqld 版本会一起变吗?
会。方案 A 重跑脚本时 sqld 一并刷新为 libSQL Releases 最新版;turso update 只更新 CLI 本体。可用 sqld --version(或 turso dev -v)确认随装版本,本文实测为 sqld 0.24.32 (40c272de 2025-02-14)。
十、卸载与清理
Turso CLI 无内置卸载命令,按安装产物逐项删除即可。以下流程已实测(卸载后验证命令确认为「命令不存在、目录已清、profile 无残留」)。
# 1. 删除安装目录(方案 A 的两个二进制都在这里)
rm -rf /root/.turso
# 2. 删除配置与缓存目录
rm -rf /root/.config/turso
# 3. 清理 profile 中的 PATH 追加行(方案 A 产生;若用方案 B 手动安装过 /usr/local/bin/turso 也一并删除)
sed -i '/# Turso/d; /\/root\/\.turso/d' /root/.bashrc
rm -f /usr/local/bin/turso
# 4. 清理多版本目录(按 8.3 使用过的路径)
rm -rf /opt/turso-versions /opt/turso-manual
卸载后验证(新开 shell):
bash -ic 'which turso; turso --version'
实测回显(which 无输出、版本查询退出码 127):
交互 shell 中 turso 退出码: 127
ls /root/.turso
实测回显:
ls: cannot access '/root/.turso': No such file or directory
grep -c turso /root/.bashrc
实测回显:
0
⚠️ 注意:
turso dev --db-file生成的数据文件(如/root/demo.db及其-wal/-shm伴生文件)、独立 sqld 的数据目录(如/opt/data/demo-sqld)属于业务数据,卸载 CLI 不会删除它们,确认不再需要时手动清理。
十一、参考链接
- Turso CLI 官方安装文档:https://docs.turso.tech/cli
- CLI 官方安装脚本:https://get.tur.so/install.sh
- Turso CLI v1.0.34 Release(含各平台包与 checksums.txt):https://github.com/tursodatabase/turso-cli/releases/tag/v1.0.34
- libSQL Releases(sqld 发布渠道):https://github.com/tursodatabase/libsql/releases
- Turso 官网与注册入口:https://turso.tech
- 本系列姊妹篇:《Turso 1.0.34 介绍与选型指南》《Turso 1.0.34 常用 CLI 命令与工具详解》