青龙面板文档 不推荐使用

警告

请尽量不要使用青龙面板，青龙面板不同版本带着不同特性，导致本程序在不同版本中运行情况不同，文档无法覆盖所有情况，除非自己了解青龙面板的运行机制，已经有一定的 Linux 和 Node.js 基础，否则不建议使用青龙面板。本人不提供任何除本文档使用版本外的支持。

注意

测试使用 v2.13.8 版本，最新版都 2.16.x，别惦记你那 2.11.x 版本了，更新吧。

已知低版本安装依赖后提示 require(...).ql is not a function 。该错误与 bilioutils 无关，与 node，npm 无关，请考虑升级青龙面板。

如果确实什么不得已的原因，无法升级青龙面板，可以考虑参考此处，作者的恩赐，然后在尝试运行。

• 默认配置文件名 cat_bili_config.json，或 .json5
• 配置文件名也可以通过环境变量 BILITOOLS_FILE_NAME 指定，后缀 .json 可以省略
• 由于作者并不熟悉，建议直接看青龙面板教程 https://github.com/whyour/qinglong

使用 npm 包

安装 Node 依赖

在侧边栏依赖管理中添加 Node 依赖

bilioutils

TIP

开始安装依赖 bilioutils，开始时间 2023/8/15 20:30:31
WARN using --force Recommended protections disabled.

依赖一直（长时间）在安装中可能是仓库源地址的问题，切换 npm 源。

拉取运行代码

Gitee

ql raw https://gitee.com/catlair/BiliOutils/raw/main/tools/bilitools_npm.js

Github

ql raw https://raw.githubusercontent.com/catlair/BiliOutils/main/tools/bilitools_npm.js

手动

// 手动创建一个 `bilitools_npm.js` 文件，并且把下面的代码拷贝进去

require('bilioutils').ql();

// 然后手动创建一个任务， `task bilitools_npm.js`

更新 BiliOutils

删除依赖 bilioutils，并重新安装该依赖即可。

自动更新可以手动添加一个任务，运行命令为 pnpm remove bilioutils && pnpm add bilioutils

更新 cookie

拉取青龙面板运行的代码

Gitee

ql raw https://gitee.com/catlair/BiliOutils/raw/main/tools/bilitools_login.js

Github

ql raw https://raw.githubusercontent.com/catlair/BiliOutils/main/tools/bilitools_login.js

手动

// 手动创建一个 `任意名称.js` 文件，并且把下面面的代码拷贝进去

require('bilioutils').sacnLogin();

// 然后手动创建一个任务， `task 任意名称.js`

// 再使用手机扫码，如果 mid 存在于配置文件中，会自动更新，否则获取到的 cookie 会打印到控制台，以及 log 文件，请自行复制到配置文件中。

// 之后可以选择禁用任务，不要它自动运行。

参考视频

运行

旧版本错误解决

配置文件

创建一个配置文件 cat_bili_config.json 配置与其他相同

或者使用环境变量

注意：青龙不是 config.json （虽然也能用）, 而是 cat_bili_config.json。（共用文档，懒得改了）

以下 config.json 或 config.json5 都是符合要求的配置文件位置，选则一个合适的位置即可。如果你创建了多个，那。。。。别创建多个啊。

├── config
│  ├── config.json
│  └── config.json5
└── src
   ├── config
   │  ├── config.json
   │  └── config.json5
   ├── config.json
   ├── config.json5
   └── index.js

或者这样更加生动

config

src

• 如果还不知道怎么配置，可以点击查看配置参考
• 你可以不用文件配置，而是使用环境变量 BILITOOLS_CONFIG（同样的配置，但需要 gzip 压缩）

npm 参数

讨论：https://github.com/catlair/BiliOutils/issues/90#issuecomment-1190364619

由于青龙面板也是通过 npm 运行的，所以理所应当的能够使用 npm 参数。

--config 或者 -c 自定义配置文件的路径，可以是绝对路径，或者相对路径。

--item 或者 -i 多用户配置执行指定的配置，下标 1 开始（倒数 -1 开始），使用英文逗号（,）分隔。逻辑错误：如果你的配置中有错误配置或者空缺是不计算在内的，所以配置就好好的配置。

--task 或者 -t 执行指定的 task，使用英文逗号（,）分隔。注意很多任务（特别是需要判断大会员状态的任务）需要先执行 loginTask 任务。

--delay 运行任务前休眠多少时间（模仿随机运行），值有两种写法，第一种是 10m-1h 在 10 分钟和 1 小时直接随机，第二种是 1h，在 0 到 1h 之间随机。关于单位：不带单位是（m）分钟，单位可以为 ms（毫秒）、s（秒）、m（分）、h（小时）。

切换 npm 源

以下没有说明的版本为未测试版本，不保证哪个方式可用。

2.11.x 版本

pnpm config set registry https://registry.npmmirror.com/ && pnpm install

任务创建好后运行（没有日志），或者在终端运行（有日志），运行完成后最好删除任务。

完成后即可在依赖管理里面安装依赖了。

2.13.x 版本

参考 2.11.x，需要修改命令

pnpm config set registry https://registry.npmmirror.com/ && pnpm install && pnpm install -g

最新版本

似乎可以直接在青龙的配置里面配置 https://registry.npmmirror.com/

旧版本 ql 函数不存在

方案一：指定导入文件

修改拉取运行代码中的包bilioutils，改为 bilioutils/main。

require('bilioutils').ql(); 
require('bilioutils/main').ql(); 

方案二：手动在指定目录安装依赖

在什么地方输入下面的命令？你运行过 ql raw 吗？

提示：Docker Desktop 打开容器终端，或者 docker exec -it 容器名 sh，这是青龙的使用方法，不是本项目的使用方法，不提供更多的帮助，勿扰。

cd /ql/scripts
pnpm config set registry https://registry.npmmirror.com/
pnpm install
pnpm add bilioutils

这样操作后更新也需要在此手动更新 pnpm add bilioutils