![Gemini_Generated_Image_a28oh3a28oh3a28o.png](/static/img/3b4c9d345f3c7f362b89b7b5a5492a03.Gemini_Generated_Image_a28oh3a28oh3a28o.webp)

SillyTavern 更像是一个 AI 对话前端工具箱，适合把不同模型后端接到同一个界面里。这里记录本地 Docker 部署过程，先把能用的入口搭起来。



SillyTavern 是一个本地运行的 LLM（大语言模型）前端界面，支持多种后端 API。使用 Docker 部署它可以免去复杂的 Node.js 环境配置，并且方便升级和管理。

### 前提条件

在开始之前，请确保你的系统（Linux 服务器、NAS、Windows 或 macOS）已经安装了以下软件：

  * **Docker Engine**
  * **Docker Compose** (现在通常集成在 Docker Desktop 中，或作为 `docker compose` 插件)

### 第 1 步：准备工作目录

为了让 Docker 容器能够持久化保存你的数据，我们需要在宿主机上创建相应的文件夹，并将它们挂载到容器内部。

根据你提供的配置文件，我们需要以下四个目录：`config`、`data`、`plugins` 和 `extensions`。

1.  在你的服务器上找一个合适的位置，创建一个主目录，例如 `sillytavern-docker`：

    ```bash
    mkdir ~/sillytavern-docker
    cd ~/sillytavern-docker
    ```

2.  在主目录下提前创建好所需的子目录。这一步很重要，可以避免 Docker 以错误的权限自动创建这些目录。

    ```bash
    mkdir config data plugins extensions
    ```

    *如果你的宿主机是 Linux，建议确保当前用户对这些目录有读写权限。*

### 第 2 步：创建 docker-compose.yml 文件

在 `sillytavern-docker` 目录下，创建一个名为 `docker-compose.yml` 的文件。

```bash
touch docker-compose.yml
# 然后使用你喜欢的编辑器打开它，例如 nano 或 vim
nano docker-compose.yml
```
将提供的配置内容粘贴进去。

```yaml
version: '3.8' # 建议添加版本号，虽然现在是可选的

services:
  sillytavern:
    # build: ..  <-- 如果你不需要从本地源码构建，请注释掉这一行，直接用下面的官方镜像。
    image: ghcr.io/sillytavern/sillytavern:latest
    container_name: sillytavern
    hostname: sillytavern
    environment:
      - NODE_ENV=production
      - FORCE_COLOR=1 # 让日志输出带颜色
    ports:
      # 左侧是宿主机端口 (你访问的端口)，右侧是容器内端口。
      # 如果 8008 被占用，可以修改左侧的值，例如 "9090:8000"
      - "8008:8000"
    volumes:
      # 数据持久化挂载：将宿主机的目录映射到容器内部路径
      - "./config:/home/node/app/config"          # 存放配置文件
      - "./data:/home/node/app/data"              # 存放角色卡、聊天记录等核心数据
      - "./plugins:/home/node/app/plugins"        # 存放后端插件
      # 存放第三方前端扩展
      - "./extensions:/home/node/app/public/scripts/extensions/third-party"
    restart: unless-stopped # 除非手动停止，否则容器退出后自动重启（开机自启）
```

保存并退出编辑器。

### 第 3 步：启动服务

在包含 `docker-compose.yml` 的目录下，执行以下命令来后台启动服务：

```bash
docker compose up -d
```

*(如果你的 Docker 版本较旧，可能需要使用 `docker-compose up -d`)*

Docker 将会自动拉取镜像并启动容器。

### 第 4 步：访问 SillyTavern

稍等片刻，等待容器启动完毕。你可以通过浏览器访问 SillyTavern 的界面。

  * 访问地址：`http://你的服务器IP:8008`
  * 如果是在本机运行，访问：`http://localhost:8008`

*（如果你在配置文件中修改了 `ports` 的左侧端口，请使用修改后的端口访问。）*

