企业官网建设流程全解析

BiliBiliToolPro 部署与上手指南：十分钟跑通，再到服务器无人值守

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

BiliBiliToolPro（项目内也叫 BiliTool）是一个 B 站（bilibili）自动任务工具，能自动完成每日看视频、分享、投币、直播抽奖、粉丝牌、漫画签到、会员权益领取、银瓜子兑换、批量取关等日常操作。它通过平台 API 替你重复点击，把每天固定要做的琐事一次配置好，之后就不用再惦记了。这篇部署与上手指南，带你从本地十分钟跑通，一路做到服务器上的定时无人值守，最后再讲讲常用调优和求助去处。

先搞清它帮你省掉什么

对很多 B 站重度用户来说，每天最烦的不是某一件大事，而是那堆"不点就亏"的小动作：看几个视频拿经验、投几枚硬币、进直播间抽奖、领一下会员权益、把银瓜子换成硬币。这些动作单看几秒钟，但每天累计起来很消耗时间，还容易忘。

BiliBiliToolPro 把这件事拆成一个个任务（task），每个任务可以单独开关、单独定时。你只需要登录一次（扫二维码或填 Cookie），之后让它按你设好的节奏自动跑就行。项目支持 Docker、青龙面板、K8s/Helm、腾讯云函数等多种部署方式，也支持本地 Console 直跑，敏感操作（比如登录、投币数量）都留了开关，适合想"先跑起来、再慢慢调"的用户。

提醒：本项目定位为学习与测试用途。跑之前先看清每个任务到底会做什么，Cookie 属于账号凭证，别贴到 Issue 或公开配置里。

选一条适合你的路

动手前先用几个问题定位自己，别一上来就纠结技术细节：

一句话判断法："会不会 Docker"和"要不要界面"这两条最关键。想省心又有界面，选 Docker Web 面板；不想装 Docker，就本地 Console；已经在用青龙，直接挂进青龙最省事。

下面从"最短路径"开始讲，让你先看到"它跑起来了"。

十分钟跑通：本地自包含包 + 扫码登录

这条路径最快见效，不需要 Docker，也不需要你预装 .NET 环境——自包含（self-contained）包已经打包好了运行时。

先做这一步：到项目的 Releases 页面，下载和你机器匹配的自包含包。当前稳定版本是v4.2.3，资源文件按平台命名，例如 Linux 是bilibili-tool-pro-v4.2.3-linux-x64.zip，Windows 是...-win-x64.zip（32 位用-win-x86），macOS 是...-osx-x64.zip。

以 Linux x64 为例，解压后进入目录运行登录任务：

unzip bilibili-tool-pro-v4.2.3-linux-x64.zip cd linux-x64 ./Ray.BiliBiliTool.Console --runTasks=Login

Windows 用户在解压目录里打开命令行，执行：

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

--runTasks=Login会启动扫码登录任务。你现在会看到控制台打印出一个二维码，用 B 站 App 扫一下即可登录。登录成功后，账号的 Cookie 会被保存下来（默认在本地cookies.json），再运行其他任务时就不用重复登录了。

登录完成后，把--runTasks=Login换成你想跑的任务代码就能跑。常用任务代码：

• Daily：每日看视频、分享、投币（经验）
• LiveLottery：天选时刻直播间抽奖
• LiveFansMedal：直播粉丝牌
• Manga/MangaPrivilege：漫画签到 / 漫画会员权益
• Silver2Coin：银瓜子兑换硬币
• VipBigPoint/VipPrivilege：大积分 / 会员权益
• Test：只校验 Cookie 是否可用，不真正执行动作

多个任务用&连接，例如--runTasks=Daily&LiveLottery。跑一次Test是确认登录态最简单的办法——它只查不操作，安全。

到这里，"跑起来了"这一步就完成了。如果你想让它长期稳定地跑，而不是每次手动敲命令，往下走。

安顿到长期环境：Docker 常驻服务器

本地 Console 适合尝鲜，但要"长期稳定、开机自启、图形界面管理"，Docker Web 面板是更省心的选择。它内置了 Quartz 调度器，账号、配置、定时、执行日志都能在网页上操作，不用再碰命令行。

依赖：装好 Docker 和 Compose 插件即可。Debian/Ubuntu 上若要用一键脚本，先装curl：

apt-get update apt-get install curl

手动 Compose 部署（比一键脚本更透明，推荐先理解它）：

mkdir bili_tool_web && cd bili_tool_web # 从仓库示例目录取 docker-compose.yml 放入当前目录 docker compose up -d docker logs -f bili_tool_web

示例编排做了三件关键的事，值得你记住：

• 把./Logs和./config挂到容器里，日志和数据都落在宿主机；
• 对外暴露端口22330，映射容器8080；
• 设了restart: unless-stopped，容器异常退出会自动拉起——这就是"开机自启 / 重启后还在"的来源，你不用另外配系统服务。

跑起来后目录长这样：

bili_tool_web/ ├── Logs/ # 运行日志 ├── config/ │ └── BiliBiliTool.db # 账号、配置都存这个 SQLite 文件 └── docker-compose.yml

注意一个容易踩的点：账号现在只存在config/BiliBiliTool.db里，Web 面板不再读旧的config/cookies.json。如果你是从旧安装升级来的，旧 JSON 里的账号不会被自动迁移，需要在面板里重新扫码添加一次。这个数据库文件就是你的"家当"，备份它等于备份了所有账号和配置。

常用管理命令：

