CF-Worker-BestIP-collector の日本語紹介

Tool

概要

本リポジトリは「Cloudflare 优选IP 收集器」のオリジナルを Cloudflare Workers に移植したもので、GitHub 上の旧版が停止された経緯を受けて作られています。主な目的は、ターゲット(ホストや CDN ノードなど)への疎通や応答速度をエッジから並列に計測し、“最も応答の良い IP(ベストIP)” を収集して提供することです。Cloudflare Workers の軽量実行環境を利用することで、従来の GitHub Actions に比べて起動・実行のレスポンスが良く、エッジ分散による低遅延計測や簡易な API 化が可能になります。README と単一の Worker スクリプトで構成されたシンプルなプロジェクトです。(約300字)

GitHub

リポジトリの統計情報

  • スター数: 46
  • フォーク数: 39
  • ウォッチャー数: 46
  • コミット数: 23
  • ファイル数: 2
  • メインの言語: JavaScript

主な特徴

  • Cloudflare Workers を用いたエッジ実行で低遅延な IP 計測が可能
  • GitHub Actions を廃止し、運用コストと複雑さを削減
  • シンプルな構成(README + Worker スクリプト)で導入が容易
  • 結果を API として提供し、外部ツールやスクリプトから利用可能

技術的なポイント

本リポジトリはファイル数が少なくシンプルですが、Cloudflare Workers を用いる点に技術的な意義があります。Worker はエッジでの JavaScript 実行を想定した環境で、HTTP リクエストの発行や並列処理、短時間での多数の接続を低遅延で行えるため、複数の候補 IP に対する疎通確認やレイテンシ測定に適しています。実装上は、fetch を用いた並列リクエスト(Promise.allSettled / Promise.race など)で応答時間や HTTP レスポンスコードを収集し、タイムアウトやエラーハンドリングで不達ノードを排除する流れが考えられます。

また、Cloudflare Workers の特徴として「エッジからの実行位置が分散している」点が挙げられ、ユーザーに近いノードからの計測を活かして地域ごとの最適 IP を割り出すことができます。結果の永続化や共有についてはリポジトリ内にストレージ実装が見当たらないため、KV ストアやR2、外部 API(Webhook)を組み合わせて保存・配信する設計が想定されます。デプロイ手段としては wrangler CLI や Cloudflare ダッシュボードへの直接アップロードが一般的で、ローカルテストは Miniflare の利用が便利です。

重要な運用上の注意点として、Cloudflare のリソース制限(実行時間、CPU、ネットワーク呼び出しの上限)やターゲットへの負荷・レート制限、利用規約違反にならないようなアクセス頻度設計が必要です。README の説明どおり、元の GitHub Action 版が「滥用资源(リソース乱用)」で停止された経緯があるため、Worker 版でも同様の懸念(過度なスキャンや高頻度アクセス)は避け、適切な間隔と試行回数で運用するべきです。セキュリティ面では、外部に公開する API には認可やレート制御を入れて悪用を防ぐことを推奨します。

実際のコード(_workers.js)を読むことで、どのようにターゲット選定・タイムアウト・レスポンス評価を行っているかを確認できますが、概念的には「エッジ実行 + 並列接続 + 結果フィルタリング」でベストIP を抽出し、JSON 等で返すシンプルかつ実用的な設計になっています。(約1000〜1400字相当)

プロジェクトの構成

主要なファイルとディレクトリ:

  • README.md: file
  • _workers.js: file

(_workers.js が Cloudflare Worker の実装本体と思われます。README には導入手順や関連リンク(YouTube 等)が記載されています。)

まとめ

Cloudflare Workers を活かした軽量なベストIP収集器で、迅速に導入・運用できる点が魅力です。(約50字)

リポジトリ情報:

READMEの抜粋:

Cloudflare 优选IP 收集器

由于GitHub版的被官方以滥用资源为理由封禁了项目,特推出基于Cloudflare worker版的优选IP,更快,更高效,更直观!抛弃github Action~

YouTube