[关于访问提示禁止Forbidden](https://st-docs.role.fun/usage/remoteconnections/)

关键点在于：whitelistMode: false

### 常用维护命令

**1. 查看日志**
如果无法访问或遇到错误，可以查看容器日志进行排查：

```bash
docker compose logs -f
```

*(按 `Ctrl + C` 退出日志查看)*

**2. 更新 SillyTavern**
当官方发布新版本时，更新非常简单：

```bash
# 1. 拉取最新镜像
docker compose pull

# 2. 重新创建并启动容器（你的数据都在本地目录里，不会丢失）
docker compose up -d
```

**3. 停止服务**

```bash
docker compose down
```

**4. 数据管理**
你的所有角色卡、聊天记录和设置现在都保存在你第 1 步创建的 `~/sillytavern-docker/data` 和 `config` 目录下。你可以随时备份这些文件夹。

本地部署SillyTavern（AI对话前端）

![Gemini_Generated_Image_3wp3br3wp3br3wp3.png](/static/img/6c424ce319114f99eaa32444594ea8ae.Gemini_Generated_Image_3wp3br3wp3br3wp3.webp)

容器更新最怕两个极端：完全不管，或者一看到 latest 就手贱升级。WUD 能先把镜像更新提醒出来，让 Docker 维护从“凭感觉”变成“先知道再决定”。



#### 第一步：准备企业微信机器人

在开始部署前，你需要先获取发送通知的“钥匙”。

1.  打开**企业微信**（电脑版或手机版）。
2.  进入你想要接收通知的**群聊**（或者创建一个新群，只有你一个人也可以）。
3.  点击群设置 -\> **添加群机器人** -\> **新创建一个机器人**（起个名字，比如“容器监控”）。
4.  添加成功后，你会得到一个 **Webhook 地址**。
5.  **复制**这个地址中 `key=` 后面的那串字符（这就是你的密钥）。

#### 第二步：创建配置文件

在你的服务器上创建一个目录，并新建 `docker-compose.yml` 文件。

1.  创建目录：
    ```bash
    mkdir -p /opt/wud
    cd /opt/wud
    ```
2.  创建/编辑文件：
    ```bash
    vim docker-compose.yml
    ```
3.  **粘贴以下内容**（请根据注释替换你的 IP 和 密钥）：



```yaml
services:
  whatsupdocker:
    image: getwud/wud:latest
    container_name: wud
    privileged: true
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - 3001:3000  # 左边是主机端口，可以根据需要修改
    environment:
      TZ: Asia/Shanghai

      # === 1. 代理配置 (重要：WUD需要联网检查更新) ===
      # 请修改为你的群晖/NAS/服务器的局域网IP
      HTTP_PROXY: http://192.168.31.221:20171
      HTTPS_PROXY: http://192.168.31.221:20171  # 即使是HTTPS代理，本地监听通常也是HTTP协议
      NO_PROXY: 127.0.0.0/8,192.168.0.0/16,localhost

      # === 2. 企业微信通知配置 ===
      # 替换下行末尾的 "你的密钥"
      WUD_TRIGGER_HTTP_WECHAT_URL: "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的密钥"
      WUD_TRIGGER_HTTP_WECHAT_METHOD: POST
      WUD_TRIGGER_HTTP_WECHAT_CONTENTTYPE: application/json
      WUD_TRIGGER_HTTP_WECHAT_TEMPLATE: '{"msgtype":"text","text":{"content":"[WUD警报] 容器 {{name}} 可升级: {{local}} -> {{remote}}"}}'
```

#### 第三步：启动服务

在包含 `docker-compose.yml` 的目录下运行：

```bash
docker-compose up -d
```

#### 第四步：验证与使用

1.  **访问仪表盘**：
    打开浏览器，访问 `http://你的服务器IP:3001`。如果你能看到 WUD 的绿色界面，列出了你当前的容器，说明启动成功。

2.  **测试更新检测**：
    WUD 启动后会立即开始第一次扫描。

      * 如果此时有容器需要更新，你的**企业微信**应该会立即收到一条消息。
      * 如果所有容器都是最新的，你可以手动找一个旧版本的镜像运行一个测试容器，来触发报警。

-----

### 💡 常见问题排查 (Troubleshooting)

  * **没有收到通知？**
    查看容器日志是解决问题的最快方法：

    ```bash
    docker logs -f wud
    ```

      * 如果你看到 `Connection timed out` 或 `proxy connect error`：说明 `HTTP_PROXY` 地址填错了，或者代理服务器拒绝了连接。
      * 如果你看到 `400 Bad Request`：说明 `TEMPLATE` 模版格式还有错，或者 Key 填错了。

  * **我想忽略某些容器？**
    有些容器（如数据库）你不希望它提示更新。你可以在**该容器**（不是 WUD）的 `labels` 中添加标签来忽略它：

    ```yaml
    labels:
      - "wud.watch=false"
    ```

docker部署wud（镜像更新提示工具）

![Gemini_Generated_Image_uz0p2zuz0p2zuz0p.png](/static/img/94808b9ca82896a8bc261133f8bcaa5f.Gemini_Generated_Image_uz0p2zuz0p2zuz0p.webp)

QD 框架适合把零散签到和自动化任务收起来统一跑。这里用 Docker Compose 部署一版，重点是目录、环境变量和后续迁移时怎么不丢配置。



# Docker 部署 Qiandao (QD-Today) 自动签到平台

本文介绍如何使用 Docker Compose 快速部署 **Qiandao** (基于 `qdtoday` 社区维护版)。该配置特别优化了网络设置，集成了代理服务以确保能顺利访问 Google、Telegram 等海外站点，并配置了 GitHub 加速以便快速拉取模板。

### 1\. 准备工作

  * 安装好 Docker 和 Docker Compose。
  * 准备好代理服务器（Clash/V2Ray 等），并确保开启了 **“允许局域网连接” (Allow LAN)** 功能。
  * 确认你的代理服务器局域网 IP（本例中为 `192.168.31.221`，请根据实际情况修改）。

### 2\. 配置文件 (`docker-compose.yml`)

新建一个目录（例如 `qd`），创建 `docker-compose.yml` 文件并填入以下内容：

```yaml
version: '3.8'

services:
  qd:
    # 使用 qdtoday 维护的最新版镜像，替代已停止更新的原版
    image: qdtoday/qd:latest
    container_name: qd
    
    # 端口映射：宿主机端口 16007 -> 容器端口 80
    # 访问地址：http://IP:16007
    ports:
      - "16007:80"
    
    # 数据持久化：将数据库和配置文件保存在宿主机，防止重启丢失
    # 请确保宿主机路径 /vol1/1000/qiandao 存在且有写入权限
    volumes:
      - /vol1/1000/qiandao:/usr/src/app/config
    
    environment:
      # 设置时区为上海，确保签到日志时间正确
      - TZ=Asia/Shanghai
      
      # 开启批量推送开关
      - PUSH_BATCH_SW=True
      
      # 配置 GitHub 加速代理，解决国内无法直接拉取公共模板库的问题
      - SUBSCRIBE_ACCELERATE_URL=https://ghfast.top/https://raw.githubusercontent.com
      
      # --- 代理配置 (关键) ---
      # 指向局域网内的代理服务器 IP 和端口
      # 注意：不要填 127.0.0.1，因为容器内的 localhost 并不是宿主机
      - HTTP_PROXY=http://192.168.31.221:20171
      - HTTPS_PROXY=http://192.168.31.221:20171
      
      # 设置不走代理的地址，防止容器内部通信或局域网通信异常
      - NO_PROXY=localhost,127.0.0.1,172.17.0.0/16
    
    # 容器崩溃或重启后自动重新启动
    restart: unless-stopped
```

### 3\. 启动服务

在终端进入该文件所在目录，运行以下命令：

```bash
# 启动容器并在后台运行
docker-compose up -d

# 查看运行日志（排查报错用）
docker-compose logs -f qd
```

### 4\. 初始化设置

1.  **访问平台**：打开浏览器访问 `http://你的服务器IP:16007`。
2.  **注册管理员**：你需要注册**第一个账号**，该账号将自动获得管理员权限。请务必第一时间完成此步骤。
3.  **测试网络**：登录后，进入“公共模板”，尝试点击“更新”或拉取一个需要翻墙的网站模板，如果速度正常且无报错，说明 `HTTP_PROXY` 配置生效。

### ⚠️ 注意事项

  * **代理 IP**：请务必将 `192.168.31.221` 替换为你自己宿主机的真实局域网 IP。
  * **权限问题**：如果启动报错 `Permission denied`，请检查挂载目录 `/vol1/1000/qiandao` 的权限，可以使用 `chmod 777 /vol1/1000/qiandao` 快速修复。

docker部署QD框架

![](/static/img/1ebc2eeb5ed9948bcc678debef6f8adf.Gemini_Generated_Image_neh3g6neh3g6neh3.webp)

有时候只想临时传个文件，没必要上复杂网盘。Dufs 这种轻量文件服务器刚好够用，Web 访问、目录浏览和 WebDAV 都有，适合做 HomeLab 的小入口。



# Docker 部署轻量级文件服务器 Dufs：从入门到权限配置

在寻找轻量级、支持 WebDAV、且界面现代化的文件服务器时，[Dufs](https://github.com/sigoden/dufs) 无疑是一个非常棒的选择。它单文件部署、资源占用极低。

但在使用 Docker Compose 部署时，很多小伙伴（包括我自己）都会遇到一个怪现象：**明明开启了所有权限，为什么登录后还是不能上传文件？**

本文将总结 Dufs 的部署方案，并着重讲解如何配置“公开模式”与“私有用户模式”，以及那个关键的“权限后缀”问题。

## 1\. Dufs 简介

Dufs 是一个用 Rust 编写的功能强大的文件服务器，支持：

  * 静态文件服务
  * 上传、下载、搜索
  * 访问控制（权限管理）
  * WebDAV 支持
  * 良好的移动端适配

## 2\. 基础部署 (Docker Compose)

首先，创建一个 `docker-compose.yml` 文件。这是最基础的版本，默认是只读的。

```yaml
version: '3'
services:
  dufs:
    image: sigoden/dufs:latest
    container_name: dufs
    ports:
      - 5032:5000
    volumes:
      - ./data:/data
    command: /data
```

## 3\. 场景一：公开模式（所有人可读写）

如果你是在内网环境，或者想做一个公开的临时文件中转站，允许任何人查看、上传、删除文件。

**配置要点：**

  * 使用 `-A` (即 `--allow-all`) 参数开启所有权限。



```yaml
    # ... 其他配置同上
    # -A 代表开启上传、删除、搜索等所有功能
    command: /data -A
```

*注意：这会允许匿名用户随意删除文件，请慎用于公网环境。*

## 4\. 场景二：私有用户模式（关键避坑点！）

这是最容易出问题的地方。我们的需求通常是：**只有管理员（我）登录后才能上传/删除，其他人要么进不来，要么只能看。**

### ❌ 常见的错误配置

很多教程或者直觉会让我们这样写：

```yaml
command: /data -A -a admin:password@/
```

**现象**：你能看到登录框，密码也正确，但登录进去后**没有上传按钮**，只有下载权限。
**原因**：Dufs 的权限逻辑是，一旦你指定了 `-a` (Auth) 规则，**默认给予的是只读权限**。即使你加了 `-A` (Allow All)，这个特定的用户规则如果没有显式声明“可写”，它依然被锁定在只读状态。

### ✅ 正确的配置方案

要赋予用户完全控制权，必须在路径后面加上 **`:rw`** (Read/Write)。

同时，为了避免 Docker 解析 YAML 时对特殊字符（如 `@`, `:`, 字符串顺序）的误读，**强烈建议使用 JSON 数组格式**来编写 `command`。

```yaml
version: '3'
services:
  dufs:
    image: sigoden/dufs:latest
    container_name: dufs
    ports:
      - 5032:5000
    volumes:
      - ./data:/data  # 请替换为你实际的挂载路径
    command:
      - -A                       # 1. 开启全局功能开关
      - -a                       # 2. 启用认证
      - admin:123456@/:rw        # 3. 关键！@/后面加上 :rw 代表根目录读写权限
      - /data                    # 4. 最后指定容器内的数据目录
```

### 核心参数解析：

  * **`-A`**: 开启服务器的功能支持（允许上传/删除/搜索等接口）。
  * **`-a`**: 定义访问控制规则。
  * **`admin:123456@/:rw`**:
      * `admin:123456`: 账号密码。
      * `@/`: 保护的路径是根目录。
      * **`:rw`**: **赋予读写权限（这是出现上传按钮的关键）**。
  * **JSON 数组格式**: 避免了 YAML 解析器把 `-A -a ...` 当作一个长字符串处理，确保每个参数都被 Dufs 正确识别。

## 5\. 总结

部署 Dufs 时，如果发现配置不生效或权限不对，请检查以下三点：

1.  **容器重建了吗？** 修改 `docker-compose.yml` 后必须执行“重新构建” (Rebuild/Up)，光重启容器是不够的。
2.  **加了 `:rw` 吗？** 设置用户时，必须显式授予写权限 (`user:pass@path:rw`)。
3.  **参数顺序对吗？** 建议把路径 `/data` 放在最后，并使用数组格式编写 command。

希望这篇笔记能帮大家愉快地使用 Dufs！

![Gemini_Generated_Image_n0v2phn0v2phn0v2.png](/static/img/cd410bf91bffb3a3b1833350c6296502.Gemini_Generated_Image_n0v2phn0v2phn0v2.webp)

搭建属于自己的轻量文件服务器

![Gemini_Generated_Image_ihgvybihgvybihgv.png](/static/img/99bf0cdf3e623b62110900d094298c1a.Gemini_Generated_Image_ihgvybihgvybihgv.webp)

容器好重建，配置丢了才麻烦。这里把 Docker 配置一键导出备份整理成固定动作，避免迁移、重装或误删时只能靠记忆重新搭。



# 实战记录：如何用 Docker 优雅地备份 Docker？(抛弃 Crontab 和 脚本)

最近在折腾家里的服务器，Docker 容器跑了几十个在固态盘上。数据通过文件拷贝备份还算简单，但最让我头大的是**容器的配置**——每个容器的端口映射、环境变量、挂载路径，一旦机器挂了，想凭记忆重新 `docker run` 或者是手写 `docker-compose` 恢复，简直是灾难。

我的需求很简单：

1.  **要把现有的容器“逆向”生成配置**：不用手动一个个备份 YAML。
2.  **全自动**：每天凌晨自己跑，不用操心。
3.  **干净**：不想在宿主机上搞乱七八糟的 Crontab 脚本，**既然用了 Docker，就用 Docker 的方式解决问题。**

## 1\. 核心工具：docker-autocompose

首先找到了 `ghcr.io/red5d/docker-autocompose` 这个神器，它可以读取当前运行的容器，直接吐出标准的 `docker-compose.yml` 文件。

需要备份的时候手动跑命令，确实好用：

```bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/red5d/docker-autocompose $(docker ps -aq) > backup.yml
```

但手动跑显然不是长久之计。

## 2\. 踩坑过程：从“臃肿”到“极简”

为了自动化，我最开始的思路比较粗暴：搞个 Python 容器，在里面安装 pip，再装 autocompose，然后写个循环脚本。

**结果踩雷了：**
每次容器启动都要重新联网下载安装包，国内网络环境一抖动，备份就挂。而且为了运行一个小脚本，弄个几百兆的 Python 环境常驻后台，太浪费资源。

**最终方案：**
后来一想，宿主机本身就有 Docker 环境，我干嘛要在容器里再装一遍？
我只需要一个**只有几 MB 大小的 `docker:cli` 容器**，挂载 `docker.sock`。它不干苦力，只负责“发号施令”，指挥宿主机去运行备份工具。

这样做的好处是：**除了第一次下载镜像之后无需下载、秒启动、断网也能跑**。

## 3\. 最终作业 (docker-compose.yml)

这是我现在正在用的版本，直接部署：

**注意看代码里的中文注释，都是踩过的坑：**

```yaml
version: '3.8'

services:
  backup-commander:
    # 直接用官方极简的 docker 命令行镜像，只有几 MB
    image: docker:cli
    container_name: auto-docker-backup
    restart: unless-stopped
    # 必须开启特权模式，否则可能没权限操作宿主机的 sock
    privileged: true
    environment:
      - TZ=Asia/Shanghai
      - KEEP_DAYS=30  # 保留最近30天的备份
    volumes:
      # 核心：把宿主机的 Docker 通讯接口挂进去，让容器能“控制”宿主机
      - /var/run/docker.sock:/var/run/docker.sock
      # 这里的路径改成你自己的挂载盘路径
      - /tmp/zfsv3/nvme12/17733717568/data/docker-backup:/backup
    
    # 具体的备份脚本逻辑
    entrypoint:
      - /bin/sh
      - -c
      - |
        echo "✅ 备份守护进程已启动..."
        
        while true; do
          # 【天坑预警】在 Compose 里写 Shell 变量必须用两个 $ 转义
          # 如果写 $DATE，会被识别成宿主机的环境变量，导致变成空值
          DATE=$$(date +%Y%m%d_%H%M)
          FILE="/backup/docker-backup-$$DATE.yml"
          
          echo "🚀 [$$DATE] 正在执行备份..."
          
          # 这里并不是在容器内安装工具，而是指挥宿主机临时起一个 autocompose 容器
          # 用完即焚 (--rm)，直接输出结果到我们的挂载目录
          docker run --rm \
            -v /var/run/docker.sock:/var/run/docker.sock \
            ghcr.io/red5d/docker-autocompose $$(docker ps -aq) > "$$FILE"
          
          # 检查一下文件有没有生成，顺便清理旧版本备份
          if [ -s "$$FILE" ]; then
             echo "🎉 备份成功！文件已生成: $$FILE"
             # 删掉超过 KEEP_DAYS 天的旧文件，防止把硬盘塞满
             find /backup -name "docker-backup-*.yml" -mtime +$${KEEP_DAYS} -delete
          else
             echo "❌ 备份失败（文件为空），建议检查日志"
          fi
          
          echo "💤 任务完成，休眠 24 小时..."
          sleep 86400
        done
```

## 4\. 两个避坑指南

在部署过程中遇到过两个报错，甚至让我一度怀疑人生：

1.  **报错 `invalid volume path`**：
    如果你用 Portainer 或者 CasaOS 这类面板部署，它可能会拦截 `/tmp` 开头的挂载路径。

      * **解决**：别跟面板较劲，直接 SSH 连上去用 `docker compose up -d` 启动，一步到位。

2.  **变量也就是那个 `$$` 的问题**：
    脚本里明明写了 `DATE=$(date...)`，但跑起来文件名总是叫 `docker-backup-.yml`，中间没有日期。

      * **原因**：Docker Compose 预处理时，会把 `$DATE` 当作宿主机变量去解析。
      * **解决**：必须写成 `$$DATE`，告诉 Docker 这是一个脚本内部变量，别给我替换了。

-----

**总结**：
如无必要，勿增实体。这个方案利用了 Docker 自身的缓存和运行能力，既不需要在宿主机装杂七杂八的脚本，也不用维护臃肿的备份容器。现在的状态是：平时几乎不占资源，一旦要恢复，把生成的 YAML 扔回去 `up` 一下就全回来了。