secubox-openwrt/package/secubox/luci-app-secubox-netifyd/README.zh.md
CyberMind-FR ccfb58124c docs: Add trilingual documentation (French and Chinese translations)
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>
2026-03-20 10:00:18 +01:00

5.9 KiB
Raw Blame History

SecuBox Netifyd 深度包检测界面

English | Francais | 中文

完整的 Netifyd DPI 引擎 LuCI 界面,具有实时流监控、应用检测和网络分析功能。

功能

实时监控

  • 实时流跟踪:通过 socket 接口实时监控活动网络流
  • Socket 集成:通过 TCP 或 Unix 域 socket 连接到 Netifyd
  • 自动刷新:可配置的轮询间隔用于实时更新

应用和协议检测

  • 深度包检测:利用 Netifyd 的 DPI 引擎
  • 应用识别检测和跟踪应用程序HTTP、HTTPS、SSH、DNS 等)
  • 协议分析:识别网络协议并分析流量模式
  • SSL/TLS 检查:提取 SSL 证书信息和加密详情

设备跟踪

  • 网络发现:自动检测网络上的设备
  • 流量分析:每个设备的上传/下载统计
  • MAC/IP 映射:关联 MAC 地址和 IP 地址
  • 最后活动跟踪:监控设备活动时间戳

服务管理

  • 启动/停止/重启:完全控制 Netifyd 服务
  • 启用/禁用:配置开机自启
  • 状态监控:查看服务健康状态和运行时间
  • 配置:通过 UCI 管理 Netifyd 设置

分析和报告

  • 热门应用:最常用应用的可视化图表
  • 热门协议:协议使用统计
  • 流量统计:总字节数、数据包和流计数
  • 导出功能:将流导出为 JSON 或 CSV 格式

要求

  • OpenWrt 21.02 或更高版本
  • LuCI (luci-base)
  • 已安装 netifyd 软件包
  • jq用于 JSON 处理)
  • secubox-core

安装

通过 SecuBox 应用商店

# 从 LuCI 管理面板
导航到 SecuBox -> 应用商店 -> 搜索 "Netifyd"
点击"安装"

手动安装

opkg update
opkg install luci-app-secubox-netifyd
service rpcd restart

配置

基本设置

  1. 安装 netifyd
opkg install netifyd
  1. 配置 netifyd socket编辑 /etc/netifyd.conf
[socket]
listen_path[0] = /var/run/netifyd/netifyd.sock
listen_address[0] = 127.0.0.1:7150
  1. 启动 netifyd
service netifyd start
service netifyd enable
  1. 访问 LuCI 界面:
导航到SecuBox -> Network Intelligence

高级配置

通过 LuCI 设置页面或 UCI 配置:

uci set secubox-netifyd.settings.socket_address='127.0.0.1'
uci set secubox-netifyd.settings.socket_port='7150'
uci set secubox-netifyd.settings.auto_start='1'
uci set secubox-netifyd.monitoring.enable_app_detection='1'
uci set secubox-netifyd.analytics.enabled='1'
uci commit secubox-netifyd

使用

仪表板

  • 查看实时服务状态
  • 监控活动流、设备和应用程序
  • 快速统计概览
  • 服务控制按钮

实时流

  • 带自动刷新的实时流表
  • 源/目标 IP 和端口
  • 协议和应用检测
  • 流量统计(字节、数据包、持续时间)
  • 将流导出为 JSON/CSV

应用程序

  • 按流量排名的热门应用
  • 每个应用的流计数
  • 流量百分比可视化
  • 可排序的应用列表

设备

  • 带 MAC/IP 地址的活动设备列表
  • 每个设备的上传/下载统计
  • 最后活动时间戳
  • 总流量跟踪

设置

  • Socket 配置TCP/Unix
  • 流保留和限制
  • 监控开关
  • 分析偏好
  • 告警配置

API 方法

服务控制

  • get_service_status - 获取 Netifyd 服务状态
  • service_start - 启动 Netifyd 服务
  • service_stop - 停止 Netifyd 服务
  • service_restart - 重启 Netifyd 服务
  • service_enable - 启用自启动
  • service_disable - 禁用自启动

数据检索

  • get_realtime_flows - 获取实时流数据
  • get_flow_statistics - 获取流统计
  • get_top_applications - 获取热门应用
  • get_top_protocols - 获取热门协议
  • get_detected_devices - 获取检测到的设备
  • get_dashboard - 获取仪表板摘要

配置

  • get_config - 获取当前配置
  • update_config - 更新配置
  • get_interfaces - 获取监控的接口

工具

  • clear_cache - 清除流缓存
  • export_flows - 导出流JSON/CSV

故障排除

Netifyd 无法启动

# 检查 netifyd 安装
which netifyd

# 检查配置
cat /etc/netifyd.conf

# 查看日志
logread | grep netifyd

# 手动重启
/etc/init.d/netifyd restart

Socket 连接失败

# 测试 TCP socket
nc -z 127.0.0.1 7150

# 检查 netifyd 进程
ps | grep netifyd

# 验证 socket 配置
grep listen /etc/netifyd.conf

无流数据

# 检查 netifyd 是否在捕获
netifyd -s

# 验证接口
grep interface /etc/netifyd.conf

# 检查 dump 文件
cat /run/netifyd/sink-request.json

性能注意事项

  • 流限制:默认 10,000 个流(可配置)
  • 保留时间:默认 1 小时(可配置)
  • 轮询间隔3-10 秒(可配置)
  • 显示限制UI 中 100 个流(可完整导出)

安全说明

  • Socket 默认监听 localhost
  • 无显式配置则无外部访问
  • 流数据包含敏感网络信息
  • 如果对外暴露 socket 建议配置防火墙规则

收集器设置脚本

使用 /usr/bin/netifyd-collector-setup 启用流导出器并安装每分钟运行 /usr/bin/netifyd-collector 的 cron 任务。脚本接受:

/usr/bin/netifyd-collector-setup [unix|tcp] [路径或主机[:端口]]

示例:

/usr/bin/netifyd-collector-setup unix /tmp/netifyd-flows.json
/usr/bin/netifyd-collector-setup tcp 127.0.0.1:9501

每次调用更新 /etc/config/secubox-netifyd,写入 /etc/netifyd.d/secubox-sink.conf 创建 cron 条目(* * * * * /usr/bin/netifyd-collector),并重启 netifyd

许可证

MIT License - Copyright (C) 2025 CyberMind.fr

链接

致谢

  • eGloo 的 Netify:深度包检测引擎
  • SecuBox 团队LuCI 集成和界面设计
  • OpenWrt 社区:平台和软件包生态系统