SillyTavern：AI角色扮演聊天前端部署与使用指南

📋 官方信息

项目名称	SillyTavern
仓库地址	https://github.com/SillyTavern/SillyTavern
官方网站	https://sillytavern.app
最新更新	2026年9月
项目定位	功能最强大的AI角色扮演聊天前端，支持自定义角色卡和世界书

🎯 项目背景

SillyTavern（俗称"傻酒馆"）是目前最受欢迎的 AI 角色扮演聊天前端，由 Cohee 和 0xdevalias 等开发者维护。它起源于 Chub Venus 等早期角色聊天平台，但凭借极高的可定制性和对各种后端模型的广泛支持，迅速成为 AI 角色扮演社区的标准工具。

与普通的 AI 聊天工具不同，SillyTavern 的核心设计围绕"角色扮演"展开：你可以创建或导入精美的角色卡（Character Card），定义角色的外貌、性格、背景故事，然后和这些虚拟角色进行沉浸式对话。配合"世界书"（World Info）功能，你还可以构建完整的虚构世界观，让对话更加生动。

项目在 GitHub 上获得了超过 2 万 Star，拥有活跃的社区和丰富的插件生态，支持本地运行和 Docker 部署。

✨ 核心特性

角色卡系统：支持 V2/V3 格式角色卡，可导入导出 PNG 格式的角色卡图片
世界书（Lorebook）：自定义世界观设定，AI 会根据关键词自动调用相关设定
多后端支持：兼容 OpenAI、Claude、Gemini、Ollama、KoboldCpp、Text Generation WebUI、TabbyAPI 等几乎所有本地/远程模型
提示词工程：内置大量提示词预设（Preset），支持高级提示词编辑
正则替换（Regex）：自定义输出文本的正则处理规则
扩展系统：支持第三方插件，如语音合成、表情立绘、记忆增强等
多人对话：支持同时与多个角色对话
UI 高度定制：数百个主题和界面布局可选

💻 环境要求

Docker 部署：Docker 20.10+，内存 1GB 以上
Node.js 部署：Node.js 18 LTS 或更高版本，npm
模型后端：需要一个兼容的大模型 API 或本地模型运行器
浏览器：Chrome / Firefox / Edge 最新版

🚀 详细部署步骤

方式一：Docker Compose 部署（推荐）

# 1. 克隆仓库
git clone https://github.com/SillyTavern/SillyTavern.git
cd SillyTavern/docker

# 2. 复制 docker-compose.yml（如已有则跳过）
# 官方提供的 docker-compose.yml 内容如下：

创建 docker-compose.yml：

services:
  sillytavern:
    container_name: sillytavern
    image: ghcr.io/sillytavern/sillytavern:latest
    volumes:
      - "./config:/home/node/app/config"
      - "./data:/home/node/app/data"
      - "./plugins:/home/node/app/public/scripts/extensions"
    restart: unless-stopped
    ports:
      - "8000:8000"

启动：

docker compose up -d

启动后访问 http://服务器IP:8000。

方式二：Docker 单容器部署

docker run -d \
  --name sillytavern \
  --restart unless-stopped \
  -p 8000:8000 \
  -v ./config:/home/node/app/config \
  -v ./data:/home/node/app/data \
  ghcr.io/sillytavern/sillytavern:latest

方式三：Node.js 源码部署

# 1. 克隆仓库
git clone https://github.com/SillyTavern/SillyTavern.git
cd SillyTavern

# 2. 安装依赖
npm install

# 3. 启动（默认监听 8000 端口）
./start.sh
# Windows 用户运行 start.bat

# 4. 全局监听模式（允许外部访问）
./start.sh --listen
# Windows: start.bat --listen

🔧 配置访问控制

编辑 config.yaml 文件，设置用户名密码：

whitelistMode: true
whitelist:
  - 127.0.0.1
  - 你的服务器IP

basicAuthMode: true

security:
  authEnabled: true
  username: "your_username"
  password: "your_secure_password"

🔌 连接模型后端

以连接 OpenAI 为例：

打开 SillyTavern，点击顶部的"API Connections"图标（插头形状）
API 类型选择"Chat Completion"（文本补全）
Chat Completion Source 选择"OpenAI"
填入你的 OpenAI API Key
选择模型（如 gpt-4o、gpt-4o-mini）
点击"Connect"按钮测试连接

连接本地 Ollama：

API 类型选择"Text Completion"或"Chat Completion"
Source 选择"Ooba"（针对 Text WebUI）或自定义
填入 Ollama 地址：http://localhost:11434

✅ 启动验证

访问 http://服务器IP:8000
首次访问会进入用户设置页面，创建用户名和密码
配置好模型后端后，选择一个内置角色卡开始对话
输入消息确认 AI 正常回复

📖 使用方法

创建角色

点击角色管理面板的"+"号，填写角色名称、描述、对话示例、第一人称消息等。高级用户可以编辑"角色定义"字段，使用详细的提示词来塑造角色性格。

导入角色卡

将下载的角色卡 PNG 图片直接拖入角色管理面板即可自动导入。角色卡图片中内嵌了角色的所有设定信息。

世界书使用

在"World Info"面板中创建条目，设置关键词和内容。当对话中出现关键词时，对应内容会自动注入到提示词中，让 AI 了解相关背景。

❓ 常见问题

Q1: 外部无法访问怎么办？
A: 需要使用 --listen 参数启动，并在 config.yaml 中将服务器 IP 加入白名单。同时检查防火墙和安全组设置。

Q2: 如何配置 HTTPS？
A: 推荐使用 Nginx 反向代理 + Let's Encrypt 证书。SillyTavern 官方文档提供了完整的反向代理配置示例。

Q3: 数据备份在哪里？
A: Docker 部署时，配置和数据分别在 ./config 和 ./data 目录。备份这两个目录即可。

Q4: 支持多少个角色？
A: 没有硬性限制，角色卡都存储在本地文件系统中。但过多角色可能影响界面加载速度。

Q5: 如何更新？
A: Docker 部署：docker compose pull && docker compose up -d。源码部署：git pull && npm install。

🔗 跳转链接

GitHub 仓库：https://github.com/SillyTavern/SillyTavern
官方文档：https://docs.sillytavern.app
中文文档：https://sillytavern.wiki
角色卡分享社区：https://chub.ai