今天，我将为大家带来一篇超实用的实操教程，手把手教你如何从零开始部署并使用开源项目 BiliBiliToolPro。这款神器可以帮助你自动完成 B 站的日常任务，包括但不限于：

  • 签到 📝

  • 每日经验 📈

  • 投币 🪙

  • 直播挂机 📺

  • 漫画签到 📚

  • 领取大会员权益 ✨

在本期教程中，我将带你一步一步完成环境准备、部署、扫码登录、配置通知以及日常维护。

⚠️ 请注意：本项目为开源学习 / 测试用途，请务必对自己的 B 站账号与使用风险负责。

🛠️ 开始之前，你需要准备：

在正式开始部署之前，请确保您已准备好以下事项：

  • 运行环境：

    • 推荐使用 Linux 服务器 或本地带 Docker 的 NAS（如飞牛 NAS）。

    • 您也可以选择青龙面板或在线容器平台。

  • 必备资料：

    • 您的 B 站 Cookie。

    • 首次部署可手动从浏览器导出，但强烈建议使用项目自带的扫码登录功能获取 / 更新 Cookie，更加便捷安全。

  • 可选：

    • Telegram、PushPlus 等通知账号，用于接收脚本执行结果和异常通知。

⚙️ 部署方式选择

BiliBiliToolPro 支持多种部署方式，灵活性极高：

  • 免费在线容器（如 ClawCloud 等）

  • 青龙面板 🐉

  • Docker / Podman 🐳

  • 下载程序包本地运行

您可以根据自身条件选择任何一种，本教程将重点演示 Docker Compose（通用且推荐）和 青龙面板（在国内用户中应用广泛）这两种方案。

接下来，我将使用最方便的「青龙面板」和最稳妥的「Docker 部署」两个方案来为大家演示完整流程。

🐳 方法一：Docker Compose 部署 (推荐 & 稳定)

我们先用最稳妥的 Docker Compose 方式演示完整流程，这种方式便于管理容器与配置文件。这里我们仍以 飞牛 NAS 为例进行演示。

📚 1. 创建 Docker Compose 项目

  1. 登录飞牛 NAS 后台，打开 Docker → Compose → 新建项目。

  2. 在创建项目中输入一个项目名称，例如：bilitool。

  3. 选择一个您可以存放该项目的目录。

  4. 在 来源 中选择 创建。

  5. 从我的博客中复制以下 Docker Compose 代码，并粘贴到代码框中：

    version: "3.8"
services:
  bili_tool_web:
    image: ghcr.io/raywangqvq/bili_tool_web
    container_name: bili_tool_web
    restart: unless-stopped
    ports:
      - "22330:8080"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./Logs:/app/Logs
      - ./config:/app/config

  6. 勾选 在创建项目后立即启动。

  7. 点击 确定。稍等片刻，项目即可创建完成。

💻 2. 访问并登录项目管理界面

  1. 回到 Docker → 容器。

  2. 点击 bili_tool_web 容器的 快捷链接 跳转至项目地址（通常是您 NAS 的 IP 地址加端口号，如 nas_ip:22330）。

  3. 在弹出的新页面中，点击左侧的 Admin。

  4. 在登录框中填入默认用户名：admin。

  5. 填入默认密码：BiliTool@2233。

  6. 点击 登录。

    ⚠️ 安全提示：如果您是在公网中部署（如 ClawCloud、云服务器），强烈建议立即修改默认密码！具体方法仍是点选左侧 Admin 进行修改。

🌐 3. 项目功能概览

这个项目总的来说包含两大部分：

  • Schedules (定时任务)：您可以在此手动运行脚本和查看脚本日志。

  • Configurations (配置文件)：用于详细设置脚本执行的内容或禁用某些脚本。

总体来说，操作就这么简单！😉

🇨🇳 4. 切换中文界面 (可选)

如果您对英文界面感到不适，一万也为大家重新编译了中文版本。

具体切换方法：

  1. 回到飞牛 OS 中，在 Compose 中先 停止 正在运行的项目 (bilitool)。

  2. 点击项目的 YAML配置。

  3. 在 image 一行中，使用一万提供的镜像地址替换源作者的地址（此地址可在我的博客中复制）：

    ghcr.io/10000ge10000/bili_tool_web:latest

  4. 修改完成后，点击 构建。

  5. 重新回到项目地址中，现在是不是中文界面更友好一点了呢？✨

🔑 5. 初次运行与账号登录

在各项任务正常运行之前，我们首先需要手动运行一遍 LoginJob 脚本，以便进行账号扫码添加。只有将账号 Cookie 添加进来之后，其他任务才能正常运行。

  1. 点选 LoginJob 右侧的 手动运行 按钮。

  2. 然后点击 日志查询 按钮。

  3. 使用手机 B 站 APP 扫描日志窗口弹出的 二维码 并登录。

  4. 登录成功后，您可以尝试运行一下 日常任务 (DailyJob)。

  5. 其他脚本您也可以尝试手动运行，或者等待其定时启动。当然，在此之前，强烈建议大家在配置文件中逐项修改自己的专属配置，以满足个性化需求。

🐉 方法二：青龙面板部署

使用 Docker 部署的方法讲完了，现在我们来聊聊如何使用青龙面板来运行这个项目。

⚡️ 1. 青龙面板快速搭建

由于我们之前已经聊过本地搭建青龙面板了，这次我将快速带过搭建过程。使用的 Compose 代码依旧可以在我的博客中找到：

