mirror of
https://github.com/kiddin9/op-packages.git
synced 2026-11-16 13:33:02 +08:00
luci-app-pingpacket
luci-app-pingpacket 是一个面向 OpenWrt 的 LuCI 状态监控插件,用于持续观察国内直连质量和国外经代理访问质量,并提供统计、日志和快速排障能力。
界面截图
监控总览 |
监控设置 |
运行日志 |
|
适用平台
- OpenWrt 24.10.x,发布
ipk安装包 - OpenWrt 25.12.x,发布
apk安装包 - 已安装 LuCI Web 管理界面
- 设备需具备
ping、curl、awk、sed、grep、tail等基础命令
当前仓库的 GitHub Actions 工作流默认构建 x86/64 SDK 版本;插件本身为 LuCI 页面和 shell 脚本,原则上也可移植到其他支持 LuCI 的 OpenWrt 架构。
页面位置
后台路径:
状态 -> Ping丢包监控
子页面:
监控日志
主要功能
监控页
- 支持分别配置国内目标和国外测速 URL
- 国内目标通过本机
ping进行 ICMP 探测 - 国外目标通过
curl+socks5h代理进行连续测速,更接近代理实际访问质量 - 国外测速仅将 HTTP
200/204视为成功 - 页面内可直接启用或关闭监控服务
- 点击“保存并应用”后会保存配置;如果当前已启用监控,服务会自动重启并按新配置重新开始累计统计
- 当检测到“数据停滞”时,页面会直接显示“重新启动服务”按钮
- 实时显示开始时间、运行时长、最近更新时间、CPU 占用、内存占用和服务状态
统计卡片
国内和国外分别独立统计以下数据:
- 平均延迟
- 最低延迟
- 最高延迟
- 丢包率
- 丢包数
- 样本数
统计口径说明:
- 以上数据均为“本次服务启用后的累计统计值”
- 停止服务、重新启用服务或重启服务后,统计会重新开始
- 国内和国外分别独立累计,不合并计算
丢包与时间的关系
监控页内置一张丢包率趋势图,用于观察网络质量随时间的变化:
- 国内、国外两条曲线分别独立展示,带面积填充与悬浮提示
- 支持
日(最近 24 小时,10 分钟粒度)、周(最近 7 天,1 小时粒度)、月(最近 30 天,6 小时粒度) - 支持
自定义时间范围,可选起点与终点,单次最多查询 90 天 - 图表上方显示所选区间的平均丢包率、区间峰值丢包率与统计区间
- 鼠标悬浮可查看某个时间点的丢包率、样本数与丢包数
- 图表数据全部由本地接口生成,不依赖任何外部 CDN 或前端库
数据来源与保留策略:
- 采集脚本按分钟把探测结果(样本数、丢包数、延迟合计)写入
/etc/pingpacket/history/YYYY-MM-DD.tsv - 每分钟最多写一行,写盘压力很小;服务停止时会立即刷写当前分钟的数据
- 历史文件最多保留 35 天,超期文件会被自动清理
- 与统计卡片不同:图表记录的是历史趋势,服务重启或设备重启后仍然保留;统计卡片的累计值则会重新开始
日志页
- 显示插件运行日志
- 顶部支持“自动刷新”开关,默认勾选
- 支持“清除日志”按钮
- 显示日志最后更新时间、日志行数和日志大小
- 默认保留最近 500 行日志
当前日志会记录:
- 服务启动
- 服务停止
- 单次丢包事件
- 恢复事件
- 国外代理测速失败原因
日志规则:
- 只要单次探测失败,就立即记录一条日志
- 连续失败时,每次失败都会单独记录
- 故障后的首次成功响应会记录恢复日志
当前探测方式
国内
- 目标类型:IP 或域名
- 探测方式:ICMP
ping - 默认目标:
www.baidu.com - 默认 Ping 间隔:
1秒
国外
- 目标类型:域名或完整 URL
- 探测方式:通过
socks5h代理发起curl请求 - 默认测速 URL:
https://www.google.com/generate_204 - 默认代理端口:
7891 - 默认测速间隔:
5秒 - 代理主机固定为 OpenWrt 本机
127.0.0.1
配置规则
- 国内和国外目标可以只填其中一个
- 两个目标都为空时,不能“保存并应用”
- 两个目标都为空时,也不能通过开关启用服务
- 若填写国外测速 URL,则必须同时填写代理端口
- 代理端口必须为
1-65535的数字 - 外国测速 URL 未填写协议时,系统会自动按
https://处理 - 页面轮询刷新时,不会覆盖用户正在编辑但尚未保存的输入内容
默认配置
安装或补齐配置时,默认值如下:
- 国内目标:
www.baidu.com - 国外测速 URL:
https://www.google.com/generate_204 - 国外代理类型:
socks5h - 国外代理端口:
7891 - 国内 Ping 间隔:
1 - 国外测速间隔:
5
默认 UCI 配置示例:
config pingpacket 'config'
option enabled '0'
option domestic_target 'www.baidu.com'
option foreign_target 'https://www.google.com/generate_204'
option foreign_proxy_type 'socks5h'
option foreign_proxy_host '127.0.0.1'
option foreign_proxy_port '7891'
option domestic_interval '1'
option foreign_interval '5'
依赖
luci-baseluci-lua-runtimeluci-compatcurl
安装
OpenWrt 24.10.x
上传 ipk 安装包后执行:
opkg install luci-app-pingpacket_v1.0.22_all.ipk
OpenWrt 25.12.x
上传 apk 安装包后执行:
apk add --allow-untrusted ./luci-app-pingpacket_v1.0.22_all.apk
说明:
- 升级时会尽量保留已有
/etc/config/pingpacket - 若系统中存在历史遗留的
/etc/config/pingpacket-opkg,安装脚本会用其中缺失的默认项补齐现有配置,然后删除该文件 - 安装脚本会自动创建
/etc/pingpacket/history目录用于保存丢包历史
运行文件
| 路径 | 说明 | 生命周期 |
|---|---|---|
/tmp/pingpacket_status.json |
监控状态与累计统计 | 服务停止后删除 |
/tmp/pingpacket.log |
运行日志,最多 500 行 | 设备重启后丢失 |
/tmp/pingpacket_cpu_state |
CPU 采样缓存 | 设备重启后丢失 |
/var/run/pingpacket/config |
本次运行的配置缓存 | 服务停止后删除 |
/var/run/pingpacket/start_time |
本次服务启动时间 | 服务停止后删除 |
/etc/pingpacket/history/*.tsv |
按分钟聚合的丢包历史 | 保留 35 天 |
接口
| 接口 | 说明 |
|---|---|
get_data |
返回配置、服务状态、系统资源与累计统计 |
get_history |
返回丢包趋势数据,参数 range=day|week|month|custom,自定义时附加 from、to(Unix 秒) |
get_logs |
返回日志内容与元信息 |
clear_logs |
清空日志文件 |
save_config |
保存配置,并按启用状态重启或停止服务 |
restart_service |
数据停滞时手动重启服务 |


