# Docker 安装指南 规范地址：https://xstavern.com/wiki/installation/docker/ 原文：https://sillytaverncn.net/installation/docker/ 核对日期：2026-11-03 授权迁移，保留作者、上游许可与出处。 Docker 安装指南 # Docker 安装指南 !!! info 本指南假设您在非 root（非管理员）文件夹中安装 SillyTavern。如果您在 root 文件夹中安装 SillyTavern，您可能需要使用管理员权限运行某些命令[`sudo`、`doas`、Command Prompt (Administrator)]。 !!! !!!success :beer: 不想折腾 Docker？试试一键启动器 Docker 很强大，但如果你只是想在本地流畅玩酒馆，一键启动器更省心 — 零依赖、原生运行、自动更新。 :arrow_right: [下载一键启动器](https://launch.deepseektavern.com) --- ## 安装 ### Linux 1. 请按照[此处](https://docs.docker.com/engine/install/)的 Docker 安装指南安装 Docker。 !!! danger **不要**安装 Docker Desktop。 !!! 2. 按照 Docker [安装后配置指南](https://docs.docker.com/engine/install/linux-postinstall/)中的**以非 root 用户身份管理 Docker**部分进行操作。 3. 使用包管理器安装 [Git](https://git-scm.com/download/linux)。 - Debian (Ubuntu/Pop! OS/等) ```sh sudo apt install git ``` - Arch Linux (Manjaro/EndeavourOS/等) ```sh sudo pacman -S git ``` - Fedora, Red Hat Enterprise Linux (RHEL), 等 ```sh sudo dnf install git ``` 4. 克隆 SillyTavern 仓库。 - Release (稳定分支) ```sh git clone https://github.com/SillyTavern/SillyTavern && cd SillyTavern/docker ``` - Staging (开发分支) ```sh git clone https://github.com/SillyTavern/SillyTavern -b staging && cd SillyTavern/docker ``` 5. 在 Docker 文件夹中运行以下命令执行 `docker compose`。 ```sh docker compose up -d ``` 6. 执行以下 Docker 命令获取 SillyTavern Docker 容器的 IP 地址。 ```sh docker network inspect docker_default ``` 您应该会看到类似下面的输出： ```json [ { "Name": "docker_default", "IPAM": { "Config": [ { "Subnet": "172.18.0.0/16", "Gateway": "172.18.0.1" } ] } } ] ``` 记下您在 _Gateway_ 中看到的 IP 地址，这很重要。 7. 使用 `sudo` 打开 `nano` 并运行以下命令： ```sh sudo nano config/config.yaml ``` 在 `nano` 中，找到 `whitelist`。您应该会看到类似下面的内容： ```yaml whitelist: - 127.0.0.1 ``` 在 _127.0.0.1_ 下面添加一行，输入您从 Docker 复制的 IP 地址。完成后应该类似这样： ```yaml whitelist: - 127.0.0.1 - 172.18.0.1 ``` 按 _Ctrl+S_ 保存文件，然后按 _Ctrl+X_ 退出 `nano`。 !!! info 注意，如果您将 Docker 网络配置为桥接模式，您也可以像往常一样将外部 IP 地址添加到白名单中。 !!! 8. 重启 Docker 容器以应用新配置。 ```sh docker compose restart sillytavern ``` 9. 打开新的浏览器并访问 [http://localhost:8000](http://localhost:8000)。几分钟后您应该就能看到 SillyTavern 加载完成。 10. 尽情享用！ :D ### Windows !!! warning 关于 Windows 上的 Docker 在 Windows 上使用 Docker **非常**复杂。您不仅需要在"启用或关闭 Windows 功能"中激活 _Windows Subsystem for Linux_，还需要为虚拟化配置系统（Intel VT-d/AMD SVM），这因 PC 制造商（或主板制造商）而异。有时，某些系统上甚至没有这个选项。 强烈建议您按照我们的 [Windows](/Installation/Windows.md) 指南安装 SillyTavern。本节仅是在 Windows 上安装的一个_粗略_思路。 !!! 1. 按照[此处](https://docs.docker.com/desktop/setup/install/windows-install/)的 Docker 安装指南安装 Docker Desktop。 2. 安装 [Git for Windows](https://git-scm.com/download/win)。 3. 克隆 SillyTavern 仓库。 - Release (稳定分支) ```sh git clone https://github.com/SillyTavern/SillyTavern && cd SillyTavern/docker ``` - Staging (开发分支) ```sh git clone https://github.com/SillyTavern/SillyTavern -b staging && cd SillyTavern/docker ``` 4. 在 Docker 文件夹中运行以下命令执行 `docker compose`。 ```sh docker compose up -d ``` 5. 执行以下 Docker 命令获取 SillyTavern Docker 容器的 IP 地址。 ```sh docker network inspect docker_default ``` 您应该会看到类似下面的输出： ```json [ { "Name": "docker_default", "IPAM": { "Config": [ { "Subnet": "172.18.0.0/16", "Gateway": "172.18.0.1" } ] } } ] ``` 记下您在 _Gateway_ 中看到的 IP 地址，这很重要。 6. 以管理员权限运行 _Notepad_ 或您选择的代码编辑器，进入 `config` 目录并打开 _config.yaml_。 在您选择的编辑器中，您应该会看到类似下面的内容： ```yaml whitelist: - 127.0.0.1 ``` 在 _127.0.0.1_ 下面添加一行，输入您从 Docker 复制的 IP 地址。完成后应该类似这样： ```yaml whitelist: - 127.0.0.1 - 172.18.0.1 ``` 按 _Ctrl+S_ 保存文件，然后退出编辑器。 !!! info 注意，如果您将 Docker 网络配置为桥接模式，您也可以像往常一样将外部 IP 地址添加到白名单中。 !!! 7. 重启 Docker 容器以应用新配置。 ```sh docker compose restart sillytavern ``` 8. 打开新的浏览器并访问 [http://localhost:8000](http://localhost:8000)。几分钟后您应该就能看到 SillyTavern 加载完成。 9. 尽情享用！ :D ### macOS !!! 尽管 macOS 与 Linux 类似，但它没有 Docker Engine。您需要像 Windows 一样安装 Docker Desktop。 您还需要安装 [Homebrew](https://brew.sh/) 以在 Mac 上安装 Git。本节仅是在 macOS 上安装的一个_粗略_思路。 !!! 1. 按照[此处](https://docs.docker.com/desktop/setup/install/mac-install/)的 Docker 安装指南安装 Docker Desktop。 2. 使用 Homebrew 安装 `git`。 ```sh brew install git ``` 3. 克隆 SillyTavern 仓库。 - Release (稳定分支) ```sh git clone https://github.com/SillyTavern/SillyTavern && cd SillyTavern/docker ``` - Staging (开发分支) ```sh git clone https://github.com/SillyTavern/SillyTavern -b staging && cd SillyTavern/docker ``` 4. 在 Docker 文件夹中运行以下命令执行 `docker compose`。 ```sh docker compose up -d ``` 5. 执行以下 Docker 命令获取 SillyTavern Docker 容器的 IP 地址。 ```sh docker network inspect docker_default ``` 您应该会看到类似下面的输出： ```json [ { "Name": "docker_default", "IPAM": { "Config": [ { "Subnet": "172.18.0.0/16", "Gateway": "172.18.0.1" } ] } } ] ``` 记下您在 _Gateway_ 中看到的 IP 地址，这很重要。 6. 使用 `sudo` 打开 `nano` 并运行以下命令。 ```sh sudo nano config/config.yaml ``` !!! 如果无法运行 `nano`，请通过 Homebrew 安装，或改用 TextEdit。 !!! 在 `nano` 中向下找到 `whitelist`，你应该会看到类似下面的内容。 ```yaml whitelist: - 127.0.0.1 ``` 在 _127.0.0.1_ 下面新增一行，填入从 Docker 复制的 IP 地址。完成后应类似如下。 ```yaml whitelist: - 127.0.0.1 - 172.18.0.1 ``` 按 _Ctrl+S_ 保存文件，然后按 _Ctrl+X_ 退出 `nano`。 !!! info 注意：如果你将 Docker 网络配置为 bridge 模式，也可以像平时一样把外部 IP 地址加入白名单。 !!! 7. 重启 Docker 容器以应用新配置。 ```sh docker compose restart sillytavern ``` 8. 打开一个新浏览器并访问 [http://localhost:8000](http://localhost:8000)。稍等片刻即可看到 SillyTavern 加载完成。 9. 享受吧！:D ## 配置 SillyTavern SillyTavern 的配置文件（config.yaml）位于 `config` 文件夹内。配置方式与非 Docker 安装没有区别，但保存修改时需要以管理员权限运行 `nano` 或代码编辑器。 !!! warning 别忘了重启 SillyTavern 的 Docker 容器以应用更改！请确保在 `docker` 文件夹内执行此命令。 ```sh docker compose restart sillytavern ``` !!! ## 查找用户数据 SillyTavern 的数据目录位于 `data` 文件夹中。备份文件很容易，但恢复或添加内容时可能需要管理员权限。 ## 运行服务端插件 在 Docker 中运行 [HoYoWiki-Scraper-TS](https://github.com/Bronya-Rand/HoYoWiki-Scraper-TS) 或 [SillyTavern-Fandom-Scraper](https://github.com/SillyTavern/SillyTavern-Fandom-Scraper) 等插件，与不使用 Docker 时没有区别，但需要对 Docker Compose 脚本做一点小修改。 !!! Note 如果在 `docker` 文件夹内已看到 _plugins_ 文件夹，可跳过步骤 1-2。 !!! 1. 使用 `nano` 或代码编辑器打开 _docker-compose.yml_，在 `volumes` 下添加如下内容。 ```sh volumes: - "./config:/home/node/app/config" - "./data:/home/node/app/data" - "./plugins:/home/node/app/plugins" ``` 2. 在 `docker` 文件夹中创建一个名为 _plugins_ 的新文件夹。 3. 按插件的说明进行安装。 4. 使用 `nano` 或具备管理员权限的代码编辑器打开 `config` 文件夹内的 _config.yaml_，并启用 `enableServerPlugins` ```sh enableServerPlugins: true ``` 5. 重启 Docker 容器。 ```sh docker compose restart sillytavern ``` 6. 完成。 许可与致谢：https://xstavern.com/wiki/licensecredits/