netquality is a shell script that diagnoses network quality and connectivity across multiple dimensions.
The tool addresses the need to comprehensively assess network performance and routing characteristics. It performs BGP lookups, checks upstream and access provider information, measures latency across China's three major carriers (China Telecom, China Unicom, and China Mobile) to 31 provinces and regions, conducts speed tests against Speedtest.NET infrastructure, traces complete routing paths using NextTrace, and tests global latency and throughput across five continents. The script supports both IPv4 and IPv6 dual-stack queries and offers multiple testing modes: standard comprehensive testing, latency-only mode, low-data mode for bandwidth-constrained environments, and the ability to skip individual test sections.
The tool suits network administrators, hosting providers, and users in mainland China who need detailed carrier-specific performance metrics and routing visibility. It works across Ubuntu, Debian, Fedora, CentOS, Arch Linux, Alpine Linux, macOS, and Windows via Docker. The script provides output in multiple formats—formatted terminal display, JSON for data analysis, and ANSI/JSON/plain text file export—with bilingual Chinese and English support. A privacy mode disables online report generation for users concerned about data transmission.
The project maintains active development with regular updates addressing security, functionality, and reliability. Recent changes include migration of all HTTP requests to HTTPS for improved security, addition of a privacy mode to disable online report features, implementation of file output capabilities for reports in multiple formats, introduction of Docker support for broader platform compatibility, and fixes for routing test stability issues and JSON formatting irregularities.
