青龙面板安装及使用指南

目录

1. 简介
2. 软件下载
3. 环境配置
   1. Python 环境安装
   2. Node.js 环境安装
   3. Redis 环境安装
4. 青龙面板安装
   1. 面板安装
   2. 初次登录
   3. 基本设置
5. 面板使用
   1. 任务管理
   2. 定时任务
   3. 环境变量
   4. 日志管理
6. 常见问题解答
   1. 如何更新青龙面板?
   2. 如何备份和恢复青龙面板?
   3. 为什么无法登录青龙面板?
   4. 如何添加新的 cron 任务?
   5. 如何查看 cron 任务的运行日志?

简介

青龙面板是一款功能强大的定时任务管理系统,广泛应用于自动化脚本的执行和管理。它支持多种脚本语言,如 JavaScript、Python、Shell 等,并提供了丰富的功能,包括任务定时、日志查看、环境变量管理等。本文将详细介绍如何安装和使用青龙面板。

软件下载

青龙面板的最新版本可以在其官方 GitHub 仓库 https://github.com/whyour/qinglong 中下载。根据您的操作系统选择对应的安装包进行下载。

环境配置

在安装青龙面板之前,需要先确保您的系统已经安装了以下依赖环境:

Python 环境安装

青龙面板需要 Python 3.7 及以上版本,可以前往 Python 官网 下载并安装。

Node.js 环境安装

青龙面板的前端界面依赖于 Node.js,请前往 Node.js 官网 下载并安装。

Redis 环境安装

青龙面板使用 Redis 作为任务队列和缓存存储,请前往 Redis 官网 下载并安装。

青龙面板安装

面板安装

1. 解压下载的安装包,进入目录。

2. 执行以下命令安装青龙面板:

   bash

   pip install -r requirements.txt

   python3 task.py db init

   python3 main.py

3. 安装完成后,青龙面板默认会在 5700 端口启动。您可以在浏览器中访问 http://localhost:5700 进入面板。

初次登录

首次登录青龙面板时,系统会要求您设置管理员账号和密码。请妥善保管好您的登录凭证,以便后续管理。

基本设置

登录面板后,您可以在 设置 页面进行一些基本的配置,例如:

• 修改面板端口
• 设置 Redis 连接信息
• 配置 Telegram 机器人等通知渠道

面板使用

任务管理

在 任务管理 页面,您可以查看所有已添加的任务,并对其进行编辑、删除等操作。

定时任务

定时任务 页面用于管理定时执行的任务。您可以在这里添加新的定时任务,设置执行时间和脚本内容。

环境变量

环境变量 页面用于管理系统环境变量,您可以在这里添加、修改和删除环境变量。

日志管理

日志管理 页面用于查看任务的运行日志,您可以根据需要筛选和查看相关日志信息。

常见问题解答

如何更新青龙面板?

1. 停止当前运行的青龙面板进程。

2. 从 GitHub 下载最新版本的安装包,并解压缩。

3. 执行以下命令更新面板:

   bash

   pip install -r requirements.txt

   python3 task.py db upgrade

   python3 main.py

4. 更新完成后,您可以访问面板检查版本信息是否已更新。

如何备份和恢复青龙面板?

1. 备份:

   • 停止青龙面板进程。
   • 将 db 目录下的 ql.db 文件备份到安全的位置。
   • 将 data 目录下的所有文件备份到安全的位置。

2. 恢复:

   • 停止青龙面板进程。
   • 将备份的 ql.db 文件和 data 目录还原到对应位置。
   • 重新启动青龙面板进程。

为什么无法登录青龙面板?

出现无法登录的情况,可能是由于以下原因:

• 检查管理员账号和密码是否正确。
• 确保 Redis 服务正常运行,并且连接信息配置正确。
• 检查防火墙是否阻止了面板的访问。
• 尝试清除浏览器缓存并重试登录。

如何添加新的 cron 任务?

1. 进入 定时任务 页面,点击 新增任务。
2. 填写任务名称、任务表达式和脚本内容。
3. 根据需要设置任务的运行环境变量。
4. 点击 保存 即可添加新的定时任务。

如何查看 cron 任务的运行日志?

1. 进入 日志管理 页面。
2. 在 日志类型 下拉框中选择 cron。
3. 根据需要筛选任务名称或时间范围。
4. 点击 查看日志 即可查看任务的运行日志信息。