马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。
您需要 登录 才可以下载或查看，没有帐号？免费注册
x
SillyTavern 本地部署完全指南（新手友好版）从零开始，把「酒馆」跑在你自己电脑上。全程只用一个黑窗口，不需要懂编程，不需要好显卡。
写在最前面：这是什么，以及它不是什么SillyTavern（中文圈叫「酒馆」）是一个聊天界面软件，开源、免费、装在你自己电脑上。 它最核心的用途，是和虚构角色进行沉浸式对话或共同创作故事。你可以导入别人做好的「角色卡」，也可以自己写一个角色，然后跟它聊天、推进剧情、写长篇故事。 但要先把一件事说清楚： 酒馆自己不会说话这一点无数新手搞混，所以放第一条。 酒馆只是一个界面。它负责显示对话、管理角色、保存记录——但它没有内置任何 AI。 你必须给它接一个「大脑」（也就是 AI 模型），它才能工作。 用一个比喻来理解： [td]| 组成部分 | 作用 | 类比 | | SillyTavern | 聊天界面 | 电视机屏幕 | | AI 模型 | 真正生成文字的东西 | 电视台信号 | | API 连接 | 把两者连起来的设置 | 有线电视线 |
所以本教程的全部工作就是三件事： - 装屏幕（安装 SillyTavern）
- 拉根线（配置 API 连接）
- 接上信号（连到某个 AI 模型）
开始之前：你需要什么硬件要求几乎没有要求。 - 一台能正常上网的 Windows 10 或 11 电脑（本教程以 Windows 为例）
- 内存 4G 以上（现在的电脑基本都满足）
- 不需要独立显卡
- 不需要高性能 CPU
⚠️ Windows 7 用户请注意：装不了。SillyTavern 需要 Node.js 20 以上版本，而 Win7 跑不了新版 Node.js。请使用 Win10 / Win11。
因为本教程走的是「在线 API」路线——AI 在服务商的服务器上跑，你的电脑只负责显示文字。 补充说明：酒馆也支持在自己电脑上跑 AI 模型（本地推理）。那条路免费、隐私性更好，但需要一块显存 8G 以上的 N 卡，配置也复杂得多。本教程不讲，适合新手跑通之后再研究。
费用说明在线 API 按量计费，用多少算多少。 好消息是：新用户注册通常会送免费额度，够你玩一段时间。建议你先注册一个、把整条流程跑通、确认自己真的用得上，再决定要不要充值。 时间预估- 首次安装：约 20～40 分钟（其中大部分是等待下载）
第一章：安装 Node.jsSillyTavern 是基于 Node.js 运行的程序。你可以把 Node.js 理解成「让这类软件能在你电脑上跑起来的一个基础环境」。 1.1 下载- 打开 https://nodejs.org/
- 你会看到两个绿色按钮
- 点左边那个，标注 LTS 的（LTS = 长期支持版，更稳定）
右边那个是最新版，功能新但可能不稳定。新手请用 LTS。
- 下载得到的是一个 .msi 文件
1.2 安装- 双击 .msi 文件
- 一路点 Next
- 中间会出现一个勾选框，问是否自动安装必要工具——保持默认即可
- 点 Install，等它走完
所有选项都用默认值就行，不需要改任何设置。 1.3 重启电脑（重要）安装完成后，请重启一次电脑。 为什么要重启？ Node.js 安装后会往系统里注册一个叫「环境变量」的东西，好让你在任何地方都能调用它。但这个注册有时要重启后才生效。 不重启可能出现「明明装了却提示找不到命令」的玄学问题——这是新手最大的劝退点之一。省这几分钟，可能浪费后面一小时排查。
1.4 验证是否装好- 按键盘上的 Win 键
- 直接输入 cmd
- 回车，会弹出一个黑窗口（命令提示符）
- 在黑窗口里输入下面这行，然后回车：
bash
node -v
如果成功，你会看到类似这样的输出：
v24.21.0
只要出现 v 开头的版本号就说明装好了，数字具体是多少不重要（Node.js 长期支持版会持续更新，截至 2026 年 9 月是 v24.x）。 唯一需要担心的：如果版本号小于 v20（比如 v18.x、v16.x），说明装的是老版本，SillyTavern 跑不起来。请去官网重新下载最新的 LTS 版本。
如果失败，会提示"不是内部或外部命令"之类的错误。解决办法： - 确认你重启过电脑了
- 重新打开一次黑窗口再试（有时要重开窗口才刷新）
- 如果还不行，卸载重装 Node.js，这次全程不要修改任何安装路径
第二章：获取 SillyTavern2.1 下载下载完成后得到一个压缩包。 2.2 解压到「干净」的路径把压缩包解压出来。 这一步有个关键注意事项： 解压后的文件夹路径，请满足： - ✅ 不要放在 Windows 系统管控的文件夹里（Program Files、System32、Windows 等）
- ✅ 不要放在桌面或文档（这些目录常被系统监控和同步，容易出权限问题）
- ✅ 不包含中文
- ✅ 不包含空格
- ✅ 尽量短
推荐的路径：
D:\SillyTavern
C:\SillyTavern
要避免的路径（这些都是新手真实踩过的坑）：
C:\Program Files\SillyTavern\ ← 系统管控目录C:\Users\张三\Desktop\我的软件\AI 聊天\ ← 桌面 + 中文 + 空格D:\新建文件夹\SillyTavern (1)\ ← 中文 + 空格
为什么这么讲究？有两层原因： 第一层是权限。 系统管控的文件夹（如 Program Files）需要管理员权限才能写入，而安装过程会频繁写文件。 第二层是编码。 很多底层工具对中文路径和空格的处理历史悠久地不完善。报错信息往往是一堆看不懂的英文，你完全没法把它和"路径里有空格"联系起来。 这不是迷信，是无数人用几小时的排查时间换来的经验。花 10 秒选个干净路径，值。 ⚠️ 另外，不要用管理员身份运行 Start.bat。正常双击即可。用管理员权限反而会导致文件路径错乱。
解压完成后，打开文件夹，你应该能看到这样的结构：
SillyTavern/├── Start.bat ← 以后双击这个启动├── package.json├── server.js├── public/└── ...
看到 Start.bat 就说明找对地方了。
第三章：安装依赖这一步是整个教程唯一可能等很久的地方。 3.1 在当前文件夹打开命令行- 打开你解压出来的 SillyTavern 文件夹
- 点击窗口顶部的地址栏（就是显示路径的那一条）
- 地址栏里的文字会变成选中状态
- 直接输入 cmd 然后回车
会弹出一个黑窗口，而且窗口标题/路径显示的就是你的 SillyTavern 目录。 这一步很关键。黑窗口必须"站"在 SillyTavern 文件夹里，后面所有命令才有效。 如果你是从开始菜单打开的 cmd，路径会不对，命令就会失败。
3.2 执行安装命令在黑窗口里粘贴下面这行命令，回车：
bash
npm install
粘贴方法：在黑窗口里点右键即可粘贴（不能用 Ctrl+V）。
3.3 等待接下来屏幕上会快速滚动大量文字。这是正常的，不是报错。 根据网速不同，可能需要 2～15 分钟。 判断标准： - ✅ 屏幕一直在动、文字一直在滚 → 在进行中，等着就好
- ✅ 最后出现 added XXX packages 之类的字样 → 完成
- ❌ 出现大片红色文字，且最后有 npm ERR! → 出错了，看下方解法
耐心是第一生产力。这一步卡住的人，90% 只是因为网络慢。 3.4 如果失败了：换国内镜像源npm install 默认从国外服务器下载，国内网络有时会超时或中断。 解决方法，依次执行这两行：
bash
npm config set registry https://registry.npmmirror.com
bash
npm install
第一条命令是「把下载源换成国内的」，第二条重新执行安装。 绝大多数情况下，换源之后就顺利了。
第四章：启动依赖装完之后，在同一个黑窗口里执行：
bash
npm start
等待几秒，你会看到类似这样的输出：
SillyTavern is listening on: http://127.0.0.1:8000Go to the above URL in your browser to access the UI
打开界面在任意一个浏览器（Chrome、Edge 都行）的地址栏输入：
http://127.0.0.1:8000
回车。 如果一切正常，你会看到 SillyTavern 的聊天界面。 到这里，最难的部分其实已经过去了。 关于那个黑窗口这个黑窗口不能关。 它就是服务本身。关掉它，服务就停了，网页也就打不开了。 你有两种选择： - 方式一：每次想用的时候，手动启动（黑窗口保持开着，最小化即可）
- 方式二：以后直接双击文件夹里的 Start.bat，效果一样，更方便
小技巧：如果只是暂时不用，把黑窗口最小化就行，不用关。
第五章：接上「大脑」（最关键的一章）现在你有一个界面，但它还是空的。这一章我们给它接上 AI。 5.1 打开连接设置在界面左上角，找到一排小图标。 点击「插头」形状的图标（通常在第二个位置）。 或者：找到写着 API 的那一行，点它。 会进入连接配置页面。 5.2 认识这几个关键字段[td]| 字段 | 是什么 | 怎么填 | | API 类型 | 连接协议 | 新手统一选 Chat Completions | | API URL | 服务商的地址 | 见下方表格 | | API Key | 你的密钥 | 注册后在服务商后台获取 | | Model | 用哪个模型 | 连接成功后从下拉列表里选 |
5.3 各平台配置参数以下是国内能正常访问的几个主流选择。任选其一即可。 ① 硅基流动 SiliconFlow（新手推荐）推荐理由：国内直连速度快、模型种类最全（一个账号能用 DeepSeek、Qwen、GLM 等多家模型）、对新用户友好,新用户注册填写邀请码有16元的代金券。 注册后在左侧菜单找到 API 密钥，新建一个，复制那串 sk- 开头的内容。 连接成功后，在模型下拉列表里可以选择，比如： - deepseek-ai/DeepSeek-V4 — 综合能力强，适合长篇创作
- Qwen/Qwen2.5-72B-Instruct — 中文语感好
- THUDM/glm-4-9b-chat — 响应快，便宜
② DeepSeek 官方特点：对话质量高，价格便宜。但模型选择单一。 ③ 智谱 GLM④ OpenRouter（可访问海外服务）特点：一个账号接全球几百个模型，包括 Claude、GPT 等。新模型上架最快。 ⑤ 小米mimo特点：小米官方大模型服务，开源模型（MiMo 系列）与在线 API 同源。接口兼容 OpenAI 规范，配置方式与前述各平台一致。同样的新用户填写邀请码会给代金券，小米还有语言模型。
⑥ Google Gemini（有免费额度）连接成功后在模型下拉列表里选模型即可。 特点：免费额度足够日常把玩，适合零成本试水。
5.4 连接并测试填好上面三项后： - 点 Connect 按钮
- 等待几秒
- 如果成功：模型下拉列表会出现一堆可选模型，状态指示灯变绿
- 选择一个模型
- 点右上角的保存图标（软盘形状）
然后测试一下： 回到聊天界面，输入：
你好
如果有回复 —— 恭喜，全部搞定。 ✅
第六章：导入角色卡现在你的酒馆能说话了，但还没有角色。这一章我们给酒馆"招人"。 6.1 打开角色管理点击界面左上角第二个方块图标（角色管理 / Character Management）。 会看到角色列表页面。 6.2 导入支持两种格式： - .png 图片 — 最常见的角色卡格式，图片里内嵌了角色信息
- .json 文件 — 纯数据格式
你可能好奇：一张图片怎么存数据？ PNG 格式允许在图片里藏一段隐藏的文字信息（技术上叫「元数据 / metadata」），角色卡就利用了这一点。所以看起来是张立绘，其实里面写了角色设定。挺巧妙的。
- 导入后，角色会出现在列表里
- 点击角色头像 → 开始聊天
6.3 去哪里找角色卡国内渠道： - 酒馆中文社区、相关贴吧
- B 站专栏和视频简介区（很多 UP 主会分享）
- 各种 QQ 群 / Telegram 群
- discord的国内社区（类脑、旅途等）
国外渠道： 提醒：角色卡质量参差不齐。拿到一张卡先看它的简介和标签，有些卡设定很详细，有些只有一句话。
6.4 自己建一个角色如果你不想找现成的： - 角色管理页面 → 点 + New（或"新建"）
- 填写：
- Name：角色名字
- Description：角色外貌、性格、说话方式
- First Message：它的开场白
- 保存
写好 Description 是关键。 与其写"她很温柔"，不如写"她说话时会先停顿一下，习惯性把茶杯推到对方面前"。具体的细节比抽象形容词有效得多。
第七章：让它写得更好（三个够用的技巧）跑通之后，你可能会觉得 AI 回复有点"味儿"——太礼貌、太像客服、或者总在结尾总结。 这一章给三个改一处就见效的技巧，不讲大理论。 技巧一：换个模型试试这是最容易被忽略、但效果最明显的一步。 同一个角色卡，用不同模型跑出来的效果差别巨大： - 有的模型特别爱说教、爱总结
- 有的模型对话自然但记忆力差
- 有的模型中文语感好，有的翻译腔重
方法： 在连接设置里换个模型，聊十几轮感受一下。 不花钱的排查方式就是多试几个。找到对味的那个，比调半天参数有用。 技巧二：加一段 System PromptSystem Prompt 是「总指令」，AI 每次回复都会遵守它。 在哪设置： 聊天界面 → 右上角或左侧的菜单里找到 System Prompt（有的版本叫「系统提示词」）区域。 推荐一段通用设定：
你现在扮演 [角色名]。请以小说叙事的语气回复，不要使用客服腔或官方口吻。每次回复 150-300 字，聚焦当下的对话与动作。不要总结，不要说教，不要主动推进剧情。
把 [角色名] 换成你的角色名字。 这段提示词做了几件事： - 指定了叙事语气
- 限定了字数（防止回复太长或太短）
- 禁掉了三个最常见的"AI 味"行为
技巧三：手动修一次，比调十次参数有用AI 的回复不理想时，你可以直接编辑它的回复。 在回复消息上找编辑按钮（通常是铅笔图标），改成你想要的样子，然后继续对话。 改完之后 AI 会沿着你改过的方向继续写。这比反复调参数快得多，也更可控。 很多人不知道这个功能，一直在调参。其实手动改一两次，AI 就"学会"你想要的调子了。
第八章：故障排查这一章按「症状 → 原因 → 解法」排列。遇到问题时直接搜关键词。 症状一：命令行提示"不是内部或外部命令"原因： Node.js 没装好，或环境变量没生效。 解法： - 确认装完 Node.js 后重启过电脑
- 重新打开一次黑窗口再试
- 还是不行就卸载重装，全程默认设置
症状二：npm install 大片红色报错原因： 网络问题（最常见），或路径不干净。 解法：
bash
npm config set registry https://registry.npmmirror.comnpm install
如果还报红，检查一下： - 文件夹路径是不是在 Program Files 或桌面上（见 2.2 节，换个目录重装）
- 文件夹路径有没有中文或空格
- 是不是用管理员身份运行的命令行（是的话关掉，重新用普通方式打开）
症状三：连不上 API / 点 Connect 没反应按顺序排查： - Key 有没有复制全？
- sk- 开头的整串，前后不要有空格
- 直接从后台的"复制"按钮复制，不要手动选
- URL 有没有多打东西？
- 结尾不要有斜杠
- 确认是 /v1 结尾，还是 /v1/，按上面表格里的原文照抄
- 账号里还有余额吗？
- 登录服务商后台看一眼。新用户的免费额度用完之后就连不上了
- 用了 Claude？
症状四：能连上，但发消息没回复可能原因和解法： - 余额耗尽 → 后台充值或换一个平台的 Key
- 模型名选错 → 重新点 Connect，下拉列表里重新选一个
- 服务端繁忙 → 等半分钟再试，或者换个模型
症状五：回复是乱码原因： 编码问题，通常是黑窗口的编码设置。 解法： 在黑窗口里执行：
bash
chcp 65001
然后重启 SillyTavern。
症状六：提示端口被占用
Error: listen EADDRINUSE: address already in use :::8000
原因： 8000 端口已经被别的程序占了，或者你之前启动的酒馆还没关掉。 解法一（简单）： 找到之前那个黑窗口，按 Ctrl + C 关掉它。 解法二（换端口）：
bash
npm start -- --port 8080
症状七：关掉黑窗口后再也打不开正常现象。 黑窗口就是服务本身。 重新双击 Start.bat，或者 npm start。
症状八：更新之后角色卡和聊天记录不见了原因： 更新时把整个文件夹覆盖了。 预防方法： 更新前只覆盖程序文件，保留 data 文件夹。 实际建议：
bash
# 更新前，先备份整个 SillyTavern 文件夹# 或者至少备份 data 目录
所有聊天记录、角色卡、设置都存在 data 文件夹里。重装系统前一定记得备份。
症状九：杀毒软件拦截，或启动时报「缺少模块」原因： 360、火绒、Windows Defender 等会误删依赖包。 解法： - 把 SillyTavern 文件夹加到杀毒软件白名单
- 或临时关闭杀毒软件，重新执行一次 npm install
症状十：重启后设置丢了原因： 大部分设置需要手动保存才会写入磁盘。 解法： - 改完 API 配置记得点右上角的保存图标（软盘形状）
- 想让「角色 + 预设 + 提示词」的组合固定下来，用 Preset（预设） 存一份
附加：想用手机访问
bash
ipconfig
找到「IPv4 地址」那行，比如 192.168.1.23
bash
npm start -- --listen
以上都没用？按顺序试这三招能解决 95% 的玄学问题： - 删掉重装。 整个文件夹删干净，重新解压、npm install。别舍不得，这比排查快。
- 换个目录。 从桌面挪到 D:\ 根目录，很多权限问题立刻消失。
- 复制报错原文去搜索。 黑窗口里最后几行红字，大概率已经有人踩过。
求助时请附上：系统版本、Node.js 版本（node -v）、黑窗口报错原文。只说一句"装不上"，没人帮得了你。
第九章：安全与合规提醒这一章不是走过场，请认真看。 关于账号和密钥- API Key 等同于银行卡密码，不要发给别人、不要截图发论坛
- 定期在后台查看用量，防止被盗刷
- 如果 Key 泄露了，立刻去后台删除重建
关于内容合规- 在线 API 服务商普遍有内容审核机制，这是服务条款的一部分
- 触发审核会导致拒答或输出中断，这是正常的规则约束，不是软件故障
- 各家服务商的审核尺度不同，请以你所选服务商的官方条款为准
- 使用时请遵守中国法律法规和服务商的使用条款
关于社区分享如果你要二次发布本教程或改动后发布： - 保留署名
- 不要插入推广链接或返利码而未作声明（会被社区判定为推广内容）
附录：一次成功的完整流程（速查版）给急着用的人，或者已经装过一遍想重装的人。
bash
# 1. 装 Node.js（https://nodejs.org/ 下载 LTS），装完重启# 2. 解压 SillyTavern 到 D:\SillyTavern# 3. 在该文件夹打开 cmd# 4. 装依赖（国内先换源）npm config set registry https://registry.npmmirror.comnpm install# 5. 启动npm start# 6. 浏览器打开 http://127.0.0.1:8000# 7. 插头图标 → Chat Completions# URL: https://api.siliconflow.cn/v1# Key: sk-你的密钥# → Connect → 选模型 → 保存# 8. 方块图标 → Import → 导入角色卡 → 开聊
最后如果教程有帮助，欢迎点赞收藏。 如果哪里卡住了、写错了、现在不管用了，欢迎在评论区留言——包括指出本文的错漏。软件更新很快，教程会过期，你的反馈能让它保持准确。 祝你玩得开心。
| 
发表于 
