青龙自动化工具平台安装及使用指南

青龙自动化工具平台安装及使用指南

qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台（Timed task management platform supporting Python3, JavaScript, Shell, Typescript）项目地址:https://gitcode.com/gh_mirrors/qi/qinglong

1. 项目介绍

青龙 是一个跨语言的定时任务管理平台，支持 Python3、JavaScript、Shell 和 TypeScript 等多种脚本语言，旨在帮助用户轻松实现定时任务的创建、管理和执行。该项目提供了 Web UI，方便用户通过界面操作，同时具备 Docker 容器化部署能力，便于集成到现有环境。

2. 项目快速启动

Docker 快速部署

首先确保你的系统已安装 Docker，然后运行以下命令来拉取最新镜像并启动容器：

docker run -d -p 5700:5700 --name qinglong whyour/qinglong

等待几秒钟后，青龙服务就会在本地 http://127.0.0.1:5700 可用。

使用本地源码运行

如果你希望从源码运行，先克隆仓库：

git clone https://github.com/whyour/qinglong.git
cd qinglong

然后安装依赖并启动项目：

pnpm install
pnpm start

打开浏览器访问 http://127.0.0.1:5700 即可查看运行的青龙平台。

3. 应用案例和最佳实践

示例1：定时备份数据库

你可以用青龙平台创建一个 Shell 脚本来定期备份 MySQL 数据库，如每晚2点：

#!/bin/bash
DATE=$(date +%Y%m%d)
mysqldump -u root -pYOUR_PASSWORD your_database > /path/to/backup/backup_$DATE.sql

配置定时任务 crontab 如下：

0 2 * * * /path/to/your/script.sh

最佳实践

• 将敏感数据（如密码）存储在环境变量中，而不是直接写入脚本。
• 对于重要的任务，设置邮件通知，以便及时了解任务执行情况。

4. 典型生态项目

• Crontab UI - 提供类似青龙的图形界面，用于编辑和管理用户的 crontab 文件。
• Ant Design 和 Ant Design Pro - 青龙 UI 基于这两个前端框架构建，提供专业美观的用户体验。
• UmiJS - 青龙的前端使用了 UmiJS 作为基础架构，以增强开发效率和代码组织。

了解更多生态项目，请访问青龙的 GitHub 主页上的相关资源链接或参与社区讨论。

---

本文档旨在提供一个基本的入门指引，更多详细信息和高级功能请查阅 项目官方文档。

qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台（Timed task management platform supporting Python3, JavaScript, Shell, Typescript）项目地址:https://gitcode.com/gh_mirrors/qi/qinglong