前言

本教程基于飞牛系统fnOS 0.8.47的Docker Compose功能进行搭建。

简介

青龙面板（Qinglong Panel）是一款开源的自动化任务管理平台，凭借其灵活的任务调度和脚本支持能力，成为开发者、运维人员及普通用户提升效率的利器。
定义：青龙面板是一款基于Web界面的多语言脚本支持工具，专注于服务器管理和自动化任务执行，适用于定时任务调度、脚本运行监控等场景。

  • 核心功能

  1. 任务管理
    定时任务：支持Crontab表达式配置，秒级任务执行精度。
    脚本执行：兼容Python、JavaScript、Shell、TypeScript等多种语言，用户可直接上传或在线编辑脚本。
    任务日志：实时查看任务执行状态、输出结果及错误排查信息。

  2. 自动化生态支持
    环境变量管理：全局或任务级变量配置，提升脚本灵活性。
    依赖管理：支持Node.js、Python等依赖库的批量安装与维护。
    通知系统：集成邮件、微信、钉钉等通知方式，任务异常时自动告警。

  • 典型应用场景

  1. 服务器运维
    自动化执行备份脚本、服务重启等维护任务。

  2. 自动化任务
    电商场景：京东自动签到、价格监控、抢购脚本。
    数据采集：爬虫脚本定时运行，支持数据清洗与存储。
    个人工具：B站每日任务、云盘签到、游戏脚本托管。

  3. 开发与测试
    自动化测试脚本调度（如API接口测试）。
    开发环境的快速部署与配置。

部署

  1. 打开Docker管理器，选择「Compose」，点击右上角「新增项目」。

  2. 在创建项目窗口中填写「项目名称」和选择数据存放「路径」，然后选择「创建docker-compose.yml」，将下列代码根据自己实际情况修改后复制粘贴进去。

    version: '3'
services:
  qinglong:
    image: whyour/qinglong:latest
    container_name: qinglong
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai  # 设置时区
    volumes:
      - ./data:/ql/data    # 持久化存储配置和脚本
    ports:
      - "5700:5700"        # 宿主机端口:容器端口（可自定义宿主机端口）

    勾选「创建项目后立即启动」，最后点击「确定」。

  3. 等待构建完成，然后在浏览器中输入IP:Port​访问。

使用

  1. 初始化配置，直接点击「开始安装」。

  2. 通知设置，先点击「跳过」。

  3. 账户设置，可自定义青龙面板后台管理的用户名和密码，然后点击「提交」。

  4. 完成安装，点击「去登录」。

  5. 输入自定义的用户名和密码，然后点击「登录」。

  6. Node.js​依赖环境安装，在最左侧菜单栏选择「依赖管理」，然后点击「创建依赖」，「依赖类型」选择node.js​，「自动拆分」选择是​，「名称」填写以下内容：

    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
ds

    最后点击「确定」。

  7. Python3​依赖环境安装，在最左侧菜单栏选择「依赖管理」，然后点击「创建依赖」，「依赖类型」选择python3​，「自动拆分」选择是​，「名称」填写以下内容：

    requests
canvas
ping3
jieba
aiohttp

    最后点击「确定」。

  8. 更多使用教程，请参照官方文档 Qinglong Doc（https://qinglong.online/guide/user-guide）