PanSou：高パフォーマンスなクラウドドライブリソース検索APIサービス 87

学習資料や映画を探すにはクラウドストレージが便利な手段ですが、頻繁に異なるクラウドストレージ間を行き来して検索する必要があり、なかにはリンクが失效しているリソースもあります。

オープンソースプロジェクトである PanSou はこれらの問題を解決できます。複数の検索ソースを一つの API に統合し、一度の検索で各大クラウドストレージプラットフォームを横断的に検索できるようにします。

PanSou は高性能なクラウドストレージリソース検索 API サービスであり、TG チャンネル検索とカスタムプラグイン検索をサポートしています。システム設計は性能と拡張性を核としており、複数チャンネル・複数プラグインの並列検索が可能で、結果の智能的な並び替えや、クラウドストレージタイプ別の分類にも対応しています。

PanSou の機能特徴

✅ 高性能検索：複数の TG チャンネルと非同期プラグイン検索を同時に実行し、検索速度がより高速です。

✅ クラウドストレージタイプの分類：複数のクラウドストレージリンクを自動認識し、タイプ別に分類して表示します。

✅ 智能的な並び替え：プラグインレベル、鮮度、優先キーワードなど多方面を組み合わせて並び替えを行います。

✅ 非同期プラグインシステム：プラグインを通じて検索ソースを拡張でき、「迅速な応答、継続的な処理」の非同期検索モードをサポートします。

✅ 二級キャッシュ：シャードメモリ＋シャードディスクキャッシュを採用しており、重複検索の速度と並列性能が明显に向上します。

サポートされているクラウドストレージタイプ

Baidu Netdisk、Aliyun Drive、Quark Netdisk、Tianyi Cloud Drive、UC Netdisk、Mobile Cloud Drive、115 Netdisk、PikPak、Xunlei Netdisk、123 Netdisk、磁力リンク、eDonkey リンクなどが含まれます。

PanSou の技術アーキテクチャ

✅ツール層（util/）：二級キャッシュシステム（cache/）、ワーカープール（pool/）、HTTP クライアント、解析ツールなどが含まれます。

✅ プラグインシステム層（plugin/）：プラグインインターフェース、非同期プラグインベースクラスを定義し、jikepan、pan666、hunhepan など各種具体的なプラグインも備えています。

✅ サービス層（service/）：キャッシュ統合、検索サービスなどが含まれます。

✅ モデル層（model/）：プラグイン結果、リクエスト、レスポンスなどのデータ構造を定義します。

✅ API 層（api/）：ハンドラー、ミドルウェア、ルーティングなどが含まれます。

✅ キャッシュシステム：シャードメモリキャッシュとシャードディスクキャッシュからなる二級キャッシュを採用し、GOB シリアライズを使用します。一部プラグインは独自のキャッシュ機構（検索結果キャッシュ、詳細ページキャッシュなど）も備えています。

✅ 並列制御：util/pool を介してワーカープール管理を実現し、並列タスクを制御します。

デプロイと使用方法

✅ Docker デプロイ（フロントエンド・バックエンド統合版と純粋バックエンド API 版）をサポートし、Docker コマンドまたは Docker Compose を使って迅速に起動できます。

✅ ソースコードからのインストールも可能で、Go 1.18 + 環境が必要です。SOCKS5 プロキシ（Telegram サイトへのアクセス用）はオプションで利用できます。

プラグインシステム

PanSou はプラグインを通じて検索ソースを拡張でき、プラグイン開発ガイドも用意されています。すでに huban、pan666、hdr4k など複数のプラグインが存在し、各プラグインは検索ロジックやキャッシュポリシーなどを独自に実装できます。

なお、作者は PanSou の詳細なシステム開発設計ドキュメントも公開しており、興味のある開発者はその原理を確認することができます。