BiliBiliToolPro 部署教程：从本地一键命令到零维护云函数，5 种方式完整指南

BiliBiliToolPro 部署教程：从本地一键命令到零维护云函数，5 种方式完整指南

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

BiliBiliToolPro 部署教程整理如下。这个项目用 B 站 API 定时跑日常任务（登录、看视频、投币、直播活动、漫画签到等），支持 Console 命令行和 Web 面板两种形态。下面按“上手成本从低到高”给出 5 条路径：先在自己电脑上跑起来，再到 Docker 常驻 Web 面板，青龙面板批量管理，最后是几乎零维护的腾讯云云函数。每条路径都遵循 前置条件 → 核心步骤 → 如何验证成功 的固定结构。

选型指南：先花 1 分钟定方案

本地 Console 部署：.NET 10 环境跑 net-dependent 包

前置条件：

• 已安装 .NET 10 运行时。框架依赖包（framework-dependent，意思是程序不捆绑运行时、靠你机器上的 .NET 工作）体积最小，从 release 页下载bilibili-tool-pro-v<version>-dotnet-dependent.zip即可。

核心步骤：

1. 解压后进入目录：

cd dotnet-dependent

2. 运行登录任务，扫码添加账号：

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

3. 登录完成后，编辑应用目录下的appsettings.json，按需设置RunTasks（例如Daily）跳过交互菜单，再启动目标任务。

如何验证成功：终端输出任务执行日志且无报错，日志中可见登录与任务请求。

Windows / Linux / macOS 本地部署：自包含包免 .NET

前置条件：下载与架构匹配的自包含 release 包（win-x64、linux-x64、osx-x64等），解压即用，不需要任何 .NET 环境。

核心步骤：

1. Windows：在解压目录打开命令提示符或 PowerShell：

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

2. Linux：

cd linux-x64 ./Ray.BiliBiliTool.Console --runTasks=Login

3. macOS：

cd osx-x64 ./Ray.BiliBiliTool.Console --runTasks=Login

4. Windows 也可以直接双击Ray.BiliBiliTool.Console.exe交互式选任务；无人值守场景用系统自带任务计划程序，通过--runTasks指定任务。

如何验证成功：出现任务执行日志并正常结束；多账号就重复跑一次Login再扫一个新账号。

Docker 部署：一条命令拉起 Web 面板

前置条件：Docker 与 Compose 插件。Debian/Ubuntu 执行脚本前需要 curl：

apt-get update apt-get install curl

核心步骤：

1. 执行一键脚本。它会检查并安装 Docker，把示例 compose 文件放进bili_tool_web/目录并启动容器：

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

2. 也可以手动 Compose 部署，自己控制文件：

mkdir bili_tool_web && cd bili_tool_web wget https://raw.githubusercontent.com/RayWangQvQ/BiliBiliToolPro/main/platforms/docker/sample/docker-compose.yml docker compose up -d docker logs -f bili_tool_web

示例 compose 挂载./Logs与./config到容器内/app/Logs、/app/config，把宿主机22330映射到容器8080，时区固定Asia/Shanghai，默认DailyTaskConfig__Cron为0 0 15 * * ?。

3. 日常操作：

docker compose stop # 停止 docker exec -it bili_tool_web /bin/bash # 进容器 docker compose pull && docker compose up -d # 升级镜像

4. 打开浏览器访问http://<主机IP>:22330，用默认账号登录：admin/BiliTool@2233，首次登录后到 Admin 页面改密码，再在面板里触发扫码登录添加 B 站账号。账号存在config/BiliBiliTool.db，旧版本config/cookies.json里的账号不会被自动迁移，需要重新添加。

如何验证成功：docker ps中bili_tool_web状态为 Up，日志无异常，Web 面板可登录。云服务器记得在防火墙放行 22330 端口。

青龙面板部署：定时拉库 + 扫码登录

前置条件：一个能正常使用的青龙面板。

核心步骤：

1. 面板「配置文件」页把RepoFileExtensions="js py"改为"js py sh"，保存。

2. 在「订阅管理」添加拉库订阅（仓库地址按你实际能访问的源填写）：

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

