qingsudanya/qinglong

青龙 Docker 镜像文档

镜像概述

青龙是一个专注于脚本任务部署与管理的Docker镜像，旨在提供便捷的自动化脚本运行环境。通过简单的部署步骤即可快速搭建任务管理平台，支持多种脚本任务的调度、执行与维护，适用于需要自动化处理各类脚本任务的场景。

核心功能和特性

• 多部署方式支持：提供Docker单容器部署和Docker Compose编排部署两种方式，满足不同环境需求
• 丰富内置命令：集成任务管理、镜像更新、日志清理、环境检测等多种实用命令
• 持久化存储：支持数据卷挂载，确保配置和任务数据持久化
• 灵活任务调度：支持按指定条件执行任务，包括随机延迟、并发执行、指定账号执行等
• 环境自愈能力：内置环境检测与修复命令，保障运行环境稳定

使用场景

• 自动化脚本任务运行与调度
• 定时任务管理与执行
• 多账号脚本任务批量处理
• 轻量级自动化运维场景

部署方法

Docker 部署

1. 安装 Docker

bash
sudo curl -sSL get.docker.com | sh

2. 启动容器

bash
docker run -dit \
  -v $PWD/ql:/ql/data \
  -p 5700:5700 \
  --name qinglong \
  --hostname qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest

参数说明：

• -v $PWD/ql:/ql/data：将当前目录下的ql文件夹挂载到容器内的/ql/data目录，用于数据持久化
• -p 5700:5700：映射容器端口5700到宿主机端口5700，用于访问青龙管理界面
• --name qinglong：指定容器名称为qinglong
• --hostname qinglong：设置容器主机名为qinglong
• --restart unless-stopped：设置容器重启策略为除非手动停止，否则自动重启

Docker Compose 部署

1. 安装 Docker Compose

bash
sudo curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

2. 部署步骤

bash
# 创建部署目录
mkdir qinglong
# 进入目录
cd qinglong
# 下载docker-compose.yml配置文件
wget https://raw.githubusercontent.com/whyour/qinglong/master/docker/docker-compose.yml

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

使用方法

内置命令

bash
# 更新并重启青龙
ql update                                                    

# 运行自定义脚本extra.sh
ql extra                                                     

# 添加单个脚本文件
ql raw <file_url>                                             

# 添加单个仓库的指定脚本
ql repo <repo_url> <whitelist> <blacklist> <dependence> <branch>   

# 删除旧日志（保留指定天数日志）
ql rmlog <days>                                              

# 启动tg-bot
ql bot                                                       

# 检测青龙环境并修复
ql check                                                     

# 重置登录错误次数
ql resetlet                                                  
# 禁用两步登录
ql resettfa                                                  

# 依次执行任务（若设置随机延迟，将随机延迟一定秒数）
task <file_path>                                             

# 立即执行任务（无视随机延迟，前台输出日志并记录到文件）
task <file_path> now                                         

# 并发执行任务（无视随机延迟，日志直接记录到文件，可指定账号）
task <file_path> conc <env_name> <account_number>(可选) 

# 指定账号执行任务（无视随机延迟，立即运行）
task <file_path> desi <env_name> <account_number> 

参数说明