0af546cd1d
## 背景 原方案使用系统 Python + pip --prefix 安装依赖到 data/dep_cache/python3， 系统 Python 环境被污染，且无法隔离不同项目的依赖。 ## 改动内容 ### 核心：Python venv 支持 - shell/start.sh: 使用 python3 -m venv 创建虚拟环境，替代 --prefix 模式 - 从 .env 文件读取 PYTHON_VENV_DIR 配置 - 首次启动自动创建 .venv，已存在则跳过 - 仅将 .venv/bin 加入 PATH 优先级，不设置 PYTHONHOME/PYTHONPATH（避免破坏 venv 机制） - .env 不再强制覆盖，仅首次从 .env.example 复制 - 启动时自动修复 task/ql 软链接指向当前部署目录 ### 后端适配 - back/config/const.ts: 新增 PYTHON_VENV_DIR 常量 - back/config/util.ts: venv 模式下跳过 pip --prefix，直接使用 venv 的 pip3 ### 开发模式支持 - shell/dev-env.sh: pnpm start 时自动 source，将 .venv/bin 加入 PATH - package.json: start:back 加入 source dev-env.sh ### 新增文件 - shell/start-simplify.sh: 精简版启动脚本（跳过系统依赖安装，适用于已预装环境的服务器） - README-NODE.md: Node.js 原生部署完整文档 ### 配置 - .env.example: 新增 PYTHON_VENV_DIR=./.venv 配置项（默认注释状态） ## 兼容性 - Docker 模式不受影响（使用独立的 docker-entrypoint.sh，走原有 --prefix 逻辑） - 未配置 PYTHON_VENV_DIR 时默认使用系统 Python（向后兼容） |
||
|---|---|---|
| .github | ||
| back | ||
| docker | ||
| docs | ||
| sample | ||
| shell | ||
| src | ||
| .editorconfig | ||
| .env.example | ||
| .gitignore | ||
| .npmignore | ||
| .npmrc | ||
| .prettierignore | ||
| .prettierrc | ||
| .umirc.ts | ||
| ecosystem.config.js | ||
| LICENSE | ||
| nodemon.json | ||
| package.json | ||
| pnpm-lock.yaml | ||
| README-en.md | ||
| README-NODE.md | ||
| README.md | ||
| SECURITY.md | ||
| tsconfig.json | ||
| typings.d.ts | ||
| version.yaml | ||
青龙
简体中文 | English
支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台
Timed task management platform supporting Python3, JavaScript, Shell, Typescript
Demo / Issues / Telegram Channel / Buy Me a Coffee
演示 / 反馈 / Telegram 频道 / 打赏开发者
功能
- 支持多种脚本语言（python3、javaScript、shell、typescript）
- 支持在线管理脚本、环境变量、配置文件
- 支持在线查看任务日志
- 支持秒级任务设置
- 支持系统级通知
- 支持暗黑模式
- 支持手机端操作
版本
docker
latest 镜像是基于 alpine 构建，debian 镜像是基于 debian-slim 构建。如果需要使用 alpine 不支持的依赖，建议使用 debian 镜像
⚠️ 重要提示: 如果您需要以非 root 用户运行 Docker，请使用 debian 镜像。Alpine 的 crond 需要 root 权限。
docker pull whyour/qinglong:latest
docker pull whyour/qinglong:debian
使用 debian 镜像以非 root 用户运行时，需指定 --user qinglong：
docker run -d \
-v /path/to/ql/data:/ql/data \
-p 5700:5700 \
--user qinglong \
--name qinglong \
whyour/qinglong:debian
npm
npm 版本支持 debian/ubuntu/alpine 系统，需要自行安装 node/npm/python3/pip3/pnpm
npm i @whyour/qinglong
部署
内置 API
内置命令
开发
git clone https://github.com/whyour/qinglong.git
cd qinglong
cp .env.example .env
# 推荐使用 pnpm https://pnpm.io/zh/installation
npm install -g pnpm@8.3.1
pnpm install
pnpm start
打开你的浏览器，访问 http://127.0.0.1:5700
链接
名称来源
青龙，又名苍龙，在中国传统文化中是四象之一、天之四灵之一，根据五行学说，它是代表东方的灵兽，为青色的龙，五行属木，代表的季节是春季，八卦主震。苍龙与应龙一样，都是身具羽翼。《张果星宗》称“又有辅翼，方为真龙”。
《后汉书·律历志下》记载：日周于天，一寒一暑，四时备成，万物毕改，摄提迁次，青龙移辰，谓之岁。
在中国二十八宿中，青龙是东方七宿（角、亢、氐、房、心、尾、箕）的总称。 在早期星宿信仰中，祂是最尊贵的天神。 但被道教信仰吸纳入其神系后，神格大跌，道教将其称为“孟章”，在不同的道经中有“帝君”、“圣将”、“神将”和“捕鬼将”等称呼，与白虎监兵神君一起，是道教的护卫天神。