version: "3.8"
services:
  qinglong:
    image: whyour/qinglong:2.17.11
    container_name: qinglong
    hostname: qinglong
    restart: unless-stopped
    ports:
      - "5700:5700"
    volumes:
      - ./ql/data:/ql/data
    environment:
      - QlBaseUrl=/
      - QlPort=5700

✅ 2. 青龙面板的优点

青龙面板有其独特的优势，包括：

  • 任务管理：集中化管理所有脚本任务。

  • 变量管理：统一配置环境变量，方便多账号使用。

  • 多账号方便：轻松实现多 B 站账号的任务自动化。

⚙️ 3. 修改拉库配置以包含 .sh 脚本

重要！ 在拉取脚本之前，我们需要修改青龙的拉库配置，以确保 .sh 结尾的脚本也能被正确拉取。

  1. 进入青龙面板，找到对应的配置文件（通常在 配置文件 或 脚本管理 相关的设置中）。

  2. 查找关于拉取文件后缀的配置项（具体行号和文件路径可能因青龙版本或个人配置而异，但通常会在拉库相关的 ql.js 或 .upstream.conf 文件中）。

  3. 在类似于匹配 .pyc 文件的规则之后，添加 sh（注意前面有个空格）。

  4. 修改完成后，请务必点击右上角的 保存 按钮！ 💾

📦 4. 安装依赖

接着，我们需要在依赖管理中安装一些必要的依赖。

  1. 进入青龙面板，导航至 依赖管理。

  2. 点击 创建依赖。

  3. 依赖类型 选择 NodeJS。

  4. 自动拆分 选择 是。

  5. 在 依赖名称 处（从博客中复制）检查无误后，选择 确定。

    axios
cheerio
download
http-server
moment
tunnel
got
ws

    ⚠️ 请注意：您需要等待所有依赖安装完成后，再执行下一步操作。

🔄 5. 订阅管理 (拉库)

然后去订阅管理中添加拉库定时任务。

  1. 进入青龙面板，导航至 订阅管理。

  2. 点击 创建订阅 或编辑现有订阅。

  3. 在 名称 处粘贴拉库命令 (拉库命令在博客中复制)。

    • 常规拉库命令：

      名称：Bilibili
类型：公开仓库
链接：https://github.com/RayWangQvQ/BiliBiliToolPro.git
定时类型：crontab
定时规则：2 2 28 * *
白名单：bili_task_.+\.sh
文件后缀：sh

  4. 点击 确定 保存订阅。

  5. 保存后，点击订阅列表中的 运行 按钮，手动运行一次拉库任务。 如果正常，拉库成功后，会自动添加 BiliBili 相关的 task 任务。

扫码登录 Bilibili 后，为了有权限向青龙的环境变量中持久化 Cookie，我们需要添加一个鉴权配置。

a. 创建应用并授权

  1. 进入青龙面板，导航至 系统设置 → 应用设置。

  2. 点击 创建应用。

  3. 名称 随意填写（例如：BiliToolPro）。

  4. 权限 全选。

  5. 创建完成后，您将得到 ClientId 和 ClientSecret 两个值。请务必妥善保存。

b. 添加环境变量

  1. 进入青龙面板，导航至 环境变量。

  2. 点击 新建变量，创建两个新的环境变量，并将上面创建应用后得到的 ClientId 和 ClientSecret 对应填入 变量值。

    • 变量名 1：Ray_QingLongConfig__ClientId

    • 变量值 1：您创建应用得到的 ClientId

    • 变量名 2：Ray_QingLongConfig__ClientSecret

    • 变量值 2：您创建应用得到的 ClientSecret

  3. 点击 确定 保存环境变量。

最后，我们就可以在青龙定时任务中，运行 BiliBiliToolPro 的扫码登录任务了。

  1. 进入青龙面板，导航至 定时任务。

  2. 找到名为 bili扫码登录任务 (或类似名称) 的任务。

  3. 点击该任务右侧的 运行 按钮。

  4. 点击 日志 按钮，查看运行日志。

  5. 使用手机 B 站 APP 扫描日志中弹出的 二维码 进行登录。

    • Cookie 持久化：登录成功后，如果已配置了上述的青龙鉴权应用，BiliBiliToolPro 会自动将 Cookie 保存到青龙的环境变量中，实现持久化。

    • 手动添加 Cookie：如果未配置青龙应用（或配置失败），脚本会打印出 Cookie 字符串，请您手动将其添加到青龙的环境变量中（变量名通常为 BILI_JCT 或 BILI_COOKIE，需根据脚本要求确定）。

    • 首次运行提示：首次运行任务时，脚本可能会自动安装一些运行环境，时间可能稍长，请耐心等待。之后再次运行就不需要重复安装了。

是不是操作起来非常简单呢？😊

至此，我们已详尽地探讨了 BiliBiliToolPro 的部署精髓，无论您选择通用稳妥的 Docker Compose，亦或是国人青睐的青龙面板，相信您都能依照本期视频的指引，轻松实现 B 站日常任务的自动化管理。这款开源工具旨在极大提升您的 B 站使用效率，让重复性操作成为过去。当然，作为开源项目，其使用需您自行承担风险与责任。希望本期分享能为您的数字生活带来便利与乐趣。

如果您在搭建过程中遇到任何疑问，欢迎在评论区留言，或者私信与我沟通。我目前粉丝量尚少，有足够的时间为大家提供帮助。我们下期再见！👋