酒馆(SillyTavern)配置
SillyTavern(酒馆)是开源的国产/国际通用角色扮演与前端界面, 支持自定义 OpenAI 兼容后端,常用于长上下文和角色卡场景。
桌面版
下载:https://github.com/SillyTavern/SillyTavern/releases
解压后运行 Start.bat(Windows)或 start.sh(macOS / Linux)。
手机版(Termux)
不要从 Google Play 商店安装 Termux
那个版本已停止维护,会导致安装失败。 从 F-Droid 或 GitHub releases 下载 APK。
termux-change-repo # 换到离你最近的镜像,连续回车即可
pkg update && pkg upgrade
pkg install git nodejs-lts
32 位系统可能还要:
pkg install esbuild
安装酒馆:
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
npm install
./start.sh
看到 SillyTavern is running on http://127.0.0.1:8000 就成功了。
用手机浏览器打开该地址(页面异常时试试 Edge),滚到底部点「连接」。
配置后端
第一步:打开 API 连接设置
酒馆界面 → 顶部 「API 连接」(API Connections)。
第二步:选后端类型
选 Chat Completion(OpenAI 兼容),不要选 Text Completion。
第三步:填写
| 字段 | 填什么 |
|---|---|
| Chat Completion Source | Custom (OpenAI-compatible) |
| Custom Endpoint (Base URL) | https://api.yzgz.cn/v1 |
| API Key | sk-你的密钥 |
| Model | claude-opus-4-5 或 MiniMax-M3.1-Flash |
Base URL 末尾带
/v1酒馆会自己拼 /chat/completions。地址写 https://api.yzgz.cn 会变成
https://api.yzgz.cn/chat/completions —— 少一层 /v1,直接 404。
第四步:连接
点「连接 / Connect」,状态变成绿色即成功。
排错
| 现象 | 原因 | 处理 |
|---|---|---|
| Connect 后报 404 | Base URL 少了 /v1 | 补上 |
| 报 401 | 密钥错 | 重新复制 |
| 一直转圈 | 首次拉模型列表慢 | 等几秒 |
| 手机打开页面异常 | 浏览器兼容 | 换 Edge 浏览器 |
相关:Cherry Studio 配置 · 客户端接入总览 · [常见问题](../reference/faq/overview