BiliBiliToolPro 部署完整指南：4 种方案快速上手，Docker 一键装好 B 站自动任务工具

【免费下载链接】BiliBiliToolProB 站（bilibili）自动任务工具，支持docker、青龙、k8s等多种部署方式。全面拥抱AI。敏感肌也能用。项目地址: https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro

BiliBiliToolPro 是一款 B 站（bilibili）自动任务工具，能帮你自动完成每日任务、直播签到、大会员权益领取等重复操作。它支持 Docker 一键部署、本地直跑、青龙面板托管和全托管云端 4 种安装部署方案，不管你是小白还是老手，都能找到适合自己的姿势。

先花 30 秒选部署方式

四种方案的核心区别只有两点：你手头有什么环境、你愿意维护多少东西。

下面按"从最省心的方案开始讲"的顺序展开：先用 Docker 一键方案跑起来，再聊本地直跑，然后是有面板基础的人的青龙托管，最后是彻底甩手的云端方案。看完你基本只需要精读其中一两节就够了。

三步装好 Docker 版（推荐首选）

为什么把 Docker 放第一个讲？因为项目自带 Web 管理界面，而容器化方案的环境隔离做得最干净——任务日志、配置文件都挂载在宿主机目录里，升级、回滚、迁移都是一条命令的事。而且官方提供了一键脚本，连 Docker 本身没装它都会帮你装。

一键脚本：贴一行命令，剩下的交给它

在一台有 root 权限的 Linux 机器上执行（脚本内容见 platforms/docker/install.sh）：

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

脚本会按顺序完成这些事：检测（没有就自动安装）Docker → 在当前目录生成bili_tool_web部署目录并下载docker-compose.yml→ 拉取镜像ghcr.io/raywangqvq/bili_tool_web→ 启动容器并映射22330端口。跑完之后，浏览器打开http://服务器IP:22330就能看到 Web 面板了：

两个小提示：如果用云服务器，记得在防火墙放行22330端口；首次启动后记得执行一次扫码登录任务添加账号。

想手动部署？docker compose 三条命令也够用

脚本不黑盒，你也可以自己控制每一步：

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

目录结构长这样，日志和配置都在宿主机上，容器炸了也不丢数据：

bili_tool_web ├── Logs ├── config │ └── cookies.json └── docker-compose.yml

日常会用到的几条命令：

docker compose stop # 停止 docker logs -f bili_tool_web # 追实时日志 docker exec -it bili_tool_web /bin/bash # 进容器 docker compose pull && docker compose up -d # 升级版本

首次登录：改密码，再扫码加账号

打开22330端口的 Web 界面，用默认账号登录：

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

登录后第一件事去Admin页面把密码改了。然后触发扫码登录，用 B 站 APP 扫一下，账号就加进来了：

扫码成功之后，每日任务、直播任务这些就能在面板里直接配置了。

不想用容器？本地直跑其实也很简单

如果你只是想在自己电脑上跑起来看看效果，或者机器上根本不想装 Docker，本地直跑是最直接的路子。它比 Docker 版少一个 Web 界面，登录时二维码直接打在控制台里，扫码即用。

有 .NET 8 环境：文件最小，更新最方便

任何系统（Windows / Linux / macOS）装好 .NET 8.0 Runtime 后，下载net-dependent.zip解压，然后：

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

Windows 用户：自包含包双击即走

下载win-x86-x64.zip解压，不依赖任何 .NET 环境：

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

懒得敲命令的话，直接双击Ray.BiliBiliTool.Console.exe也行，再用 Windows 任务计划程序设个定时就行。

Linux / macOS：一条命令起

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

从最新版压缩包（linux-x64/osx-x64）解压后，进入目录执行上面这条即可。装完 .NET 环境遇到问题可以翻 docs/questions.md。

本地直跑适合"我自己的机器我做主"的场景；但如果你希望 7x24 稳定运行，还是建议回到上面的 Docker 方案。

青龙面板用户：两条任务搞定托管

已经在跑青龙面板的朋友可以把 BiliBiliToolPro 接进去——面板拉取本仓库后，bili_task_*.sh这批脚本会自动注册成定时任务，之后更新也走订阅自动拉库。

第一步：让面板认识 sh 脚本。在"配置文件"页把RepoFileExtensions从"js py"改成"js py sh"，保存。

第二步：加一个拉库任务。两种方式任选其一：

• 订阅管理：新建公开仓库订阅，链接填https://github.com/RayWangQvQ/BiliBiliToolPro.git，定时规则2 2 28 * *，白名单bili_task_.+\.sh，文件后缀sh，保存后手动跑一次；
• 定时任务：新建任务，命令填ql repo https://github.com/RayWangQvQ/BiliBiliToolPro.git "bili_task_"，定时规则同上，保存后手动运行。

