# xykt/netquality

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/xykt-netquality).**

4,325 stars · 343 forks · Shell · agpl-3.0

## Links

- GitHub: https://github.com/xykt/NetQuality
- awesome-repositories: https://awesome-repositories.com/repository/xykt-netquality.md

## Description

NetQuality is a network performance benchmarking suite that measures latency, bandwidth, and routing paths across IPv4 and IPv6 networks using TCP and ICMP probes. It functions as a BGP routing analyzer, identifying peering relationships and network bottlenecks by retrieving data from global routing databases, and as a dual-stack network tester that performs diagnostics simultaneously over both protocol stacks to compare performance and connectivity.

The tool distinguishes itself through its TCP-based traceroute engine, which traces the full route packets take to a destination while identifying each hop and its latency, with support for large-packet mode. It also provides multi-region bandwidth testing, measuring upload and download throughput across domestic and international servers to assess network capacity and bottlenecks. The diagnostic suite can be run inside a Docker container with host-network mode for isolated or containerized environments, and results can be exported as structured JSON or saved to files in ANSI, JSON, or plain-text format for programmatic analysis or offline review.

The suite covers network latency measurement, bandwidth throughput testing, and TCP traceroute diagnostics, with the ability to run in dual-stack mode, latency-only mode, or skip specific diagnostic modules. It also traces return routing paths across China's three major ISPs using NextTrace, and queries BGP peering information from BGP.TOOLS and BGP.HE.NET databases.

## Tags

### Testing & Quality Assurance

- [Network Performance Benchmarks](https://awesome-repositories.com/f/testing-quality-assurance/network-performance-benchmarks.md) — A tool for measuring latency, bandwidth, and routing performance across IPv4 and IPv6 networks using TCP and ICMP probes.
- [Low-Data Network Testing](https://awesome-repositories.com/f/testing-quality-assurance/low-data-network-testing.md) — Minimizes traffic consumption during network tests by using small packet sizes and adaptive probe intervals.

### Development Tools & Productivity

- [Network Speed Testers](https://awesome-repositories.com/f/development-tools-productivity/command-line-network-clients/network-speed-testers.md) — Measures upload and download speeds to servers across five continents using the Speedtest.net infrastructure. ([source](https://github.com/xykt/NetQuality#readme))
- [Multi-Region Speed Tests](https://awesome-repositories.com/f/development-tools-productivity/command-line-network-clients/network-speed-testers/multi-region-speed-tests.md) — Measures upload and download throughput across domestic and international servers to assess network capacity and bottlenecks. ([source](https://github.com/xykt/NetQuality/blob/main/README_EN.md))

### DevOps & Infrastructure

- [Diagnostic Probes](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/networking/dual-stack-networking/diagnostic-probes.md) — Performs diagnostics simultaneously over IPv4 and IPv6 to compare performance across both protocols. ([source](https://github.com/xykt/NetQuality/blob/main/README.md))
- [Dual-Stack Network Testers](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/networking/dual-stack-networking/dual-stack-network-testers.md) — Performs diagnostics simultaneously over IPv4 and IPv6 to compare performance and connectivity across both protocol stacks.

### Networking & Communication

- [BGP Routing Analyzers](https://awesome-repositories.com/f/networking-communication/bgp-routing-analyzers.md) — Identifies peering relationships and network bottlenecks by analyzing routing paths and retrieving data from global BGP databases.
- [Probing Frameworks](https://awesome-repositories.com/f/networking-communication/dual-stack-ip-localization/probing-frameworks.md) — Simultaneously sends probes over IPv4 and IPv6 stacks to compare latency and routing behavior across both protocols.
- [BGP Data Integration](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/bgp-and-spine-leaf-architectures/bgp-data-integration.md) — Retrieves and analyzes peering policies from global routing databases to identify network entry points and bottlenecks. ([source](https://github.com/xykt/NetQuality/blob/main/README_EN.md))
- [Network Latency Analyzers](https://awesome-repositories.com/f/networking-communication/network-latency-analyzers.md) — Runs a comprehensive diagnostic that measures latency, bandwidth, and routing paths across IPv4 and IPv6 networks to identify connectivity bottlenecks. ([source](https://github.com/xykt/NetQuality#readme))
- [Performance Monitoring](https://awesome-repositories.com/f/networking-communication/network-performance-testers/performance-monitoring.md) — Collecting and exporting network diagnostic data in structured formats for programmatic analysis and offline review.
- [Round-Trip Time Measurements](https://awesome-repositories.com/f/networking-communication/round-trip-time-measurements.md) — Measures round-trip time to endpoints across multiple ISPs and regions using TCP large-packet probes. ([source](https://github.com/xykt/NetQuality/blob/main/README.md))
- [TCP Traceroute Diagnostics](https://awesome-repositories.com/f/networking-communication/tcp-traceroute-diagnostics.md) — Uses TCP packets instead of ICMP to trace routing paths, enabling accurate hop detection through firewalls and NATs.
- [BGP Diagnostics](https://awesome-repositories.com/f/networking-communication/traffic-routing/bgp-diagnostics.md) — Identifies BGP peering relationships and network bottlenecks along the path between source and destination. ([source](https://github.com/xykt/NetQuality/blob/main/README.md))
- [Return Path Visualization](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/network-routing/return-path-visualization.md) — Displays the full return path to China's three major ISPs across 31 provinces using NextTrace. ([source](https://github.com/xykt/NetQuality/blob/main/README_EN.md))
- [BGP Peering Displays](https://awesome-repositories.com/f/networking-communication/traffic-routing/bgp-diagnostics/bgp-peering-displays.md) — Shows upstream providers, local policies, and BGP peering data sourced from BGP.TOOLS and BGP.HE.NET databases. ([source](https://github.com/xykt/NetQuality#readme))

### System Administration & Monitoring

- [Bandwidth Testers](https://awesome-repositories.com/f/system-administration-monitoring/bandwidth-monitors/bandwidth-testers.md) — Measures available bandwidth between the local machine and remote endpoints to assess network throughput. ([source](https://github.com/xykt/NetQuality/blob/main/README.md))
- [Packet Path Tracing](https://awesome-repositories.com/f/system-administration-monitoring/packet-path-tracing.md) — Traces the full route packets take to a destination, identifying each hop and its latency, with support for TCP large-packet mode. ([source](https://github.com/xykt/NetQuality/blob/main/README.md))

### Part of an Awesome List

- [Diagnostic JSON Reports](https://awesome-repositories.com/f/awesome-lists/data/data-export/json-exports/diagnostic-json-reports.md) — Exports the full diagnostic report as structured JSON for programmatic analysis and integration. ([source](https://github.com/xykt/NetQuality#readme))
