LonelyTavern

修复 Termux 上的 SillyTavern(酒馆):更新、卸载与 start.sh 报错

最后更新于 2026年9月20日 · Android · 由 LonelyTavern 开发者撰写 · 命令依据 SillyTavern 官方 Android 指南

本文讲的是修好 SillyTavern 本身,而不是换掉它。直接跳到与你的症状对应的那一节即可。

1. Termux 什么都装不上、更新不了

全新安装时最常见的根本原因:用的是 Play 商店版的 Termux,它已经不再维护,自带的软件包都过时了。卸载它,改从 F-Droid(推荐)或 Termux 的 GitHub Releases 安装 Termux。然后把所有东西更新到最新:

pkg update && pkg upgrade

如果软件包下载卡住或超时,运行 termux-change-repo,换一个镜像,然后重试。

2. start.sh 以前能用,现在不行了

通常是这样:某次软件包升级把 SillyTavern 依赖的 Node 换掉了,或者一开始装的就是非 LTS 版的 Node。官方指南指定的是 nodejs-lts;很多视频教程写的却是 pkg install nodejs——光是这个差别,就能解释很多“上周还好好的”。按下面的顺序逐步排查:

pkg update && pkg upgrade
pkg install nodejs-lts
cd ~/SillyTavern && git pull --rebase --autostash
bash start.sh

如果还是不行,就重新克隆一份——同时保留你的数据:

mv ~/SillyTavern ~/SillyTavern-old
git clone https://github.com/SillyTavern/SillyTavern -b release
cp -r ~/SillyTavern-old/data ~/SillyTavern/
cd ~/SillyTavern && bash start.sh

你的聊天、角色和设置都在 data 文件夹里;旧的安装会保留在 ~/SillyTavern-old 中,直到你确认所有东西都迁移过来了。

3. 一锁屏,服务器就挂了

Android 回收后台进程非常激进,而 Termux 里的 Node 服务器正是首要目标。按效果从强到弱:

4. 安装时 npm 崩溃(错误代码 134)

npm install 时出现错误 134,几乎都是低内存手机内存耗尽导致的。关掉其他所有应用,重新运行安装;确认 Node 是 LTS 版(pkg install nodejs-lts)。在 32 位设备上,官方指南还要求运行 pkg install esbuild。

5. 什么都很慢

检查两件事。

6. 聊天或角色不见了

数据丢失的报告大多与写入中断有关——应用或手机在保存途中被杀掉,或者某次更新出了问题。预防胜于补救。运行一次 termux-setup-storage 以获得共享存储的访问权限,然后每次更新前都备份一下:

cp -r ~/SillyTavern/data ~/storage/shared/SillyTavern-backup

如果东西已经不见了:先停下,不要继续写入,在做最坏打算之前,先看看 data 里 SillyTavern 自己的 backups 文件夹。

7. 一锁屏或切换应用,回复就断了

这个问题不在服务器,而在浏览器。回复是通过一条实时连接流式传输到你打开的标签页里的,而手机浏览器为了省电,会在几秒内挂起后台标签页,流就断了。有三个办法:

Android 上的 Firefox 往往比 Chrome 让后台标签页多存活一会儿。

8. 卸载,或者干净地从头再来

没有卸载程序。SillyTavern 只是 Termux 里的一个文件夹,所以删除它就是删掉那个文件夹,或者直接删掉 Termux。先把 data 备份到共享存储,因为这两种做法都会连同你的聊天一起删掉。

完整步骤(包括保留聊天的干净重装)见:如何卸载 SillyTavern。

如果你不想在手机上跑服务器

以上内容都是为了让 SillyTavern 本身继续运行。如果你想要的正是这个,官方文档写得很好,社区也很乐于助人。

如果你真正需要的只是你的角色、你的 API 密钥和你的手机,这正是我们打造 LonelyTavern 的原因。它是一款原生 Android 和 iPhone 应用,能导入 V3 酒馆角色卡和世界书,用你自己的密钥连接任意兼容 OpenAI 的服务商,并把一切都保存在你的设备上。

免费,无需账号,没有广告,也不用半夜两点爬起来修。它不是完整的 SillyTavern:没有扩展,也没有群聊。但就最核心的玩法而言,装好就能用。

在 App Store 下载 下载应用,请到 Google Play

相关指南:在 iPhone 上使用 SillyTavern:三种可行的方法 · Chai:导出和备份聊天记录 · Character.AI:导出并保存聊天记录 · 全部指南。

SillyTavern 和 Termux 均为各自作者的独立项目。LonelyTavern 与这两个项目都没有关联,也未获得其认可。本文命令依据 SillyTavern 官方文档(docs.sillytavern.app)——最新说明请务必以那里为准。