AI陪伴指南

酒馆 SillyTavern 电脑安装教程：Windows 与 macOS（2026）

2026 年酒馆 SillyTavern Windows、macOS 安装教程：装 Node.js 20+ 与 Git，克隆后运行 Start.bat 或 start.sh，附 Launcher、Docker 与 npm 镜像。

作者：苏苏 发布： 最后更新： 栏目：酒馆

结论先说：酒馆 SillyTavern 在 Windows 和 macOS 上的安装只有三步——装 Node.js 20 以上版本和 Git、克隆 release 分支、运行 Start.bat 或 start.sh，然后浏览器打开 http://localhost:8000。新手 15 分钟内能装完，国内最容易卡在 GitHub 克隆和 npm 下载依赖这两步，下文给出对应办法。

前置条件

你需要一台 Windows 10/11 或 macOS 电脑、普通用户权限即可（不需要管理员），并给酒馆和依赖预留一些磁盘空间。只接云端 API 时不需要独立显卡。

软件版本

官方文档要求 Node.js 20 或更高，并建议安装最新 LTS 版。截至 2026-11-05，Node 20 已于 2026-04-30 停止维护，Node 24 进入维护期，Node 26 于 2026-10-28 成为 Active LTS。直接装 nodejs.org 首页标注「LTS」的版本即可。Windows 7 跑不了 Node 20，官方明确无法安装。

Git 用于下载和更新酒馆。Windows 装 Git for Windows（git-scm.com），也可以用 winget install -e --id Git.Git；macOS 运行 xcode-select --install 会附带 git，或用 Homebrew 运行 brew install git。

网络环境

安装阶段的网络需求集中在两处：从 GitHub 克隆酒馆仓库，以及首次启动时从 npm 下载依赖。国内直连 GitHub 和 npm 官方源经常很慢甚至中断，npm 这一段可以换成国内镜像解决，GitHub 这一段只能重试或借助加速器选择海外节点提速。装好之后，接 DeepSeek 这类国内模型不需要加速器；接 Gemini、Claude 则要求运行酒馆的这台电脑有日本、新加坡等受支持地区的出口，香港不在两家的支持地区内。

三种安装方式怎么选？

新手选「手动 Git」或「Launcher」，已经用 Docker 的人再考虑 Docker。三种方式装出来的酒馆功能一样，区别在安装和更新的便利程度。

方式适合谁优点缺点
手动 Git + 启动脚本大多数人步骤少、出错好排查、更新只需 git pull要自己装 Node.js 和 Git
SillyTavern Launcher不想碰命令行的 Windows 用户自动装 Git、Node.js，带更新、备份菜单多一层脚本，出错时信息不直观
Docker Compose已在用 Docker 或要部署到服务器环境隔离、迁移方便需要先装 Docker，对新手门槛高

Windows 怎么装？

Windows 上按官方文档的「手动 Git」流程，四步完成。

  1. 在 D 盘或其他非系统目录新建一个文件夹，比如 D:\AI。不要放在 Program Files、System32 或桌面同步目录。
  2. 打开这个文件夹，点击资源管理器地址栏，输入 cmd 回车，打开命令行窗口。
  3. 运行克隆命令：
git clone https://github.com/SillyTavern/SillyTavern -b release
  1. 克隆完成后进入 SillyTavern 文件夹，双击 Start.bat（扩展名可能被隐藏，显示为 Start）。首次运行会自动安装依赖，结束后浏览器自动打开酒馆。不要右键「以管理员身份运行」。

想用 Launcher 的话，官方给出的命令是先装 Git，再克隆 Launcher 并运行安装器：

cmd /c winget install -e --id Git.Git
git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat

安装器会让你选择要装的组件，装完后以后双击 Launcher.bat 进入菜单启动或更新酒馆。

macOS 怎么装？

macOS 的流程和 Linux 一样：装好 Node.js 与 git 后，在终端运行三条命令。

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

如果提示 Permission denied，说明脚本没有执行权限，运行 chmod +x start.sh 后再试，或直接用 bash start.sh。start.sh 会检查 npm 是否存在、安装依赖并启动服务。终端出现监听地址后，浏览器打开 http://localhost:8000。

Mac 用户也可以用 Launcher：克隆 SillyTavern-Launcher 后运行 chmod +x install.sh && ./install.sh，之后用 ./launcher.sh 启动。

npm 下载依赖太慢怎么办？

把 npm 源换成国内的 npmmirror 镜像，是中文教程里最常用的办法。在命令行运行：

npm config set registry https://registry.npmmirror.com
npm config get registry

