Features

• Support for multiple scripting languages (python3, javaScript, shell, typescript)
• Support online management of scripts, environment variables, configuration files
• Support online view task log
• Support second-level task setting
• Support system level notification
• Support dark mode
• Support cell phone operation
• Manage panels through the remote CLI and Agent Skill

Version

docker

The latest image is built on alpine and the debian image is built on debian-slim. If you need to use a dependency that is not supported by alpine, it is recommended that you use the debian image.

⚠️ Important: If you need to run Docker as a non-root user, please use the debian image. Alpine's crond requires root privileges.

docker pull whyour/qinglong:latest
docker pull whyour/qinglong:debian

When running the debian image as a non-root user, specify --user qinglong:

docker run -d \
  -v /path/to/ql/data:/ql/data \
  -p 5700:5700 \
  --user qinglong \
  --name qinglong \
  whyour/qinglong:debian

npm

The npm version supports debian/ubuntu/alpine systems and requires node/npm/python3/pip3/pnpm to be installed.

npm i @whyour/qinglong

Deployment

View Documentation

Built-in API

View Documentation

Built-in commands

View Documentation

Remote CLI and Agent Skill

Use the standalone npm package @whyour/qinglong-cli to manage a remote QingLong panel from your terminal or automation workflows. Create, update and run tasks and subscriptions, inspect logs, and manage applications, environment variables, scripts, configuration, dependencies and other OpenAPI resources. JSON output supports scripts and AI agents.

Requires Node.js >=22.12; Node.js 24 is recommended. Install the package to use ql:

npm install -g @whyour/qinglong-cli
ql login --url https://ql.example.com
ql auth status --json
ql task list --json
ql subscription list --json
ql --help

Create an application in the panel's System Settings → Application Settings and grant the required permissions. Enter its Client ID/Secret when prompted during login. Existing tokens are also supported through QL_URL and QL_ACCESS_TOKEN. Each command supports --help; set QL_LANG=en for English help.

The npm CLI manages remote panels. The panel's built-in executable is also named ql; use a separate installation directory on panel hosts to avoid replacing it. For local script execution and maintenance, see panel-internal tools.

CLI guide · 简体中文 · Full command reference

The package includes a remote management skill covering authentication, command selection and result verification for AI agents. Local execution and maintenance have a separate internal skill.

Development

git clone https://github.com/whyour/qinglong.git
cd qinglong
cp .env.example .env
# Recommended use pnpm https://pnpm.io/zh/installation
npm install -g [email protected]
pnpm install
pnpm start

Open your browser and visit http://127.0.0.1:5700

Links

• nevinee
• crontab-ui
• Ant Design
• Ant Design Pro
• Umijs
• darkreader
• admin-server

Name Origin

The Green Dragon, also known as the Canglong, is one of the four elephants and one of the four spirits of the heavens in traditional Chinese culture. According to the Five Elements, it is a spirit animal representing the East as a green dragon, the five elements are wood, and the season represented is spring, with the eight trigrams dominating vibration. Like the Ying Long, the Cang Long has feathered wings. According to the Zhang Guo Xing Zong (Zhang Guo Xing Zong), "a true dragon is one that has complementary wings".

In the Book of the Later Han Dynasty (後漢書-律曆志下), it is written: "The sun is in the sky, a cold and a summer, the four seasons are ready, all things are changed, the regency moves, and the green dragon moves to the star, which is called the year. (The Year of the Star)

Among the twenty-eight Chinese constellations, the Green Dragon is the generic name for the seven eastern constellations (Horn, Hyper, Diao, Fang, Heart, Tail and Minchi). It is known in Taoism as "Mengzhang" and in different Taoist scriptures as "Dijun", "Shengjian", "Shenjian" and He is also known in different Daoist scriptures as "Dijun", "Shengjun", "Shenjun" and "Ghost Catcher"[1], and is the guardian deity of Daoism, together with the White Tiger Supervisor of Soldiers.