BiliBiliToolPro/qinglong

在青龙中运行

原理是，利用青龙的拉库命令，拉取本仓库源码，自动添加cron定时任务，然后在青龙容器中安装dotnet环境或bilitool的二进制包，定时运行相应的Task。

开始前，请先确保你的青龙面板是运行正常的。

• 1. 步骤
  • 1.1. 登录青龙面板并修改配置
  • 1.2. 在青龙面板中添加拉库定时任务
    • 1.2.1. 方式一：订阅管理
    • 1.2.2. 方式二：定时任务拉库
  • 1.3. 检查定时任务
  • 1.4. 配置青龙Client Secret（可选）
    • 1.4.1. 新建 Application
    • 1.4.2. 密钥配置到环境变量
  • 1.5. Bili登录
• 2. 先行版
• 3. GitHub加速
• 4. 常见问题
  • 4.1. 安装dotnet失败怎么办法
  • 4.2. Couldn't find a valid ICU package installed on the system
  • 4.3. 提示文件不存在或路径异常，怎么排查
  • 4.4. The configured user limit (128) on the number of inotify instances has been reached

1. 步骤

1.1. 登录青龙面板并修改配置

青龙面板，配置文件页。

修改 RepoFileExtensions="js py" 为 RepoFileExtensions="js py sh"

保存配置。

1.2. 在青龙面板中添加拉库定时任务

两种方式，任选其一即可：

1.2.1. 方式一：订阅管理

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

没提到的不要动。

保存后，点击运行按钮，运行拉库。

1.2.2. 方式二：定时任务拉库

青龙面板，定时任务页，右上角添加任务，填入以下信息：

名称：拉取Bili库
命令：ql repo https://github.com/RayWangQvQ/BiliBiliToolPro.git "bili_task_"
定时规则：2 2 28 * *

点击确定。

保存成功后，找到该定时任务，点击运行按钮，运行拉库。

1.3. 检查定时任务

如果正常，拉库成功后，会自动添加bilibili相关的task任务。

1.4. 配置青龙Client Secret（可选）

扫码登录Bili后，需要有权限向青龙的环境变量中持久化Cookie，所以需要添加一个鉴权。

青龙官方说明：https://qinglong.online/api/preparation

1.4.1. 新建 Application

青龙 -> 系统设置 -> 应用设置，点击新建。

1.4.2. 密钥配置到环境变量

将上面2个值添加到环境变量中即可。

Name分别为：

• Ray_QingLongConfig__ClientId
• Ray_QingLongConfig__ClientSecret

1.5. Bili登录

在青龙定时任务中，点击运行bili扫码登录任务，查看运行日志，扫描日志中的二维码进行登录。

登录成功后，如果已配置了上述的Application，会将cookie保存到青龙的环境变量中：

如果未配置Application，会打印出cookie，请手动自己到环境变量中添加。

首次运行会自动安装环境，时间可能长一点，之后就不需要重复安装了。

2. 先行版

青龙拉库时可以指定分支，develop分支的代码会超前于默认的main分支，包含当前正在开发的新功能。

想提前体验新功能，或想要Bug能快速得到解决的朋友，可以尝试切换先行版，但同时也意味着稳定性会相应降低（其实可以忽略不计~🤨）。

分支：develop
白名单：bili_dev_task_.+\.sh

其他选项同上。

3. GitHub加速

拉库时，如果服务器在国内，访问GitHub速度慢，可在仓库地址前加上加速代理进行加速。

如：

https://github.moeyy.xyz/https://github.com/RayWangQvQ/BiliBiliToolPro.git
https://gh-proxy.com/https://github.com/RayWangQvQ/BiliBiliToolPro.git
...

加速代理地址通常不能保证长期稳定，请自行查找使用。

4. 常见问题

4.1. 安装dotnet失败怎么办法

首先，青龙有两个版本的镜像：

• alpine：whyour/qinglong:latest
• debian：whyour/qinglong:debian

安装dotnet失败的情况，几乎全发生在alpine版上。。。

所以，如果你“执迷不悟”，就是一定要用alpine版，那请先通过日志自行排查，不行就根据微软官方文档，进入qinglong容器后，手动安装。

如果还不行，那么可以切换到基于bilitool的二进制包运行方式，该方式不需要安装dotnet，方式：

编辑青龙面板的配置文件，新增如下两行：

export BILI_MODE="bilitool" # bili运行模式，dotnet或bilitool
export BILI_GITHUB_PROXY="https://github.moeyy.xyz/" # 下载二进制包时使用的加速代理，不要的话则置空

bilitool没有先行版的概念，因为只有main分支才会打包，更新会稍慢一点。

另外，alpine版的问题，我不建议来提交issue，因为已经大大超出本项目的scope了，建议可以去给alpine官方或微软的dotnet官方提交issue。

4.2. Couldn't find a valid ICU package installed on the system

如 #266 ，需要在青龙面板的环境变量添加如下环境变量：

名称：DOTNET_SYSTEM_GLOBALIZATION_INVARIANT
值：1

4.3. 提示文件不存在或路径异常，怎么排查

需要docker exec -it qinglong bash后，查看几个常用路径：

/ql
    /data
        /repo
    /scripts
    /shell

• /ql/dada/repo目录下存储了拉库后，bilitool的源代码
• /ql/scripts目录下存储了bilitool的定时运行脚本
• /ql/shell目录下是青龙的基础脚本

请cd到相应目录，查看该目录下文件是否存在，状态是否正常。

4.4. The configured user limit (128) on the number of inotify instances has been reached

报错：

Asp.Net Core - The configured user limit (128) on the number of inotify instances has been reached

可以尝试添加如下环境变量解决：

DOTNET_USE_POLLING_FILE_WATCHER=1

添加后，对配置变更事件的监听，会从监听 Linux 系统的 inotify 事件，变成定时轮询。