第二条命令输出镜像地址即说明生效，然后重新运行 Start.bat 或 start.sh。Node.js 安装包下载慢，也可以从 npmmirror 的 Node 镜像目录下载对应 LTS 版。GitHub 克隆慢时，可以加 --depth 1 只下载最新一版代码，体积小很多：

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

不建议使用网上来源不明的「GitHub 加速地址」或网盘整合包，这类渠道无法确认代码是否被改动过。

要不要用 Docker？

只在你已经熟悉 Docker 时才推荐。官方推荐用 Docker Compose：

git clone https://github.com/SillyTavern/SillyTavern && cd SillyTavern/docker
docker compose up -d

镜像为 ghcr.io/sillytavern/sillytavern:latest，默认把容器的 8000 端口映射到本机 8000，配置和数据挂载在 docker 目录下的 config、data 文件夹。Windows、macOS 需先装 Docker Desktop。

怎么更新和备份？

用 Git 安装的酒馆，在 SillyTavern 目录运行 git pull，再重新启动即可。如果提示本地文件冲突，官方文档建议用 git pull --rebase --autostash。release 分支约每月更新一次，当前稳定版为 2026-09-14 发布的 1.19.0。

你的角色卡、聊天记录、世界书都在 data/default-user/ 文件夹，API Key 存在根目录的 secrets.json。更新前把这两样复制到别处备份，换电脑时也是拷贝这两样。

常见问题

酒馆需要什么版本的 Node.js？ 官方要求 Node.js 20 或更高，建议最新 LTS。Node 20 已于 2026-04-30 停止维护，装 nodejs.org 首页的 LTS 版即可。

Windows 上酒馆装在哪个文件夹？ 装在自己建的普通文件夹里。不要装在 Program Files、System32 等系统目录，也不要用管理员身份运行 Start.bat。

git clone 太慢或失败怎么办？ 加 --depth 1 减少下载量，或在网络通畅时重试；依赖安装慢就把 npm 源换成 npmmirror。

Launcher、手动 Git、Docker 选哪个？ 新手选手动 Git 或 Launcher；Docker 适合已经在用 Docker 的人或服务器部署。

安装完怎么打开酒馆？ 启动脚本运行后浏览器会自动打开 http://localhost:8000，没弹出就手动输入。

怎么更新酒馆？会不会丢角色和聊天记录？ 在酒馆目录运行 git pull 后重启，正常更新不会动 data 文件夹；更新前仍建议备份 data/default-user。

Mac 上提示 Permission denied 怎么办？ 运行 chmod +x start.sh 后再执行，或直接用 bash start.sh。

装好之后下一步是接模型：DeepSeek（国内直连）、Gemini API、Claude API，报错见 酒馆常见报错。还没了解酒馆是什么，先看 新手 30 分钟上手。

参考来源

常见问题

酒馆需要什么版本的 Node.js？

官方文档要求 Node.js 20 或更高，并建议装最新 LTS 版。Node 20 已于 2026-04-30 停止维护，2026-10-28 起 Node 26 是 Active LTS，装 nodejs.org 首页标注的 LTS 版即可。

Windows 上酒馆装在哪个文件夹？

装在自己建的普通文件夹里，比如 D 盘下的 AI 文件夹。官方明确不要装在 Program Files、System32 等系统目录，也不要用管理员身份运行 Start.bat。

git clone 太慢或失败怎么办？

可以加 --depth 1 只下载最新代码，减少下载量；或在网络通畅时重试。依赖安装慢可以把 npm 源换成国内的 npmmirror 镜像。

Launcher、手动 Git、Docker 选哪个？

新手在 Windows 上选手动 Git 或 Launcher 都行，Launcher 会帮你装 Git 和 Node.js 并提供更新菜单；Docker 适合已经在用 Docker 的人或服务器部署。

安装完怎么打开酒馆？

运行 Start.bat 或 start.sh 后，浏览器会自动打开 http://localhost:8000。如果没有自动弹出，手动在浏览器输入这个地址即可。

怎么更新酒馆？会不会丢角色和聊天记录？

在酒馆目录运行 git pull，再重新启动即可，正常更新不会动 data 文件夹。更新前建议整体备份 data/default-user 文件夹。

Mac 上提示 Permission denied 怎么办？

说明 start.sh 没有执行权限，在酒馆目录运行 chmod +x start.sh 后再执行 ./start.sh，或直接用 bash start.sh 启动。

#SillyTavern#酒馆#安装教程#Windows#macOS#Node.js
苏苏

AI 陪伴重度用户，2023 年起玩 Character.AI 和酒馆，负责本站教程的实测与更新。

相关阅读