NBping

NBping

NBping is a Ping tool developed in Rust. It supports concurrent Ping for multiple addresses, visual chart display, real-time data updates, and other features.

</a>

中文文档

NBPing (formerly Nping)

[!IMPORTANT] Renaming Notice

This project has been officially renamed from Nping to NBPing.

Please update your bookmarks, dependencies, and installation scripts accordingly. The old name is now deprecated and will no longer be maintained.

bash复制

nbping --help

Exporter Mode

Now NBping supports exporting ping metrics to Prometheus format, so you can visualize them with tools like Grafana.

nbping exporter www.baidu.com www.google.com -i 1 -p 9100

Then, you can scrape the metrics from http://localhost:9100/metrics

You can use Grafana to visualize the data:

Installation

MacOS Homebrew

brew install nbping

nbping --help

Feature:

• TCP Ping support
• IP range Ping support

Roadmap:

• Optimize UI interface, add more dynamic effects.

Usage

…

Exporter Usage

…

Configuration file

Instead of passing everything on the command line, you can start NBping from a YAML file with --config:

nbping --config nbping.yaml

The file mirrors the command-line flags. See nbping.example.yaml:

mode: tui              # tui | exporter (default: tui)
targets:
  - google.com
  - github.com
  - apple.com
  - baidu.com
  - 1.1.1.1
count: 0               # 0 = unlimited
interval: 1            # seconds
force_ipv6: false
multiple: 0            # tui mode only
view_type: graph       # graph | table | point | sparkline (tui mode only)
# output: results.log  # tui mode only
port: 9090             # exporter mode only

Notes:

• Precedence: command-line flags override the config file, which overrides built-in defaults (CLI flag > YAML config > default). For example, nbping --config nbping.yaml -i 1 forces a 1-second interval regardless of the file.
• Mode: the mode field selects TUI or exporter mode when no subcommand is given. Running the explicit nbping exporter ... subcommand always uses exporter mode.
• force_ipv6: the -6 flag can only turn IPv6 on; to disable IPv6 while a config enables it, set force_ipv6: false in the file.
• Unknown keys are rejected, so typos surface as errors at startup.

Acknowledgements

Thanks to these people for their feedback and suggestions for NBping!

| ThatFlower | zx4i | snail2sky | shenshouer | vnt-dev | qingyuan0o0 | Onlywzr

Thanks to these self-media for reposting and paying attention to NBping!

| 阮一峰的网络日志 |Rust 中文社区 | 公众号:奇妙的linux世界 | 公众号:IT运维技术圈 | X:@geekbb | 公众号:一飞开源 | 公众号: 开源日记

Star History