Qinglong：Python3、JavaScript、Shell、TypeScript をサポートする定期タスク管理プラットフォーム
Python3、JavaScript、Shell、Typescript をサポートする定時タスク管理平台（Python3、JavaScript、Shell、Typescript をサポートする時限タスク管理プラットフォーム）。
ひと目でわかる
- これは何？
- README とリポジトリメタデータに基づく whyour/qinglong の事実確認。機能、Docker と npm のインストール経路、開発手順、確認すべき空白を扱う。
- 誰に向いている？
- Qinglong はPython、JavaScript、Shell、TypeScriptの定期タスクをWeb画面で管理したい個人・運用者向けです。認証、バックアップ、負荷時の挙動はREADMEだけでは判断できません。
- 商用利用できる？
- できます。Apache-2.0 は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 2 日前です。
- 何の言語で書かれている？
- 主に TypeScript です（GitHub の言語統計による）。
回答はプロジェクトの GitHub データ（最終同期：2026年9月14日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
README の機能一覧
README の冒頭に機能リストがある。Python3、JavaScript、Shell、TypeScript のサポート、スクリプト・環境変数・設定ファイルのオンライン管理、タスクログのオンライン表示、秒単位のタスク設定、システムレベルの通知、ダークモード、モバイル操作のサポートである。プロジェクトの説明では定时任务管理平台（定期タスク管理プラットフォーム）とされており、リポジトリメタデータによるとコードベースは TypeScript で書かれている。README はこれらの機能がどのように実装されるか、どのインターフェースに現れるかを説明しておらず、その部分は直接テストするか、このファイル以外のドキュメントを参照する必要がある。
機能一覧には秒単位のスケジュール、システム通知、ログ表示、環境変数と設定ファイルのオンライン管理が並びます。ただしREADMEは、タスクの実行権限をユーザー単位でどう制御するか、ログをどれだけ保持するか、失敗時に再実行するかを説明していません。管理画面へ到達できた段階で、テスト用スクリプトを一つ登録し、実行時刻、標準出力、環境変数のマスキング、再起動後の状態を分けて確認します。
Docker と npm のインストール経路
インストール経路が2つ記載されている。Docker の場合、latest イメージは Alpine ベース、debian イメージは debian-slim ベースであり、Alpine の crond は root 権限を必要とするため、非 root ユーザーは debian イメージを選び --user qinglong で実行すべきと README は警告している。プルコマンドは `docker pull whyour/qinglong:latest` と `docker pull whyour/qinglong:debian` である。npm 経由では node、npm、python3、pip3、pnpm が必要で、`npm i @whyour/qinglong` でインストールする。npm 版の実行コマンドや起動方法は README に書かれておらず、リンク先のデプロイメントドキュメントに記載されている。
API と組み込みコマンドのドキュメント
README はデプロイ、組み込み API、組み込みコマンドの3つの外部ドキュメントにリンクしている。API エンドポイントやコマンド名自体は README に登場しない。Qinglong と統合する場合、これらのリンクを辿る必要があり、リポジトリメタデータにはスキーマやエンドポイント一覧は含まれていない。ドキュメントサイトは qinglong.online であるが、その内容は README の一部ではなく、ここでは引用していない。
ソースからの開発セットアップ
開発については、README はリポジトリのクローン、.env.example を .env にコピー、pnpm 8.3.1 をグローバルインストール、pnpm install、pnpm start の順を示している。その後、ブラウザで http://127.0.0.1:5700 を開くとある。しかし .env ファイルの内容、データベースの設定方法、デフォルトのログイン認証情報については説明されていない。これらの詳細は README にはなく、コードまたはリンクされたドキュメントで確認する必要がある。
名前の由来と文化的背景
プロジェクト名は、中国の伝統文化における四霊の一つである青龍（蒼龍）に由来する。README は『後漢書』の一節を引用し、青龍を東方七宿の総称とし、木、春、震卦に関連づけている。また道教では守護神としての役割があると述べている。この由来の節は名前についてのみであり、ソフトウェアの機能や能力を示すものではない。
リポジトリメタデータと Apache-2.0 ライセンス
リポジトリメタデータによると、コードベースは TypeScript で、デフォルトブランチは develop、スナップショット時点でスター 19,753、フォーク 3,240、オープンイシュー 99 である。ライセンスは Apache-2.0 である。抜粋は、永続的、全世界的、非独占的、無償、ロイヤリティフリー、取消不能の著作権ライセンスと、特許ライセンスを付与している。特許ライセンスは、ライセンシーが作品が直接または寄与的に特許侵害を構成すると主張する特許訴訟を提起した場合に終了する。再配布にはライセンスのコピーを添付しなければならない。抜粋には保証、サポート、セキュリティ保証に関する記述はなく、それらは提供された資料の範囲外である。
採用前に確認すべき未記載の詳細
評価者が知りたいであろういくつかの事実は README に欠けている。認証、マルチユーザーサポート、バックアップ戦略、秒単位のタスク設定以外のスケジュール精度についての言及はない。性能ベンチマークやセキュリティレビューの主張もなく、本番環境での導入例も挙げられていない。Docker と npm の指示はあるが、どのバージョンの node、python3、pnpm がテストされているか、負荷下での動作は書かれていない。重要な作業に Qinglong を依存する前に、リンクされたドキュメント、コードベース、または管理された試行でこれらの点を確認すべきである。
QinglongのDocker手順には運用上の差がはっきりあります。latestはAlpine、debianはdebian-slimを基盤にしており、Alpineのcrondはroot権限を要求するため、非rootで動かす例はdebianイメージと--user qinglongの組み合わせです。データは/ql/dataへマウントし、5700番ポートを公開します。npm版はnode、npm、python3、pip3、pnpmを別途用意する前提で、npm i @whyour/qinglongだけでは起動手順まで確定しません。開発用のpnpm startは127.0.0.1:5700を開く流れですが、認証情報や永続化の既定値はREADMEにありません。
編集部の結論
Qinglong はPython、JavaScript、Shell、TypeScriptの定期タスクをWeb画面で管理したい個人・運用者向けです。認証、バックアップ、負荷時の挙動はREADMEだけでは判断できません。最初に whyour/qinglong:debian を --user qinglong で起動する構成と、ソースの pnpm start を別環境で確認し、/ql/data、5700番ポート、環境変数の扱いを記録してください。
コミュニティノート