# SillTavern

**Repository Path**: LimeOnTop/sill-tavern

## Basic Information

- **Project Name**: SillTavern
- **Description**: 配套b站视频教程
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 18
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2026-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 过时的教程
这个教程已经过时，且存在诸多问题，建议你查看新视频，新教程，更方便，更实用
[搭建SillyTavern总出错？｜想入坑SillyTavern却卡在的搭建？｜一键教你怎么安装和搭建SillyTavern与CLI反代！](https://www.bilibili.com/video/BV17zZVBjEom)
## 文档
**本教程在B站同步更新，欢迎查看视频教程**
<br>
[点我跳转至B站](https://www.bilibili.com/video/BV1yoGuzEEKc)
<br>
**如果教程能帮到你，求个三连，谢谢你啦**
<br>
**该教程已于2025年7月16日完结**
<br>
**本以为完事大吉了，在2025年7月16日再次更新**

# 遇到问题请尝试Termux挂小窗！
# 无法回复(爆红)尝试将最大回复长度拉大！
---

*操作步骤均不需要Root与魔法，仅仅只是无脑复制粘贴命令而已*
<br>
您需要先下载Termux
<br>
Termux使用本文档提供的！`arm64-v8a`！不要使用`GooglePlay`版本！会报错!

[点我跳转至GithubRelease](https://github.com/termux/termux-app)
<br>
[国内镜像源高速下载](https://github.akams.cn/https://github.com/termux/termux-app/releases/download/v0.118.3/termux-app_v0.118.3+github-debug_arm64-v8a.apk)
<br>
[Github直链下载](https://github.com/termux/termux-app/releases/download/v0.118.3/termux-app_v0.118.3+github-debug_arm64-v8a.apk)
---

在安装Termux后，输入以下命令来修改镜像源

```bash
sed -i 's@^\(deb.*stable main\)$@#\1\ndeb https://mirrors.aliyun.com/termux/termux-packages-24 stable main@' $PREFIX/etc/apt/sources.list
```

*修改为阿里镜像源，清华源谁用谁倒霉…*



```bash
apt update && apt upgrade
```

*更新软件包管理器*

安装必要软件

```bash
apt install vim wget git nodejs -y
```

*安装必要工具，添加参数-y无需手动输入y*

配置nodejs镜像源

```bash
npm config set registry https://registry.npmmirror.com
```

*配置npmMirror镜像源，以便国内用户可以高速下载*

# 开始部署

使用wget获取酒馆源码

```bash
wget -O ST.zip https://github.akams.cn/https://github.com/SillyTavern/SillyTavern/archive/refs/tags/1.17.0.zip
```

>如果您在运行这步后报错，挂上魔法，运行以下命令
<br>

```bash
wget -O ST.zip https://github.com/SillyTavern/SillyTavern/archive/refs/tags/1.17.0.zip
```

继续后续操作即可


解压该文件

```bash
unzip ST.zip
```

*解压ST.zip*

```bash
mv SillyTavern-1.17.0 st
```

*将Sillyxxxxx这个目录重命名为ST，方便cd和后续启动*

```bash
cd st
```

*进入st这个目录*


```bash
./start.sh
```

*运行启动脚本*

# 后续如何启动

关闭Termux再启动后通过以下命令再次启动

```bash
cd st
```

*切换到st目录*

```bash
./start.sh
```

*运行启动脚本*

# 自定义启动脚本（可选）

觉得每次启动都要cd和运行个sh?<br>你可以尝试写一个脚本来一条命令直接启动
```bash
cd
# 返回到根目录
```

```bash
vim <脚本名称>.sh
# 选择一个方便好记忆的内容
# 比如vim 123.sh
```
然后，进入输入界面后，按下键盘上的`i`键
<br>
屏幕上出现`-- INSERT --`后，输入以下内容

```bash
echo 酒馆正在启动
echo 浏览器：127.0.0.1:8000
echo 默认用户：user
echo 默认密码：password
cd ~
cd st
./start.sh
# 低下的shell水平，见谅。
```

输入完成之后，先按下*ESC*然后输入`:wq`+`回车`即可，保存后你就可以直接运行

```bash
sh <你设置的脚本名称>.sh
# 如：
# sh 123.sh
```

来快速启动！
# 清理剩余文件（可选）

你可以使用ls命令和rm/rmdir来清理下载的文件

```bash
cd #回到根目录
ls #列出文件与文件夹
```

```bash
rm <文件名>
rm -r <文件夹名>
```

这玩意会问你要不要删，打个y回他就行

# 一键安装脚本（可选）

**如果你觉得上述操作太过麻烦，可以尝试以下脚本来一键安装**
<br>
*该脚本并非UP主所写*

```bash
curl -O https://gitee.com/print-yuhuan/SillyTavern-Termux/raw/main/Install.sh && bash Install.sh​
```

# API密钥导入与拓展管理
**首先，你需要一个魔法环境，这是必须的**
<br>
在完事大吉（部署完毕后），你可以正式来配置API密钥（APIKEY）以开始游玩SillyTavern。

**在文档里写有点干巴，所以这一节也有配套教程～**
<br>
[点我跳转至B站](https://www.bilibili.com/video/BV1sqMQztEH7)

## 如何获取API密钥
>使用酒馆必要的就是API密钥，这里提供三位哔哩哔哩UP主的视频给大家参考～
>**除了国内的AI以外，其它所有的，如Grok，Gemini等AI均需要魔法环境才能使用**

[【1.3 硅基流动APi密钥在Cherry Studio的使用-哔哩哔哩】](https://b23.tv/cGyWl0q)
<br>
[【如何免费使用deepseek大模型的apikey-哔哩哔哩】](https://b23.tv/aZXmraX)
<br>
[【如何获取Gemini API Key-哔哩哔哩】](https://b23.tv/9bc4wQU)
<br>
注意！获取过程中遇到问题不要去询问这些UP主！问我！不要打扰其他人！
<br>
硅基流动的API需要选择在**聊天补全来源处**选择自定义，然后在**自定义端点（基础URL）处**填写`https://api.siliconflow.cn/v1`后填写你获取的密钥即可
<br>
`DeepSeek注册已不赠送金额`，如果想免费使用`DeepSeek模型`请考虑使用硅基流动的API密钥
## 酒馆助手的安装
>`酒馆助手`是一个**酒馆拓展**，安装后可以让酒馆渲染前端页面，可以说是玩酒馆必装了。
按照视频教程找到**拓展**选项卡，然后选择**安装拓展**，后输入以下仓库链接。

```markdown
https://gitlab.com/novi028/JS-Slash-Runner
```

# 你可能会用到的链接
整理了以下文档/链接，有兴趣你可以去看看，由于特殊原因，类脑(odysseia)的链接已不再提供

>1.[SillyTavern傻酒馆中文文档](https://sillytavern.wiki/)<br>2.[艾萝工坊](https://www.erocraft.com/silly-tavern/)<br>3.[类脑ΟΔΥΣΣΕΙΑ](https://www.baidu.com)<br>4.[酒馆助手官方文档](https://n0vi028.github.io/JS-Slash-Runner-Doc/)<br>5.[旅程](https://discord.gg/https://discord.gg/elysianhorizon)<br>6.[ReLST2C](https://discord.gg/qAFuVjpcRU)

其中`SillyTavern傻酒馆中文文档`与`艾萝工坊`都是教程文档，从部署到角色卡/预设的获取写的都非常详尽 是很优秀的酒馆文档<br>而`旅程`是在*Discord上的中文酒馆频道*，有很多大大在这里发布他们制作的角色卡与模型预设。

# 后续可能的问题

因为评论区反馈的人太多，故单开一个板块来说说可能遇到的问题。
<br>
**请确保自己认真阅读并使用文档之后再在评论区提问，否则这将会浪费你我的时间**
<br>
**大多数错误都是命令复制漏了/镜像没配置到/干脆就是没复制命令**
<br>
**这种问题出现在评论区将不予回复，如果是文档内标注过的问题将会直接删除**


## 输出过程卡顿
1**这可能是由于你使用是Google Gemini模型，而且没用配置预设和正则的情况下发生的**
<br>
2**可能是安卓后台机制的原因，确保给Termux后台运行权限/开小窗**

## 软件安装问题
如果你遇到wget/nodejs not install 这一情况，输出以下命令即可

```bash
apt install wget nodejs
```

**这很有可能是你没复制安装必要软件那一步的命令**

# 【进阶】ClewdR的配置

## ClewdR是什么
是一个*高性能的*的**LLM反代项目**，支持**Claude与Gemini**。<br>经过实测，配置Clewdr可以很大程度上提高Gemini的输出速度。<br>还有，用**Rust**写的

>看到过一个很形象的比喻，SillTavern是酒馆，大模型是少女，而Clewdr则是将少女带去酒馆的黄毛(具体出处忘了)

## 安装Clewdr
回到根目录
```bash
cd
```

创建并进入目录
```bash
mkdir clewdr && cd clewdr
```

接着，下载Clewdr。

```bash
wget -O clewdr.zip https://github.akams.cn/https://github.com/Xerxes-2/clewdr/releases/download/v0.11.12/clewdr-android-aarch64.zip
```

解压
```bash
unzip clewdr.zip
```

运行clewdr

```bash
./clewdr
```

这将会生成配置，并在本地创建配置文件。
<br>尝试在浏览器输入`127.0.0.1:8484`进入Clewdr配置页。

# 后续如何再次启动ClewdR
在你新开一个终端后，先运行以下命令回到根目录
```bash
cd
```
然后运行以下两条命令启动
```bash
cd clewdr
./clewdr
```
如果你是先开酒馆再开Clewdr，这样做就没问题了
<br>
如果你是先开clewdr再开酒馆，可以直接运行下面两条命令，不用`cd`
```bash
cd clewdr
./clewdr
```
新开的终端同样需要先运行`cd`然后运行如下命令方可启动酒馆
```bash
cd st
./start.sh
```

# 捐赠
**教程录制与文档撰写不易，需要经过多次测试后发出**
<br>
**如果可以的话，请支持我哦**
<br>
**感激不尽 ฅ( ̳• ◡ • ̳)ฅ**
<br>

```bash
echo 蟹蟹！ꉂ(ˊᗜˋ*)
```

<img src="https://gitee.com/LimeOnTop/sill-tavern/raw/master/mm_reward_qrcode_1765118195981.png" width = "200" height = "200" alt="捐赠" align=center />