Skip to content
このページは AI で翻訳されており、不正確な表現が含まれる場合があります。GitHub で改善にご協力ください。

ネットワーク診断 ​

ブラウザ上で Ping、トレースルート、ポート確認、DNS 照会、速度測定、LAN スキャンを実行します。メニューの場所:サイドバーの「ツール → ネットワーク診断」。

バックグラウンドタスク ​

「開始」を押すたびにバックグラウンドタスクが作成され、API はすぐにタスク ID を返し、画面が出力をポーリングします。

  • 同時に実行できるタスクは最大 4 つで、超えると少し待ってから再試行するよう通知されます。
  • 1 つのタスクは最長 5 分間実行され、時間切れになると自動でキャンセルされます。
  • 直近 50 件のタスクが保持され、実行中のタスクは整理されません。タスクごとに最大 500 行の出力が保持されます。
  • 実行中は「停止」を押してキャンセルできます。ページ下部の「最近のタスク」に過去のタスクが一覧表示され、クリックすると出力を確認できます。
  • タスクの状態:実行中、完了、失敗、キャンセル済み。

Ping ​

ターゲットに ICMP エコーリクエストを送り、各往復時間、パケットロス率、最小 / 平均 / 最大のレイテンシーを出力します。

パラメーター説明
ターゲットホスト名または IP。IPv4 と IPv6 に対応
回数デフォルトは 4、最大 20

各リクエストのタイムアウトは 2 秒、間隔は約 0.7 秒です。まず特権不要の UDP 型 ICMP ソケットを使い、失敗した場合は raw ソケットを試します。Docker コンテナ内では NET_RAW 権限、または net.ipv4.ping_group_range の設定が必要です。権限が足りない場合は、ポート確認で代用できます。ターゲットから一切応答がない場合、タスクの状態は失敗になります。

トレースルート ​

システムのコマンドを呼び出して経路をたどり、コマンドの出力をそのまま表示します。

  • Windows では tracert を使い、それ以外では traceroute を優先し、次に tracepath を使います。
  • 最大 20 ホップで、逆引きは行いません(IP をそのまま表示します)。
  • システムに対応するコマンドがない場合、タスクはエラーになります。Docker イメージでは traceroute パッケージをインストールできます。

ポート確認 ​

ターゲットに TCP 接続を試み、開いているポートのみを一覧表示します。

パラメーター説明
ターゲットホスト名または IP
ポート例:22,80,443,8000-8100。カンマ区切りと範囲指定に対応し、ポート範囲は 1-65535
  • 1 回で最大 1024 ポートまで確認できます。
  • 並列数は 100、ポートごとの接続タイムアウトは 1.5 秒です。
  • よく使われるポートでは、サービス名(ssh、http、https、mysql、redis、postgres、rdp など)と接続にかかった時間を表示します。

DNS 照会 ​

パラメーター説明
ドメイン / IP照会する名前。PTR タイプの場合は IP を入力
種類A、AAAA、CNAME、MX、TXT、NS、PTR。デフォルトは A
DNS サーバー空欄でシステムのリゾルバーを使用。223.5.5.5、223.5.5.5:5353、または DoH アドレス https://dns.alidns.com/dns-query を指定可能

照会のタイムアウトは 8 秒で、レコードと所要時間を出力します。

速度測定 ​

ダウンロード速度の測定です。4 並列で実行し、1 秒ごとに現在の速度(Mbps)を出力し、終了時に総ダウンロード量と平均速度を出力します。

パラメーター説明
ダウンロード URL完全な http(s):// の URL。空欄で Cloudflare の速度測定ノード(https://speed.cloudflare.com/__down?bytes=200000000)を使用
時間秒。画面での範囲は 2〜30、デフォルトは 8

速度測定のリクエストはリダイレクトに従いません。プローブが禁止されているアドレスに誘導されるのを防ぐためです。

LAN スキャン ​

ネットワークセグメント内のオンラインのデバイスをスキャンし、結果を表にして表示します:IP、MAC、ホスト名、開放ポート。

