Skip to content

ja.md

Latest commit

 

History

History
116 lines (83 loc) · 3.67 KB

ja.md

File metadata and controls

116 lines (83 loc) · 3.67 KB
Raw

unispeedtest (日本語)

English

unispeedtest は、回線品質を計測する CLI ツールです。現在は Cloudflare のスピードテスト用エンドポイントを利用していますが、将来的に他プロバイダへ拡張しやすい構成を想定しています。

主な機能

  • ダウンロード速度（サンプル Mbps の 90 パーセンタイル）
  • アップロード速度（サンプル Mbps の 90 パーセンタイル）
  • 無負荷レイテンシ（20 サンプルの中央値）
  • ダウンロード/アップロード負荷時レイテンシ
  • ジッター（無負荷レイテンシ連続差分の絶対値平均）
  • パケットロス（1000 リクエスト、同時実行 50）
  • ネットワーク情報（Cloudflare colo、ASN/AS 組織名、グローバル IP）

インストール

1) GitHub Releases からインストール（推奨）

Releases から最新版アーカイブを取得し、unispeedtest を PATH の通った場所に配置してください。

またはインストーラスクリプトを利用できます。

curl -fsSL https://raw.githubusercontent.com/hsblabs/universal-speedtest-cli/main/install.sh | sh

デフォルトのインストール先は /usr/local/bin です（INSTALL_DIR で変更可能）。 インストーラスクリプトは release の checksums.txt を使って SHA-256 を検証します。

2) Go でインストール

go install github.com/hsblabs/universal-speedtest-cli/cmd/unispeedtest@latest

この方法ではバイナリ名は unispeedtest になります。

使い方

unispeedtest

オプション:

  • -html <path>: 自己完結 HTML レポートを保存
  • -html-title <title>: HTML レポートへタイトルを追加（-html が必要）
  • -json: JSON（1行）で出力
  • -pretty: 整形済み JSON で出力（-json を含む）
  • -v, --version: CLI バージョンを表示して終了

例:

unispeedtest -html report.html -html-title "自宅 Wi-Fi"
unispeedtest -json
unispeedtest -pretty
unispeedtest --version

HTML レポート

-html <path> は、外部アセットを使わないレスポンシブな単一 HTML レポートを保存します。 計測日時は Unix エポックミリ秒で記録し、インライン JavaScript が閲覧環境のロケールとタイムゾーンに合わせて表示します。 -html-title "自宅 Wi-Fi" を指定すると、文書タイトルと見出しは Internet Speed Report - 自宅 Wi-Fi になります。 通常のターミナル出力や JSON 出力は維持されるため、-json または -pretty と併用できます。 指定パスに既存ファイルがある場合は上書きします。

JSON 出力形式

一部の測定だけ失敗した場合、該当メトリクスは null で出力され、warnings 配列に理由が入ります。これにより、本当の 0 と欠損値を区別できます。

{
  "download_mbps": 225.14,
  "upload_mbps": 102.87,
  "latency_ms": {
    "unloaded": 12.41,
    "loaded_down": 35.09,
    "loaded_up": 41.22,
    "jitter": 1.98
  },
  "packet_loss_percent": 0.1,
  "server_colo": "Tokyo",
  "network_asn": "AS2516",
  "network_as_org": "KDDI CORPORATION",
  "ip": "203.0.113.10",
  "warnings": [
    "upload loaded latency unavailable: no samples collected"
  ]
}

開発

テスト:

go test ./...

ビルド:

go build -trimpath -ldflags="-s -w" -o dist/unispeedtest ./cmd/unispeedtest

補足:

  • NO_COLOR=1 を設定すると ANSI カラー出力を無効化できます。

ライセンス

MIT