技術文章 · IT 指令工具箱

iperf3 指令:測 1G、2.5G、10G 吞吐、反向與多連線

整理 iperf3 Server、Client、反向、雙向、UDP、平行連線、指定介面、JSON 與長時間測試,區分網路吞吐和 Speedtest。

作者 Steve Chen · 發布  · 約 5 分鐘閱讀

IT 指令工具箱 — 廷皓技術專欄插圖

iperf3 測的是兩個端點之間的網路傳輸,不包含磁碟讀寫,也不等同 Internet Speedtest。先在受控內網短時間測試,再逐步增加方向、時間與平行連線。

23 組範例iperf3LinuxmacOSWindows查核日期:2026-08-11
動手前:吞吐測試會刻意吃頻寬與 CPU。正式網路要排測試時段、指定兩端與 Port、設定時間上限;不要對未授權主機或 Internet 位址做高流量測試。

啟動 Server 與基本 TCP 測試

啟動 iperf3 Serveriperf3 server

iperf3 -s

預設監聽 TCP 5201;防火牆只允許測試來源。

Server 只接受一次測試iperf3 server

iperf3 -s -1

完成一個 client session 後離開,適合臨時測試。

指定 Server Portiperf3 server

iperf3 -s -p 5202

Client 也要使用相同 -p。

基本 Client 測試iperf3 client

iperf3 -c 192.0.2.20

把位址換成已授權的 iperf3 Server。

測試 30 秒iperf3 client

iperf3 -c 192.0.2.20 -t 30

比預設短測更容易看出波動,也會增加負載。

每 2 秒輸出一次iperf3 client

iperf3 -c 192.0.2.20 -t 30 -i 2

用於觀察吞吐隨時間變化。

省略前 5 秒統計iperf3 client

iperf3 -c 192.0.2.20 -t 30 -O 5

排除 TCP 暖機,但測試仍會完整跑完。

方向、平行連線與介面

反向測試iperf3 client

iperf3 -c 192.0.2.20 -R -t 30

資料由 Server 傳回 Client,可比較上/下行路徑。

雙向同時測試iperf3 3.7+

iperf3 -c 192.0.2.20 --bidir -t 20

版本需支援;雙向會同時增加負載。

四條平行 TCP streamiperf3 client

iperf3 -c 192.0.2.20 -P 4 -t 30

可測多 flow 總體吞吐;不是單一連線效能。

八條平行 streamiperf3 client

iperf3 -c 192.0.2.20 -P 8 -t 30

先從 1、4 逐步增加,避免只靠堆 stream 美化結果。

指定來源 IPiperf3 client

iperf3 -c 192.0.2.20 -B 192.0.2.10 -t 20

多網卡/多路由主機可控制來源;IP 必須存在本機。

指定 IPv4iperf3 client

iperf3 -4 -c 192.0.2.20 -t 20

可和 IPv6 結果比較。

指定 IPv6iperf3 client

iperf3 -6 -c 2001:db8::20 -t 20

兩端路由與防火牆都要支援 IPv6。

省略控制連線認證的誤解iperf3

iperf3 --version

先確認版本與功能;公開 Server 需另做網路限制與認證設計。

UDP、格式與長時間觀察

UDP 100 Mbit/s 測試iperf3 client

iperf3 -c 192.0.2.20 -u -b 100M -t 20

觀察 loss 與 jitter;不要一開始就打滿線路。

UDP 1 Gbit/s 測試iperf3 client

iperf3 -c 192.0.2.20 -u -b 1G -t 20

僅在已確認端點、NIC、CPU 與網路餘裕時使用。

UDP 反向測試iperf3 client

iperf3 -c 192.0.2.20 -u -b 100M -R -t 20

比較另一方向的 loss/jitter。

以 Mbit/s 顯示iperf3 client

iperf3 -c 192.0.2.20 -f m -t 20

避免 bit/byte 單位看錯。

輸出 JSONiperf3 client

iperf3 -c 192.0.2.20 -t 20 -J > iperf-result.json

便於保存與比較;檔案含端點 IP 等資訊。

設定連線逾時iperf3 client

iperf3 -c 192.0.2.20 --connect-timeout 5000

單位與支援度依版本,先看 iperf3 --help。

測 5 分鐘穩定度iperf3 client

iperf3 -c 192.0.2.20 -t 300 -i 10

長測前排維護時段並監看 Port error、CPU 與溫度。

Client 指定 Server Portiperf3 client

iperf3 -c 192.0.2.20 -p 5202 -t 20

需和 Server -p 一致。

怎麼確認有做對

  • 雙向各測,記錄端點、NIC、路徑、版本、時間與平行 stream 數。
  • 同時看交換器 CRC/drop、主機 CPU 與協商速率。
  • iperf3 後再測 SMB/NFS 或實際應用,分清楚網路與儲存瓶頸。

常見錯誤

  • 只跑多平行 stream,卻宣稱單一連線也有相同速度。
  • 在上班尖峰直接打滿 Uplink。
  • 把 iperf3 當成磁碟或 ISP Speedtest。
  • Server 對全 Internet 開放且沒有來源限制。

版本與官方文件

參數會隨工具版本與作業系統實作改變。正式環境先用 --help、-h 或系統內建說明確認,再以當版官方文件為準。

聯絡廷皓討論 看更多文章