也可以在「定时任务」新建任务，命令写ql repo <仓库地址> "bili_task_"，定时规则2 2 28 * *，两种方式二选一。保存后手动执行一次。

3. 拉库成功后，面板的「定时任务」列表里会出现bili_task_daily、bili_task_login等一批 B 站任务。

4. 想扫码后 Cookie 自动写回青龙环境变量：「系统设置 → 应用设置」新建一个应用，把 Client ID / Client Secret 配成环境变量Ray_QingLongConfig__ClientId与Ray_QingLongConfig__ClientSecret。

5. 运行「bili扫码登录」任务，扫日志里打印的二维码。配了应用则 Cookie 自动落库到环境变量；没配就把日志里打印的 Cookie 手动粘进环境变量。

如何验证成功：任务列表里任务齐全，扫码任务日志提示成功，环境变量里出现账号 Cookie。

⚠️ 注意：首次任务运行会较久，脚本要现场安装 .NET 10 运行时，之后不再重复。

腾讯云 SCF 部署：上传 release ZIP，零维护收尾

前置条件：腾讯云账号已激活云函数 SCF；从 release 页确认有bilibili-tool-pro-v<version>-tencent-scf.zip资产并下载。

💡 说明：仓库里用 GitHub Actions 自动部署 SCF 的工作流已归档停用，当前支持的做法是上传 release ZIP；每次升级重复上传即可。

核心步骤：

1. SCF 控制台 → 云函数 → 新建函数：创建方式选「自定义创建」，运行环境CustomRuntime，本地上传 zip 包，执行方法index.main_handler。

2. 高级配置：初始化超时 30 秒，执行超时 86400 秒；执行设置开启异步执行与状态追踪。环境变量先加三组用于首测：

3. 函数代码页签点「运行测试」，看日志确认成功后，删掉Ray_RunTasks，让触发器消息来指定任务。

4. 触发管理 → 创建定时触发器，例如命名DailyTask，周期按控制台的 cron 格式填写（旧例为每天 15:10 的10 15 * * *，以控制台要求为准）；附加信息填Daily，多任务用&连接（如Daily&LiveLottery）。运行时 handler 会把触发器消息转成--runTasks参数。

如何验证成功：测试运行日志正常，触发器到点触发且执行记录有对应任务输出。

⚠️ 注意：SCF 是 Console 形态，和 Docker 的 Web 面板是两套东西；日志走 CLS 可能产生费用，部署前查一下自己账号的计价与配额。不建议为了省日志费直接删日志主题——那会丢掉诊断历史，而且未必能省掉全部费用。

常见问题与排错

Q1：本地运行提示缺 .NET，去哪里装？当前 release 的框架依赖包需要 .NET 10 运行时，按 Microsoft 官方安装文档操作即可；没有把握就用各平台的自包含包，完全不用管 .NET。

Q2：任务执行失败了怎么排查？按顺序来：读日志报错并对照 配置说明 → 搜 issues 有没有同样症状 → 把日志级别调到Debug（Serilog__WriteTo__0__Args__restrictedToMinimumLevel）重跑，注意 Debug 日志可能含敏感请求数据，贴出去前先删 Cookie、token 等 → 确认是可复现缺陷再提 issue。

Q3：定时任务的时间在哪改？会不会撞高峰？Web 部署改面板里的 cron 设置；SCF 改触发器 cron。仓库当前没有 B 站任务型 Actions 工作流，别指望改 Actions 定时。另外尽量别把定时设在整点，错开高峰能降低大量请求同时发出被限制的風險。

Q4：听说可以用 GitHub Actions 每天跑任务？仓库里原来的 B 站任务工作流已归档到platforms/gitHubActions/bak/，Actions 不会扫描这个目录，所以 fork、开 Actions、加COOKIESTR都不会再跑任务。当前支持的是 Web 面板、青龙面板和 SCF 上传 release ZIP 这几条路径。

Q5：青龙任务第一次跑特别久？首次任务会安装 .NET 10 运行时，之后不需要重复安装，属于正常现象。

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