---
title: "networkQuality：macOS 中隐藏的网络测试工具（命令行）"
source: "https://www.sysgeek.cn/macos-networkquality/"
author:
  - "[[海猴子]]"
published: 2023-12-18
created: 2025-12-02
description: "掌握 macOS 中隐藏的 networkQuality 命令，优化你的网络连接，提升连接速度。详解网络性能测试和诊断。"
tags:
  - "clippings"
---
![](https://img.sysgeek.cn/img/logo/macos/macos-13.jpg)

![macOS](https://img.sysgeek.cn/img/logo/macos/macos-13.jpg)

这里，我们有一个有趣而强大的工具，即 macOS 12 Monterey 及其更新版本中引入的 `networkQuality` 命令。它被用于评估网络质量和诊断潜在的网络问题，主要关注上传下载速度以及网络的响应能力。

## 运行默认测试

如果你想利用 Network Quality 工具进行测试，只需打开 macOS 中的「终端」应用程序并输入以下命令：

** 复制 ** 复制 ** 复制 ** 复制 ** 复制 ** 复制

** 复制
```
networkQuality -v
```

执行此命令将触发一系列默认测试，并将结果直观地展示在「终端」窗口中。

![networkQuality 测试结果](https://img.sysgeek.cn/img/2023/12/macos-networkquality.png)

networkQuality 测试结果

| 指标 | 单位 | 说明 |
| --- | --- | --- |
| Plink capacity | Mbps | 上行速度 |
| Downlink capacity | Mbps | 下行速度 |
| Uplink bytes transferred | 字节 | 上行传输的字节数 |
| Downlink bytes transferred | 字节 | 下行传输的字节数 |
| Uplink Flow count | 次 | 上行流量计数 |
| Downlink Flow count | 次 | 下行流量计数 |
| Idle Latency | 毫秒 | 空闲延迟 |
| Responsiveness | RPM | 响应数 |

RPM 表示每分钟往返次数。响应数越高，表示网络的响应能力越好。

## Private Relay 测试

除了基本功能外，Network Quality 工具还为 Apple 的 Private Relay 提供支持。Private Relay 是一项功能强大的服务，通过两个独立的服务器对所有网络流量进行加密和路由，以提供额外的隐私和安全性。要在工具中启用 Private Relay，只需在命令中添加 `-p` 开关：

** 复制 ** 复制 ** 复制 ** 复制 ** 复制

** 复制
```
networkQuality -v -p
```

## 自定义配置

为了满足个性化需求，你可以根据具体情况自定义 Network Quality 工具的配置。默认情况下，工具通过 `https://mensura.cdn-apple.com/api/v1/gm/config` 从 Apple 获取配置文件。但你可以通过使用 `-C` 参数指定不同的配置 URL 来进行自定义。

Apple 的默认配置如下：

** 复制 ** 复制 ** 复制 ** 复制

** 复制
```
{ "version": 1,
  "test_endpoint": "hkhkg3-edge-bx-014.aaplimg.com",
  "urls": {
      "small_https_download_url": "https://mensura.cdn-apple.com/api/v1/gm/small",
      "large_https_download_url": "https://mensura.cdn-apple.com/api/v1/gm/large",
      "https_upload_url": "https://mensura.cdn-apple.com/api/v1/gm/slurp",
      "small_download_url": "https://mensura.cdn-apple.com/api/v1/gm/small",
      "large_download_url": "https://mensura.cdn-apple.com/api/v1/gm/large",
      "upload_url": "https://mensura.cdn-apple.com/api/v1/gm/slurp"
   }
}
```

需要注意的是，Apple 的 `test_endpoint` 在请求时可能会变更，会选择一个就近的（不同）服务器，从而减少延迟并分散服务器负载。

比如，如果你有一个位于 `https://networkquality.example.com/config` 的自定义配置文件，可以通过以下命令运行 Network Quality 工具，来使用自定义配置：

** 复制 ** 复制 ** 复制

** 复制
```
networkQuality -v -C https://networkquality.example.com/config
```

通过这个命令，工具将按照自定义配置文件中指定的设置执行测试。要为 Network Quality 工具建立自己的测试服务器，可以在项目的 [GitHub 页面](https://github.com/network-quality/goserver) 上找到详细的文档。

## networkQuality 命令参数

** 复制 ** 复制

** 复制
```
USAGE: networkQuality [-C <configuration_url>] [-c] [-d] [-f <comma-separated list>] [-h] [-I <network interface name>] [-k] [-p] [-r host] [-S <port>] [-s] [-u] [-v]
    -C: Override Configuration URL or path (with scheme file://)
    -c: Produce computer-readable output
    -d: Do not run a download test (implies -s)
    -f: <comma-separated list>: Enforce Protocol selections. Available options:
        h1: Force-enable HTTP/1.1
        h2: Force-enable HTTP/2
        h3: Force-enable HTTP/3 (QUIC)
        L4S: Force-enable L4S
        noL4S: Force-disable L4S
    -h: Show help (this message)
    -I: Bind test to interface (e.g., en0, pdp_ip0,...)
    -k: Disable certificate validation
    -p: Use iCloud Private Relay
    -r: Connect to host or IP, overriding DNS for initial config request
    -S: Start and run server on specified port. Other specified options ignored
    -s: Run tests sequentially instead of parallel upload/download
    -u: Do not run an upload test (implies -s)
    -v: Verbose output
```

---

macOS 中的 `networkQuality` 工具是一款强大的命令行实用程序，专注于测量网络连接性能。它不仅可以用于常规网络测试，还支持通过 Apple Private Relay 进行测试而无需购买 iCloud+ 服务，这是一个很方便的功能。

相关资源：

- [networkQuality Wiki](https://github.com/network-quality/community/wiki)
- [PPM 响应性草案 RFC](https://www.ietf.org/archive/id/draft-cpaasch-ippm-responsiveness-00.html)

[** 赞(1)](https://www.sysgeek.cn/macos-networkquality/)

分享到 [**](https://www.sysgeek.cn/macos-networkquality/ "分享到微信") **

### 相关推荐

- [![macOS Tahoe 26.1 发布：新增「液态玻璃」色调模式-系统极客](https://img.sysgeek.cn/img/2025/06/macos-26.jpg)](https://www.sysgeek.cn/macos-tahoe-26-1/) [macOS Tahoe 26.1 发布：新增「液态玻璃」色调模式](https://www.sysgeek.cn/macos-tahoe-26-1/)
- [![macOS Tahoe 26.0.1 发布，修复 M3 Ultra 无法安装的问题-系统极客](https://img.sysgeek.cn/img/2025/06/macos-26.jpg)](https://www.sysgeek.cn/macos-tahoe-26-0-1/) [macOS Tahoe 26.0.1 发布，修复 M3 Ultra 无法安装的问题](https://www.sysgeek.cn/macos-tahoe-26-0-1/)
- [![10+ macOS Tahoe 26 全新设置，值得你的关注与调校-系统极客](https://img.sysgeek.cn/img/2025/06/macos-26.jpg)](https://www.sysgeek.cn/macos-tahoe-26-new-settings/) [10+ macOS Tahoe 26 全新设置，值得你的关注与调校](https://www.sysgeek.cn/macos-tahoe-26-new-settings/)
- [![macOS Sequoia 15.6.1 发布，修复已被利用的高危漏洞-系统极客](https://img.sysgeek.cn/img/2024/06/macos-13.jpg)](https://www.sysgeek.cn/macos-sequoia-15-6-1/) [macOS Sequoia 15.6.1 发布，修复已被利用的高危漏洞](https://www.sysgeek.cn/macos-sequoia-15-6-1/)
- [![macOS Sequoia 15.6 发布，修复 81 项安全问题-系统极客](https://img.sysgeek.cn/img/2024/06/macos-13.jpg)](https://www.sysgeek.cn/macos-sequoia-15-6/) [macOS Sequoia 15.6 发布，修复 81 项安全问题](https://www.sysgeek.cn/macos-sequoia-15-6/)
- [![Apple Container：苹果容器化框架简介-系统极客](https://img.sysgeek.cn/img/logo/macos/macos-17.jpg)](https://www.sysgeek.cn/apple-container/) [Apple Container：苹果容器化框架简介](https://www.sysgeek.cn/apple-container/)
- [![macOS 26 Tahoe 桌面壁纸下载（4K/6K 高清官方壁纸）-系统极客](https://img.sysgeek.cn/img/2025/06/macos-26.jpg)](https://www.sysgeek.cn/macos-tahoe-wallpaper/) [macOS 26 Tahoe 桌面壁纸下载（4K/6K 高清官方壁纸）](https://www.sysgeek.cn/macos-tahoe-wallpaper/)
- [![iOS、iPadOS 和 macOS 26 支持机型列表：哪些设备可以升级？-系统极客](https://img.sysgeek.cn/img/logo/macos/macos-17.jpg)](https://www.sysgeek.cn/ios-26-ipados-26-macos-26-compatibility-list/) [iOS、iPadOS 和 macOS 26 支持机型列表：哪些设备可以升级？](https://www.sysgeek.cn/ios-26-ipados-26-macos-26-compatibility-list/)

- [首页](https://www.sysgeek.cn/)
- [新闻](https://www.sysgeek.cn/news/)
- [macOS](https://www.sysgeek.cn/macos/)
- [专题](https://www.sysgeek.cn/topic/)