B站自动任务工具推荐：BiliBiliToolPro开源免费避坑全指南

为什么值得推荐？#

1. 功能全面：几乎涵盖了B站所有重复性任务，从日常签到到大会员福利领取，一应俱全

2. 易于部署：支持Docker、青龙面板、K8s等多种部署方式，无论是技术小白还是高级用户都能找到适合自己的方案

3. 开源透明：代码完全开源，用户可以自主检查安全性，避免个人信息泄露风险

4. 持续维护：项目活跃度极高，开发者积极响应社区反馈，定期更新功能和修复问题

5. 多账号支持：支持同时管理多个B站账号，任务执行互不干扰，适合家庭或团队使用

核心理念：当你忘记做某项任务时，它会像一个贴心小助手，按照预先配置的命令，在指定时间、按照指定频率，帮助你自动完成计划的任务。

1. 每日自动任务（Daily）最核心功能#

这是BiliBiliToolPro的看家本领，能够自动完成B站每日任务，让你每天躺赚满额65点经验，快速升级到Lv6！

• 自动登录：每日自动登录B站，获得5点经验值

• 自动观看视频：观看指定时长的视频，获得5点经验值

• 自动分享视频：分享视频到动态，获得5点经验值

• 自动投币：可配置每天投币数量（最多5个），每个投币获得10点经验值，最多50点

• 指定UP主支持：可以选择优先为特定的UP主投币，支持自己喜欢的创作者

推荐运行频率：每天一次，建议设置在早上或晚上固定时间

2. 天选时刻抽奖（LiveLottery）#

自动参与直播中心的”天选时刻”抽奖活动，有机会白嫖各种奖品！

• 自动检测直播间的天选时刻活动

• 自动参与抽奖，无需手动操作

• 可设置每天参与次数（建议0-4次）

注意事项：大部分抽奖需要关注主播，如果不希望产生太多关注，可以配合”批量取关”功能使用。

3. 大会员大积分任务（VipBigPoint）#

大会员专属福利！自动完成大积分任务，积分可兑换各种实物和虚拟奖品。

• 每日签到：每天自动签到获得积分

• 浏览指定页面：自动浏览大会员相关页面

• 观看指定视频：自动观看指定剧集内容

推荐运行频率：每天一次，建议在凌晨运行

4. 直播间挂机（LiveFansMedal）#

自动在拥有粉丝勋章的直播间挂机，提升亲密度等级。

• 自动进入有粉丝勋章的直播间

• 保持在线状态，累积亲密度

• 可配置挂机时长

5. 漫画任务（Manga）#

自动完成B站漫画相关任务，不错过任何福利。

• 漫画签到：每天自动签到

• 漫画阅读：自动阅读指定页数的漫画，获取阅读奖励

6. 领取大会员权益（MangaPrivilege、VipPrivilege）#

大会员每月有各种免费权益，自动领取，避免浪费！

• 漫画阅读券：自动领取每月的免费漫画阅读券

• 大会员福利：自动领取优惠券、折扣等福利

• B币券：自动领取每月赠送的5张B币券

7. 银瓜子兑换硬币（Silver2Coin）#

将观看直播获得的银瓜子自动兑换成硬币，硬币可用于投币获取经验值。

8. 免费B币券充电（Charge）#

大会员每31天可免费领取一张5B币券，可以给喜欢的UP主充电。

• 自动检测B币券是否可领取

• 自动为指定的UP主充电（不能为自己充电）

• 避免B币券过期浪费

9. 批量取关（UnfollowBatched）#

批量取关指定分组下的所有关注，主要用于清理天选抽奖产生的关注。

• 可指定分组名称（如”天选时刻”）

• 可设置取关数量（-1表示全部取关）

• 按时间倒序从后往前取关

推荐运行频率：手动运行（根据需要）

10. 多种消息推送#

任务执行完成后，自动推送结果到你的手机或电脑，让你随时掌握任务执行情况。

支持的推送方式（按推荐排序）：

1. Telegram推送（最推荐，稳定可靠）

2. 企业微信应用推送

3. 企业微信推送

4. 钉钉推送

5. PushPlus推送

6. Server酱推送

7. Microsoft Teams推送

8. 酷推QQ推送

此外，还支持自定义推送到任意API地址，满足个性化需求。

11. Web管理界面#

提供精美的Web管理界面，所有信息一目了然：

• 📊 查看所有任务的运行状态

• 📝 查看详细运行日志

• ⚙️ 在线修改配置

• 📅 查看任务执行历史

• 🔄 手动触发任务运行

方式一：Docker部署（最推荐）#

Docker部署是最简单快捷的方式，特别适合新手用户。以下是详细步骤：

1. 前期准备#

确保你的系统已安装Docker环境。如果未安装，可以参考官方文档进行安装。

2. 一键脚本部署（最简单）#

如果你追求最快的部署速度，可以使用一键脚本：

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

这条命令会自动完成镜像拉取、容器创建等所有操作。

3. Docker Compose部署（推荐）#

如果你需要自定义配置，Docker Compose是更好的选择：

步骤1：创建项目目录

1
mkdir -p ~/bili_tool_web && cd ~/bili_tool_web

步骤2：下载配置文件

1
# 下载docker-compose.yml
2
wget https://raw.githubusercontent.com/RayWangQvQ/BiliBiliToolPro/main/docker/sample/docker-compose.yml
3

4
# 创建config目录并下载cookies.json模板
5
mkdir -p config && cd config
6
wget https://raw.githubusercontent.com/RayWangQvQ/BiliBiliToolPro/main/docker/sample/config/cookies.json
7
cd ..

步骤3：编辑配置文件

编辑 docker-compose.yml 文件，根据需要修改配置：

1
services:
2
  bili_tool_web:
3
    image: ghcr.io/raywangqvq/bili_tool_web
4
    container_name: bili_tool_web
5
    restart: unless-stopped
6
    tty: true
7
    volumes:
8
      - ./Logs:/app/Logs
9
      - ./config:/app/config
10
    ports:
11
      - "22330:8080"
12
    environment:
13
      TZ: "Asia/Shanghai"
14
      DailyTaskConfig__Cron: "0 0 15 * * ?"
15
      LiveLotteryTaskConfig__Cron: "0 0 22 * * ?"
16
      UnfollowBatchedTaskConfig__Cron: "0 0 6 1 * ?"
17
      VipBigPointConfig__Cron: "0 7 1 * * *"
18
      DailyTaskConfig__NumberOfCoins: 5

关键参数说明：

• image: 使用的Docker镜像

• container_name: 容器名称

• restart: 重启策略， unless-stopped 表示除非手动停止，否则总是重启

• volumes: 数据卷挂载，将容器内的日志和配置目录映射到宿主机

• ports: 端口映射，将容器的8080端口映射到宿主机的22330端口

• environment: 环境变量设置

  • TZ: 时区设置

  • DailyTaskConfig__Cron: 每日任务的执行时间（这里设置为每天15:00）

  • LiveLotteryTaskConfig__Cron: 天选抽奖任务的执行时间（每天22:00）

  • UnfollowBatchedTaskConfig__Cron: 批量取关任务的执行时间（每月1日6:00）

  • VipBigPointConfig__Cron: 大积分任务的执行时间（每天凌晨1:07）

  • DailyTaskConfig__NumberOfCoins: 每日投币数量

步骤4：启动服务

1
docker compose up -d

-d 参数表示后台运行。

步骤5：查看运行状态

1
docker compose ps

如果一切正常，你应该能看到类似下面的输出：

1
NAME            COMMAND                          STATE          PORTS
2
bili_tool_web   dotnet Ray.BiliBiliTool.Web.dll  Up             0.0.0.0:22330->8080/tcp

步骤6：查看实时日志

1
docker logs -f bili_tool_web

4. 访问Web界面#

服务启动后，在浏览器中输入：

1
http://你的服务器IP:22330

如果是本地部署，直接访问：

1
http://localhost:22330

默认登录信息：

• 用户名： admin

• 密码： BiliTool@2233

重要提醒：首次登录后，请务必到Admin页面修改密码，保障账户安全！

5. 添加B站账号#

登录系统后，点击”添加账号”按钮，会显示一个二维码。使用B站APP扫码登录即可。

方式二：本地/服务器直接运行#

如果你希望在本地或服务器上直接运行程序，可以选择这种方式。

1. 下载程序包#

访问项目的 Release页面，下载最新版本的程序包。

根据你的系统选择相应的包：

• Windows系统：下载 win-x86-x64.zip

• Linux系统：下载 linux-x64.zip

• macOS系统：下载 osx-x64.zip

如果你的系统已安装.NET 8.0环境，也可以下载 net-dependent.zip，文件更小（不到1M）。

2. 解压并配置#

下载并解压后，找到 appsettings.json 文件，使用文本编辑器打开。

配置你的Cookie信息：

1
{
2
  "BiliBiliCookies": [
3
    "SESSDATA=你的SESSDATA值; bili_jct=你的bili_jct值; DedeUserID=你的用户ID;"
4
  ]
5
}

如何获取Cookie：

1. 打开浏览器，登录B站官网

2. 按F12打开开发者工具

3. 切换到”Application”标签页

4. 在左侧找到”Cookies” → ” https://www.bilibili.com”

5. 复制 SESSDATA、 bili_jct 和 DedeUserID 的值

3. 运行程序#

Windows系统：

• 如果使用自包含包：直接双击运行 Ray.BiliBiliTool.Console.exe

• 如果使用依赖包：在当前目录下执行命令 dotnet Ray.BiliBiliTool.Console.dll

Linux系统：

1
./Ray.BiliBiliTool.Console --runTasks=Login

首次运行时，会出现一个二维码，使用B站APP扫码登录即可。

方式三：青龙面板部署#

如果你已经部署了青龙面板，可以直接在青龙面板中运行BiliBiliToolPro。

1. 安装.NET运行环境#

编辑青龙面板的 extra.sh 文件，添加以下内容：

1
sh -c "$(wget https://raw.githubusercontent.com/RayWangQvQ/BiliBiliToolPro/main/qinglong/ray-dotnet-install.sh -O -)"

保存后，在终端中执行：

1
docker exec -it qinglong bash /ql/config/extra.sh

2. 修改配置文件#

在青龙面板的”配置文件”中，修改 config.sh：

1
RepoFileExtensions="js py sh"

3. 添加依赖#

在青龙面板的”依赖管理”中，添加以下依赖：

• icu

• libicu

• libunwind

• libicu-devel

4. 添加环境变量#

在青龙面板的”环境变量”中添加Cookie：

• 名称： Ray_BiliBiliCookies__1

• 值：你的B站Cookie

多个账号的话，将 1 改成 2、 3 等。

5. 拉取脚本库#

在青龙面板的”订阅管理”中，添加订阅：

1
ql repo https://github.com/RayWangQvQ/BiliBiliToolPro.git "bili_task_"

6. 创建定时任务#

在青龙面板的”定时任务”中，创建任务：

1
cron: 0 9 * * *
2
new Env("bili每日任务")

脚本内容：

1
#!/usr/bin/env bash
2
. bili_task_base.sh
3
target_task_code="Daily"
4
run_task "${target_task_code}"

这样，每天早上9点就会自动执行B站每日任务。

方式四：Podman部署#

Podman是Docker的替代品，使用方法基本相同。

1. 安装Podman#

1
# Ubuntu/Debian
2
sudo apt-get install podman
3

4
# CentOS/RHEL
5
sudo yum install podman

2. 验证安装#

1
podman -v
2
podman info

3. 运行容器#

极简版：

1
podman run -itd --name="bili_tool_web" docker.io/zai7lou/bili_tool_web

综合版：

1
# 创建目录
2
mkdir -p /bili_tool_web && cd /bili_tool_web
3
mkdir -p Logs
4

5
# 下载配置文件
6
mkdir -p config
7
cd ./config
8
wget https://raw.githubusercontent.com/RayWangQvQ/BiliBiliToolPro/main/docker/sample/config/cookies.json
9
cd ..
10

11
# 运行容器
12
podman run -itd --name="bili_tool_web" \
13
    -v ./Logs:/app/Logs \
14
    -v ./config:/app/config \
15
    -e DailyTaskConfig__Cron="0 0 15 * * ?" \
16
    -e LiveLotteryTaskConfig__Cron="0 0 22 * * ?" \
17
    -e UnfollowBatchedTaskConfig__Cron="0 0 6 1 * ?" \
18
    -e VipBigPointConfig__Cron="0 7 1 * * *" \
19
    -e DailyTaskConfig__NumberOfCoins="5" \
20
    docker.io/zai7lou/bili_tool_web

4. 查看日志#

1
podman logs -f bili_tool_web

1. 账号安全#

• 不要将Cookie泄露给他人：Cookie是登录B站的凭证，一旦泄露，他人可以操作你的账号

• 建议使用小号测试：第一次使用时，建议先用小号测试，确认功能正常后再用主号

• 定期更换Cookie：Cookie可能会过期，建议每隔一段时间重新获取

• 不要设置异常高频任务：过于频繁的任务执行可能引起B站的注意，建议按照推荐的频率设置

2. 版本更新#

项目更新频繁，新版本通常会修复已知问题并添加新功能。建议定期更新：

Docker部署更新：

1
docker compose pull && docker compose up -d

本地部署更新：

重新下载最新版本的程序包，覆盖旧版本即可。

青龙面板更新：

在订阅管理中点击”更新”按钮即可。

3. 任务配置#

• 仔细阅读配置文档：BiliBiliToolPro提供了丰富的配置选项，建议仔细阅读官方文档

