saysaucee/qinglong

青龙面板 Docker 镜像文档

概述

青龙面板是一款轻量级自动化脚本管理工具，提供Web界面用于配置和管理定时任务、脚本执行及相关数据。该Docker镜像封装了完整运行环境，支持快速部署和数据持久化，适用于需要集中管理自动化脚本的场景。

核心功能与特性

• 脚本管理：支持添加、编辑、删除各类自动化脚本
• 定时任务：可视化配置任务执行时间和频率
• 数据持久化：通过挂载卷实现配置、日志、数据库等数据持久化存储
• 多目录分离：独立管理配置、日志、脚本、仓库等功能目录
• Web界面：提供直观的Web管理界面，默认端口5700
• 容器化部署：简化部署流程，支持容器重启策略配置

使用场景

• 个人或团队需要自动化执行定时脚本的场景
• 需集中管理多个脚本及其执行计划的场景
• 希望通过容器化方式快速部署脚本管理工具的场景

使用方法

基本部署（docker run）

使用以下命令部署青龙面板容器：

bash
docker run -dit \
  -v $PWD/ql-1/config:/ql/config \  # 配置文件目录
  -v $PWD/ql-1/log:/ql/log \        # 日志文件目录
  -v $PWD/ql-1/db:/ql/db \          # 数据库文件目录
  -v $PWD/ql-1/repo:/ql/repo \      # 脚本仓库目录
  -v $PWD/ql-1/raw:/ql/raw \        # 原始文件目录
  -v $PWD/ql-1/scripts:/ql/scripts \# 脚本文件目录
  -v $PWD/ql-1/jbot:/ql/jbot \      # jbot相关文件目录
  -p 5700:5700 \                    # 映射Web界面端口
  --name ql-1 \                     # 容器名称
  --hostname ql-1 \                 # 容器主机名
  --restart unless-stopped \        # 重启策略：除非手动停止
  saysaucee/qinglong                # 镜像名称

参数说明

挂载卷（-v）

• /ql/config：存放配置文件，包括用户设置、任务配置等
• /ql/log：存储应用运行日志，用于问题排查
• /ql/db：数据库文件目录，保存任务数据、执行记录等
• /ql/repo：脚本仓库目录，支持从仓库拉取脚本
• /ql/raw：原始文件存储目录
• /ql/scripts：用户自定义脚本存放目录
• /ql/jbot：jbot相关配置和数据目录

端口映射（-p）

• 5700:5700：将容器内Web界面端口映射到主机5700端口，通过http://主机IP:5700访问面板

容器设置

• --name ql-1：指定容器名称为ql-1
• --hostname ql-1：设置容器主机名为ql-1
• --restart unless-stopped：容器退出时自动重启（手动停止除外）

访问面板

部署完成后，通过浏览器访问 http://主机IP:5700 即可打开青龙面板Web界面，进行脚本管理和任务配置。