米尼尼
发布于 2026-01-23 / 5 阅读
0

Docker 部署 SillyTavern

在 1Panel 面板下安装 SillyTavern(也就是大家常说的“酒馆”),最稳妥、最干净的方式是使用 Docker 部署。


准备工作

  • ​前提​:你已经安装好了 1Panel 面板。

  • ​网络​:由于 SillyTavern 的镜像在 GitHub 容器库(ghcr.io),国内网络拉取可能较慢,请耐心等待或确保服务器网络通畅。


第一步:拉取镜像 (Pull Image)

这一步是为了先把安装包下载下来。

  1. 登录你的 1Panel 面板。

  2. 点击左侧导航栏的 ​「容器」​。

  3. 点击顶部的 「镜像」 标签页。

  4. 点击 「拉取镜像」 按钮。

镜像来源: 直接输入

镜像名称: ghcr.io/sillytavern/sillytavern:release

(建议使用 release 版本,比较稳定)

  1. 点击 ​「确认」​。

    • 此时右下角会有提示“正在拉取镜像”,等待它显示“拉取成功”即可。


第二步:创建本地数据文件夹

为了防止以后升级容器导致你的老婆/老公(角色卡)、聊天记录丢失,我们需要在主机上建立文件夹来挂载。

  1. 点击左侧导航栏的 「主机」 -> ​「文件」​。

  2. 进入 /opt​ 目录(或者你喜欢的任何目录)。

  3. 点击 「新建」 -> ​「文件夹」​,命名为 sillytavern​。

  4. 进入 sillytavern​ 文件夹,再分别新建三个子文件夹:

    • ​config​ (放配置文件)

    • ​data​ (放角色卡、背景、聊天记录)

    • ​plugins​ (放插件)

最终你的目录结构应该是这样的:

/opt/sillytavern/
├── config/
├── data/
└── plugins/

第三步:创建并运行容器 (核心步骤)

  1. 回到 「容器」 菜单,点击 「容器」 列表页。

  2. 点击蓝色的 「创建容器」 按钮。

1. 基础信息

配置项

填写/选择内容

说明

名称

​sillytavern​

给容器起个名字

镜像

​ghcr.io/sillytavern/sillytavern:release​

选择刚才下载的镜像

重启策略

​总是重启 (Always)​

保证服务器重启后酒馆自动开门

2. 端口设置 (Port)

点击“添加”按钮。

容器端口

主机端口

协议

​8000​

​8000​

TCP

(如果主机的 8000 端口被占用了,主机端口可以改成 8001 或其他)

3. 挂载 (Volumes) —— 最重要的一步!

点击“添加”按钮,我们需要添加 3条 挂载记录,把刚才建立的文件夹对应上去。

挂载方式

本地路径 (主机)

容器路径 (内部)

权限

本机目录

​/opt/sillytavern/config​

​/home/node/app/config​

读写

本机目录

​/opt/sillytavern/data​

​/home/node/app/data​

读写

本机目录

​/opt/sillytavern/plugins​

​/home/node/app/plugins​

读写

⚠️ 注意:容器路径必须严格填写,不能写错,否则你的数据存不进去。

早期版本的容器路径可能是 /home/node/app/public,但新版推荐用 /home/node/app/data。

4. 网络

  • ​网络模式​:选择 bridge​ (默认即可)。

5. 完成

  • 点击右下角的 「确认」 按钮。


第四步:访问酒馆

  1. 等待容器状态显示为 ​「运行中」​(绿色图标)。

  2. 打开你的浏览器。

  3. 在地址栏输入:
    http://你的服务器IP:8000
    (如果你刚才修改了主机端口,请用修改后的端口)

此时,你应该能看到 SillyTavern 熟悉的木纹界面了!🎉


常见问题 (Troubleshooting)

Q1: 打开网页一直转圈,无法访问?

  • ​检查防火墙​:去 1Panel 的 「主机」 -> 「防火墙」 页面,确认 8000 端口已经放行。

  • ​云服务器安全组​:如果你用的是腾讯云、阿里云等,记得去云厂商的控制台“安全组”里,把 8000 端口(TCP)打开。

Q2: 怎么导入角色卡?

  • ​方法A (网页)​:直接在网页界面左侧的“角色”栏,点击导入图标。

  • ​方法B (文件)​:直接把你下载的 .png​ 或 .json​ 角色卡扔进服务器的 /opt/sillytavern/data/default-user/characters​ 目录里,然后刷新网页即可。

Q3: 如何更新酒馆版本?

  1. 在 1Panel 「容器」 -> 「容器」 列表中,找到 sillytavern​。

  2. 点击右侧的 「更多」 -> ​「重建」​。

  3. 勾选 「拉取最新镜像」,然后点击确认。
    (因为我们挂载了数据目录,所以重建容器不会丢失你的角色和聊天记录)