パラメーター説明
ネットワークセグメントCIDR。例:192.168.1.0/24。空欄の場合は、本機の最初のプライベート IPv4 NIC が属するセグメントを使います(ドロップダウンに本機で利用可能なセグメントが一覧表示され、大きすぎるセグメントは /24 に縮小されます)

制限と仕組み:

  • IPv4 のプライベートセグメント(10.0.0.0/8、172.16.0.0/12、192.168.0.0/16)のみに対応しています。
  • 1 回で最大 1024 アドレス(/22 相当)までで、ネットワークアドレスとブロードキャストアドレスは自動で除外されます。
  • 各アドレスについて、よく使われるポート 80、443、22、445、139、3389、8080、62078、5000、53 を確認し、接続に成功した場合や拒否された場合はオンラインとみなします。
  • MAC アドレスはシステムの近隣テーブルから取得します。近隣テーブルに記録があれば、よく使われるポートが開いていないホストもオンラインとして一覧に含まれます。
  • ホスト名は逆引き DNS で解決されます(タイムアウト 1.5 秒)。
  • MAC があるデバイスでは「Wake-on-LAN に追加」を押すと、Wake-on-LAN のデバイス一覧に追加できます。

プローブ禁止リスト ​

ページ右上の「プローブ禁止リスト」で、診断ツールのアクセスを許可しないターゲットを設定します。

  • クラウドベンダーのメタデータアドレスは常に禁止されています:169.254.169.254/32、100.100.100.200/32、fd00:ec2::254/128。ツールがインスタンスの認証情報の窃取に使われるのを防ぎます。
  • IP やセグメントを 1 行に 1 つ追加できます。例:10.0.0.0/8。
  • ターゲットのホスト名から解決されたいずれかのアドレスがリストに一致すると、タスクはエラーになります。速度測定のダウンロード URL も同様にチェックされ、スキャンでは一致したアドレスをスキップします。

ヒント

診断ツールは Gately が動作しているホストまたはコンテナの中で実行されるため、確認結果にはその環境のネットワーク状況が反映されます。確認できる範囲を制限したい場合は、LAN 内の機密性の高いセグメントをプローブ禁止リストに追加してください。

ネットワーク自己診断 ​

概要ページの「自己診断」ボタン(初回起動時の初期設定ガイドにも入口があります)で、よくあるネットワークと設定の問題をまとめて確認できます。問題のある項目が先頭に並び、対処方法も表示されます。

確認項目説明
公開アドレスDDNS で使う公開 IP 照会 URL から外向きの IPv4 / IPv6 を取得します
NATこのマシンが公開 IPv4 / IPv6 を直接保持しているか。ネットワークインターフェースに 100.64.0.0/10 のアドレスがある場合は、キャリアグレード NAT の内側にある可能性を示します(Tailscale などのオーバーレイ用インターフェースは除外)
システム時刻照会サービスの応答時刻から時計のずれを推定します。60 秒を超えると 2 段階認証コードや証明書の検証が失敗します
80 / 443 番ポート空いているか、使用中か、待ち受ける権限がないか
DDNS の名前解決動的アドレスを使うレコードについて、ドメインの現在の解決結果がこのマシンの外向きアドレスと一致するか
証明書期限切れ、または 14 日以内に期限が切れる証明書
HTTPS サイトの証明書有効な HTTPS リスナーのうち、一致する証明書がないドメインを持つサイト(これらのドメインは TLS ハンドシェイクで失敗します)
frp の競合frpc 内で名前が重複しているプロキシと、直近 30 分のログで frps が報告したプロキシ名・ドメイン・リモートポートの競合(複数の機器で同じ frpc 設定をコピーした場合によく起こります)
各モジュールの状態概要で警告またはエラー状態になっているモジュール

自己診断は設定された公開 IP 照会サービスにアクセスし、クリックしたときだけ実行されます。読み取り専用アカウントと API トークンでは使えません。

Apache-2.0 ライセンスで公開されています。