酒馆 SillyTavern 手机版：安卓 Termux 部署教程（2026）

结论先说：安卓手机可以用 Termux 在本机运行酒馆 SillyTavern，核心命令只有四条：pkg install git nodejs-lts nano、克隆 release 分支、bash start.sh、浏览器打开 http://127.0.0.1:8000。Termux 一定要从 F-Droid 或官方 GitHub 下载；iPhone 不能本机运行，只能访问电脑上的酒馆。

前置条件

你需要一部 Android 7.0 以上的手机、足够的剩余存储空间，以及 20–30 分钟时间。酒馆只是聊天界面，模型在云端运行，所以对手机性能要求不高，但安装依赖时内存太小可能失败。

设备与系统

Termux 是安卓上的 Linux 命令行环境，酒馆就跑在它里面。清华 TUNA 的 Termux 镜像要求 Android 7.0（API 24）及以上。32 位安卓手机需要额外装一个依赖，下文会写。Android 12 及以上系统会限制后台子进程，可能导致酒馆被系统结束，后面单独讲解决办法。

网络环境

手机部署有两段网络需求。第一段是安装：Termux 的软件包、GitHub 上的酒馆代码、npm 依赖都在境外服务器，国内直连可能很慢，Termux 包可以换国内镜像，GitHub 和 npm 慢时可以重试或换 npm 镜像。第二段是聊天：酒馆的 API 请求从手机本机发出，接 DeepSeek 直连即可，不需要加速器；接 Gemini、Claude 时，手机需要日本、新加坡等受支持地区的出口，香港不在两家支持地区内。

手机跑酒馆有哪几种方式？

安卓本机部署选 Termux；iPhone 或不想折腾手机的人，选「电脑运行、手机访问」。

方式	适用设备	优点	缺点
Termux 本机运行	安卓	不依赖电脑，随时可用	后台可能被杀，安装稍繁琐
电脑运行、手机局域网访问	安卓、iPhone	手机不用装任何东西	电脑要开着，要配置白名单或密码
云服务器部署	所有设备	随时随地访问	要租服务器，公网暴露有安全风险

Termux 部署要哪几步？

按官方文档的顺序做，每条命令执行完再输入下一条。

第一步：安装 Termux

从 F-Droid 搜索 Termux 下载，或到 github.com/termux/termux-app 的 releases 页下载 APK。官方文档明确说 Google Play 上的 Termux 已不再维护，不要用。也不要装来路不明的「Termux 修改版」。

第二步：换镜像并更新

打开 Termux，先运行：

termux-change-repo

用方向键和空格选择要更换的仓库，再选一个镜像（国内可选清华 TUNA 等就近镜像），回车确认。清华镜像帮助页也推荐用这个工具，并提醒不要用第三方「一键换源脚本」，那可能装入不受信任的签名密钥。换完后更新：

pkg update && pkg upgrade

第三步：安装依赖

pkg install git nodejs-lts nano

注意是 nodejs-lts，不是 nodejs，很多视频教程写错了这一点。如果你的手机是 32 位安卓，官方要求先运行 pkg install esbuild。

第四步：克隆并启动酒馆

git clone https://github.com/SillyTavern/SillyTavern -b release
cd ~/SillyTavern
bash start.sh

首次启动会自动安装依赖，耗时几分钟到十几分钟。npm 依赖下载慢，可以先运行 npm config set registry https://registry.npmmirror.com 换成国内镜像。安装时报错代码 134，多半是手机内存不够，关掉其他 App 再试。

第五步：在浏览器里打开

看到启动成功的提示后，不要关闭 Termux，切到手机浏览器打开 http://127.0.0.1:8000。8000 是酒馆的默认端口。之后每次使用，都要先在 Termux 里启动酒馆，再打开浏览器。

官方文档还给了一个省事的别名，写进 ~/.bashrc 后，以后只要输入 st 就能启动：

alias st='cd ~/SillyTavern && bash start.sh'

酒馆总是被后台杀掉怎么办？

Android 12 及以上系统会限制应用的后台子进程，超出限制时直接结束，Termux 里会出现 [Process completed (signal 9) - press Enter]。按下面顺序处理：

1. 下拉通知栏，在 Termux 通知上点「Acquire wakelock」，防止休眠。
2. 在系统设置里把 Termux 的电池优化设为「不限制」，国产系统还要允许自启动和后台运行。
3. 仍然被杀，可以查 Termux 官方 GitHub 的 issue #2366，里面有用 ADB 关闭进程监控的方法。这一步需要开发者选项，不熟悉的话不建议操作。

怎么更新和备份？

更新只要两条命令：cd ~/SillyTavern && git pull，然后 bash start.sh。角色卡和聊天记录在 ~/SillyTavern/data/default-user/，API Key 在 secrets.json。

卸载 Termux 会清空这些数据。备份前先运行 termux-setup-storage 授权访问手机存储，再把 data 文件夹复制到 ~/storage/shared/ 下，就能在手机文件管理器里看到。

常见问题

酒馆有官方手机 App 吗？ 没有。安卓上官方文档给的方式是 Termux 本机运行再用浏览器打开；网上叫 SillyTavern 的安卓 App 都是第三方项目。

Termux 从哪里下载？ F-Droid 或 github.com/termux/termux-app 的 releases。Google Play 版已不再维护。

为什么装 nodejs-lts 而不是 nodejs？ 官方文档写的就是 nodejs-lts，按官方装出问题时更容易排查。

Termux 用着用着提示 signal 9 是怎么回事？ Android 12 以上的后台进程限制结束了酒馆。先开 wakelock、关电池优化，仍不行再查 ADB 方法。

iPhone 能用酒馆吗？ 不能本机运行。在电脑上跑酒馆，开启局域网访问并设好白名单或密码，再用 iPhone 浏览器访问。

手机上的酒馆怎么更新？ 在 Termux 运行 cd ~/SillyTavern && git pull，再 bash start.sh。更新前备份 data 文件夹。

手机跑酒馆接 Gemini 要注意什么？ 请求从手机本机发出，手机要有日本、新加坡等受支持地区的出口，不要用香港节点；接 DeepSeek 不需要。

接 API 的具体步骤见 酒馆接 Gemini API、酒馆接 Claude API、酒馆接 DeepSeek；连接报错见 酒馆常见报错；电脑端安装见 Windows 与 macOS 安装教程。

参考来源

• 官方文档 · Android（Termux）安装：https://docs.sillytavern.app/installation/android-(termux)/
• SillyTavern 官方仓库：https://github.com/SillyTavern/SillyTavern
• Termux 官方仓库：https://github.com/termux/termux-app
• Termux 镜像列表：https://github.com/termux/termux-packages/wiki/Mirrors
• 清华 TUNA Termux 镜像帮助：https://mirrors.tuna.tsinghua.edu.cn/help/termux/
• 官方文档 · 配置文件（端口、白名单）：https://docs.sillytavern.app/administration/config-yaml/