CyberMind-FR
ccfb58124c
Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
146 lines
3.3 KiB
Markdown
146 lines
3.3 KiB
Markdown
[English](README.md) | [Francais](README.fr.md) | [中文](README.zh.md)
|
||
|
||
# SecuBox 网络诊断
|
||
|
||
OpenWrt 实时 DSA 交换机端口统计和网络错误监控仪表板。
|
||
|
||
## 功能特性
|
||
|
||
- **交换机端口状态面板**：DSA 交换机端口的可视化表示，带有链路状态、速度和双工指示器
|
||
- **错误监控部件**：带警报阈值的实时错误跟踪（正常/警告/严重）
|
||
- **接口详情**：完整的 ethtool 输出、驱动统计和内核消息日志
|
||
- **自动刷新**：可配置的轮询间隔（5s、10s、30s 或手动）
|
||
- **响应式设计**：适配移动端的界面，带 SecuBox 暗色主题
|
||
|
||
## 支持的硬件
|
||
|
||
- MOCHAbin（Marvell Armada 8040）带 mvpp2 驱动
|
||
- 任何带 DSA 交换机拓扑的 OpenWrt 设备
|
||
- 独立以太网接口（非 DSA）
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
# 使用 SDK 编译
|
||
cd secubox-tools/sdk
|
||
make package/luci-app-secubox-netdiag/compile V=s
|
||
|
||
# 在设备上安装
|
||
opkg install luci-app-secubox-netdiag_*.ipk
|
||
```
|
||
|
||
## 依赖项
|
||
|
||
- luci-base
|
||
- ethtool
|
||
|
||
## 菜单位置
|
||
|
||
SecuBox > 网络诊断
|
||
|
||
## 监控的错误指标
|
||
|
||
| 指标 | 描述 |
|
||
|------|------|
|
||
| rx_crc_errors | CRC/FCS 校验和错误 |
|
||
| rx_frame_errors | 帧错误 |
|
||
| rx_fifo_errors | FIFO 溢出错误 |
|
||
| rx_missed_errors | 丢失的数据包（缓冲区满） |
|
||
| tx_aborted_errors | TX 中止 |
|
||
| tx_carrier_errors | 载波检测错误 |
|
||
| collisions | 以太网冲突 |
|
||
| rx_dropped | 接收丢弃 |
|
||
| tx_dropped | 发送丢弃 |
|
||
|
||
## 警报阈值
|
||
|
||
| 级别 | 条件 | 指示器 |
|
||
|------|------|--------|
|
||
| 正常 | 0 错误/分钟 | 绿色 |
|
||
| 警告 | 1-10 错误/分钟 | 黄色 |
|
||
| 严重 | >10 错误/分钟 | 红色（脉冲） |
|
||
|
||
## RPCD API
|
||
|
||
### 方法
|
||
|
||
```
|
||
luci.secubox-netdiag
|
||
get_switch_status - 所有接口及 DSA 拓扑
|
||
get_interface_details { interface: string } - 完整 ethtool/dmesg 详情
|
||
get_error_history { interface: string, minutes: int } - 错误时间线
|
||
get_topology - DSA 交换机结构
|
||
clear_counters { interface: string } - 清除错误历史
|
||
```
|
||
|
||
### ubus 调用示例
|
||
|
||
```bash
|
||
ubus call luci.secubox-netdiag get_switch_status
|
||
```
|
||
|
||
## 数据来源
|
||
|
||
- `/sys/class/net/*/statistics/*` - 内核统计
|
||
- `/sys/class/net/*/carrier` - 链路状态
|
||
- `/sys/class/net/*/master` - DSA 拓扑
|
||
- `ethtool <iface>` - 链路参数
|
||
- `ethtool -S <iface>` - 驱动统计
|
||
- `dmesg` - 内核消息
|
||
|
||
## UI 组件
|
||
|
||
### 端口卡片
|
||
```
|
||
+----------+
|
||
| eth0 |
|
||
| [*] Up |
|
||
| 1G FD |
|
||
| OK |
|
||
+----------+
|
||
```
|
||
|
||
### 错误监控器
|
||
```
|
||
eth2 - CRC 错误（最近 5 分钟）
|
||
[迷你图] 123/分钟（严重）
|
||
```
|
||
|
||
## 文件
|
||
|
||
```
|
||
luci-app-secubox-netdiag/
|
||
Makefile
|
||
htdocs/luci-static/resources/
|
||
view/secubox-netdiag/
|
||
overview.js # 主 LuCI 视图
|
||
secubox-netdiag/
|
||
netdiag.css # SecuBox 主题样式
|
||
root/usr/
|
||
libexec/rpcd/
|
||
luci.secubox-netdiag # RPCD 后端脚本
|
||
share/
|
||
luci/menu.d/
|
||
luci-app-secubox-netdiag.json
|
||
rpcd/acl.d/
|
||
luci-app-secubox-netdiag.json
|
||
```
|
||
|
||
## 截图
|
||
|
||
### 主仪表板
|
||
- DSA 交换机端口网格布局
|
||
- 独立接口在下方
|
||
- 错误监控器在底部
|
||
|
||
### 端口详情模态框
|
||
- 链路状态（速度、双工、自动协商）
|
||
- 流量统计（字节、数据包）
|
||
- 带增量的错误计数器
|
||
- 最近内核消息
|
||
- 清除历史/导出日志按钮
|
||
|
||
## 许可证
|
||
|
||
MIT
|