BiliBiliToolPro 部署完全指南：本地到 K8s 四种方式快速跑起来

BiliBiliToolPro 部署完全指南：本地到 K8s 四种方式快速跑起来

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

BiliBiliToolPro 是一个 B 站自动任务工具，可以按定时计划为多个账号跑每日经验、投币、直播抽奖、漫画签到等任务。本文按"本地 → Docker → 青龙 → K8s"的顺序，把四条部署路径的命令都写全，照抄即可跑通。

部署方案怎么选

四条路线的差异主要在环境依赖和调度方式上，先看表再选。

没有特殊需求，直接选 Docker：不用装 .NET 环境，账号、排期、开关都能在浏览器里改。

本地三步跑起来

这条路最省事，自包含包解压即用，不需要装任何依赖；代价是定时执行要你自己用系统计划任务或 crontab 兜底。

1. 从 Releases 页面下载与平台匹配的发布包：win-x64、linux-x64、osx-x64是自包含包，dotnet-dependent包需要机器上有 .NET 10 运行时。
2. 解压后进入可执行文件所在目录。
3. 运行登录任务，按你的系统执行对应命令：

4. 终端会打印二维码，用 B 站 App 扫码完成登录。

5. 登录成功后，把参数换成--runTasks=Daily再跑一次，即可执行每日任务。

💡 提示：不想每次敲参数，可以编辑目录下的appsettings.json把RunTasks固定下来；多个任务用&拼接，如Daily&LiveLottery。

成功标志：终端输出登录成功、账号已加入的提示，且应用目录生成cookies.json（内含 cookie 数组）。

Docker 一键部署命令

这条路适合要长期挂机的服务器，容器把运行环境全带齐了；代价是需要一台常驻开机的机器或 NAS。

1. 确认已安装 Docker 和 Compose 插件，执行docker compose version能看到版本即可。
2. 建一个部署目录，把仓库中platforms/docker/sample/docker-compose.yml的内容放进去，关键配置如下：

services: bili_tool_web: image: ghcr.io/raywangqvq/bili_tool_web container_name: bili_tool_web restart: unless-stopped volumes: - ./Logs:/app/Logs - ./config:/app/config ports: - "22330:8080"

3. 在目录内启动容器并跟踪日志：

docker compose up -d docker logs -f bili_tool_web

4. 浏览器打开http://服务器IP:22330，用默认账号admin、密码BiliTool@2233登录。
5. 登录后第一时间到 Admin 页面修改面板密码。
6. 在账号页面点击登录触发按钮，扫出现的二维码添加 B 站账号。

成功标志：docker logs里 Web 服务正常启动，浏览器打开 22330 端口能看到登录页，扫码后账号列表里出现新账号。

⚠️ 注意：Web 面板的账号存在config/BiliBiliTool.db里，旧安装的cookies.json账号不会自动迁移，需要在面板重新扫码添加。

Podman 的流程与 Docker 基本一致，细节见 platforms/podman/README.md。

青龙面板添加定时任务

这条路适合已经在青龙上跑别的脚本的用户，拉一次仓库所有任务就自动注册好；代价是首次运行会自动装运行时，比较慢。

1. 打开青龙"配置文件"页，把RepoFileExtensions="js py"改成RepoFileExtensions="js py sh"，保存。
2. 添加拉库任务，二选一：订阅管理里新建公开仓库订阅，链接填https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro，白名单bili_task_.+\.sh，文件后缀sh；或在"定时任务"页添加任务，命令填ql repo https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro "bili_task_"。
3. 手动运行一次拉库任务。
4. 到"定时任务"页确认已自动注册出一批bili_task_脚本：

5. 运行"bili扫码登录"任务，打开它的运行日志，扫日志里打印的二维码登录：

6. 可选：在"系统设置 → 应用设置"创建应用，把凭据以Ray_QingLongConfig__ClientId、Ray_QingLongConfig__ClientSecret两个环境变量写入，Cookie 就会自动存进青龙环境变量；不配置的话，把日志里打印的 Cookie 手动加到环境变量页即可。

成功标志：登录日志提示扫码成功，环境变量页出现Ray_BiliBiliCookies__0，其余bili_task_任务能按各自定时跑通。

⚠️ 注意：如果 .NET 安装报错，在"环境变量"页加DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1；仍不行就在配置文件页加export BILI_MODE="bilitool"改用预编译二进制。

用 Helm 部署到 Kubernetes

这条路适合已有集群、希望统一纳管的环境；但要留意仓库里的 chart 还是旧版 console 镜像，不能直接套用当前 Web 容器。

1. 克隆仓库到本地：

git clone https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro.git

2. 编辑platforms/helm/bilibili-tool/values.yaml，确认镜像、Cookie 环境变量和 cron 变量符合你的环境。
3. 安装 chart 并跟日志：

helm install my-release ./platforms/helm/bilibili-tool \ -f ./platforms/helm/bilibili-tool/values.yaml kubectl logs -f <pod_name>

成功标志：helm list中 release 为 deployed 状态，kubectl logs里看到控制台启动并开始执行任务。

⚠️ 注意：chart 默认镜像是旧版 console/cron 镜像，与当前 Web 面板镜像不兼容，想用 Web 页面建议单节点走 Docker 方案。

常用配置改哪里

三种部署方式都支持"环境变量覆盖 appsettings.json"，Web 面板还能在界面上直接改大部分开关，最常碰的是下面几项。

控制台侧用Ray_前缀、双下划线连接配置层级：

export Ray_RunTasks="Daily" export Ray_BiliBiliCookies__1="SESSDATA=..." export Ray_DailyTaskConfig__NumberOfCoins="5"

每个字段的取值范围和默认值，以 完整配置说明 为准。Web 面板的排期则不用改文件，直接在调度页改 cron 并保存，重启后按新计划执行：

常见问题

Q：控制台提示缺少 .NET 环境，跑不起来？A：dotnet-dependent包需要 .NET 10 运行时。不想装环境的话，直接换win-x64/linux-x64/osx-x64自包含包，独立就能跑。

Q：Docker 容器起来了，浏览器却打不开页面？A：先用docker ps确认容器存活，再检查宿主机 22330 端口是否被占用，必要时改docker-compose.yml里的宿主机端口映射。远程服务器还要放行安全组和防火墙。

Q：任务执行报 Cookie 失效或登录失败？A：重新跑一次 Login 任务（控制台--runTasks=Login，Docker 在面板扫码）刷新 Cookie 即可，多账号逐个补扫。

Q：青龙首次运行特别慢，或 .NET 安装报错？A：首跑会自动安装运行时，慢属正常；报错就先加环境变量DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1，仍失败就切BILI_MODE="bilitool"模式。

Q：想临时停掉定时任务，但不想删部署？A：控制台把Security__IsSkipDailyTask设为true即可跳过执行；Web 面板直接关闭对应任务的IsEnable开关。

部署完成后，先扫登一个账号、跑一次Test任务确认整条链路连通，再放开定时任务。遇到本文没覆盖的问题，查 常见问题 和 配置说明，或到项目 issues 里搜一下同样的报错。

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