README

此模块使用 macOS 12+ 上的 networkQuality 来确定当前网络速度。该模块需要在客户端 Mac 上安装并运行 network 模块。

默认情况下，此模块是禁用的，不会运行。管理员必须在客户端启用并配置模块后，它才会运行。下面是如何配置它的说明。

networkQuality 二进制文件使用 Apple 的服务器来确定网络速度。有关其工作原理的信息，请参阅 https://support.apple.com/en-us/101942。

当模块启用时，您可以通过触摸位于 /Users/Shared/.com.github.munkireport.speedtest 的文件来触发当前网络的单次重测。

请注意使用此模块时的网络拥塞和数据使用。不建议在办公室或实验室地点启用此模块。您将负责使用此模块创建或因使用此模块而产生数据超出的任何网络问题。

配置

所有配置密钥都在 MunkiReport 域内设置。有关如何使用配置文件配置此模块的示例，请参阅包括移动配置配置文件。

speedtest_enabled

默认情况下，模块是禁用的。要启用模块，请在客户端上设置 speedtest_enabled。

sudo defaults write /Library/Preferences/MunkiReport.plist speedtest_enabled -bool True

speedtest_get_isp 默认情况下，模块不会从 Speedtest.net 的 API (https://www.speedtest.net/speedtest-config.php) 获取 ISP 信息。不会将有关您的 Mac 的数据发送到 Speedtest.net。

要获取有关 ISP 的信息，请在客户端上设置 speedtest_get_isp。

sudo defaults write /Library/Preferences/MunkiReport.plist speedtest_get_isp -bool True

speedtest_get_location 默认情况下，模块不会收集并报告从 Speedtest.net 的 API (https://www.speedtest.net/speedtest-config.php) 报告的 IP 的纬度和经度坐标。不会将有关您的 Mac 的数据发送到 Speedtest.net。启用此功能需要启用 speedtest_get_isp。

要获取 IP 的纬度和经度，请在客户端上设置 speedtest_get_location。

sudo defaults write /Library/Preferences/MunkiReport.plist speedtest_get_location -bool True

speedtest_weekly_run 默认情况下，模块不会重测网络。要启用每周一次的重测，请在客户端上设置 speedtest_weekly_run。

sudo defaults write /Library/Preferences/MunkiReport.plist speedtest_weekly_run -bool True

speedtest_current_only 默认情况下，模块显示它已运行速度测试的最后一个 5 个网络。如果在经常更改网络的 MacBook 或 Mac 上设置此选项，可能会触发它们在每次网络更改时重新测试网络速度。

要仅显示当前网络，请在客户端上设置 speedtest_current_only。

sudo defaults write /Library/Preferences/MunkiReport.plist speedtest_current_only -bool True

speedtest_debug_enabled 默认情况下，模块不会在客户端上显示调试信息。要显示调试信息和逻辑，请在客户端上设置 speedtest_debug_enabled。

sudo defaults write /Library/Preferences/MunkiReport.plist speedtest_debug_enabled -bool True

表架构

• base_rtt (字符串) 基础 RTT（ping）
• country (字符串) 外部 IP 地址的国家
• dhcp_domain_name (字符串) DHCP 的域名
• dhcp_domain_name_servers (字符串) DHCP 的 DNS
• dhcp_routers (字符串) DHCP 的路由器
• dhcp_subnet_mask (字符串) DHCP 的子网掩码
• dl_flows (整数) 下载流计数
• dl_responsiveness (整数) 下载连接的响应性
• dl_bytes_transferred (大整数) 以字节为单位的已下载数据量
• dl_throughput (大整数) 以字节为单位的下载速度
• end_time (大整数) 测试结束的时间戳
• external_ip (字符串) 来自网络模块的外部IP地址
• external_ip_isp (字符串) 来自Speedtest.net的外部IP地址
• interface_name (字符串) 用于测试的接口
• ipv4dns (字符串) IPv4 DNS服务器
• ipv4ip (字符串) IPv4地址
• ipv4mask (字符串) IPv4网络掩码
• ipv4router (字符串) IPv4路由器地址
• ipv6ip (字符串) IPv6地址
• ipv6mask (整数) IPv6子网掩码
• isp (字符串) Speedtest.net报告的ISP
• isp_rating (字符串) Speedtest.net报告的ISP评分
• iteration (整数) 网络进行的测试次数
• lat (浮点数) Speedtest.net报告的IP地址的纬度
• lon (浮点数) Speedtest.net报告的IP地址的经度
• latest (布尔值) 如果这是当前/最新的测试
• start_time (大整数) 测试开始的时间戳
• test_endpoint (字符串) 用于测试网络速度的端点
• ul_flows (整数) 上传流量计数
• ul_responsiveness (整数) 上传连接的响应性
• ul_bytes_transferred (大整数) 上传的数据量（字节）
• ul_throughput (大整数) 上传速度（字节）