Appearance
Mac 本地部署教程
说实话，一开始我也觉得在 Mac 上部署酒馆挺复杂的，但其实真的不难，跟着步骤走，你也能成功！
写在前面
- 整个过程大概需要 10-20 分钟，取决于你的网速
- 所有命令我都会告诉你怎么复制，不用担心输错
- 如果遇到问题，可以拉到最后的常见问题部分看看
一、确认系统版本
这一步的目的：确认你的 Mac 系统版本是否满足要求。
第一步：检查系统版本
这一步在干什么？
因为我们需要安装 Homebrew（Mac 的软件管理工具），而 Homebrew 需要 macOS 13（Ventura）及以上版本。
- 点击顶部状态栏的 图标
- 点击"关于本机"
- 查看"macOS"后面的版本号
如果版本号是 13.0 或更高，就继续下一步。
如果你的系统版本低于 13.0？
请到"系统设置"中更新你的系统。
如果电脑太老，无法安装 13.0 及以上的系统？可以先尝试安装 Homebrew，如果安装不上，就只能放弃了。
二、安装 Homebrew
这一步的目的：安装 Homebrew，这是 Mac 上的软件包管理工具，后面的 Git 需要通过它来安装。
第一步：下载 Homebrew 安装包
这一步在干什么？
从 GitHub 下载 Homebrew 的安装包。
下载地址：https://github.com/Homebrew/brew/releases
- 打开上面的链接
- 找到最顶部的最新版本
- 点击展开 Assets
- 点击 Homebrew-xxx.pkg 下载安装包（xxx 一般是版本号）
第二步：安装 Homebrew
下载后双击运行安装包，一路点"继续"、"同意"，需要验证的话就输入你的电脑密码。
如果 Homebrew 请求权限，就直接允许。
如果安装出错？
如果遇到错误 Command Line Tools (CLT) are missing，需要先安装命令行开发工具：
打开终端（搜索"终端"或按 Cmd + 空格 搜索 Terminal），输入：
bash
xcode-select --install这行命令在干什么？
安装 macOS 的命令行开发工具，这是 Homebrew 依赖的东西。
点击弹出的"安装"按钮，等待安装完成。安装完成后，重新运行 Homebrew 安装包就行。
验证安装：
bash
xcode-select -p这行命令在干什么？
检查命令行工具是否安装成功。如果返回路径（比如 /Library/Developer/CommandLineTools），就说明成功了。
第三步：验证安装
这一步在干什么？
打开终端，检查 Homebrew 是否安装成功。
- 点击 Dock 栏上的"启动台"图标（或按
F3） - 在搜索栏输入"终端"，打开它
- 输入以下命令：
bash
brew -v这行命令在干什么？
检查 Homebrew 的版本号。如果显示类似 Homebrew 4.x.x，就说明安装成功啦！
三、安装 Node.js
这一步的目的：安装 Node.js，这是运行酒馆必需的环境。简单来说，酒馆是用 JavaScript 写的，Node.js 就是让 JavaScript 能在电脑上运行的工具。
第一步：下载 Node.js
下载地址：https://nodejs.org/zh-cn/download
这一步在干什么？
根据你的 Mac 芯片类型选择对应的版本：
- Intel 芯片：选择 x64，然后点击"macOS 安装程序（.pkg）"下载
- M 系列芯片（M1/M2/M3）：选择 Arm64，然后点击"macOS 安装程序（.pkg）"下载
不知道怎么查看芯片类型？
点击 图标 → "关于本机" → 查看"芯片"一栏。
第二步：安装 Node.js
下载后双击运行安装包，一路点"继续"、"同意"，需要验证的话就输入你的电脑密码。
如果 Node 请求权限，就直接允许。
四、安装 Git
这一步的目的：Git 是用来从网上下载酒馆代码的工具，需要先安装它。
第一步：安装 Git
这一步在干什么？
通过 Homebrew 安装 Git。
打开终端，输入：
bash
brew install git这行命令在干什么？
让 Homebrew 下载并安装 Git。
如果网络没问题的话，就会开始下载安装 Git 了。全程无需操作，静静等待安装完成就行。
当你再次看到命令行提示符（类似 你的电脑名:~ 你的用户名$），就代表安装完成。
第二步：验证安装
这一步在干什么？
验证 Git 和 Node.js 是否都安装成功。
在终端中输入以下命令（可以直接复制粘贴，可以一次性执行多行）：
bash
git -v
node -v
npm -v这些命令在干什么？
git -v：检查 Git 的版本号node -v：检查 Node.js 的版本号npm -v：检查 npm（Node.js 的包管理器）的版本号
如果每一行都显示版本号，就说明全部安装成功啦！
如果提示"command not found"？
如果提示 -bash: xxx: command not found（xxx 是某个命令名），就代表那个工具没安装成功。根据教程重新安装对应的工具。
五、下载酒馆
这一步的目的：从网上下载酒馆的代码文件。
第一步：下载酒馆代码
这一步在干什么？
运行 git clone 命令，从 GitHub 下载酒馆的代码文件，并保存到你的用户文件夹下。
在终端中输入：
bash
git clone https://github.com/SillyTavern/SillyTavern.git -b release这行命令在干什么？
从 GitHub 官方仓库下载酒馆代码，-b release 表示下载稳定版分支。Git 会自动在你的用户文件夹下生成一个 SillyTavern 文件夹。
等待下载完成，看到 100% 和 done 就表示成功了！
提示
这一步速度根据你的网络速度而定，如果出错，大概率是网络问题。可以尝试使用魔法网络。
六、安装依赖
这一步的目的：安装酒馆运行所需的依赖文件，就像给游戏安装补丁一样。
第一步：进入酒馆文件夹
这一步在干什么？
切换到酒馆的文件夹，准备安装依赖。
bash
cd ~/SillyTavern这行命令在干什么？
进入你刚才下载的 SillyTavern 文件夹。~ 代表你的用户主目录。
第二步：安装依赖包
bash
npm install这行命令在干什么？
让 npm 读取 package.json 文件，自动下载并安装所有需要的依赖包。
等待安装完成，看到新的命令行提示符出现，就说明成功了！
七、启动酒馆
这一步的目的：运行酒馆服务，让酒馆在你的 Mac 上运行起来！
第一步：启动酒馆
这一步在干什么？
进入酒馆文件夹并启动酒馆服务。
bash
cd ~/SillyTavern && ./start.sh这行命令在干什么？
先进入酒馆文件夹，然后运行启动脚本。酒馆就会开始运行，然后自动打开浏览器。
小贴士
- 第一次启动会比较慢，可能需要等一两分钟，后面再启动就会快很多
- 初次打开可能会长时间白屏，直接刷新页面即可
第二步：访问酒馆
正常情况下，浏览器会自动打开酒馆（访问 http://127.0.0.1:8000）。
如果没有自动打开，就自己打开浏览器，输入：
http://127.0.0.1:8000看到这个界面就表示成功了！记得在设置里把语言改成中文哦~
千万要注意
在使用酒馆的过程中，这个终端窗口不能关闭！
它必须一直运行，酒馆才能正常使用。你可以把它最小化，但不能关掉。
日常使用技巧
每次怎么启动？
最简单的方式，打开终端，输入：
bash
cd ~/SillyTavern && ./start.sh你可以把这行命令保存在备忘录里，每次复制粘贴就行。
怎么更新酒馆？
酒馆大概每月会更新一次，更新的方法：
bash
cd ~/SillyTavern && git pull这行命令在干什么？
进入酒馆文件夹，然后拉取最新版本的代码。
提示
你刚安装完酒馆的时候是不需要更新的，已经是最新版。酒馆的稳定版本每个月更新一次。
常见问题
Q: 找不到终端怎么办？
按 Cmd + 空格 打开聚焦搜索，输入"终端"或"Terminal"就能找到。
Q: Homebrew 安装失败怎么办？
检查网络是否正常，确认系统版本是否满足要求（macOS 13+）。
Q: 提示"command not found"怎么办？
说明某个工具没安装成功，根据教程重新安装对应的工具（Git 或 Node.js）。
Q: 下载酒馆时速度很慢怎么办？
这通常是网络问题，可以尝试使用魔法网络，或者换个时间段再试。
Q: 可以在其他设备上访问 Mac 上的酒馆吗？
可以！在局域网内，通过手机、平板等设备都可以访问。需要在酒馆配置文件中修改设置。详细方法可以参考进阶教程。
最后想说
其实 Mac 部署酒馆真的很简单，只要你按部就班地来，肯定能成功！
如果遇到了什么奇怪的问题，或者想和其他玩家交流，欢迎来我们的 QQ 群：216189515
群里大家都很友好，有问题就问，不用害羞~
下一步：
- 想了解其他部署方式？看看 安卓本地部署 或 Windows 本地部署
- 想对比不同部署方式？回到 部署方式对比