一个综合性网络质量(PING)检测工具，支持正/反向PING绘图、互PING拓扑绘图与报警、全国PING延迟地图与在线检测工具等功能
English README
- 正向PING，反向Ping绘图
- 互PING间机器的状态拓扑，自定义延迟、丢包阈值报警（声音报警），报警时MTR检测
- 全国PING延迟地图（各省份可分电信、联通、移动三条线路）
- 检测工具，支持使用SmartPingNext各节点进行网络相关检测
- 节点编辑（支持修改节点名称和IP地址，自动同步关联配置）
- 配置导入/导出
- 支持深色/浅色主题切换
- 设置面板统一管理主题与语言
- 中英双语界面，支持运行时切换（无需刷新）
- 可收缩侧边栏
- 单文件部署，无需额外配置文件
- 后端: Go 1.24 + SQLite3（纯 Go 实现，无 CGO 依赖）
- 前端: Vue 3 + TypeScript + Vite + Element Plus + ECharts
从 Releases 下载对应平台的版本：
| 平台 | 架构 | 文件 |
|---|---|---|
| Linux | amd64 | smartping-linux-amd64.tar.gz |
| Linux | arm64 | smartping-linux-arm64.tar.gz |
| Linux | armv7 | smartping-linux-armv7.tar.gz |
| Windows | amd64 | smartping-windows-amd64.zip |
| macOS | arm64 | smartping-darwin-arm64.tar.gz |
# Linux/macOS
tar -xzf smartping-*.tar.gz
./smartping
# Windows
# 解压 smartping-*.zip
# 双击运行 smartping.exe首次运行会自动创建 conf/、db/、logs/ 目录并释放默认配置文件。
需要 Go 1.24+，以及 Node.js 20.19+ 或 22.12+。
# 前端
cd web
npm ci
npm run build:embed
# 后端
cd ..
go build -o smartping src/smartping.gobuild:embed 支持 Windows、Linux 和 macOS，会在前端构建成功后替换 src/static/html 中的生成文件，避免重复复制产生嵌套目录或打包旧资源。仅开发前端时仍可使用 npm run build。
支持多架构镜像：linux/amd64、linux/arm64、linux/arm/v7
docker pull pathletboy/smartping-next:latest
# 运行容器
docker run -d \
--name smartping \
-p 8899:8899 \
-v smartping-conf:/app/conf \
-v smartping-db:/app/db \
-v smartping-logs:/app/logs \
--restart unless-stopped \
pathletboy/smartping-next:latest
# 或自行构建
docker build -t smartping-next:latest .
docker run -d --name smartping -p 8899:8899 smartping-next:latest
# 或使用 docker-compose
docker-compose up -d默认端口: 8899 | 默认密码: smartping
本系统的定位为轻量级工具，即使组多点成互Ping网络可以遵守无中心化原则，所有的数据均存储自身节点中，每个节点提供出方向的数据，从任意节点查询数据均会通过Ajax请求关联节点的API接口获取并组装全部数据。
├── src/ # Go 后端源码
│ ├── smartping.go # 程序入口
│ ├── g/ # 全局配置和数据结构
│ ├── http/ # HTTP 服务层
│ ├── funcs/ # 核心业务逻辑
│ ├── nettools/ # 底层网络工具
│ └── static/ # 嵌入的静态文件
│ ├── html/ # 前端页面
│ ├── conf/ # 默认配置
│ └── db/ # 默认数据库
├── web/ # Vue 3 前端源码
│ ├── src/
│ │ ├── views/ # 页面组件
│ │ ├── components/ # 通用组件
│ │ ├── api/ # API 接口
│ │ └── assets/ # 静态资源
│ └── package.json
├── conf/ # 配置文件（运行时生成）
├── db/ # SQLite 数据库（运行时生成）
└── logs/ # 日志文件（运行时生成）
| 端点 | 方法 | 描述 |
|---|---|---|
/api/config.json |
GET | 获取配置 |
/api/ping.json |
GET | 获取 PING 数据 |
/api/topology.json |
GET | 获取拓扑状态 |
/api/alert.json |
GET | 获取报警日志 |
/api/mapping.json |
GET | 获取地图数据 |
/api/tools.json |
GET | 在线检测工具 |
/api/saveconfig.json |
POST | 保存配置 |
/api/proxy.json |
GET | 代理访问远程节点 |
/api/ping.json 返回的指标数组与 lastcheck 时间轴逐项对应，数值使用字符串表示。没有采样记录的分钟使用 "-"，图表显示为断点；"0" 是真实记录的零值，不能与缺失采样混同。API 客户端应在转换数字前处理 "-"。查询时间和返回的时间轴均使用节点时区。
/api/topology.json 按目标 IP 返回字符串状态："true" 表示未达到告警阈值，"false" 表示达到告警阈值，"unknown" 表示配置的检查窗口内没有该目标的采样（包含跨分钟完成采样的宽限时间）。未知状态不触发告警，也不将已有告警标记为恢复。客户端应显式处理三种值，不能将非 "false" 值一律视为正常。
欢迎参与项目贡献！比如提交PR修复一个bug，或者新建 Issue 讨论新特性或者变更。
本项目基于 smartping/smartping 开发，在原有功能基础上进行了以下改进：
- 使用 Vue 3 + TypeScript + Element Plus 重构前端
- 单文件部署，前端和默认配置嵌入二进制
- 纯 Go SQLite 驱动，无 CGO 依赖，跨平台编译
- 新增深色/浅色主题切换支持
- 可收缩侧边栏
- 中英双语界面，支持运行时切换
- 配置导入/导出功能
- Docker 镜像支持
- GitHub Actions 自动构建多平台发布包
- 图表组件防抖优化，减少频繁重绘
- 全局错误边界，提升用户体验
- 类型安全增强，移除不安全的类型断言
- 内存泄漏修复，确保组件正确销毁
- 改进响应式布局适配
- 全局 ICMP 连接池，解决并发 Ping 假丢包问题
- 修复节点删除后图表页残留显示
- 修复 ICMP DestinationUnreachable 类型断言错误
- 修复 Ping 数据查询 24 小时上限限制
- 修复最小延迟误报为 0 的计时竞态