{"id":13455755,"url":"https://github.com/whyour/qinglong","last_synced_at":"2026-10-18T21:05:30.785Z","repository":{"id":37233200,"uuid":"347404990","full_name":"whyour/qinglong","owner":"whyour","description":"支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台（Timed task management platform supporting Python3, JavaScript, Shell, Typescript）","archived":false,"fork":false,"pushed_at":"2026-10-08T17:41:37.000Z","size":18541,"stargazers_count":19938,"open_issues_count":93,"forks_count":3221,"subscribers_count":137,"default_branch":"develop","last_synced_at":"2026-10-08T19:21:42.467Z","etag":null,"topics":["crontab","docker","javascript","python","shell","task-manager","typescript"],"latest_commit_sha":null,"homepage":"https://qinglong.online","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whyour.png","metadata":{"files":{"readme":"README-en.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2021-03-13T15:21:04.000Z","updated_at":"2026-10-08T19:18:20.000Z","dependencies_parsed_at":"2026-09-13T07:25:43.570Z","dependency_job_id":null,"html_url":"https://github.com/whyour/qinglong","commit_stats":null,"previous_names":[],"tags_count":95,"template":false,"template_full_name":null,"purl":"pkg:github/whyour/qinglong","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyour%2Fqinglong","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyour%2Fqinglong/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyour%2Fqinglong/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyour%2Fqinglong/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whyour","download_url":"https://codeload.github.com/whyour/qinglong/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whyour%2Fqinglong/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38341850,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-18T02:00:06.448Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crontab","docker","javascript","python","shell","task-manager","typescript"],"created_at":"2024-07-31T08:01:10.601Z","updated_at":"2026-10-18T21:05:30.780Z","avatar_url":"https://github.com/whyour.png","language":"TypeScript","funding_links":["https://www.buymeacoffee.com/qinglong"],"categories":["Utilities","TypeScript","JavaScript","Crontab","Hack","Media automation (\\*arr stack)"],"sub_categories":["Automation and Scripting"],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg width=\"100\" src=\"https://user-images.githubusercontent.com/22700758/191449379-f9f56204-0e31-4a16-be5a-331f52696a73.png\"\u003e\n\n\u003ch1 align=\"center\"\u003eQinglong\u003c/h1\u003e\n\n[简体中文](./README.md) | English\n\nTimed task management platform supporting Python3, JavaScript, Shell, Typescript\n\n[![npm version][npm-version-image]][npm-version-url] [![docker pulls][docker-pulls-image]][docker-pulls-url] [![docker stars][docker-stars-image]][docker-stars-url] [![docker image size][docker-image-size-image]][docker-image-size-url]\n\n[npm-version-image]: https://img.shields.io/npm/v/@whyour/qinglong?style=flat\n[npm-version-url]: https://www.npmjs.com/package/@whyour/qinglong?activeTab=readme\n[docker-pulls-image]: https://img.shields.io/docker/pulls/whyour/qinglong?style=flat\n[docker-pulls-url]: https://hub.docker.com/r/whyour/qinglong\n[docker-stars-image]: https://img.shields.io/docker/stars/whyour/qinglong?style=flat\n[docker-stars-url]: https://hub.docker.com/r/whyour/qinglong\n[docker-image-size-image]: https://img.shields.io/docker/image-size/whyour/qinglong?style=flat\n[docker-image-size-url]: https://hub.docker.com/r/whyour/qinglong\n\n[Demo](http://demo.qinglong.online:4433/) / [Issues](https://github.com/whyour/qinglong/issues) / [Telegram Channel](https://t.me/jiao_long) / [Buy Me a Coffee](https://www.buymeacoffee.com/qinglong)\n\n[演示](http://demo.qinglong.online:4433/) / [反馈](https://github.com/whyour/qinglong/issues) / [Telegram 频道](https://t.me/jiao_long) / [打赏开发者](https://user-images.githubusercontent.com/22700758/244744295-29cd0cd1-c8bb-4ea1-adf6-29bd390ad4dd.jpg)\n\u003c/div\u003e\n\n![cover](https://user-images.githubusercontent.com/22700758/244847235-8dc1ca21-e03f-4606-9458-0541fab60413.png)\n\n## Features\n\n- Support for multiple scripting languages (python3, javaScript, shell, typescript)\n- Support online management of scripts, environment variables, configuration files\n- Support online view task log\n- Support second-level task setting\n- Support system level notification\n- Support dark mode\n- Support cell phone operation\n- Manage panels through the [remote CLI and Agent Skill](#remote-cli-and-agent-skill)\n\n## Version\n\n### docker\n\nThe `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.\n\n**⚠️ Important**: If you need to run Docker as a **non-root user**, please use the `debian` image. Alpine's `crond` requires root privileges.\n\n```bash\ndocker pull whyour/qinglong:latest\ndocker pull whyour/qinglong:debian\n```\n\nWhen running the `debian` image as a non-root user, specify `--user qinglong`:\n\n```bash\ndocker run -d \\\n  -v /path/to/ql/data:/ql/data \\\n  -p 5700:5700 \\\n  --user qinglong \\\n  --name qinglong \\\n  whyour/qinglong:debian\n```\n\n### npm\n\nThe npm version supports `debian/ubuntu/alpine` systems and requires `node/npm/python3/pip3/pnpm` to be installed.\n\n```bash\nnpm i @whyour/qinglong\n```\n\n## Deployment\n\n[View Documentation](https://qinglong.online/guide/getting-started/installation-guide)\n\n## Built-in API\n\n[View Documentation](https://qinglong.online/guide/user-guide/built-in-api)\n\n## Built-in commands\n\n[View Documentation](https://qinglong.online/guide/user-guide/basic-explanation)\n\n## Remote CLI and Agent Skill\n\nUse the standalone npm package [@whyour/qinglong-cli](https://www.npmjs.com/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.\n\nRequires Node.js \u003e=22.12; Node.js 24 is recommended. Install the package to use `ql`:\n\n```bash\nnpm install -g @whyour/qinglong-cli\nql login --url https://ql.example.com\nql auth status --json\nql task list --json\nql subscription list --json\nql --help\n```\n\nCreate 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.\n\nThe 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/LOCAL.en.md).\n\n[CLI guide](cli/README.en.md) · [简体中文](cli/README.md) · [Full command reference](cli/skills/qinglong-cli/references/openapi.md)\n\nThe package includes a [remote management skill](cli/skills/qinglong-cli/SKILL.md) covering authentication, command selection and result verification for AI agents. Local execution and maintenance have a separate [internal skill](cli/skills/qinglong-local/SKILL.md).\n\n## Development\n\n```bash\ngit clone https://github.com/whyour/qinglong.git\ncd qinglong\ncp .env.example .env\n# Recommended use pnpm https://pnpm.io/zh/installation\nnpm install -g pnpm@8.3.1\npnpm install\npnpm start\n```\n\nOpen your browser and visit \u003chttp://127.0.0.1:5700\u003e\n\n## Links\n\n- [nevinee](https://gitee.com/evine)\n- [crontab-ui](https://github.com/alseambusher/crontab-ui)\n- [Ant Design](https://ant.design)\n- [Ant Design Pro](https://pro.ant.design/)\n- [Umijs](https://umijs.org)\n- [darkreader](https://github.com/darkreader/darkreader)\n- [admin-server](https://github.com/sunpu007/admin-server)\n\n## Name Origin\n\nThe Green Dragon, also known as the Canglong, is one of the four elephants and one of the [four spirits of the heavens](https://zh.wikipedia.org/wiki/%E5%A4%A9%E4%B9%8B%E5%9B%9B%E7%81%B5) 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\".\n\nIn 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)\n\nAmong the [twenty-eight Chinese constellations](https://zh.wikipedia.org/wiki/%E4%BA%8C%E5%8D%81%E5%85%AB%E5%AE%BF), 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhyour%2Fqinglong","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhyour%2Fqinglong","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhyour%2Fqinglong/lists"}