![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` 一下就全回来了。

数据备份篇-docker配置一键导出备份

![](/static/img/abaaae6f1ad5f9f3e0cf09ca73034c90.Gemini_Generated_Image_y7yys6y7yys6y7yy.webp)

NAS 上跑下载工具，最重要的是目录映射和访问入口别乱。这里记录迅雷 Docker 的部署细节，方便以后换机器或重建容器时快速恢复下载环境。



# dockercompose部署
```js
services:
  xunlei:
    image: cnk3x/xunlei:latest
    privileged: true
    container_name: xunlei
    hostname: mynas
    network_mode: host
    volumes:
      - /mnt/sdb1/xunlei:/xunlei/data
      - /mnt/sdb1/downloads:/xunlei/downloads
    restart: unless-stopped
```

参数含义同上，安装完毕后访问端口为http://IP:2345 也可以增加XL_WEB_PORT变量来指定端口。

如果使用host网络模式，还需要在防火墙上放行2345端口，命令为：

**如果是firewalld**
```js
firewall-cmd --zone=public --add-port=2345/tcp --permanent
firewall-cmd --reload
```
**如果是ufw**
```js
ufw allow 2345
```
# 输入邀请码
输入邀请码：迅雷牛通即可正常使用。

# 其它说明
NAS版迅雷网页端访问没有授权验证，因此不适合安装到公网服务器，建议在内网等NAS设备安装访问。

非迅雷VIP会限制每日只能添加3个下载任务。

nas部署迅雷docker

![Gemini_Generated_Image_w885i9w885i9w885.png](/static/img/a5ebcf7f95c95da5b1f7e65820d93f5e.Gemini_Generated_Image_w885i9w885i9w885.webp)

长文本靠键盘硬敲太累，在线语音又总让人担心隐私。这次试的是离线语音输入方案，重点看识别效率、使用门槛和能不能真的融入日常记录。



打字对于有的的人是享受，但是遇到长文输入的话真的很烦，有没有？

这里强力推荐一个开源项目：

https://github.com/HaujetZhao/CapsWriter-Offline

# 下载安装

[下载Releases整合包一键即用](https://github.com/HaujetZhao/CapsWriter-Offline/releases/tag/v1.0)，注意图里面的两个是都需要开启的，先开启服务端，等待一段时间（这个根据你的电脑配置而定）再开启应用端。

![image.png](/static/img/5f4b8eeeef23e5e0c8f233ed2377e720.image.webp)

# 开机自启

每次开机还得重新手动开启两个监听窗口有点小麻烦，按我下面做，实现开机不弹窗静默自启。

新建文本，复制以下代码：

 DIM objShell 

 set objShell = wscript.createObject("wscript.shell") 

 iReturn = objShell.Run("cmd.exe /C C:\XX\X.exe", 0, TRUE)

注意里面的C:\XX\X.exe是你要开机自启的exe文件完整路径。要启动的文件多了，你可以在 c盘根目录下新建一个文件夹，把所有的东西都放进去。

改文本文件扩展名为.vbs

win+r输入shell:startup进入启动文件夹，把vbs文件放进去。

重启实验下，完事。



因为服务端启动时间较长，我是只放的server服务端exe，让其开机自启动，有需要的时候再开应用端。

# 扩展分支

github主页还有图形化gui（可以做到说中文输出英文的效果）以及docker的分支大家可以自行研究使用！