青龙面板搭建教程

青龙面板

青龙是 whyour 大佬写的一个定时任务管理平台，支持 Python3、JavaScript、Shell、Typescript，简单来说就是可以定时运行一些脚本，就比如说薅羊毛、签到、抢购等等，谁会跟羊毛过意不去呢？

青龙面板涵盖以下功能

支持多种脚本语言（python3、JavaScript、shell、typescript）

支持在线管理脚本、环境变量、配置文件

支持在线查看任务日志

支持秒级任务设置

支持系统级通知

支持暗黑模式

支持手机端操作

搭建部署

推荐使用Docker进行部署，NAS或者面板（如宝塔、1Panel等）可以直接在镜像仓库搜索进行部署，如果是云服务器等先下载安装docker，再进行青龙的部署，从大佬的README中可以看到相关部署的教程，我这里搬运下

latest 镜像是基于 alpine 构建，debian 镜像是基于 debian-slim 构建。如果需要使用 alpine 不支持的依赖，建议使用 debian 镜像，下面是拉取镜像命令

1 2	`docker pull whyour/qinglong:latest docker pull whyour/qinglong:debian`

下面进行部署青龙

docker (推荐)

curl -sSL get.docker.com | sh
docker run -dit \
  -v $PWD/ql/data:/ql/data \
  # 冒号后面的 5700 为默认端口，如果设置了 QlPort, 需要跟 QlPort 保持一致
  -p 5700:5700 \
  # 部署路径非必须，比如 /test
  -e QlBaseUrl="/" \
  # 部署端口非必须，当使用 host 模式时，可以设置服务启动后的端口，默认 5700
  -e QlPort="5700" \
  --name qinglong \
  --hostname qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest

docker-compose (推荐)

#  curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
mkdir qinglong
wget https://raw.githubusercontent.com/whyour/qinglong/master/docker/docker-compose.yml

# 启动
docker-compose up -d
# 停止
docker-compose down

到此就完成了，然后在本地打开青龙面板界面，默认端口为5700，打开你的浏览器，访问 http://127.0.0.1:5700可进入安装向导，设置账户密码，按要求一步一步即可，推送可先不填，如果没有进入配置向导，可在终端执行以下命令查看账号密码

1	`docker exec -it qinglong cat /ql/config/auth.json`

看到如下界面就完成了

拔毛行动

拉取脚本仓库

在拉取脚本仓库之前需要先了解下拉取命令的格式，青龙有个内置命令：ql ，描述如下：

# 更新并重启青龙
ql update
# 运行自定义脚本extra.sh
ql extra
# 添加单个脚本文件
ql raw <file_url>
# 添加单个仓库的指定脚本
ql repo <repo_url> <whitelist> <blacklist> <dependence> <branch> <extensions>
# 删除旧日志
ql rmlog <days>
# 启动tg-bot
ql bot
# 检测青龙环境并修复
ql check
# 重置登录错误次数
ql resetlet                                            
# 禁用两步登录
ql resettfa

参数说明
file_url 脚本地址
repo_url 仓库地址
whitelist 拉取仓库时的白名单，即就是需要拉取的脚本的路径包含的字符串，多个竖线分割
blacklist 拉取仓库时的黑名单，即就是需要拉取的脚本的路径不包含的字符串，多个竖线分割
dependence 拉取仓库需要的依赖文件，会直接从仓库拷贝到scripts下的仓库目录，不受黑名单影响，多个竖线分割
extensions 拉取仓库的文件后缀，多个竖线分割
branch 拉取仓库的分支
days 需要保留的日志的天数
file_path 任务执行时的文件路径

对上述命令有个初步了解之后，再看拉库命令就明了很多了，首先我们先拉个6dy大佬写的JD签到做任务的库6dylan6/jdpro[2]，登陆后选择订阅管理创建订阅，在名称一行输入拉库指令如下：

国内机（带代理）：

1	`ql repo https://js.jdpro.site/https://github.com/6dylan6/jdpro.git "jd_\|jx_\|jddj_" "backUp" "^jd[^_]\|USER\|JD\|function\|sendNotify\|utils"`

默认代理拉不了，自行找可用代理

国外机：

1	`ql repo https://github.com/6dylan6/jdpro.git "jd_\|jx_\|jddj_" "backUp" "^jd[^_]\|USER\|JD\|function\|sendNotify\|utils"`

定时任务随意，要遵循crontab表达式规则，可以使用这个在线工具 https://tool.lu/crontab 里面也有详细说明每个字段的意思

创建订阅

创建完成后可在订阅管理中看到刚刚创建的订阅，此时点击右侧运行等待拉库完成即可，后面会根据你设置的定时规则自动拉库，这样就做到自动更新脚本了

运行订阅

点击日志可以查看到拉库状态，我这里是已经拉完了，实际第一次拉库会显示添加XXX任务成功的log

拉库

此时点击左侧定时任务，便可查看到刚刚拉下来的脚本了

定时任务

这里的定时规则可以根据自己的需求改动，右侧也可以手动运行，查看日志看看是否运行错误，顶部更多可以创建视图进行分类，当脚本过多时不会显得太乱

安装依赖

我们只拉库还不行，此时运行可以发现，肯定是会报错的，通常表现为

# 缺少依赖
Error: Cannot find module ‘xx’

'xxxx' module not found

# 缺少Python依赖
ModuleNotFoundError: No module named ‘xxx’

# 拉库不完整，缺少相应文件，检查拉库命令重新拉库
Error: Cannot find module ‘./xx’

对于缺少依赖的问题，可以在左侧依赖管理进行安装，通常需要安装的依赖如下所示：

NodeJs:

crypto-js
prettytable
dotenv
jsdom
date-fns
tough-cookie
tslib
ws@7.4.3
ts-md5
jsdom -g
jieba
fs
form-data
json5
global-agent
png-js
@types/node
require
typescript
js-base64
axios
moment

Python3:

requests
canvas
ping3
jieba
PyExecJS
aiohttp

Linux:

1
2
3

bizCode
bizMsg
lxm

安装失败可以在系统设置 - 依赖设置里面配置代理或者镜像源

我这里用的是这个

Node 软件包镜像源：

1	`https://registry.npmmirror.com`

Python 软件包镜像源：

1	`https://pypi.tuna.tsinghua.edu.cn/simple`

Linux 软件包镜像源：

1	`https://mirrors.aliyun.com`

当然还是推荐对应的一键安装脚本QLDependency[3]：

一键安装单独青龙的依赖
国内版：

1	`docker exec -it qinglong bash -c "$(curl -fsSL https://ghproxy.com/https://raw.githubusercontent.com/FlechazoPh/QLDependency/main/Shell/QLOneKeyDependency.sh \| bash)"`

国外版：