Files
NetQuality/README.md
2025-07-22 17:10:35 +08:00

189 lines
7.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<p align="center">
<img src="https://hits.xykt.de/net.svg?action=view&count_bg=%2379C83D&title_bg=%23555555&title=Runs&edge_flat=false"/>
<img src="https://hits.xykt.de/net_github.svg?action=hit&count_bg=%233DC8C0&title_bg=%23555555&title=Visits&edge_flat=false"/>
<a href="/LICENSE"><img src="https://img.shields.io/badge/License-AGPL%20v3-blue.svg" alt="license" /></a>
</p>
## 网络质量体检脚本 - [Network Quality Check Script (EN)](https://github.com/xykt/NetQuality/blob/main/README_EN.md)
**支持OS/PlatformUbuntu | Debian | Linux Mint | Fedora | Red Hat Enterprise Linux (RHEL) | CentOS | Arch Linux | Manjaro | Alpine Linux | AlmaLinux | Rocky Linux | macOS | Anolis OS | Alibaba Cloud Linux | SUSE Linux | openSUSE | Void Linux**
- 中英文双语言支持
- 支持IPv4/IPv6双栈查询
- 精美排版,直观显示,多终端单屏优化展示,便于截图分享
- BGP信息、本地策略、接入信息、三网TCP大包延迟、三网回程路由、国内测速、国际互连七大模块
- 基础数据源自*BGP.TOOLS*及*BGP.HE.NET*数据库
- 上游及接入信息直观展示
- 中国大陆地区31个省/市/自治区电信/联通/移动三网回程延迟
- 基于*SPEEDTEST.NET*的中国大陆(含大湾区)三网网速测试
- 基于*NextTrace*的三网回程完整路由展示
- 全球五大洲网速及延迟测试
- 延迟模式、低数据模式、跳过任意章节,多种测试方式弹性选择
- Json输出便于大数据分析
#### 屏幕截图
|IPv4测试结果|IPv6测试结果|
| ---------------- | ---------------- |
|![IPv4](https://github.com/xykt/NetQuality/raw/main/res/v4_cn.png)|![IPv6](https://github.com/xykt/NetQuality/raw/main/res/v6_cn.png)|
|延迟模式测试结果|完整路由模式测试结果|
| ---------------- | ---------------- |
|![Ping](https://github.com/xykt/NetQuality/raw/main/res/ping_cn.png)|![Route](https://github.com/xykt/NetQuality/raw/main/res/route_v4.png)|
## 使用方法
### 便捷模式:交互界面
![Net](https://github.com/xykt/ScriptMenu/raw/main/res/Net_CN.png)
````bash
bash <(curl -Ls Check.Place) -N
````
### 高级模式:参数运行
![Help](https://github.com/xykt/NetQuality/raw/main/res/help.png)
##### 默认双栈检测:
````bash
bash <(curl -Ls Net.Check.Place)
````
##### 只检测IPv4结果
````bash
bash <(curl -Ls Net.Check.Place) -4
````
##### 只检测IPv6结果
````bash
bash <(curl -Ls Net.Check.Place) -6
````
##### 延迟模式:
````bash
bash <(curl -Ls Net.Check.Place) -P
````
##### 完整路由模式TCP大包
```bash
bash <(curl -Ls Net.Check.Place) -R [大陆地区省级行政区名称或中/英文简称]
```
缺省状态默认检测北京、上海、广东三地
```bash
bash <(curl -Ls Net.Check.Place) -R
```
指定参数可检测任意大陆省级行政区(以下任选其一)
```bash
bash <(curl -Ls Net.Check.Place) -R 桂
bash <(curl -Ls Net.Check.Place) -R 广西
bash <(curl -Ls Net.Check.Place) -R 广西壮族自治区
bash <(curl -Ls Net.Check.Place) -R GX
bash <(curl -Ls Net.Check.Place) -R gx
```
##### 低数据模式:
````bash
bash <(curl -Ls Net.Check.Place) -L
````
##### 跳过任意章节:
````bash
bash <(curl -Ls Net.Check.Place) -S 1234567
````
##### 中英文双语支持:
````bash
bash <(curl -Ls Net.Check.Place) -l cn|en
````
##### Json输出[输出示例](https://github.com/xykt/NetQuality/blob/main/res/output.json)
````bash
bash <(curl -Ls Net.Check.Place) -j
````
##### 输出报告ANSI/JSON/纯文本至文件:
````bash
bash <(curl -Ls Net.Check.Place) -o /path/to/file.ansi
bash <(curl -Ls Net.Check.Place) -o /path/to/file.json
bash <(curl -Ls Net.Check.Place) -o /path/to/file.txtoranyother
````
##### 跳过检测系统及安装依赖:
````bash
bash <(curl -Ls Net.Check.Place) -n
````
##### 自动安装依赖:
````bash
bash <(curl -Ls Net.Check.Place) -y
````
##### 报告展示完整IP地址
````bash
bash <(curl -Ls Net.Check.Place) -f
````
## 脚本更新
2025/05/11 14:00 增加报告svg图片分享链接修复一些排版问题
2025/04/23 18:00 增加-o输出报告ANSI/JSON/纯文本至文件,修复三网回程线路测试偶发卡死问题
2025/04/21 22:15 更新:完整路由模式,折叠重复的路由信息
2025/04/21 00:00 修复macOS兼容性问题提升脚本鲁棒性
2025/04/20 21:00 修复大陆IP无法正常获取脚本资源的问题
2025/03/28 00:50 增加-R完整路由模式增加低数据模式的国际互连延迟测试修复bugs
2025/03/13 22:40 增加-n参数跳过OS检测及安装依赖
2025/03/12 17:00 脚本发布
## 脚本贡献
**服务器赞助商(排名不分先后)**
| 赞助商 | 商标 | 网址 |
| - | - | - |
| V.PS | ![vps_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_vps.png) | [https://v.ps](https://v.ps)|
| BAGE | ![bage_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_bage.png) | [https://bagevm.com](https://bagevm.com)|
| LisaHost</br>丽萨主机 | ![lisa_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_lisa.png) | [https://lisahost.com](https://lisahost.com)|
| DreamCloud | ![dreamcloud_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_dreamcloud.png) | [https://as211392.com](https://as211392.com)|
| CNFaster | ![cnfaster_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_cnfaster.png) | [https://cnfaster.com](https://cnfaster.com)|
| UCloud</br>优刻得 | ![ucloud_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_ucloud.png) | [https://ucloud.cn](https://www.ucloud.cn/staticIPHost?ytag=uhost_ip_github)|
| AaITR | ![aaitr_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_aaitr.png) | [https://aaitr.com](https://www.aaitr.com/link.php?id=5)|
| VIRCS</br>威尔克斯 | ![vircs_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_vircs.png) | [https://vircs.com](https://www.vircs.com/promotion?code=6)|
| Thordata</br>`原生IP` | ![thordata_logo](https://raw.githubusercontent.com/xykt/NetQuality/main/res/sponsor/logo_thordata.png) | [https://thordata.com](https://www.thordata.com/?ls=VNSCxroa&lk=quality)|
##### *E-Mail: sponsor@check.place Telegram Bot: https://t.me/xythebot*
**仅接受长期稳定运营,信誉良好的商家*
**Acknowledgments:**
- 感谢NextTrace项目组[官网](https://www.nxtrace.org/)[GitHub](https://github.com/nxtrace/NTrace-core))提供稳定可靠的三网回程路由测试工具
- 感谢[SPEETNET.net](https://www.speedtest.net/)[Speedtest® CLI](https://www.speedtest.net/apps/cli)是目前大陆地区唯一可用的命令行三网测速工具
- 感谢[GlobalSign@Nodeseek](https://www.nodeseek.com/space/5813#/general)提供稳定可靠的三网测试地址,你的付出为脚本最重要的功能之一奠定了坚实基础
- 感谢[福尔摩斯@Nodeseek](https://www.nodeseek.com/space/13352#/general),你在功能及美工方面为脚本提供了诸多宝贵建议
- 感谢[酒神@Nodeseek](https://www.nodeseek.com/space/9#/general),你为脚本提供了技术支持及宝贵建议
- 感谢Si你为脚本的功能及排版提供了重要建议参考
- 感谢Kakan你为脚本提供了宝贵的参考意见
**Stars History:**
![Stargazers over time](https://starchart.cc/xykt/NetQuality.svg?background=%23FFFFFF&axis=%23333333&line=%2377ff77)
**Daily Runs History:**
![daily_runs_history](https://hits.xykt.de/history/net.svg?days=46&chartType=bar&title=%E7%BD%91%E7%BB%9C%E8%B4%A8%E9%87%8F%E4%BD%93%E6%A3%80%E8%84%9A%E6%9C%AC%E6%AF%8F%E6%97%A5%E8%BF%90%E8%A1%8C%E9%87%8F%E7%BB%9F%E8%AE%A1&width=1024&height=400&color=steelblue)