拉库成功后，"定时任务"列表里就会出现一排 B 站任务，包括登录、每日任务、直播粉丝牌等：

可选：让 Cookie 自动存进环境变量。在"系统设置 → 应用设置"里新建一个应用，把生成的 Client ID / Client Secret 配成环境变量Ray_QingLongConfig__ClientId和Ray_QingLongConfig__ClientSecret。之后每次扫码登录，Cookie 会自动写回青龙环境变量，不用再手动复制粘贴。

登录账号：跑一次"bili 扫码登录"任务，二维码会打在运行日志里，扫完即登录成功。没配 Application 的话日志会直接打印 Cookie，手动加进环境变量就行。首次运行会自动安装 .NET 环境，会慢一些，之后就不用了。

彻底甩手：交给云端跑

最后一类方案适合"我一台服务器都不想维护"的朋友，思路是把任务调度直接交给云平台的免费额度。

GitHub Actions：Fork + 一个 Secret

前提是有 GitHub 账号。步骤很短：

1. Fork 本项目到你自己仓库（也可以git clone https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro后推上去）；
2. 在仓库 Settings → Secrets 里添加COOKIESTR，值就是你的 B 站 Cookie；
3. Fork 下来的仓库默认是禁用 Actions 的，进 Actions 页点一下 Enable workflow，再手动触发一次验证。

唯一要记住的坑：别用默认时间。默认每天 0 点整跑，全网用户挤在一起容易把 IP 打限流，把工作流里的 cron 改成错峰的非整点时间就好。

腾讯云 SCF：无服务器，零机器

腾讯云函数（SCF）有免费额度，正常用基本零成本。推荐走 Actions 自动部署，保证代码永远是最新版：

1. 先在腾讯云新建一个 API 密钥（拿到 SecretId / SecretKey）；
2. Fork 项目，仓库 Secrets 里添加TENCENT_SECRET_ID、TENCENT_SECRET_KEY、TENCENT_SERVERLESS_YML（填 platforms/tencentScf/serverless.yml 的内容）、IS_AUTO_DEPLOY_TENCENT_SCF=true；
3. 手动触发auto-deploy-tencent-scf工作流，函数就部署好了。

不熟 Actions 也可以手动：下载tencent-scf.zip，在 SCF 控制台新建函数（CustomRuntime 环境，执行方法index.main_handler，执行超时 86400 秒），环境变量里加Ray_BiliBiliCookies__1（Cookie 串），先加Ray_RunTasks=Test跑一次测试，成功后删掉这个变量，改由触发器传参——比如定时触发器DailyTask附加信息填Daily：

SCF 的日志会写入日志服务（CLS），有免费额度，正常用不花钱；想彻底零日志费用的话，把对应日志主题删掉即可。更多细节见 platforms/tencentScf/README.md。

登录与配置：各方案都绕不开的两件事

不管用哪种方式，最终都要做两件事：登录 B 站账号、按需改配置。

登录入口因方案而异：Docker 和 k8s 方案在 Web 面板里点扫码登录；本地直跑看控制台二维码；青龙方案看任务日志里的二维码；SCF 方案看函数日志里的二维码。扫码成功后 Cookie 会被持久化到对应方案的配置位置（config/cookies.json、环境变量等），之后任务就能自动跑。

配置方式：最通用的做法是改appsettings.json（配置项说明见 docs/configuration.md）；Docker 和 SCF 这类无界面方案则习惯用环境变量覆盖，比如 compose 文件里的DailyTaskConfig__Cron: "0 0 15 * * ?"就是把每日任务定在每天 15 点。

几个建议：

• 定时任务都错峰、避开整点，和 Actions 一个道理；
• 首次跑通后把默认密码改掉；
• 多账号就在 Cookie 里继续追加，任务会按账号逐个执行。

遇到问题先查这里

• 常见问题（.NET 环境安装、端口不通、登录失败等）：docs/questions.md
• 配置项全解：docs/configuration.md
• 任务玩法说明：docs/task-help.md、定时任务设置：docs/scheduler-settings.md
• 青龙 / Docker / k8s 等平台专属说明：platforms/

文档解决不了的，直接去项目仓库提 Issue，附上运行日志，一般都能很快定位。

【免费下载链接】BiliBiliToolProB 站（bilibili）自动任务工具，支持docker、青龙、k8s等多种部署方式。全面拥抱AI。敏感肌也能用。项目地址: https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro