Files
op-packages/luci-app-pingpacket

luci-app-pingpacket

luci-app-pingpacket 是一个面向 OpenWrt 的 LuCI 状态监控插件,用于持续观察国内直连质量和国外经代理访问质量,并提供统计、日志和快速排障能力。

界面截图

Ping丢包监控总览
监控总览
Ping丢包监控设置
监控设置
Ping丢包监控运行日志
运行日志

适用平台

  • 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-base
  • luci-lua-runtime
  • luci-compat
  • curl

安装

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 数据停滞时手动重启服务