青龙面板部署 BiliBiliToolPro 保姆级教程（订阅管理版）

本文仅介绍通过订阅管理方式将 BiliBiliToolPro 部署到青龙面板，操作简单，易于更新。

一、准备工作

1.1 青龙面板环境

• 青龙面板已正常运行（建议版本 2.10 以上）

• 强烈建议使用 debian 版青龙镜像：whyour/qinglong:debian，兼容性好，避免 .NET 环境安装失败

1.2 没有青龙面板？快速搭建

1.安装Docker（如果未安装）
curl -sSL get.docker.com | sh

2.运行青龙容器
docker run -dit \
  -v $PWD/ql/data:/ql/data \
  -p 5700:5700 \
  -e QlBaseUrl="/" \
  -e QlPort="5700" \
  --name qinglong \
  --hostname qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest

访问 http://你的IP:5700 完成初始化。

二、修改青龙配置（关键步骤）

1. 登录青龙面板，左侧菜单点击 配置文件

2. 找到 RepoFileExtensions 配置项

3. 修改为：RepoFileExtensions="js py sh"

   

4. 点击保存

⚠️ 不修改此项将无法拉取 sh 脚本，导致任务列表为空。

三、通过订阅管理添加仓库

3.1 新建订阅

1. 进入 订阅管理 页面，点击 新建订阅

2. 填写以下内容：

3. 点击 确定 保存

3.2 手动拉取

• 在订阅列表中找到刚创建的订阅，点击 运行 按钮

• 等待拉取完成，刷新页面

3.3 检查结果

拉取成功后，进入 定时任务 页面，应能看到以 bili_task_ 开头的任务列表（如 bili_task_Login.sh、bili_task_Daily.sh 等）。如果没有，请检查白名单和后缀配置。

四、配置青龙 API 鉴权（推荐）

为了让扫码后 Cookie 自动写入环境变量，需配置 Application。

4.1 新建 Application

1. 系统设置 → 应用设置 → 新建

2. 填写名称（任意），权限建议全选

3. 保存后得到 Client ID 和 Client Secret

4.2 添加环境变量

1. 进入 环境变量 页面，点击 新建

2. 添加两个变量：

五、扫码登录 B 站

1. 在 定时任务 页面找到 bili_task_Login.sh

2. 点击 运行

3. 稍等几秒，点击 日志 查看二维码

4. 使用 B 站 App 扫码登录

   

💡 首次运行会自动安装 .NET 环境，约 2~5 分钟，请耐心等待。

六、验证与测试

• 登录成功后，若已配置 Application，Cookie 会自动写入环境变量 Ray_BiliBiliCookies__0

• 手动运行 bili_task_Daily.sh 测试每日任务，查看日志确认执行正常

七、常见问题

Q：拉库后定时任务为空？
A：检查配置文件中 RepoFileExtensions 是否已添加 sh，以及订阅的白名单正则是否正确。

Q：运行任务报 .NET 安装失败？
A：你的青龙可能是 alpine 版，请改用 debian 版重装。

Q：扫码后 Cookie 未自动保存？
A：确认已正确配置 Client ID 和 Secret；若未配置，需手动从日志复制 Cookie 到环境变量。

Q：任务卡住不结束？
A：在定时任务的“执行后”输入框填写 echo success，保存后重试。