2025最新BiliBiliToolPro使用指南：从部署到精通的全方位教程

BiliBiliToolPro是一款功能强大的B站自动任务工具，支持多种部署方式，让你轻松实现B站每日任务自动化。本文将从部署到高级配置，为你提供全方位的使用教程，帮助你快速上手并充分利用这款工具。

一、部署方式选择

BiliBiliToolPro提供了多种部署方式，你可以根据自己的需求和技术背景选择最适合的方式。

1.1 Docker部署（推荐）

Docker部署是推荐的方式，具有简单、高效、跨平台等优点。

1.1.1 一键脚本部署

最简单的Docker部署方式是使用一键脚本，适合大多数用户：

bash <(curl -sSL https://raw.githubusercontent.com/RayWangQvQ/BiliBiliToolPro/main/docker/install.sh)

1.1.2 Docker Compose部署

如果你需要自定义配置，可以选择Docker Compose方式：

首先创建目录并下载配置文件：

mkdir bili_tool_web && cd bili_tool_web
wget https://raw.githubusercontent.com/RayWangQvQ/BiliBiliToolPro/main/docker/sample/docker-compose.yml
mkdir -p config
cd ./config
wget https://raw.githubusercontent.com/RayWangQvQ/BiliBiliToolPro/main/docker/sample/config/cookies.json
cd ..

然后启动服务：

docker compose up -d

docker-compose.yml配置文件内容如下：

services:
  bili_tool_web:
    image: ghcr.io/raywangqvq/bili_tool_web
    container_name: bili_tool_web
    restart: unless-stopped
    tty: true
    volumes:
      - ./Logs:/app/Logs
      - ./config:/app/config
    ports:
      - "22330:8080"
    environment:
      TZ: "Asia/Shanghai"
      DailyTaskConfig__Cron: "0 0 15 * * ?"

1.1.3 手动Docker指令部署

如果你熟悉Docker命令，也可以使用手动指令部署：

mkdir bili_tool_web && cd bili_tool_web
docker pull ghcr.io/raywangqvq/bili_tool_web
docker run -d --name="bili_tool_web" \
    -p 22330:8080 \
    -e TZ=Asia/Shanghai \
    -v ./Logs:/app/Logs \
    -v ./config:/app/config \
    ghcr.io/raywangqvq/bili_tool_web

更多Docker相关操作，请参考Docker使用说明。

1.2 本地部署

如果你希望在本地直接运行程序，可以选择本地部署方式。

1.2.1 .NET环境部署

如果你的系统已安装.NET 8.0环境，可以直接下载程序包运行：

dotnet ./Ray.BiliBiliTool.Console.dll --runTasks=Login

运行后会出现二维码，扫码登录后即可运行各个任务。

1.2.2 Windows系统部署

Windows用户可以下载win-x86-x64.zip包，解压后运行：

.\Ray.BiliBiliTool.Console.exe --runTasks=Login

也可以直接双击Ray.BiliBiliTool.Console.exe运行程序。

1.2.3 Linux系统部署

Linux用户可以使用以下命令部署：

wget https://github.com/RayWangQvQ/BiliBiliToolPro/releases/download/0.3.1/bilibili-tool-pro-v0.3.1-linux-x64.zip
unzip bilibili-tool-pro-v0.3.1-linux-x64.zip
cd ./linux-x64/
./Ray.BiliBiliTool.Console --runTasks=Login

1.3 青龙面板部署

如果你使用青龙面板，可以通过以下方式部署：

1. 在青龙面板中添加任务
2. 复制qinglong/DefaultTasks/bili_task_daily.sh中的内容
3. 设置定时规则，例如：0 9 * * *

bili_task_daily.sh内容如下：

#!/usr/bin/env bash
# cron:0 9 * * *
# new Env("bili每日任务")

. bili_task_base.sh

target_task_code="Daily"
run_task "${target_task_code}"

二、初始配置

2.1 登录系统

部署完成后，访问http://localhost:22330即可打开BiliBiliToolPro的Web界面。

默认登录信息：

• 用户名：admin
• 密码：BiliTool@2233

首次登录后，请及时修改密码以保证安全。

2.2 添加B站账号

登录系统后，需要添加B站账号。点击添加账号按钮，会显示一个二维码：

使用B站APP扫码登录：

2.3 配置文件详解

BiliBiliToolPro的配置主要通过appsettings.json文件进行，你可以根据需要修改配置。配置文件说明请参考配置说明。

主要配置项包括：

2.3.1 Cookie配置

Cookie是用于登录B站的凭证，是必须配置的项：

"BiliBiliCookies__1": "your_cookie_here"

你可以从浏览器中获取B站的Cookie，具体方法请参考获取B站Cookie。

2.3.2 每日任务配置

每日任务配置包括观看视频、分享视频、投币等设置：

"DailyTaskConfig": {
  "IsWatchVideo": true,
  "IsShareVideo": true,
  "NumberOfCoins": 5,
  "SelectLike": false,
  "SupportUpIds": "108569350",
  "DayOfReceiveVipPrivilege": 1,
  "DayOfExchangeSilver2Coin": -1,
  "SaveCoinsWhenLv6": false,
  "IsDonateCoinForArticle": false
}

2.3.3 推送配置

你可以配置任务结果的推送方式，支持多种推送渠道：

"Serilog": {
  "WriteTo": [
    {
      "Name": "Telegram",
      "Args": {
        "botToken": "your_bot_token",
        "chatId": "your_chat_id"
      }
    },
    {
      "Name": "PushPlus",
      "Args": {
        "token": "your_pushplus_token"
      }
    }
  ]
}

三、功能使用

3.1 每日任务

每日任务是BiliBiliToolPro的核心功能，包括观看视频、分享、投币等操作。配置示例：

"DailyTaskConfig": {
  "IsWatchVideo": true,
  "IsShareVideo": true,
  "NumberOfCoins": 5,
  "SelectLike": true,
  "SupportUpIds": "108569350,123456789"
}

• IsWatchVideo: 是否开启观看视频任务
• IsShareVideo: 是否开启分享视频任务
• NumberOfCoins: 每日投币数量
• SelectLike: 投币时是否同时点赞
• SupportUpIds: 优先选择支持的UP主ID集合

3.2 天选时刻抽奖

BiliBiliToolPro支持自动参与天选时刻抽奖，并可以设置过滤规则：

"LiveLotteryTaskConfig": {
  "ExcludeAwardNames": "舰|船|航海|代金券|自拍|照|写真|图",
  "IncludeAwardNames": "",
  "AutoGroupFollowings": true,
  "DenyUids": "65566781,1277481241"
}

3.3 批量取关

如果你需要清理关注列表，可以使用批量取关功能：

"UnfollowBatchedTaskConfig": {
  "GroupName": "天选时刻",
  "Count": 5,
  "RetainUids": "108569350"
}

3.4 定时任务

你可以通过Cron表达式设置任务的执行时间：

"DailyTaskConfig__Cron": "0 0 15 * * ?"

上述配置表示每天15:00执行每日任务。

四、高级配置

4.1 多账号管理

BiliBiliToolPro支持多账号管理，只需在配置中添加多个Cookie：

"BiliBiliCookies__1": "cookie_for_account_1",
"BiliBiliCookies__2": "cookie_for_account_2",
"BiliBiliCookies__3": "cookie_for_account_3"

4.2 安全设置

为了避免被B站检测，可以配置一些安全参数：

"Security": {
  "RandomSleepMaxMin": 20,
  "IntervalSecondsBetweenRequestApi": 2,
  "UserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
}

4.3 自定义任务

如果你需要自定义任务，可以通过修改代码实现。任务相关的代码位于src/Ray.BiliBiliTool.Application/目录下。

五、常见问题

5.1 如何获取B站Cookie？

你可以通过浏览器获取B站Cookie，具体方法请参考获取B站Web Cookie。

5.2 如何更新BiliBiliToolPro？

如果你使用Docker Compose部署，可以通过以下命令更新：

docker compose pull && docker compose up -d

5.3 如何查看任务日志？

任务日志保存在Logs目录下，你也可以在Web界面中查看实时日志。

5.4 本地部署需要安装什么环境？

本地部署需要安装.NET 8.0环境，安装方法请参考常见问题中的"本地或服务器如何安装.net环境"。

六、总结

通过本教程，你应该已经掌握了BiliBiliToolPro的部署和使用方法。BiliBiliToolPro提供了丰富的功能，可以帮助你自动化完成B站的各种任务，节省时间和精力。

如果你在使用过程中遇到任何问题，可以查阅官方文档或在项目的GitHub仓库提交issue。

祝使用愉快！