![Gemini_Generated_Image_scv3acscv3acscv3.png](/static/img/4b56833a3d5858e281fe27ad9474f479.Gemini_Generated_Image_scv3acscv3acscv3.webp)

市面上有很多下载b站视频的免费工具，如
[pc及mac软件](https://www.bilibili.com/opus/1024566076286959656 )
[浏览器扩展](https://microsoftedge.microsoft.com/addons/detail/bilibili%E5%93%94%E5%93%A9%E5%93%94%E5%93%A9%E4%B8%8B%E8%BD%BD%E5%8A%A9%E6%89%8B/cagicamgdlbdmonbclkpgiabbldodgae)

而今天要介绍的是一款全自动下载收藏夹视频并整理的docker，个人感觉是更好的一种方式，那我们话不多说直接开始。




# docker-compose部署：

```js
services:
  bili-sync-rs:
    # 不推荐使用 latest 这种模糊的 tag，最好直接指明版本号,注意docker有更新
    image: amtoaer/bili-sync-rs:v2.6.3
    restart: unless-stopped
    network_mode: bridge
    # 该选项请仅在日志终端支持彩色输出时启用，否则日志中可能会出现乱码
    tty: true
    # 非必需设置项，推荐设置为宿主机用户的 uid 及 gid (`gid`)
    # 可以执行 `id ${user}` 获取 `user` 用户的 uid 及 gid
    # 程序下载的所有文件权限将与此处的用户保持一致，不设置默认为 Root
    user: 1000:1000
    hostname: bili-sync-rs
    container_name: bili-sync-rs
    # 程序默认绑定 0.0.0.0:12345 运行 http 服务
    # 可同时修改 compose 文件与 config.toml 变更服务运行的端口
    ports:
      - 12345:12345
    volumes:
      - ./config:/app/.config/bili-sync
      # metadata/people 正确挂载才能在 Emby 或 Jellyfin 中显示 UP 主头像
      # 右边的目标目录不固定，只需要确保目标目录与 bili-sync 中填写的“UP 主头像保存路径”保持一致即可
      - /vol2/1000/docker/emby/configs/metadata:/app/.config/bili-sync/upper_face
      # 接下来可以挂载一系列用于保存视频的目录，接着在 bili-sync 中配置将视频下载到这些目录即可
      # 例如：
      - /vol2/1000/Media/B站收藏:/home/amtoaer/HDDs/Videos/Bilibilis/
    # 如果你使用的是群晖系统，请移除最后的 logging 配置，否则会导致日志不显示
    logging:
      driver: "local"
```
# 相关配置：
参考：https://zhuanlan.zhihu.com/p/1938531839766687970

需要注意的是获取ac_time_value时：**先打开一个浏览器的无痕窗口** F12 打开开发者工具页面，选择控制台，**再登陆账户**，粘贴`window.localStorage.ac_time_value`回车即可获取。

# up主照片显示：
这里引用官方说明：对于使用 Emby、Jellyfin 媒体服务器的用户，需确保此处路径指向 Emby、Jellyfin 配置中的 /metadata/people/ 才能够正常在媒体服务器中显示 UP 主的头像，如下图：

<img src='/static/img/ab849972ee1abdb084665c15a72f048b.PixPin_2025-11-14_23-24-11.webp' width='500' height='auto' />


下载一个视频试试，看一下这个目录下是否有新添加的up主信息：

<img src='/static/img/0f0f41833380590cc6f96ac16af7eb06.PixPin_2025-11-14_23-25-08.webp' width='500' height='auto' />

最后，很关键的一点：**运行emby的计划任务，刷新数据库！**

<img src='/static/img/cf31d14d683d8e46bb94df27393f217b.PixPin_2025-11-14_23-27-38.webp' width='500' height='auto' />

# 关于报错：

检查刷新 Credential 遇到错误：request failed, status code: 86095, message: 86095，等待下一轮执行：

**开个不常用浏览器的无痕模式，然后再获取token，把这个浏览器关掉，确保docker占用一个单独的客户端id就可以了。**

B站订阅自动下载-docke部署bili-sync

![Gemini_Generated_Image_d1167wd1167wd116.png](/static/img/dd89fa484c3a03e0764d19f8a05c3004.Gemini_Generated_Image_d1167wd1167wd116.webp)

docker-compose如下：



```js
services:
   emby:
      container_name: emby-amilys
      image: amilys/embyserver:latest
      restart: unless-stopped
      network_mode: bridge
      ports:
         - 8896:8096
         - 8920:8920  # 可选：HTTPS端口
      volumes:
         - ./config:/config
         - ./config/hosts:/etc/hosts
         - /mnt/ARS2-NFS/nas/link:/media/video  # 媒体目录
         - /mnt/ARS2-NFS/nas/music:/media/music  # 音乐目录
         - /mnt/ARS2-NFS/nas/photos:/media/photos  # 照片目录
      environment:
         - UID=0
         - GID=0
         - GIDLIST=100,101
         - TZ=Asia/Shanghai
      devices:
         - /dev/dri:/dev/dri  # 硬件加速
      deploy:
         resources:
            limits:
               memory: 8G
            reservations:
               memory: 1G
```

docker部署emby开心版

![Gemini_Generated_Image_dwmkgadwmkgadwmk.png](/static/img/5c1fd5ef3f0152c2d197b77acf3abb30.Gemini_Generated_Image_dwmkgadwmkgadwmk.webp)

movie-pilot搭建要点。



# 项目搭建
docker-comose部署：
```js
version: '3.3'
services:
  moviepilot:
    stdin_open: true
    tty: true
    container_name: moviepilot-v2
    hostname: moviepilot-v2
    network_mode: host
    volumes:
      - '/media:/media'#媒体文件存储目录
      - '/moviepilot-v2/config:/config'#配置文件、数据库、日志等
      - '/moviepilot-v2/core:/moviepilot/.cache/ms-playwright'#浏览器内核存储目录
      - '/var/run/docker.sock:/var/run/docker.sock:ro'# Docker 管理权限

    environment:
      - 'NGINX_PORT=3000'
      - 'PORT=3001'
      - 'PUID=0'
      - 'PGID=0'
      - 'UMASK=000'
      - 'TZ=Asia/Shanghai'
      - 'SUPERUSER=admin' #超级管理员用户名
      - 'SUPERUSER_PASSWORD=你的初始登录密码' #超级管理员初始密码

    restart: always
    image: jxxghp/moviepilot-v2:latest
```

# 部署微信通知

:::tip{title="提示"}
在云服务器（你的家庭宽带有公网ip才可以本地部署）部署微信代理服务器！否则本地搭建内网穿透是起不到转发通知的作用的。
:::
docker-compose：

```js
version: '3.3'
services:
  wxchat:
    container_name: wxchat
    restart: always
    ports:
      - '3100:80'
    image: 'ddsderek/wxchat:latest'
```

进入 mp 设定-通知-添加-WeChat通知，界面如下：
![PixPin_2025-11-05_21-52-01.png](/static/img/97285e7ddb6fb60eae6b7854c7a3aa9f.PixPin_2025-11-05_21-52-01.webp)

在企业微信端应用管理-接收消息-API接收配置相关参数：

URL为
`http(s)://DOMAIN:PORT/api/v1/message/?token=moviepilot`（其中moviepilot修改为实际配置中实际的API_TOKEN的值，DOMAIN、PORT替换为本工具的外网访问地址及端口，需要有公网IP域名并做好端口转发）

TOKEN和ENCODINGAESKEY与上图相同位置保持一致。

能正常保存即设置成功。

![PixPin_2025-11-05_21-58-49.png](/static/img/a9f7a1b8bc2250ef10840489b88232f8.PixPin_2025-11-05_21-58-49.webp)

最后别忘了在应用管理-企业可信ip添加自己的公网ip：

![PixPin_2025-11-05_21-57-17.png](/static/img/0811cdf71933ac17900231f2281d2dab.PixPin_2025-11-05_21-57-17.webp)

# 文件下载与整理


:::tip{title="常见问题"}
下载文件有目录没有文件：MP/QB/EMBY这个三个容器必须设置好相应的文件夹映射，缺一不可！

硬连接失败：注意必须在同一根目录下！
:::


<img src='/static/img/68a65a7480e43074a76a8e41b6ece3bd.PixPin_2025-11-06_11-30-37.webp' width='300' height='auto' />

Movie-Pilot搭建及配置微信通知

![Gemini_Generated_Image_j84onj84onj84onj.png](/static/img/5212db4a7675ad90ee7a87ad66ae4081.Gemini_Generated_Image_j84onj84onj84onj.webp)

本教程将指导如何将一个单一的访问路径（如 `domain.com/my-tool`）部署为一个包含多个子工具（如 `/my-tool/tool-a`, `/my-tool/tool-b`）的工具箱。



这个方案的核心是利用 Nginx Proxy Manager (NPM) 强大的路径转发和重写功能，将一个子目录（如 `/my-tool`）映射到一个“工具箱”主页，并能正确地分发到该主页下的各个子工具页面。

-----

# 1\. 核心思路：中心辐射型文件结构

我们不再将所有代码放在一个 `index.html` 文件中，而是创建一个“中心辐射型”的目录结构。

  * **中心 (Hub):** 一个 `index.html` 文件，作为工具箱的主页（卡片选择界面）。
  * **辐射 (Spokes):** 每一个工具都存放在自己的子文件夹中。

# 2\. 步骤一：创建文件结构

在服务器上（例如宝塔面板的 `/www/wwwroot/` 目录下），创建你的工具箱主文件夹，并按以下结构组织文件：

```
/www/wwwroot/my-toolbox/
    |
    ├── index.html           <-- (这是“中心”：工具箱的主页)
    |
    ├── tool-a/              <-- (辐射1：工具A)
    │   └── index.html       <-- (工具A的HTML/JS/CSS代码)
    |
    ├── tool-b/              <-- (辐射2：工具B)
    │   └── index.html       <-- (工具B的HTML/JS/CSS代码)
    |
    └── ...                  <-- (未来可添加更多工具文件夹)
```

# 3\. 步骤二：编写“中心”主页 (index.html)

这是 `my-toolbox/index.html` 文件的关键部分。你需要使用**相对路径**来链接到你的各个“辐射”工具。

```html
<body>
    <main>
        <div class="grid ...">

            <a href="./tool-a/" class="tool-card ...">
                <h2>工具A (FinalShell)</h2>
                <p>这是工具A的描述...</p>
            </a>

            <a href="./tool-b/" class="tool-card ...">
                <h2>工具B (MD-Replace)</h2>
                <p>这是工具B的描述...</p>
            </a>
            
        </div>
    </main>
</body>
```

  * **关键点**：链接 `href` 的值是 `./tool-a/` 和 `./tool-b/`。
  * `./` 代表“当前目录”。
  * 末尾的 `/` 很重要，它告诉浏览器去访问一个目录，而不是一个文件。

# 4\. 步骤三：启动 Docker 容器

使用一个 Nginx 容器来托管**整个** `my-toolbox` 文件夹。

```bash
docker run -d \
  --name my-toolbox-server \
  -p 5001:80 \
  -v /www/wwwroot/my-toolbox:/usr/share/nginx/html:ro \
  nginx:alpine
```

  * `-v`：将我们包含所有文件（主页 + 子工具）的 `my-toolbox` 文件夹，挂载到 Nginx 的根目录。
  * `-p`：将 Nginx 容器的 `80` 端口映射到服务器的 `5001` 端口。

# 5\. 步骤四：配置 NPM (关键)

这是让所有路径（主页和子工具）都能正确访问的“魔法”所在。

1.  登录 NPM，编辑你的主域名（例如 `zym588.space`）。

2.  进入 **"Custom locations"** 标签页。

3.  **删除**所有旧的 `/my-tool` 规则（如果存在）。

4.  点击 **"Add location"**，创建**唯一**的一条新规则：

      * **`Define location`**:
        `^~ /my-tool/`
        *(关键：`^~` 代表高优先级匹配，末尾的 `/` 至关重要)*

      * **`Forward Hostname / IP`**:
        `127.0.0.1`

      * **`Forward Port`**:
        `5001` *(指向步骤三中 Docker 容器的端口)*

      * **点击 齿轮(⚙️)图标**，进入 **"Custom Nginx Configuration"**：

      * **粘贴**以下这**唯一**的一行 `rewrite` 规则：

        ```nginx
        rewrite ^/my-tool/(.*)$ /$1 break;
        ```

5.  **保存**。

-----

### 为什么这样可行？（工作原理解析）

配置的这条规则，通过 `rewrite` 巧妙地处理了所有情况：

1.  **访问主页 ( .../my-tool )**：

      * Nginx 会自动在 URL 末尾补全斜杠，重定向到 `.../my-tool/`。

2.  **访问主页 ( .../my-tool/ )**：

      * `location` 匹配 `^~ /my-tool/`。
      * `rewrite` 规则被触发，`^/my-tool/(.*)$` 匹配成功，此时 `(.*)` 捕获的内容是**空字符串**。
      * URL 被重写为 `/$1`，即 `/`。
      * NPM 将这个 `/` 请求转发给 `127.0.0.1:5001`。
      * Docker 容器内的 Nginx 收到 `/` 请求，返回 `/usr/share/nginx/html/index.html`（**工具箱主页**）。**成功**。

3.  **点击卡片 ( .../my-tool/tool-a/ )**：

      * `location` 匹配 `^~ /my-tool/`。
      * `rewrite` 规则被触发，此时 `(.*)` 捕获的内容是 `tool-a/`。
      * URL 被重写为 `/$1`，即 `/tool-a/`。
      * NPM 将这个 `/tool-a/` 请求转发给 `127.0.0.1:5001`。
      * Docker 容器内的 Nginx 收到 `/tool-a/` 请求，返回 `/usr/share/nginx/html/tool-a/index.html`（**工具A页面**）。**成功**。

通过这个方案，你只需维护一个 Docker 容器和一个 NPM `location` 规则，就可以无限扩展你的工具箱。

为主域名添加子目录应用（2）

![Gemini_Generated_Image_55fl9k55fl9k55fl.png](/static/img/6d861e666c16a94a302a4ece2e51b3dd.Gemini_Generated_Image_55fl9k55fl9k55fl.webp)

现在有一个新的 HTML 静态小工具，需要通过子目录路径（例如 https://zym588.space/my-tool 来发布和访问，同时避免在 NAS 上配置复杂的内网穿透。



# 一、当前环境 


1.  **云服务器**：已安装**宝塔面板**。
2.  **反向代理**：在云服务器使用 Docker 容器安装了 **Nginx Proxy Manager (NPM)**，作为所有服务的公网入口，管理域名和 SSL 证书。
3.  **服务**：大部分服务（如博客）运行在**本地NAS**上，通过**内网穿透**连接到云服务器上的 NPM。
4.  **关键冲突**：为确保 NPM 的 Docker 容器能监听并占用 `80` (HTTP) 和 `443` (HTTPS) 端口，宝塔面板**自带的 Nginx 服务**保持在“**已关闭**”状态。

**目标 (The Goal):**
现在有一个新的 HTML 静态小工具，需要通过子目录路径（例如 `www.your-domain.com/my-tool`）来发布和访问，同时避免在 NAS 上配置复杂的内网穿透。

-----

# 二、核心思路：隔离、挂载与转发

既然宝塔的 Nginx 无法启动（端口冲突），而 NAS 上的服务链路又太长（配置麻烦），最佳方案是：

**在云服务器上，启动一个全新的、专用的、独立的 Nginx 容器，专门用于托管这个 HTML 小工具。**

这个新容器将：

1.  **不**占用 `80` 或 `443` 端口，而是监听一个“内部端口”（例如 `5001`），因此**不会**与 NPM 容器冲突。
2.  通过 Docker 的“卷挂载”功能，直接读取存放在服务器上的 HTML 文件。
3.  最后，配置 NPM，将 `.../my-tool` 路径的流量转发到本地的 `127.0.0.1:5001`。

此方案可将新工具与现有复杂环境完美隔离开，实现简单、干净、可复制的部署，且不干扰任何现有服务。

-----

# 三、详细操作步骤

## 第一步：在宝塔面板准备 HTML 文件

1.  **登录宝塔面板**。
2.  点击左侧菜单的 **“文件”**。
3.  导航到一个合适的位置，例如 `/www/wwwroot/` 目录。
4.  点击 **“新建目录”**，创建一个专门存放小工具的文件夹，命名为 `my-tool`。（完整路径：`/www/wwwroot/my-tool`）
5.  进入这个新建的 `/www/wwwroot/my-tool` 文件夹。
6.  点击 **“上传”** 按钮，将 HTML 小工具文件（以及相关的 CSS/JS 文件夹）上传到此目录。
7.  **【关键步骤】**：Nginx 这类网页服务器，默认会在目录中寻找 `index.html` 作为首页文件。为实现自动加载，必须确保主 HTML 文件被**重命名为 `index.html`**。


![PixPin_2025-11-02_20-42-48.png](/static/img/c9ce6d18413096e9b93d4c8cc8e0ffb0.PixPin_2025-11-02_20-42-48.webp)

## 第二步：用Docker挂载静态HTML文件

此步骤将启动一个 Nginx 服务，并使其读取第一步中准备的文件。

1.  在宝塔面板，点击左侧菜单的 **“终端”** (如果找不到，请去“软件商店”安装“宝塔SSH终端”)。

2.  登录终端后，**复制** 下面这行命令，**粘贴** 到终端中，然后按回车键：

    ```bash
    docker run -d --name my-tool-server -p 5001:80 -v /www/wwwroot/my-tool:/usr/share/nginx/html:ro nginx:alpine
    ```

3.  **命令拆解：**

      * `docker run -d`：在后台（`-d` 即 detached）运行一个新容器。
      * `--name my-tool-server`：为容器指定一个名称，方便后续管理（如 `docker stop my-tool-server`）。
      * `-p 5001:80`：**端口映射**。将**云服务器的 `5001` 端口**连接到**容器内部的 `80` 端口**。Nginx 默认在容器里监听 `80` 端口。
      * `-v /www/wwwroot/my-tool:/usr/share/nginx/html:ro`：**卷挂载**。这是操作的**精髓**。它将服务器上的文件夹（`/www/wwwroot/my-tool`）“链接”到 Nginx 容器内部的默认网站根目录（`/usr/share/nginx/html`）。
      * `:ro`：(read-only) 这是一个安全设置，表示容器只能“只读”文件，不能修改。
      * `nginx:alpine`：指定使用的 Docker 镜像。`nginx:alpine` 是一个官方的、超轻量级的 Nginx 镜像，专为静态文件托管而生，体积小、启动快。
      
执行完毕后，小工具已经在云服务器的 `127.0.0.1:5001` 端口上成功运行了。

## 第三步：配置 NPM 进行流量转发

最后一步，是配置 NPM，将特定路径的公开访问流量转发到新启动的内部服务上。

1.  **登录云服务器上的 Nginx Proxy Manager (NPM) 面板**。

2.  点击 **Hosts** \> **Proxy Hosts**。  

![PixPin_2025-11-02_20-47-55.png](/static/img/85ebdd0c906ab994a865c7275101147b.PixPin_2025-11-02_20-47-55.webp)

3.  找到要使用的主域名（例如 `www.zym588.space`），点击右侧的“三点”菜单，选择 **Edit**。

![PixPin_2025-11-02_20-48-31.png](/static/img/cf3a2fbcb61f612d2b2ccd45fe3c719f.PixPin_2025-11-02_20-48-31.webp)

4.  在弹出的窗口中，选择 **"Custom locations"** 标签页。

5.  点击 **"Add location"** 按钮。



6.  **填写 Location 路由信息**：

      * **Define location:** `^~ /my-tool`
          * *(`^~` 是一个 Nginx 匹配修饰符，意为“高优先级匹配”。它指示 Nginx，一旦 URL 以 `/my-tool` 开头，就**立即使用此规则**，不再尝试匹配其他更通用的规则（例如已有的、指向 NAS 的 `/` 规则），确保新规则被优先处理。)*
      * **Scheme:** `http`
          * *(因为新 Nginx 容器在内部监听的是 HTTP 协议。)*
      * **Forward Hostname / IP:** `127.0.0.1`
          * *(因为新 Nginx 容器和 NPM 运行在**同一台**云服务器上，`127.0.0.1` 即“本机地址”。)*
      * **Forward Port:** `5001`
          * *(指向第二步中 `-p` 映射的那个服务器端口。)*
          
![PixPin_2025-11-02_20-48-56.png](/static/img/a11e44e2479d25e817db9c1fe53e3a2a.PixPin_2025-11-02_20-48-56.webp)


7.  **【关键】配置路径剥离 (Path Stripping)**：

      * 访客访问的是 `.../my-tool/index.html`。如果直接转发，`5001` 端口的 Nginx 会试图在 `/usr/share/nginx/html/my-tool/index.html` 里找文件，这会失败（因为挂载的根目录里没有 `my-tool` 这一层）。

      * 必须在转发前“剥掉” URL 里的 `/my-tool` 部分。

      * 点击 `^~ /my-tool` 输入框右侧的 **齿轮 (⚙️) 图标**。

      * 在弹出的 **"Custom Nginx Configuration"** 文本框中，**粘贴** 以下两行代码：

        ```nginx
        rewrite ^/my-tool/(.*)$ /$1 break;
        rewrite ^/my-tool$ / break;
        ```

      * **代码详解**：

          * `rewrite ^/my-tool/(.*)$ /$1 break;`：处理所有带子路径的请求（如 `.../my-tool/style.css`）。`  (.*) ` 会“捕获” `/my-tool/` 后面的所有内容（即 `style.css`），并存为变量 `$1`。Nginx 将 URL 重写为 `/$1`（即 `/style.css`），`break` 停止后续重写，并将这个新 URL 转发出去。
          * `rewrite ^/my-tool$ / break;`：处理只输入 `.../my-tool`（没有末尾斜杠）的情况，将其重写为 `/`，Nginx 收到 `/` 后会自动寻找 `index.html`。



      * 点击 **Save** 保存此自定义配置。

<img src='https://blog.zym588.space/static/img/86b50144bdc49ea0b224e0a0eca4e9c8.PixPin_2025-11-02_20-51-35.webp' width='500' height='auto' style="display: block; margin: 0 auto;" />
8.  点击右下角绿色的 **Save** 按钮，保存整个主机的配置。



-----

# 四、验证成果与未来扩展

## 验证

回到 NPM 的 Proxy Hosts 列表，`www.zym588.space` 的状态**应该立即变为了 "Online"** （绿色）。NPM 会定期进行健康检查，此时它能成功连接到 `127.0.0.1:5001`。

*如果状态未变绿*，可尝试刷新 NPM 页面。如果仍有问题，请返回宝塔终端，运行 `docker ps` 命令，确保名为 `my-tool-server` 的容器正处于 `RUNNING` 状态。

最后，打开浏览器，在隐身模式下访问 `http://www.zym588.space/my-tool`，即可看到 HTML 小工具的页面。

## 如何扩展：添加更多小工具？

此方法的可复制性很强。如果以后需要添加 `tool-B`、`tool-C`...

1.  **宝塔**：创建新目录 `/www/wwwroot/tool-B`，上传 `tool-B` 的 `index.html`。
2.  **终端**：运行一行**新**的 `docker run` 命令，使用一个**新端口**（如 `5002`）、**新名字**和**新目录**：
    ```bash
    docker run -d --name tool-B-server -p 5002:80 -v /www/wwwroot/tool-B:/usr/share/nginx/html:ro nginx:alpine
    ```
3.  **NPM**：在 `www.zym588.space` 里**再加一个 Location**，指向 `^~ /tool-B`，转发到 `127.0.0.1:5002`，并配置**对应**的 `rewrite` 规则 (只需将 `my-tool` 替换为 `tool-B`)。

**建议**：当此类服务超过两三个时，管理多条 `docker run` 命令会变得繁琐。届时，最佳实践是学习使用 `docker-compose.yml` 文件。它允许使用一个“清单”文件来统一定义和管理所有服务，实现一键启动、停止和更新。