
globalping-probe v0.50.1
お使いのハードウェア上で動作し、グローバルなコミュニティネットワークのプローブに接続するglobalpingプローブコード
Globalping Probe
Globalping プラットフォームは、コミュニティがホストするプローブのグローバルに分散されたネットワークに依存しており、誰でも任意の場所から ping や traceroute などのネットワークテストコマンドを実行できます。
Globalping プローブコミュニティに参加する
Globalping はコミュニティの貢献によって成長しています。皆様のサポートにより、プラットフォームを継続的に強化し、すべてのユーザーに無料で信頼性の高い測定結果を提供できます。 プローブをホストして、ぜひコミュニティにご参加ください。
新しいプローブのセットアップ
Globalping プローブネットワークに参加するには、Docker コンテナを実行するだけです。x86 と ARM の両方のアーキテクチャで動作します。
推奨: Docker および Podman 用のダッシュボードウィザード
[!TIP] ダッシュボードのウィザードを使って始めることをお勧めします。ウィザードは、あなたの固有の採用トークンを含むコマンドを生成するので、プローブが自動的にあなたのアカウントに追加されます。
代替案 #1: オプション/手動採用による Docker
docker run -d --log-driver local --network host --restart=always --name globalping-probe globalping/globalping-probe
Globalping アカウントをお持ちの場合は、採用トークンを追加してクレジットを生成し、レート制限を引き上げることを忘れないでください。 -e GP_ADOPTION_TOKEN=XXX
[!TIP] 自動化のために、Linux サーバー向けのユニバーサルインストールスクリプトを使用し、必要に応じて適応させることを検討してください。
代替案 #2: オプション/手動採用による Podman
Podman を選択するユーザーは、こちらの手順に従って、コンテナが起動時に自動的に開始されるようにしてください。また、コンテナログを確認して正常に起動したかどうかを確認してください。Podman では追加の権限が必要な場合があります。 以下のコマンドでコンテナを実行します。
sudo podman run --cap-add=NET_RAW -d --network host --restart=always --name globalping-probe globalping/globalping-probe
代替レジストリ
何らかの理由でメインの Docker Hub レジストリにアクセスできない場合は、公式の GitHub Packages ミラーを使用できます。
docker run -d --log-driver local --network host --restart=always --name globalping-probe ghcr.io/jsdelivr/globalping-probe
ghcr.io は現在 IPv6 をサポートしていないことに注意してください。
プローブの採用
新しいプローブがオンラインになることは、プラットフォームとコミュニティにとって大きな助けとなります。利用可能なすべてのハードウェアで新しいプローブを開始することをお勧めします!
Globalping のアクティブユーザーであり、無料枠以上の制限が必要な場合は、Globalping ダッシュボードに登録してプローブを採用することをお勧めします。
採用されたプローブは、追加の日次クレジットを生成し、さらに多くのテストを実行するために使用できます。
Globalping クレジットの詳細はこちら
自動採用
環境変数 GP_ADOPTION_TOKEN にあなたの固有の採用トークンを設定することで、採用プロセスを完全に自動化することもできます。トークンを含むパーソナライズされたコマンドについては、ダッシュボードをご確認ください。
あなたの採用トークンを知っている人は誰でも、あなたのアカウントに新しいプローブを登録できることに注意してください。
実行場所
仮想プローブは、Docker コンテナを実行できるものであれば何でも実行できます。x86 および ARM アーキテクチャをサポートしています。これには、クラウドプロバイダーでホストされている任意の Linux サーバー、自宅のサーバー、オフィスに転がっている Raspberry Pi も含まれます。
設定は不要で、安定したインターネット接続でコンテナを実行するだけです。
アップデート方法
アップデートについて心配する必要はありません。プローブは利用可能になるとすぐに最新バージョンに自動的に更新されます。GitHub から直接プルされ、コンテナ内にインストールされます。
[!NOTE] コンテナ自体は自動的には更新されません。更新されるのは実行されるコードのみです。
オプション: コンテナの更新
自動更新ではコンテナは更新されないため、定期的にコンテナの新しいバージョンをプルすることをお勧めします。
コンテナを更新するには、以下を実行します。
docker pull globalping/globalping-probe
docker stop globalping-probe
docker rm globalping-probe
docker run -d --log-driver local --network host --restart=always --name globalping-probe globalping/globalping-probe
制限事項
- IP アドレスごとに 1 つのプローブのみ実行できます。
- 物理的な場所に確実に解決できないプローブは切断します。
- 匿名プロキシ、Tor 出口ノード、または VPN サービスを経由してトラフィックがルーティングされるプローブはブロックします。
セキュリティ
- プローブは安全な接続を介して API にのみ接続します。デバイスにポートを開けたり、着信接続を受け入れたりすることはありません。
- マルウェアや潜在的に危険なコンテンツに関連するドメインおよびIP アドレスの定期的に更新されるリストとデータベースを使用し、API レベルでそれらを禁止します。
- プライベート IP アドレスをターゲットとしてブロックします。
- ネットワークの悪用を防ぐために、API レベルですべてのユーザーをレート制限します。
テスト数の調整
プローブが処理できる測定テストの数は、利用可能な CPU コアと過去数分間の平均 CPU 負荷に応じてスケーリングします。私たちのコードは非常に軽量でリソースをあまり消費しないため、ほとんどの場合、プローブはそのまま実行することをお勧めします。
ただし、それでもリソース使用量を制御したい場合は、docker run コマンドに docker パラメータ --cpuset-cpus="0-2" を追加し、引用符内で CPU の数を設定します。
ハードウェアプローブ
GitHub スポンサーとして月額 $10 以上を寄付すると、ハードウェアプローブをリクエストして自宅やオフィスに設置できます。
仕組み
プローブをスイッチまたはルーターに接続するだけで完了です。自分で Docker コンテナを設定したり、24 時間 365 日稼働するコンピューターを用意する必要はありません。
ハードウェアプローブパッケージには、開始に必要なすべてが含まれています。
- 金属筐体の ARM ベースのミニコンピューター
- 電源アダプター
- OS とプローブコンテナがプリインストールされた SD カード
- Ethernet パッチケーブル
プローブをリクエストするには、GitHub スポンサーになり、このフォームに記入してください。
[!TIP] ハードウェアプローブのファームウェアを調べて、独自のバージョンを作成することもできます。詳細はこちらをご覧ください。
ハードウェアプローブプロバイダーになる
企業向けに、カンファレンスで配布したり、独自のステッカーやスワッグを含めてユーザーに発送できる、共同ブランドのハードウェアプローブをスポンサーすることを提供しています。
ハードウェアプローブプロバイダーになるの詳細はこちら
サポートとフィードバック
行き詰まった場合やフィードバックがある場合は、新しい issue を開いてください。
開発
詳細については、CONTRIBUTING.md を参照してください。