Repolode
Submit
xykt

xykt/NetQuality

A Shell script that runs a network quality health check on a Linux or macOS server, covering BGP, backhaul latency, routing and speed tests for mainland China.

View on GitHub
Stars
5,873
Forks
429
Open issues
0
Last commit
2 months ago

What is it?

NetQuality is a Shell script that inspects the network quality of a server or VM from the outside. It groups its checks into seven modules: BGP and upstream information, local policy, access network details, TCP large-packet latency to the three major Chinese carriers, three-carrier backhaul routes, domestic speed tests, and international interconnection.

The script reports IPv4 and IPv6 results separately and can target any of 31 mainland Chinese provinces and municipalities for backhaul latency. Speed tests use Speedtest.net, and full route tracing uses NextTrace. Users can choose a ping-only mode, a low-data mode, or skip individual sections, and output can be rendered in Chinese or English, as JSON, or saved to a file.

It runs on a wide range of Linux distributions and macOS, and is also available as a Docker image for Linux and Windows.

Key features

  • 01Tests IPv4 and IPv6 dual-stack network quality
  • 02Measures TCP large-packet latency to China Telecom, Unicom and Mobile across 31 provinces
  • 03Traces full three-carrier backhaul routes with NextTrace
  • 04Runs domestic speed tests via Speedtest.net and global latency checks
  • 05Supports JSON output, file export and Chinese/English display

Use cases

  • Evaluating a VPS or cloud server's connectivity to mainland China before deployment
  • Comparing routing quality across carriers and regions
  • Collecting structured network data as JSON for analysis
  • Running quick checks in a privacy-conscious mode that skips online report generation

Topics

#network#latency#bgp#traceroute#speed-test#shell#diagnostics

FAQ

What is NetQuality?
A Shell script that runs a network quality health check on a Linux or macOS server, covering BGP, backhaul latency, routing and speed tests for mainland China. NetQuality is a Shell script that inspects the network quality of a server or VM from the outside. It groups its checks into seven modules: BGP and upstream information, local policy, access network details, TCP large-packet latency to the three major Chinese carriers, three-carrier backhaul routes, domestic speed tests, and international interconnection.
Is NetQuality free to use? What license does it have?
NetQuality is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is NetQuality still maintained?
Updated within 6 months. The last commit to NetQuality was on Sep 1, 2026.
What can I use NetQuality for?
Evaluating a VPS or cloud server's connectivity to mainland China before deployment Comparing routing quality across carriers and regions Collecting structured network data as JSON for analysis Running quick checks in a privacy-conscious mode that skips online report generation
Where can I get NetQuality?
The source code and installation instructions are on GitHub: https://github.com/xykt/NetQuality

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects