shufflewzc/qinglong

青龙-小Faker

镜像概述

青龙-小Faker是一个功能强大的定时任务管理工具，支持Python、JavaScript、Shell及TypeScript等多种脚本语言，提供直观的Web可视化界面，方便用户创建、配置、监控和执行定时任务，适用于各类自动化脚本的定时调度需求。

核心功能和特性

• 多语言支持：兼容Python、JavaScript、Shell、TypeScript等多种脚本语言
• 可视化管理：提供Web界面，支持任务的创建、编辑、删除和状态监控
• 灵活定时调度：基于crontab语法，支持自定义任务触发时间配置
• 任务日志记录：详细记录任务执行过程和结果，便于问题排查
• 容器化部署：通过Docker实现快速部署，简化安装和环境配置流程

使用场景和适用范围

• 自动化脚本执行：如定时数据爬取、文件备份、系统监控告警等
• 开发测试环境：定时运行测试脚本、自动化构建任务、接口测试等
• 个人/企业自动化：替代传统crontab，提供更友好的任务管理方式

使用方法和配置说明

Docker Run 快速部署

bash
docker run -d \
  --name qinglong \
  -p 5700:5700 \
  -v /path/to/local/data:/ql/data \
  --restart always \
  whyour/qinglong:latest

参数说明：

• -p 5700:5700：将容器5700端口映射到主机，用于访问Web管理界面
• -v /path/to/local/data:/ql/data：挂载本地目录到容器，持久化任务配置和日志数据
• --restart always：设置容器退出后自动重启

Docker Compose 配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  qinglong:
    image: whyour/qinglong:latest
    container_name: qinglong
    ports:
      - "5700:5700"
    volumes:
      - ./ql-data:/ql/data  # 本地数据目录映射
    restart: always

启动命令：docker-compose up -d

访问与使用

部署完成后，通过浏览器访问 http://<主机IP>:5700 进入管理界面，根据引导完成初始配置，即可开始创建和管理定时任务。

致谢

感谢以下项目和贡献者的支持：

• nevinee
• https://github.com/alseambusher/crontab-ui
• Ant Design
• Ant Design Pro
• Umijs3.0
• https://github.com/darkreader/darkreader