🚀 Sync 2026-11-03 05:32:30

2026-11-07 04:34:05 +08:00 · 2026-11-03 05:32:30 +08:00
1 parent 981b1dc64d
commit e37cccd846
@@ -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
@@ -1,224 +0,0 @@
-# luci-app-pingpacket
-
-`luci-app-pingpacket` 是一个面向 OpenWrt 的 LuCI 状态监控插件，用于持续观察国内直连质量和国外经代理访问质量，并提供统计、日志和快速排障能力。
-
-## 界面截图
-
-<table>
-  <tr>
-    <td width="50%" align="center">
-      <img src="jpg/1.png" alt="Ping丢包监控总览" width="100%">
-      <br>
-      <sub>监控总览</sub>
-    </td>
-    <td width="50%" align="center">
-      <img src="jpg/2.png" alt="Ping丢包监控设置" width="100%">
-      <br>
-      <sub>监控设置</sub>
-    </td>
-  </tr>
-  <tr>
-    <td colspan="2" align="center">
-      <img src="jpg/3.png" alt="Ping丢包监控运行日志" width="78%">
-      <br>
-      <sub>运行日志</sub>
-    </td>
-  </tr>
-</table>
-
-## 适用平台
-
- 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` | 数据停滞时手动重启服务 |
-
@@ -0,0 +1 @@
+zh_Hans