1341 字
7 分钟
酒馆 SillyTavern 本地部署方案
一、前言
网络上传的”酒馆”(俗称 傻酒吧 / ST)指的是开源项目 SillyTavern——一个纯前端 AI 聊天界面(不含模型),可以本地部署在 Windows / Linux / macOS,也能通过 Termux 在安卓手机上跑起来。真正负责”对话”的模型后端需单独接入(本地模型或云端 API)。
二、方案总览
| 方案 | 运行设备 | 难度 | 特点 | 推荐度 |
|---|---|---|---|---|
| SillyTavern + Termux(官方主流) | 安卓手机 | 中 | 最正统的安卓部署法,浏览器访问 | ⭐⭐⭐⭐⭐ |
| SillyTavern-Termux 一键脚本 | 安卓手机 | 低 | 国内镜像加速、中文菜单,专为中国用户优化 | ⭐⭐⭐⭐⭐ |
| Windows 本地部署 | Windows 电脑 | 低 | 双击 start.bat 即可,最省事 | ⭐⭐⭐⭐⭐ |
| SillyTavern-Launcher(启动器) | Windows/Linux | 低 | 官方启动器,可同时管理本地模型后端 | ⭐⭐⭐⭐ |
| 其他”酒馆类”前端(TavernAI / VenusAI / RisuAI 等) | 均可 | - | 老前辈或分支,生态远不如 SillyTavern | ⭐⭐ |
官方文档:https://sillytavern.wiki/ | 项目仓库:https://github.com/SillyTavern/SillyTavern 注意:SillyTavern 官方没有原生安卓 APP,安卓上是通过 Termux 跑本地服务 + 手机浏览器访问(网页 PWA 形式),与 PC 体验一致。
三、安卓部署(Termux 方案)
3.1 准备工作
- 一台安卓手机 + 稳定的科学上网环境(GitHub 访问需要,网络差时可换国内镜像源)
- 下载安装 Termux(F-Droid 官方渠道,勿用 Google Play 版,版本过旧):
https://f-droid.org/en/packages/com.termux/(下载 APK 安装)
3.2 安装步骤(在 Termux 终端逐条执行)
# 1. 更新系统包(有 Y/N 提示就输 y 回车)pkg update && pkg upgrade
# 2. 安装依赖:git + nodejs(+ esbuild 可选,官方推荐)pkg install git nodejs esbuild
# 3. 克隆酒馆(release = 稳定版,staging = 测试版)git clone https://github.com/SillyTavern/SillyTavern -b release
# 4. 进入目录并安装依赖cd SillyTavern && npm install
# 5. 启动node server.js3.3 访问与日常使用
- 启动后打开手机浏览器访问:
http://127.0.0.1:8000(注意是 http 不是 https) - 重启手机 / Termux 后只需:
cd SillyTavern && node server.js - 更新到最新版:
cd SillyTavern && git pull - 切换测试版:
cd SillyTavern && git switch staging
3.4 一键脚本(推荐国内用户)
SillyTavern-Termux(Gitee 上有项目)——自动切换 Termux 国内源、内置 GitHub 代理、中文交互菜单、一键备份/更新/插件管理:
# 国内用户(Gitee 镜像)curl -O https://gitee.com/print-yuhuan/SillyTavern-Termux/raw/main/Install.sh && bash Install.sh
# 海外/有代理用户curl -O https://raw.githubusercontent.com/print-yuhuan/SillyTavern-Termux/refs/heads/main/Install.sh && bash Install.sh安装完成后重启 Termux 即进入中文主菜单(含启动、更新、备份、卸载、插件管理)。
3.5 局域网共享(可选)
编辑 config.yaml:
listen: truewhitelist: falseport: 8000然后局域网内其他设备访问 http://手机内网IP:8000 即可一起玩(仅在可信局域网开放,不要暴露公网)。
四、Windows 本地部署
4.1 前置环境
- 安装 Node.js LTS(推荐 v20/22,不要超过 v23,避免兼容问题):https://nodejs.org/
- 安装 Git:https://git-scm.com/ 或
winget install --id Git.Git -e --source winget
4.2 安装酒馆
- 在非系统受控目录新建文件夹(如
C:\ST),不要装进 Program Files,不要用管理员权限运行 - 在文件夹地址栏输入
cmd回车,执行:
git clone https://github.com/SillyTavern/SillyTavern -b release- 进入
SillyTavern文件夹,双击start.bat,它会自动安装依赖并启动,浏览器自动打开
4.3 手动方式(可选)
cd SillyTavernnpm installnpm start访问:http://localhost:8000
4.4 国内网络加速建议
- npm 换镜像源:
npm config set registry https://registry.npmmirror.com - git clone 失败时,可尝试 GitHub 加速镜像(如 ghproxy 类)
五、模型后端怎么配(关键一步)
酒馆本身不”说话”,需要先连上模型,三种典型选择:
| 后端类型 | 代表 | 说明 |
|---|---|---|
| 本地模型(完全离线、免费) | Ollama / KoboldCPP / llama.cpp | 需要电脑或手机性能较好;手机端跑小模型(如 7B 量化)较吃力,推荐电脑跑本地模型 |
| 云端 API(效果最好) | OpenAI / Claude / Gemini / OpenRouter / 各家国产 API | 需要 API Key 和费用;在酒馆设置里填 OpenAI 兼容接口即可 |
| 免费池 | AI Horde / NovelAI | 排队式众包算力,开箱即用,适合尝鲜 |
小贴士:如果只是想在手机上玩”酒馆 + 云端模型”(如国内可用的 OpenAI 兼容 API),手机性能完全不是问题——Termux 只跑前端,AI 推理在云端。
六、同类替代品一览
| 项目 | 说明 | 本地部署 | 安卓 |
|---|---|---|---|
| SillyTavern | 生态最大、更新最勤,角色卡/插件/世界书齐全 | ✅ | ✅(Termux) |
| TavernAI | SillyTavern 的前身,已基本停止维护 | ✅ | ✅(Termux) |
| VenusAI | SillyTavern 早期分支 | ✅ | ✅(Termux) |
| RisuAI | 现代轻量前端,单文件启动 | ✅ | ✅(Termux/网页) |
| KoboldAI Lite | KoboldAI 系轻量聊天界面 | ✅ | ✅ |
结论:直接用 SillyTavern 即可,替代品在功能与社区生态上均无法相比。
七、常见问题与安全提醒
- 端口被占用:报 “Address already in use” 时,改
config.yaml里的port字段 - GitHub 拉取失败:检查网络,或换一键脚本方案(内置国内代理)
- 不要在公网裸奔:默认只监听本机;开启
listen: true局域网共享时务必配好whitelist,不要直接暴露到公网 - 角色卡:可在酒馆内置的”下载扩展和资源”中获取社区卡片,或从角色卡社区导入(支持 PNG 卡、JSON 卡格式)
- 未成年人 / 法律风险内容请注意合规,公共讨论渠道曾有针对该软件内容风险的清理事件
报告基于公开网络资料整理,具体命令以官方文档为准:https://sillytavern.wiki/
酒馆 SillyTavern 本地部署方案
https://blog.heyunxi.top/posts/酒馆sillytavern本地部署方案/