https://www.0niu.cn/tags/netsentinel/Recent content in NetSentinel on HiDaHugo -- gohugo.iozhThu, 18 Jun 2026 10:00:00 +0800https://www.0niu.cn/posts/netsentinel-network-diagnostics-tool/Thu, 18 Jun 2026 10:00:00 +0800https://www.0niu.cn/posts/netsentinel-network-diagnostics-tool/<p>NetSentinel 是一个开源的局域网诊断桌面应用，用 Python 写了约 13.6 万行代码，内置 62 个工具，覆盖设备发现、网络监控、故障诊断、安全审计、自动化和教育六大模块。所有数据在本地处理，不需要账号，不传遥测，MIT 协议。</p> <p>它的定位很明确：替代 Nmap（设备发现/端口扫描）、Wireshark（广播风暴/ARP 监控）、PingPlotter（稳定性日志/断网证据）、Wi-Fi 分析器，以及手动拼凑 ISP 投诉材料的繁琐过程。</p> <h2 id="核心功能">核心功能</h2> <p><strong>设备发现</strong></p> <p>扫描局域网内所有设备，显示 IP、MAC、主机名、厂商、型号和风险等级。支持 ARP + ICMP + TCP SYN + mDNS 并行扫描。还能生成网络拓扑图，扫描 Wi-Fi（隐藏 SSID、 rogue AP、WPS 开启的网络）。</p> <p><strong>网络监控</strong></p> <ul> <li>实时带宽图表（上传/下载）</li> <li>设备在线率历史（1h/12h/24h/7d）</li> <li>后台稳定性记录器：持续 ping/RTT/抖动/DNS 日志，导出 CSV 作为断网证据</li> <li>每设备流量统计（需要 Npcap/libpcap）</li> <li>IoT 设备行为基线：学习正常流量模式，异常时告警</li> </ul> <p><strong>故障诊断</strong></p> <ul> <li>&ldquo;What&rsquo;s Wrong?&rdquo; 一键排查：自动跑 DNS、风暴、STP、ISP 检查，按可能性排序</li> <li>根因关联器：逐跳 ping 链，定位丢包从哪一跳开始，给出结论（是你路由器还是 ISP 的问题）</li> <li>服务诊断：对任意主机做 DNS/TCP/HTTPS/ICMP/traceroute 探测，分类故障层级</li> <li>DNS 基准测试：对比系统 DNS 和 Cloudflare/Google/Quad9，含 DNS 泄漏测试</li> <li>测速：三级引擎（Ookla CLI → speedtest-cli → 纯 Python 兜底）</li> </ul> <p><strong>安全审计</strong></p> <ul> <li>SYN 半开端口扫描</li> <li>OS 指纹识别</li> <li>CVE 查询：关联 NVD 数据库</li> <li>TLS 证书监控：每小时检查，30 天到期预警</li> <li>凭据测试：检查 SSH/SMB/FTP/Telnet 弱口令</li> <li>ARP 欺骗监控：实时检测 IP-MAC 冲突</li> <li>恶意 DHCP 服务器检测</li> </ul> <p><strong>二层网络检测</strong></p> <ul> <li>STP 根桥检测：捕获 BPDU，识别哪个设备抢了根桥角色（常见于 Google Nest 等设备导致每 30-45 秒断网）</li> <li>广播风暴检测：测量洪泛级别，定位源设备</li> </ul> <p><strong>自动化与集成</strong></p> <ul> <li>只读 REST API（127.0.0.1:8765）</li> <li>MQTT / Home Assistant 集成</li> <li>Shell hooks：设备离线、高 RTT、新设备上线时触发命令</li> <li>内置 10 个硬件插件：TP-Link Deco、UniFi、FRITZ!Box、MikroTik、OpenWrt、Netgear、ASUS、Synology 等</li> </ul> <h2 id="isp-投诉报告">ISP 投诉报告</h2> <p>这是 NetSentinel 比较实用的功能。网络不稳定时，ISP 客服通常让你&quot;重启路由器试试&quot;。NetSentinel 的 ISP Accountability Report 会生成一个独立 HTML 文件，包含：</p> <ul> <li>逐跳 traceroute 表</li> <li>各跳丢包率</li> <li>DNS 延迟</li> <li>带时间戳的断网日志</li> </ul> <p>直接发给客服，有据可查。</p><p>NetSentinel 是一个开源的局域网诊断桌面应用，用 Python 写了约 13.6 万行代码，内置 62 个工具，覆盖设备发现、网络监控、故障诊断、安全审计、自动化和教育六大模块。所有数据在本地处理，不需要账号，不传遥测，MIT 协议。</p> <p>它的定位很明确：替代 Nmap（设备发现/端口扫描）、Wireshark（广播风暴/ARP 监控）、PingPlotter（稳定性日志/断网证据）、Wi-Fi 分析器，以及手动拼凑 ISP 投诉材料的繁琐过程。</p> <h2 id="核心功能">核心功能</h2> <p><strong>设备发现</strong></p> <p>扫描局域网内所有设备，显示 IP、MAC、主机名、厂商、型号和风险等级。支持 ARP + ICMP + TCP SYN + mDNS 并行扫描。还能生成网络拓扑图，扫描 Wi-Fi（隐藏 SSID、 rogue AP、WPS 开启的网络）。</p> <p><strong>网络监控</strong></p> <ul> <li>实时带宽图表（上传/下载）</li> <li>设备在线率历史（1h/12h/24h/7d）</li> <li>后台稳定性记录器：持续 ping/RTT/抖动/DNS 日志，导出 CSV 作为断网证据</li> <li>每设备流量统计（需要 Npcap/libpcap）</li> <li>IoT 设备行为基线：学习正常流量模式，异常时告警</li> </ul> <p><strong>故障诊断</strong></p> <ul> <li>&ldquo;What&rsquo;s Wrong?&rdquo; 一键排查：自动跑 DNS、风暴、STP、ISP 检查，按可能性排序</li> <li>根因关联器：逐跳 ping 链，定位丢包从哪一跳开始，给出结论（是你路由器还是 ISP 的问题）</li> <li>服务诊断：对任意主机做 DNS/TCP/HTTPS/ICMP/traceroute 探测，分类故障层级</li> <li>DNS 基准测试：对比系统 DNS 和 Cloudflare/Google/Quad9，含 DNS 泄漏测试</li> <li>测速：三级引擎（Ookla CLI → speedtest-cli → 纯 Python 兜底）</li> </ul> <p><strong>安全审计</strong></p> <ul> <li>SYN 半开端口扫描</li> <li>OS 指纹识别</li> <li>CVE 查询：关联 NVD 数据库</li> <li>TLS 证书监控：每小时检查，30 天到期预警</li> <li>凭据测试：检查 SSH/SMB/FTP/Telnet 弱口令</li> <li>ARP 欺骗监控：实时检测 IP-MAC 冲突</li> <li>恶意 DHCP 服务器检测</li> </ul> <p><strong>二层网络检测</strong></p> <ul> <li>STP 根桥检测：捕获 BPDU，识别哪个设备抢了根桥角色（常见于 Google Nest 等设备导致每 30-45 秒断网）</li> <li>广播风暴检测：测量洪泛级别，定位源设备</li> </ul> <p><strong>自动化与集成</strong></p> <ul> <li>只读 REST API（127.0.0.1:8765）</li> <li>MQTT / Home Assistant 集成</li> <li>Shell hooks：设备离线、高 RTT、新设备上线时触发命令</li> <li>内置 10 个硬件插件：TP-Link Deco、UniFi、FRITZ!Box、MikroTik、OpenWrt、Netgear、ASUS、Synology 等</li> </ul> <h2 id="isp-投诉报告">ISP 投诉报告</h2> <p>这是 NetSentinel 比较实用的功能。网络不稳定时，ISP 客服通常让你&quot;重启路由器试试&quot;。NetSentinel 的 ISP Accountability Report 会生成一个独立 HTML 文件，包含：</p> <ul> <li>逐跳 traceroute 表</li> <li>各跳丢包率</li> <li>DNS 延迟</li> <li>带时间戳的断网日志</li> </ul> <p>直接发给客服，有据可查。</p> <h2 id="安装">安装</h2> <p><strong>Windows</strong></p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>winget install NetSentinel.NetSentinel </span></span></code></pre></div><p>或从 <a href="https://github.com/ossianericson/netsentinel/releases/latest">GitHub Releases</a> 下载安装包，也可在 Microsoft Store 搜索安装。</p> <p><strong>macOS / Linux</strong></p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>git clone https://github.com/ossianericson/netsentinel </span></span><span style="display:flex;"><span>cd netsentinel </span></span><span style="display:flex;"><span>pip install -r requirements.txt </span></span><span style="display:flex;"><span>sudo python app.py </span></span></code></pre></div><p>二层功能（STP 检测、ARP 监控、广播风暴分析）需要安装 <a href="https://npcap.com">Npcap</a>（Windows）或 libpcap（macOS/Linux）。</p> <h2 id="适用场景">适用场景</h2> <ul> <li>家里网络频繁断连，怀疑是某个 IoT 设备搞鬼</li> <li>需要向 ISP 证明断网不是你的问题</li> <li>想看清局域网里到底有哪些设备</li> <li>安全审计：端口暴露、弱口令、ARP 欺骗检测</li> <li>网络学习：每个功能都对应 CompTIA Network+ / CCNA 课程中的协议</li> </ul>