qinglong Download - qinglong Source code download

qinglong

Python

1.0.0

下載

青龍

簡體中文| English

支援Python3、JavaScript、Shell、Typescript 的定時任務管理平台

Timed task management platform supporting Python3, JavaScript, Shell, Typescript

Demo / Issues / Telegram Channel / Buy Me a Coffee

簡報/ 回饋/ Telegram 頻道/ 打賞開發者

cover

功能

支援多種腳本語言（python3、javaScript、shell、typescript）
支援線上管理腳本、環境變數、設定文件
支援線上查看任務日誌
支援秒級任務設定
支援系統級通知
支援暗黑模式
支援手機端操作

版本

docker

latest鏡像是基於alpine構建， debian鏡像是基於debian-slim構建。如果需要使用alpine不支援的依賴，建議使用debian鏡像

docker pull whyour/qinglong:latest
docker pull whyour/qinglong:debian

npm

npm 版本支援debian/ubuntu/alpine系統，需自行安裝node/npm/python3/pip3/pnpm

npm i @whyour/qinglong

部署

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 ，首次進入會提示安裝Docker服務，點選立即安裝，按提示完成安裝
安裝完成後在應用程式商店中找到青龙面板，點擊安裝，配置網域名稱等基本資訊即可完成安裝

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 && cd $_
wget https://raw.githubusercontent.com/whyour/qinglong/master/docker/docker-compose.yml

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

podman (推薦)

 # https://podman.io/getting-started/installation
podman run -dit 
  --network bridge 
  -v $PWD /ql/data:/ql/data 
  # 冒号后面的 5700 为默认端口，如果设置了 QlPort, 需要跟 QlPort 保持一致
  -p 5700:5700 
  # 部署路径非必须，比如 /test
  -e QlBaseUrl= " / " 
  # 部署端口非必须，当使用 host 模式时，可以设置服务启动后的端口，默认 5700
  -e QlPort= " 5700 " 
  --name qinglong 
  --hostname qinglong 
  docker.io/whyour/qinglong:latest

npm (本地)

建議使用純淨系統安裝，避免系統原有資料遺失，需自行安裝node/npm/python3/pip3/pnpm

 # Debian/Ubuntu
curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -

npm install -g node-pre-gyp [email protected]
npm install -g @whyour/qinglong
qinglong
# 根据提示增加环境变量 QL_DIR 和 QL_DATA_DIR，QL_DATA_DIR 必须以 /data 结尾
export QL_DIR= " "
export QL_DATA_DIR= " "
# 再次执行
qinglong

內建指令

task

 # 依次执行，如果设置了随机延迟，将随机延迟一定秒数
task < file_path >                                             
# 依次执行，无论是否设置了随机延迟，均立即运行，前台会输出日，同时记录在日志文件中
task < file_path > now                                         
# 并发执行，无论是否设置了随机延迟，均立即运行，前台不产生日，直接记录在日志文件中，且可指定账号执行
task < file_path > conc < env_name > < account_number >(可选的) 
# 指定账号执行，无论是否设置了随机延迟，均立即运行 
task < file_path > desi < env_name > < account_number >      
# 设置任务超时时间   
task -m < max_time > < file_path >
# 使用 -- 分割，-- 后面的参数会传给脚本，下面的例子，脚本就可接收到参数 -u whyour -p password
task < file_path > -- -u whyour -p password

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	任務執行時的檔案路徑

開發

git clone https://github.com/whyour/qinglong.git
cd qinglong
cp .env.example .env
# 推荐使用 pnpm https://pnpm.io/zh/installation
npm install -g [email protected]
pnpm install
pnpm start

打開你的瀏覽器，造訪http://127.0.0.1:5700