跳到主要内容

Qinglong

官方网站

Qinglong(青龙)是一个支持定时任务的JS脚本运行服务,可用于各类自动化任务管理。

Docker方式安装

compose文件

networks:
default:
external: true
name: ${DOCKER_MY_NETWORK}
services:
qinglong:
container_name: qinglong
image: whyour/qinglong:latest
restart: unless-stopped
volumes:
- ${DOCKER_HOME}/qinglong/data:/ql/data
- /etc/localtime:/etc/localtime:ro
- /etc/timezone:/etc/timezone:ro
environment:
- ENABLE_HANGUP=true
- ENABLE_WEB_PANEL=true
- TZ=${TZ}
# ports:
# - "5700:5700"
networks:
default:
ipv4_address: 172.20.0.21
deploy:
resources:
limits:
cpus: "0.5"
memory: 300M

env文件

DOCKER_HOME=/home/username/docker
DOCKER_MY_NETWORK=npm_default
TZ=Asia/Shanghai

启动

# 创建相关目录
mkdir -p ${DOCKER_HOME}/qinglong/data

# 启动容器
docker compose up -d

首次访问后需要设置管理员账号和密码。可通过 NPM 反向代理访问,默认面板端口为 5700。

备注

  1. 权限提示:某些脚本可能需要在容器内安装额外的依赖,可以通过面板的"依赖管理"功能安装。

  2. 安全建议

    • 建议不要直接对外暴露 5700 端口,而是通过 Nginx Proxy Manager 反向代理访问
    • 设置强密码并定期更改
    • 考虑启用两步验证
  3. 脚本管理

    • 通过面板上的"脚本管理"可以添加、编辑和删除脚本
    • 定时任务支持 crontab 格式的配置
    • 可以查看任务日志和执行情况
  4. 备份建议

    • 定期备份 ${DOCKER_HOME}/qinglong/data 目录
    • 可以使用面板中的"备份"功能创建配置备份
  5. 如果配置了 UFW 防火墙,可能需要放行容器使用的内部网络:

    sudo ufw allow from 172.20.0.0/24