docker compose stop # 停止 docker logs -f bili_tool_web # 看实时日志 docker exec -it bili_tool_web /bin/bash # 进容器排查 docker compose pull && docker compose up -d # 拉新镜像并升级

升级就是"拉新镜像 + 重新起"这一句，因为数据和日志都在挂载卷里，升级不会丢。

打开浏览器访问http://服务器IP:22330，首次登录用初始账号admin / BiliTool@2233。登录后第一时间去 Admin 页面把默认密码改掉，这步别偷懒。面板首页会展示各任务今天的运行状态和下次触发时间。

交给它自动跑：定时 + 无人值守

常驻之后，最后一步就是"设好定时，让它自己跑"。Web 面板里每个任务都能单独开/关、单独设 Cron，配置页里能直接改。

这里有一个新手最容易卡住的点：BiliBiliToolPro 的 Cron 用的是 Quartz 六段式（带秒），不是 Linux 常见的五段式。比如示例里的0 0 15 * * ?表示"每天 15:00:00"。如果你习惯性写五段，会直接不触发。想改时间，在任务配置里对照 Quartz 语法改就行。

如果你已经在用青龙面板，也可以把 BiliBiliToolPro 挂进青龙，和现有脚本一起被调度。大致两步：一是把配置文件里的RepoFileExtensions从"js py"改成"js py sh"（要允许跑 shell 脚本）；二是添加一个拉库任务，拉下来后青龙会自动注册一堆bili_task_*.sh定时任务。拉库地址用仓库地址即可：

ql repo https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro "bili_task_"

拉库成功后，青龙"定时任务"里会出现一排 B 站相关任务。

单独讲明白：登录 / 扫码获取登录态

不管是哪条部署路径，"拿到登录态"都是绕不开的一步，这里统一说清楚，因为它决定了后面所有任务能不能跑。

• 本地 Console：跑--runTasks=Login出现二维码，B 站 App 扫码，Cookie 自动存到cookies.json。
• Docker / Web 面板：在面板里点"添加账号 / 触发登录"，页面给出二维码，扫码即可。
• 青龙：运行bili扫码登录任务，在运行日志里找到打印出来的二维码去扫。

Cookie 的存放位置随宿主不同而不同：Web 面板存在config/BiliBiliTool.db；Console 存在cookies.json；青龙（配了应用凭据后）会写进Ray_BiliBiliCookies__0、Ray_BiliBiliCookies__1这类环境变量。想再加一个账号，就再跑一次登录任务，多账号是原生支持的。

Cookie 有有效期，过期后任务会跳过该账号。面板里有自动检查和"Cookie 过期提醒"，过期了重新扫一次码就能续上，不用整台机器重装。

调优与收尾

跑通之后，日常最常用的其实就下面几项，改完基本就不用再动。

每日投币数量与行为（DailyTaskConfig）：

• NumberOfCoins：每日投币数，取值 0–5，经验跟投币次数挂钩。
• SelectLike：投币时是否顺手点赞，默认true。
• IsWatchVideo/IsShareVideo：是否看视频 / 分享视频，默认开。
• SaveCoinsWhenLv6：账号到 6 级后是否"攒硬币"（不再投币），默认关。

优先支持某个 UP 主：SupportUpIds填 UP 主的 ID（多个用英文逗号），任务会优先从这个人的视频里挑选观看 / 分享 / 投币；不填或填-1则从关注和排行榜随机取。UP 主 ID 在他的 B 站个人主页能查到。

安全与节流（Security）：IntervalSecondsBetweenRequestApi控制两次调 B 站 API 的间隔秒数，RandomSleepMaxMin让每天执行时间在一个范围内随机，IsSkipDailyTask设true可在不删任何东西的前提下临时停掉任务。这几个是"怕太频繁被风控"的常用旋钮。

推送通知：支持 Telegram、企业微信、钉钉、Server酱、PushPlus、Microsoft Teams 等，任务结果和 Cookie 过期都会推给你。面板里"任务配置 → 检查与提醒"可以开 Cookie 过期提醒和按任务的失败提醒，配好之后真正能"无人值守"——出了问题它先告诉你。

几个高频坑，遇到别慌：

• 定时不触发：九成是 Cron 写成了五段式。BiliBiliToolPro 用 Quartz 六段式，补上"秒"那段。
• 升级后账号没了：Web 面板账号只认config/BiliBiliTool.db，旧的cookies.json不迁移，需要重新扫码。
• Cookie 过期 / 任务跳过：先跑一次Test确认登录态，过期就重新扫码。
• 调试看更细的日志：把控制台日志级别从Information调到Debug（配置键Serilog__WriteTo__0__Args__restrictedToMinimumLevel），但 Debug 日志可能含敏感请求数据，贴出去前先打码。

如果还是解决不了，按这个顺序求助：先读 docs/configuration.md 的完整配置项说明，再看 docs/questions.md 常见问题，然后在项目 Issue 里搜相同症状。确实要提 Issue 时，附上版本、环境、复现步骤和打码后的 Debug 日志，别贴 Cookie、Token、密码。相关文档与入口：docs/runInLocal.md（本地/服务器运行）、platforms/docker/README.md（Docker）、platforms/qinglong/README.md（青龙）、docs/scheduler-settings.md（定时设置）。

按这条线走——十分钟本地跑通、Docker 常驻服务器、再配好定时和提醒——BiliBiliToolPro 就能替你自动完成 B 站的各种日常任务。先用最小配置跑起来，再按你的账号情况逐项微调，是上手最稳的节奏。

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