• 根据需求开启任务：不需要的任务可以关闭，避免不必要的资源占用

• 合理设置执行时间：建议将任务设置在网络不繁忙的时间段执行

4. 推送配置#

配置推送可以让你实时了解任务执行情况，推荐开启：

• 选择合适的推送方式：根据你常用的通讯工具选择

• 正确填写推送配置：确保Token、Key等参数填写正确

• 测试推送功能：配置完成后，先手动触发任务测试推送是否正常

5. 日志查看#

定期查看日志，及时发现和解决问题：

• Docker部署：使用 docker logs -f bili_tool_web 查看实时日志

• Web界面：在Web管理界面中可以查看详细日志

• 本地部署：日志文件通常在 Logs 目录下

6. 合理使用#

• 仅供学习和测试使用：本项目仅用于学习交流，请勿滥用

• 遵守B站用户协议：不要使用工具进行违规操作

• 尊重内容创作者：支持你喜欢的UP主，不要只是为了经验值而投币

1. 任务执行失败怎么办？#

可能原因：

• Cookie过期

• 网络连接问题

• B站API接口变更

解决方法：

1. 检查Cookie是否过期，重新获取并更新

2. 查看日志文件，定位具体错误信息

3. 确保网络环境正常，没有被限制或限流

4. 检查是否为最新版本，如果不是，更新到最新版本

5. 如果问题仍然存在，可以在项目的GitHub Issues中搜索或提问

2. Cookie如何获取？#

详细步骤：

1. 打开浏览器，登录B站官网

2. 按F12打开开发者工具

3. 切换到”Application”标签页（Chrome）或”存储”标签页（Firefox）

4. 在左侧找到”Cookies” → ” https://www.bilibili.com”

5. 找到以下三个Cookie项：

   • SESSDATA

   • bili_jct

   • DedeUserID

6. 复制这三个值，格式如下：

1
SESSDATA=你的SESSDATA值; bili_jct=你的bili_jct值; DedeUserID=你的用户ID;

3. Docker容器无法启动？#

检查步骤：

1. 检查Docker服务是否正在运行：

1
sudo systemctl status docker

如果Docker服务未运行，启动它：

1
sudo systemctl start docker

检查端口22330是否被占用：

1. netstat -tlnp | grep 22330

2. 如果端口被占用，修改 docker-compose.yml 中的端口映射

4. Web界面无法访问？#

排查方法：

1. 检查容器是否正在运行：

1
docker ps | grep bili_tool_web

检查容器日志：

1. docker logs bili_tool_web

2. 检查防火墙设置，确保端口22330开放

3. 如果是云服务器，检查安全组设置

5. 如何添加多个账号？#

方法1：通过Web界面

登录Web管理界面，点击”添加账号”，扫码登录即可添加新账号。

方法2：通过配置文件

在 cookies.json 文件中添加多个Cookie：

1
{
2
  "BiliBiliCookies": [
3
    "账号1的Cookie",
4
    "账号2的Cookie",
5
    "账号3的Cookie"
6
  ]
7
}

方法3：通过环境变量（Docker/青龙）

添加多个环境变量：

• Ray_BiliBiliCookies__1

• Ray_BiliBiliCookies__2

• Ray_BiliBiliCookies__3

• 以此类推…

6. 推送配置不生效？#

检查步骤：

1. 确认推送配置参数填写正确

2. 测试推送服务是否正常工作

3. 查看日志中是否有推送相关的错误信息

4. 尝试切换其他推送方式测试

7. 天选时刻抽奖没有中奖？#

说明：

• 天选抽奖是概率事件，不一定每次都能中奖

• 参与抽奖的次数越多，中奖概率越高，但也意味着会产生更多关注

• 如果不希望关注太多主播，可以减少抽奖次数或配合批量取关功能

8. 如何修改任务执行时间？#

Docker部署：

编辑 docker-compose.yml 文件，修改环境变量中的Cron表达式：

1
environment:
2
  DailyTaskConfig__Cron: "0 0 15 * * ?"  # 每天15:00执行

Web界面：

在Web管理界面中，可以在线修改任务的执行时间。

青龙面板：

修改定时任务的Cron表达式。

9. 大积分任务提示”账号风险”？#

说明：

• 这是B站的风控机制，不一定是因为使用工具

• 建议减少大积分任务的执行频率

• 可以尝试在凌晨等非高峰时段执行

10. 如何完全卸载？#

Docker部署：

1
docker compose down
2
rm -rf ~/bili_tool_web

本地部署：

直接删除程序目录即可。

青龙面板：

在订阅管理中删除订阅，删除相关定时任务和环境变量。