网络质量检测脚本使用说明

实测能完整跑完并生成报告，从回车到出报告 22 分钟（其中约 6 分钟停在 Ubuntu 的 iperf3 蓝色对话框上，见下文步骤）。它的下载地址走 jsDelivr 公共 CDN 而不是 GitHub，所以国内能稳定下载。对国内机器有用的部分：三网 TCP 大包延迟正常出数（北京三网约 30 毫秒）；国际互连有数据（东京 148 毫秒、洛杉矶 144 毫秒、香港 283 毫秒），可以看出这台国内机器出海的质量。没有用的部分：三网回程路由 18 项全部是 NoData（回程本来就是海外机器的概念）；上游与接入信息全是空的；国内测速 6 个节点里杭州电信、宁波电信、香港联通、深圳移动 4 个是 ERROR，只有上海联通（发送 197 Mbps）和苏州移动（发送 198 Mbps）出了数——这 4 个 ERROR 的节点和本站在纽约机器上实测时失败的是同一批，说明是节点本身的问题。

实测于 2026-09-20 · 腾讯云上海 · Ubuntu 24.04 · 2 核 1GB。国内服务器连 GitHub 时通时断，同一条命令不同时间的结果可能不一样。

• 需要 curl 和 bash。本站实测时以 root 运行。
• 首次运行会用包管理器安装依赖。脚本提示要装的是 jq、curl、imagemagick、mtr、iperf3、stun、bc 这 7 个，但 imagemagick 会带进一大串图形和字体库：实测在一台干净的 Debian 13 上，apt 实际新装了 95 个软件包，下载 41.4 MB，占用 152 MB 磁盘。硬盘很小的机器先看一眼剩余空间。
• 预留时间：实测从回车到出报告一共 21 分 18 秒，期间不要关终端。担心 SSH 断线就先开一个 screen 或 tmux 再跑。

第 1 步：粘贴命令回车

脚本先检查依赖。缺依赖时会停下来问一次，这是全程唯一需要操作的地方。

Lacking necessary dependencies.
Packages jq curl imagemagick mtr iperf3 stun bc will be installed using package manager.
Continue? (y/n):

第 2 步：输入 y 回车，等依赖装完

输入 y 之后屏幕会滚过很长一段 apt 的安装输出（实测 95 个包），不用管它。

Ubuntu 上多一步：蓝色对话框按回车

在 Ubuntu 上，输入 y 之后安装到 iperf3 时，屏幕会突然变成一个全屏的蓝色对话框，标题是 Configuring iperf3，问是否让 iperf3 作为后台服务开机自动启动，默认选中的是 No。直接按回车选 No 即可，安装会继续。不按的话脚本会一直停在这里——本站在两台 Ubuntu 24.04 机器上都遇到了这个对话框，其中一次没有应答，停了 6 分钟没有任何进展。Debian 13 上实测没有出现这个对话框。

 Configuring iperf3

 Start Iperf3 as a daemon automatically?

            <Yes>            <No>

第 3 步：等检测跑完

依赖装好后脚本自动开始逐项检测，不需要再做任何操作。三网延迟要测 31 个省乘以三家运营商，国际互连要测十个城市，是最花时间的两段。

第 4 步：看报告

全部跑完后屏幕会刷新成一份完整的「网络质量体检报告」，最后一行是报告图片的链接，可以直接发给别人看。报告正文之前会先打印几屏赞助商的字符画广告，往下翻才是报告。

                          网络质量体检报告：167.71.*.*
                       https://github.com/xykt/NetQuality
            报告时间：2026-09-20 05:36:56 CST  脚本版本：v2026-09-01

实测运行后系统里多了 95 个用包管理器装的软件包（imagemagick、mtr、iperf3、stun 以及它们带进来的图形和字体库），脚本结束后不会卸载。其中 stun 包会注册一个开机启动的系统服务（systemctl 显示 stun.service 为 enabled）；实测检查时它没有进程在运行，也没有监听任何端口。iperf3 的系统服务是 disabled 状态。不想留的话可以用 apt remove 卸掉，再 apt autoremove 清理带进来的库。