网站导航
> 技术文档 > Silly Tavern（酒馆） 教程第一章：安装（简洁干货版）

Silly Tavern（酒馆） 教程第一章：安装（简洁干货版）

网友: 技术文档 2025-07-26 19:43:35

本文介绍 Silly Tavern 的下载与安装方法，覆盖 Windows 和 Mac/Linux 系统，适合新手按步骤操作。

一、什么是 Silly Tavern？

Silly Tavern 是一个开源的前端界面，用于与大语言模型（LLM）交互，支持：

  • 自定义角色聊天
  • 角色卡导入（.png上传 / .json上传 / URL在线导入）
  • 插件扩展（TTS语音、图像生成等）
  • 本地或远程后端连接（无需月卡/内购费用，只需付API调用费，API免费层或本地运行小尺寸模型则不需要花钱，本地模型（在自己电脑运行模型）还可以实现隐私信息完全不出本地）

⚠️ 注意：Silly Tavern 本身不提供 AI 能力，需配合本地模型或在线 API 使用。

二、系统支持

系统 是否支持 推荐方式 Windows 10/11 ✅ 支持 一键启动器 或 Git 克隆 macOS ✅ 支持 Git 克隆 Linux ✅ 支持 Git 克隆 Android ⚠️ 可运行（需 Termux） 暂不包含 iOS ❌ 不支持 ——

三、安装前准备

1. 必需组件

组件 作用 下载地址 Node.js 运行环境 https://nodejs.org Git 代码下载工具 https://git-scm.com 浏览器 访问界面（推荐 Chrome） ——

📌 要求：

  • Node.js 版本 ≥ 18.16
  • Windows 7 不支持（Node.js 不兼容）
  • 至少2个G的电脑空间

2. 验证安装

2.1 安装Node.js

点get Node.js
Silly Tavern（酒馆） 教程第一章：安装（简洁干货版）
作为小白我们只需要选2.的msi安装包下载，意思是选预编译的版本
Silly Tavern（酒馆） 教程第一章：安装（简洁干货版）
之后安装时，安装选项一直保持默认即可，安装路径可以改改（比如从c盘改到其他盘），不要勾选复选框（Automatically install the necessary tools，自动安装必要工具），有些小众功能以后可能用到它，但是大部分功能不需要这些工具。安装工具预计可能多占电脑空间几个G，酌情决定。
Silly Tavern（酒馆） 教程第一章：安装（简洁干货版）

2.1 安装git

下载git
Silly Tavern（酒馆） 教程第一章：安装（简洁干货版）

打开终端（Windows：先win+r再输入cmd回车；Mac/Linux：Terminal），复制粘贴以下代码回车：

node -v

应返回版本号（如 v18.18.0）。

git --version

应返回 Git 版本信息。

四、Windows 安装步骤

方式一：一键启动器（推荐新手）

适用于不熟悉命令行的用户。

  1. 下载启动器：

    • 访问：https://github.com/SillyTavern/SillyTavern-Launcher
    • 点击 “Code” → “Download ZIP”

  2. 解压文件：

    • 将 ZIP 解压到任意目录（建议路径不含中文也不要在program files这样需要权限的文件夹，如 D:\\SillyTavern）

  3. 安装：

    • 双击运行 installer.bat
    • 若提示“Windows 保护你的电脑”，点击“更多信息”→“仍要运行”

  4. 启动：

    • 安装完成后，运行 launcher.bat
    • 点击 “Launch SillyTavern”，你会看到一个新的黑色命令行窗口弹出来，开始滚动一些文字，游玩期间不要关闭，这是程序后台，关了这个黑色的命令行窗口，浏览器窗口那边也会失去支持，以后每次想玩，就双击这个文件
    • 浏览器自动打开 http://localhost:8000

✅ 安装完成。

方式二：Git 克隆（手动安装）

适用于希望手动控制更新的用户。

  1. 打开命令行（cmd），进入目标目录（建议路径不含中文也不要在program files这样需要权限的文件夹，如D:\\SillyTavern），或在目标目录地址栏输入cmd再回车：

    cd D:\\SillyTavern

  2. 克隆项目（稳定版）：

    git clone https://github.com/SillyTavern/SillyTavern -b release

  3. 进入目录并启动：

    cd SillyTavernstart.bat

上面的代码每次复制一行到cmd命令行窗口，按回车运行

或直接在目标目录（如D:\\SillyTavern）双击start.bat打开（更简单），这时你会看到一个新的黑色命令行窗口弹出来，开始滚动一些文字，游玩期间不要关闭，这是程序后台，关了这个黑色的命令行窗口，浏览器窗口那边也会失去支持，以后每次想玩，就双击这个文件

  1. 自动弹出浏览器窗口：
    • 打开 http://localhost:8000

✅ 安装完成。

五、macOS / Linux 安装步骤

1. 安装依赖

macOS：
# 安装 Homebrew（如未安装）/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"# 安装 Node.js 和 Gitbrew install node git
Ubuntu/Debian：
sudo apt updatesudo apt install nodejs npm git -y
Fedora/RHEL：
sudo dnf install nodejs git -y

2. 克隆并运行 Silly Tavern

git clone https://github.com/SillyTavern/SillyTavern -b releasecd SillyTavernchmod +x start.sh./start.sh

3. 访问界面

  • 浏览器打开 http://localhost:8000

✅ 安装完成。

六、常见问题

问题 原因 解决方法 start.bat 双击闪退 Node.js 未安装或路径错误 检查 node -v 是否正常 提示“‘git’ 不是内部或外部命令” Git 未安装或未加入 PATH 重新安装 Git，勾选“Add to PATH” 权限错误（macOS/Linux） 脚本无执行权限 运行 chmod +x start.sh 无法访问 localhost:8000 端口被占用 修改 start.sh 中的端口参数（如 -p 8001） Windows 7 报错 不支持 Node.js 18+ 升级至 Windows 10 或更高

七、后续配置提示

安装完成后，Silly Tavern 只是一个空壳界面，还需：

  1. 配置后端（如本地模型或 API）
  2. 导入角色卡
  3. 设置插件（可选）

这些内容将在后续教程中介绍。

附：资源链接

  • Silly Tavern GitHub: https://github.com/SillyTavern/SillyTavern
  • Silly Tavern Launcher: https://github.com/SillyTavern/SillyTavern-Launcher
  • Node.js: https://nodejs.org
  • Git: https://git-scm.com
  • 第二篇：《连接 AI 后端：本地模型 vs 在线 API》
  • 第三篇：《角色卡导入与管理》
  • 第四篇：《TTS 语音配置指南》
网络标签：

相关问题