1341 字
7 分钟
酒馆 SillyTavern 本地部署方案
2026-08-08

一、前言#

网络上传的”酒馆”(俗称 傻酒吧 / 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 终端逐条执行)#

Terminal window
# 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.js

3.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 代理、中文交互菜单、一键备份/更新/插件管理:

Terminal window
# 国内用户(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: true
whitelist: false
port: 8000

然后局域网内其他设备访问 http://手机内网IP:8000 即可一起玩(仅在可信局域网开放,不要暴露公网)。


四、Windows 本地部署#

4.1 前置环境#

4.2 安装酒馆#

  1. 在非系统受控目录新建文件夹(如 C:\ST),不要装进 Program Files,不要用管理员权限运行
  2. 在文件夹地址栏输入 cmd 回车,执行:
git clone https://github.com/SillyTavern/SillyTavern -b release
  1. 进入 SillyTavern 文件夹,双击 start.bat,它会自动安装依赖并启动,浏览器自动打开

4.3 手动方式(可选)#

cd SillyTavern
npm install
npm 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)
TavernAISillyTavern 的前身,已基本停止维护✅✅(Termux)
VenusAISillyTavern 早期分支✅✅(Termux)
RisuAI现代轻量前端,单文件启动✅✅(Termux/网页)
KoboldAI LiteKoboldAI 系轻量聊天界面✅✅

结论:直接用 SillyTavern 即可,替代品在功能与社区生态上均无法相比。


七、常见问题与安全提醒#

  • 端口被占用:报 “Address already in use” 时,改 config.yaml 里的 port 字段
  • GitHub 拉取失败:检查网络,或换一键脚本方案(内置国内代理)
  • 不要在公网裸奔:默认只监听本机;开启 listen: true 局域网共享时务必配好 whitelist,不要直接暴露到公网
  • 角色卡:可在酒馆内置的”下载扩展和资源”中获取社区卡片,或从角色卡社区导入(支持 PNG 卡、JSON 卡格式)
  • 未成年人 / 法律风险内容请注意合规,公共讨论渠道曾有针对该软件内容风险的清理事件

报告基于公开网络资料整理,具体命令以官方文档为准:https://sillytavern.wiki/

酒馆 SillyTavern 本地部署方案
https://blog.heyunxi.top/posts/酒馆sillytavern本地部署方案/
作者
Yunxi
发布于
2026-08-08
许可协议
CC BY-NC-SA 4.0