手机版 SillyTavern(酒馆)完整部署与使用教程
手机版 SillyTavern(酒馆)完整部署与使用教程
Contents
想在安卓手机上运行SillyTavern(俗称”酒馆”)?推荐使用Termux搭建本地服务,通过浏览器访问127.0.0.1:8000即可使用。本文提供从安装到进阶的完整指南,包含2026年最新免终端方案对比、常见问题排查及角色卡获取渠道。
前置准备
- Android 10+系统(建议8GB内存机型)
- Termux(需从F-Droid安装,Google Play版已停更)
- 2GB以上存储空间
- 稳定网络环境(部分步骤需科学上网)
分步教程
1. Termux基础安装
- 从F-Droid安装Termux、Termux:API、Termux:Boot
- 打开Termux执行基础配置:
pkg update && pkg upgrade -y pkg install git nodejs-lts -y
2. 部署SillyTavern(以1.18.0为例)
git clone https://github.com/SillyTavern/SillyTavern.git
cd SillyTavern
git checkout 1.18.0 # 锁定版本
npm install
npm run init # 1.18.0新增步骤
3. 设置快捷指令(可选)
编辑~/.bashrc添加:
alias qidong='cd ~/SillyTavern && node server.js'
alias gengxin='cd ~/SillyTavern && git checkout package-lock.json && git pull && npm install'
alias chongqi='pkill -9 node; sleep 1; cd ~/SillyTavern && node server.js'
4. 启动与访问
node server.js
浏览器访问http://127.0.0.1:8000
2026年免终端方案对比
| 方案 | 维护状态 | 内核版本 | 特点 |
|---|---|---|---|
| ST-android | 活跃(v0.5.0) | 1.18.0 | 支持完整备份导入,扩展支持较弱 |
| Wivern | 停止(2026.3) | 1.16.0 | 完整fork含扩展,安全性存疑 |
| ST-Ctrl | 新出(2026.6) | 1.18.0 | 中文管理台,支持扩展/备份/局域网 |
去哪找角色卡
推荐渠道(SFW友好)
- aicharactercards.com(审核严格)
- RisuRealm(支持CC授权)
- character-tavern.com(策展优质)
最大库(需年龄验证)
注:以上均为用户生成内容,请遵守各站条款与年龄限制
常见问题排查
| 问题 | 解决方案 |
|---|---|
| 锁屏后断连 | 安装Termux:Boot保持后台,关闭电池优化 |
| npm install报错 | 添加代理export https_proxy=http://127.0.0.1:7890 |
| 角色卡导入卡顿 | 清理缓存或重启Termux |
| 状态栏异常 | 安装酒馆助手扩展 |
FAQ
Q:iPhone能否本地运行?
A:不能。iOS限制Node.js服务运行,可通过浏览器访问云端/家庭电脑部署的酒馆,或使用原生App(如Foreverse)。
Q:升级会丢失聊天记录吗?
A:不会。记录保存在data/目录,不受git pull影响。
Q:手机运行卡顿怎么办?
A:确认:①API响应速度 ②角色卡大小(建议压缩图片)③关闭其他后台应用
开始你的角色扮演
现在您已掌握手机部署SillyTavern的全部要领。如需更简化的移动端体验,可访问tuniang.ai获取原生应用方案。