diff --git a/luci-app-pingpacket/luci-app-pingpacket/.gitattributes b/luci-app-pingpacket/.gitattributes similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/.gitattributes rename to luci-app-pingpacket/.gitattributes diff --git a/luci-app-pingpacket/luci-app-pingpacket/Makefile b/luci-app-pingpacket/Makefile similarity index 99% rename from luci-app-pingpacket/luci-app-pingpacket/Makefile rename to luci-app-pingpacket/Makefile index f68f461d2..5dbe5f65c 100644 --- a/luci-app-pingpacket/luci-app-pingpacket/Makefile +++ b/luci-app-pingpacket/Makefile @@ -6,7 +6,7 @@ LUCI_PKGARCH:=all PKG_NAME:=luci-app-pingpacket PKG_VERSION:=1.0.0 -PKG_RELEASE:=20 +PKG_RELEASE:=3 PKG_LICENSE:=Apache-2.0 include $(TOPDIR)/feeds/luci/luci.mk diff --git a/luci-app-pingpacket/README.md b/luci-app-pingpacket/README.md deleted file mode 100644 index c4d7ea3c5..000000000 --- a/luci-app-pingpacket/README.md +++ /dev/null @@ -1,224 +0,0 @@ -# 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 配置示例： - -```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` 安装包后执行： - -```sh -opkg install luci-app-pingpacket_v1.0.22_all.ipk -``` - -### OpenWrt 25.12.x - -上传 `apk` 安装包后执行： - -```sh -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` | 数据停滞时手动重启服务 | - diff --git a/luci-app-pingpacket/jpg/1.png b/luci-app-pingpacket/jpg/1.png deleted file mode 100644 index cb170364b..000000000 Binary files a/luci-app-pingpacket/jpg/1.png and /dev/null differ diff --git a/luci-app-pingpacket/jpg/2.png b/luci-app-pingpacket/jpg/2.png deleted file mode 100644 index f2d4a861d..000000000 Binary files a/luci-app-pingpacket/jpg/2.png and /dev/null differ diff --git a/luci-app-pingpacket/jpg/3.png b/luci-app-pingpacket/jpg/3.png deleted file mode 100644 index 225792fbc..000000000 Binary files a/luci-app-pingpacket/jpg/3.png and /dev/null differ diff --git a/luci-app-pingpacket/luci-app-pingpacket/luasrc/controller/pingpacket.lua b/luci-app-pingpacket/luasrc/controller/pingpacket.lua similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/luasrc/controller/pingpacket.lua rename to luci-app-pingpacket/luasrc/controller/pingpacket.lua diff --git a/luci-app-pingpacket/luci-app-pingpacket/luasrc/view/pingpacket/logs.htm b/luci-app-pingpacket/luasrc/view/pingpacket/logs.htm similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/luasrc/view/pingpacket/logs.htm rename to luci-app-pingpacket/luasrc/view/pingpacket/logs.htm diff --git a/luci-app-pingpacket/luci-app-pingpacket/luasrc/view/pingpacket/status.htm b/luci-app-pingpacket/luasrc/view/pingpacket/status.htm similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/luasrc/view/pingpacket/status.htm rename to luci-app-pingpacket/luasrc/view/pingpacket/status.htm diff --git a/luci-app-pingpacket/po/zh-cn b/luci-app-pingpacket/po/zh-cn new file mode 120000 index 000000000..8d69574dd --- /dev/null +++ b/luci-app-pingpacket/po/zh-cn @@ -0,0 +1 @@ +zh_Hans \ No newline at end of file diff --git a/luci-app-pingpacket/luci-app-pingpacket/po/zh_Hans/pingpacket.po b/luci-app-pingpacket/po/zh_Hans/pingpacket.po similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/po/zh_Hans/pingpacket.po rename to luci-app-pingpacket/po/zh_Hans/pingpacket.po diff --git a/luci-app-pingpacket/luci-app-pingpacket/root/etc/config/pingpacket b/luci-app-pingpacket/root/etc/config/pingpacket similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/root/etc/config/pingpacket rename to luci-app-pingpacket/root/etc/config/pingpacket diff --git a/luci-app-pingpacket/luci-app-pingpacket/root/etc/init.d/pingpacket b/luci-app-pingpacket/root/etc/init.d/pingpacket old mode 100644 new mode 100755 similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/root/etc/init.d/pingpacket rename to luci-app-pingpacket/root/etc/init.d/pingpacket diff --git a/luci-app-pingpacket/luci-app-pingpacket/root/usr/bin/pingpacket.sh b/luci-app-pingpacket/root/usr/bin/pingpacket.sh old mode 100644 new mode 100755 similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/root/usr/bin/pingpacket.sh rename to luci-app-pingpacket/root/usr/bin/pingpacket.sh diff --git a/luci-app-pingpacket/luci-app-pingpacket/root/usr/share/rpcd/acl.d/luci-app-pingpacket.json b/luci-app-pingpacket/root/usr/share/rpcd/acl.d/luci-app-pingpacket.json similarity index 100% rename from luci-app-pingpacket/luci-app-pingpacket/root/usr/share/rpcd/acl.d/luci-app-pingpacket.json rename to luci-app-pingpacket/root/usr/share/rpcd/acl.d/luci-app-pingpacket.json