![](/static/img/02c9d7a1dfd690c2b039b2d781a153e2.Gemini_Generated_Image_jjti7njjti7njjti.webp)



# （下载地址在文末）

## 1. 背景与需求

在 Windows 环境下进行批量装机或重装系统后，软件部署通常面临以下痛点：

* **Winget 的局限性**：官方源虽然方便，但部分软件版本滞后，或缺少特定版本（如去广告版、绿色版）。
* **本地安装的繁琐**：传统的批处理安装（`.bat`）难以处理静默参数不统一、进程卡死等异常情况。
* **重复安装问题**：脚本若重复运行，可能会覆盖已配置好的软件。

基于此，编写了一个 PowerShell 脚本 (`AutoInstall.ps1`)，采用 **“Winget 在线 + Local 离线”** 的混合部署策略，并加入了进程监控和注册表查重机制。

## 2. 核心技术实现

### 2.1 混合数据源架构

脚本将部署流程分为两个阶段，逻辑解耦：

1. **在线阶段**：解析 `my_apps.txt` 配置文件，调用系统内置 `winget` 部署常用软件（Chrome, VSCode 等）。支持通过标签 `# [SOURCE: msstore]` 动态切换下载源。
2. **离线阶段**：遍历 `Local_Apps` 目录，根据文件后缀（`.exe`/`.msi`/文件夹）自动匹配安装策略。

### 2.2 基于注册表的“幂等性”检测 (查重)

为了防止重复安装，脚本在本地部署阶段引入了预检查机制。

* **原理**：通过读取 `HKLM` 和 `HKCU` 下的 `Uninstall` 注册表项，构建已安装软件名称列表。
* **匹配**：将待安装文件名与已安装列表进行模糊匹配（Regex）。

```powershell
# 获取系统已安装软件列表
function Get-InstalledAppNames {
    $paths = @(
        "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*",
        "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*",
        "HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*"
    )
    $names = @()
    foreach ($path in $paths) {
        Get-ItemProperty $path -ErrorAction SilentlyContinue | ForEach-Object {
            if ($_.DisplayName) { $names += $_.DisplayName }
        }
    }
    return $names
}

```

### 2.3 进程熔断机制 (Timeout)

在使用 `winget` 或调用外部 `exe` 时，可能会出现网络挂起或安装程序卡死的情况。
脚本放弃了简单的 `Wait-Process`，改用循环轮询的方式监控进程运行时间。一旦超过阈值（默认 10 分钟），强制终止进程。

```powershell
# 启动进程并获取对象
$proc = Start-Process -FilePath $exe -ArgumentList $args -PassThru -NoNewWindow

$startTime = Get-Date
while (-not $proc.HasExited) {
    Start-Sleep -Seconds 2
    # 计算运行时长
    if (((Get-Date)-$startTime).TotalMinutes -ge $TimeLimitMinutes) {
        Stop-Process -Id $proc.Id -Force -ErrorAction SilentlyContinue
        Write-Host " [!] 任务超时，强制熔断。" -ForegroundColor Red
        break 
    }
}

```

### 2.4 动态说明映射

本地文件通常只有英文文件名（如 `SoftCnKiller.exe`）。脚本内置了一个哈希表（HashTable）字典，在运行时动态匹配文件名并输出中文说明，提升日志可读性。

```powershell
$AppDict = @{
    "finalshell" = "SSH连接/服务器管理"
    "softcnkiller" = "流氓软件清理工具"
    "wiztree"    = "磁盘空间分析"
    # ...
}

```

## 3. 脚本目录规范

为了保证脚本的可移植性（Portable），采用相对路径结构：

```text
Deploy_Tool_V33/
│
├── 一键启动.bat          # 引导层：负责提权和绕过执行策略
├── AutoInstall.ps1       # 逻辑层：PowerShell 核心代码
├── my_apps.txt           # 配置层：Winget 软件清单
│
└── Local_Apps/           # 数据层：存放本地安装包
    ├── setup_v1.0.exe
    └── PortableTool/     # 支持直接复制绿色软件目录

```

## 4. 异常处理策略

脚本针对几种常见的安装失败场景做了处理：

1. **Winget 找不到包**：捕获 ExitCode，若非 0 或 3010（重启），则输出错误代码供排查。
2. **静默安装失败**：本地 EXE 默认尝试 `/S` 或 `/silent` 参数。如果进程快速退出且未成功（依据返回码），脚本会提示用户可能需要手动介入，但不会中断整个流程。
3. **UI 对齐**：针对中英文混合输出导致的控制台对齐问题，编写了 `Show-Header` 函数，基于字符字节宽度计算 Padding，确保日志输出整洁。

## 5. 使用说明

1. **配置**：修改 `my_apps.txt` 添加需要的 Winget ID；将离线包放入 `Local_Apps`。
2. **运行**：直接运行 `一键启动.bat`。
3. **交互**：脚本启动后会要求输入“部署路径”（针对绿色软件）和“超时时间”，随后自动执行。

---

**下载地址**：
[整合包下载地址](https://www.123865.com/s/3OzeVv-wsWQv?pwd=6666#)

基于 PowerShell 与 Winget 的 Windows 自动化部署脚本

Windows 装机必备软件清单

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



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)


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

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

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)


# 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` 快速修复。