Linux 命令列測速神器 speedtest-cli：安裝、使用、分享結果與自動化腳本

無圖形介面的伺服器、容器、嵌入式裝置如何測試網速？speedtest-cli 以 Python 實作 Speedtest.net 協議，無需瀏覽器、Flash、JavaScript，純命令列即可測量上/下行頻寬、延遲、抖動、封包損失，支援指定測試節點、輸出 JSON/CSV、分享圖片連結。本文涵蓋安裝、基礎/進階用法、自動化監控腳本、常見問題。

安裝 speedtest-cli

方法一：Python pip（跨平台、版本最新）

# 系統級安裝
sudo pip3 install speedtest-cli

# 或使用者級 (不需 root)
pip3 install --user speedtest-cli
export PATH="$HOME/.local/bin:$PATH"

方法二：系統套件管理器（版本可能較舊）

方法三：手動下載單一腳本（無 Python 套件管理器環境）

wget -O speedtest-cli https://raw.githubusercontent.com/sivel/speedtest-cli/master/speedtest.py
chmod +x speedtest-cli
sudo mv speedtest-cli /usr/local/bin/

基礎用法

# 自動選最近節點測試
speedtest-cli

# 輸出範例：
# Retrieving speedtest.net configuration...
# Testing from ISP Name (IP)...
# Retrieving speedtest.net server list...
# Selecting best server based on ping...
# Hosted by Server Name (City, Country) [km]
# Testing download speed........................................
# Download: 945.32 Mbit/s
# Testing upload speed..........................................
# Upload: 512.45 Mbit/s
# Share results: https://www.speedtest.net/result/123456789.png

進階參數與常用組合

自動化監控腳本範例

每小時記錄網速到 CSV (含時間戳)

#!/bin/bash
# /usr/local/bin/speedtest-log.sh
LOGFILE="/var/log/speedtest.csv"
# 首次執行寫入標題
[[ -f "$LOGFILE" ]] || speedtest-cli --csv-header | sed 's/^/timestamp,/' > "$LOGFILE"
# 記錄
speedtest-cli --csv | sed "s/^/$(date -Iseconds),/" >> "$LOGFILE"

# 加入 crontab 每小時執行
0 * * * * /usr/local/bin/speedtest-log.sh

JSON 完整記錄 + 異常告警 (下行 < 100 Mbps 發送郵件)

#!/bin/bash
THRESHOLD=100000000   # 100 Mbps = 100,000,000 bits/s
RESULT=$(speedtest-cli --json)
DOWNLOAD=$(echo "$RESULT" | jq -r '.download')
if (( $(echo "$DOWNLOAD < $THRESHOLD" | bc -l) )); then
    echo "$RESULT" | jq -r '"下行頻寬異常: \(.download/1000000) Mbps, 節點: \(.server.name), 時間: \(.timestamp)"' | \
    mail -s "網速告警" admin@example.com
fi
# 存檔
echo "$RESULT" | jq -c . >> /var/log/speedtest.jsonl

Docker 環境測速

# 臨時容器測試 (不污染宿主機)
docker run --rm --net=host ghcr.io/sivel/speedtest-cli:latest

# 指定節點
docker run --rm --net=host ghcr.io/sivel/speedtest-cli:latest --server 12345 --json

常見問題與解決

替代工具：iperf3 (內網/點對點精準測試)

# 伺服器端
iperf3 -s

# 客戶端
iperf3 -c SERVER_IP -t 30 -P 4   # 30秒、4並行流
# 輸出真實 TCP 頻寬、重傳、擁塞窗口，不受 Speedtest.net 節點限制

speedtest-cli 以「零依賴圖形介面、標準化輸出、易於自動化」成為 Linux 命令列測速首選。配合 cron、Prometheus、Grafana，即可建立全天候網路品質監控體系，讓頻寬問題無處遁形。