Network Optimizer系列26：架构深潜——.NET 10+Blazor构建的自托管NMS模块化设计

【免费下载链接】NetworkOptimizerSelf-hosted optimization, monitoring (NMS), and security audit tool for UniFi Networks. Includes Wi-Fi Optimizer for wireless health scoring and channel optimization, advanced DNS/VLAN/firewall security checks, config optimization suggestions, centralized WAN and LAN speed test server w/ L2 tracing, CM, ONT, SFP, 5G modem stats more.​​​​​​​​​​​​​项目地址https://gitcode.com/gh_mirrors/ne/NetworkOptimizer点击查看免费下载Network Optimizer 是一款面向 UniFi 网络的自托管 NMS网络管理系统用 .NET 10 Blazor 构建提供 Wi-Fi 优化、安全审计、WAN/LAN 测速与设备健康监控等能力。这篇文章从架构视角拆解它的模块化设计12 个功能如何被拆成职责清晰的 .NET 类库又如何通过单向依赖和统一存储层拼装成一个可自托管、可扩展的完整系统。为什么选择 .NET 10 Blazor 技术栈对于想搭一套私有网络监控平台的新手来说理解一个项目的技术选型是理解架构的第一步。Network Optimizer 的完整技术栈如下技术组件在架构中的角色.NET 10全部服务端与功能模块的运行框架TargetFramework为net10.0Blazor ServerWeb UI 层页面在服务端渲染通过 SignalR 与后端实时通信EF Core SQLite核心持久层配置、审计历史、测速结果等结构化数据InfluxDB 2.x可选的时序数据库承载 SNMP 指标、延迟探针等监控数据iperf3 / OpenSpeedTestLAN/WAN/客户端测速引擎Go 二进制运行在网关上的轻量组件WAN 测速、WAN Steering、AP AgentSerilog统一日志这个选型的核心思路是单进程、少外部依赖。不装 InfluxDB 也能用只是没有时序监控数据库就是一个 SQLite 文件——这是自托管体验顺滑的关键。模块地图一个解决方案里的 12 个功能库打开 NetworkOptimizer.sln你会看到按功能域划分的 13 个src/项目 13 个对应的tests/测试项目。官方 README 中的结构总览src/ ├── NetworkOptimizer.Web # Blazor Web UI组合根 ├── NetworkOptimizer.Core # 共享工具与接口 ├── NetworkOptimizer.Storage # SQLite InfluxDB 存储层 ├── NetworkOptimizer.UniFi # UniFi Console API 客户端 ├── NetworkOptimizer.Audit # 83 项安全检查的审计引擎 ├── NetworkOptimizer.Diagnostics # 配置优化建议 ├── NetworkOptimizer.Monitoring # SNMP 轮询与时序指标 ├── NetworkOptimizer.WiFi # Wi-Fi 健康评分与信道优化 ├── NetworkOptimizer.Sqm # 自适应 SQM 拥塞管理 ├── NetworkOptimizer.Threats # 威胁情报分析 ├── NetworkOptimizer.Alerts # 告警规则与定时任务 ├── NetworkOptimizer.Reports # PDF / Markdown 报告 └── NetworkOptimizer.Agent # 远程站点轻量 Agent各模块职责一句话说明src/NetworkOptimizer.UniFi/与 UniFi Console 对话的唯一入口。UniFiApiClient.cs 封装了 Cookie 认证、CSRF Token、401 自动重登与 Polly 重试其他模块从不直接碰 UniFi 的 HTTP API。src/NetworkOptimizer.Audit/纯规则引擎。防火墙影子规则、VLAN 隔离、DNS 泄漏等 83 项检查全部是无状态的 C# 规则类输入配置快照输出 0–100 分——这也是它测试覆盖最厚的模块之一。src/NetworkOptimizer.Monitoring/SNMP 轮询器、探针、各厂商Cable Modem / ONT / 5G 调制解调器的指标解析器都在这里指标经过MetricsAggregator归一化后写入 InfluxDB。src/NetworkOptimizer.Web/Services/整个 Web 项目里最大的目录500 个服务类负责把上面的功能库编排成面向用户的业务流程如测速调度、Agent 隧道代理、告警联动。 架构要点每个功能都是独立类库可以单独编译、单独测试、单独演进。想只读审计引擎的代码只需打开一个项目即可不用在 Web 层几千个文件里大海捞针。依赖分层Web 是组合根功能库只认接口在 NetworkOptimizer.Web.csproj 中可以看到清晰的单向依赖Web项目引用全部 12 个功能库而功能库之间互不引用只依赖Core共享模型与接口。依赖方向严格是Web → 功能库 → Core/Storage不存在反向或循环依赖。真正的组装发生在组合根 Program.csbuilder.Services.AddDbContextNetworkOptimizerDbContext((sp, options) ...); builder.Services.AddScopedIAuditRepository, AuditRepository(); builder.Services.AddScopedIMonitoringInterfaceRepository, MonitoringInterfaceRepository(); // ... 十余个仓储与服务的注册所有数据访问都通过 src/NetworkOptimizer.Storage/ 中接口 仓储的成对文件完成Interfaces/IxxxRepository.csRepositories/XxxRepository.cs功能模块拿到的是抽象而非具体实现。这就是典型的依赖注入分层表现层Blazor 组件src/NetworkOptimizer.Web/Components/应用服务层Web/Services下的业务流程编排领域功能层12 个功能类库基础设施层StorageSQLite/InfluxDB、UniFi API 客户端、Agent 隧道协议双数据库设计SQLite 存事实InfluxDB 存时序Storage 模块 是理解这套 NMS 数据流的钥匙SQLiteEF Core承载一切持久事实——设置、审计历史、测速结果、SQM 基线、Agent 配置。Migrations/ 目录下已有 300 个迁移文件启动时自动Migrate()用户无需手工执行数据库升级。InfluxDB可选MonitoringInfluxClient是全项目唯一触碰 InfluxDB 客户端的地方。SNMP 指标写入走缓冲 定时批量刷盘避免高频打爆数据库连接 Token 经ICredentialProtectionService加密存储页面向导自动完成 bucket 与 token 的开通。这套结构化数据 时序数据分离的设计让监控历史如 ISP Health 评分既保留完整时间轴又不污染主库远程站点接入On-Site Agent 的隧道协议设计自托管 NMS 的一个经典难题是多站点如何安全接入而不开放入站端口Network Optimizer 的答案是 NetworkOptimizer.Agent——一个可以直接跑在客户网关上实测占用约 50 MB的轻量 .NET 程序只出不进Agent 主动拨号单条出站 HTTPS/gRPC 隧道连回中心服务器站点侧零入站暴露CGNAT 后也能工作。协议独立建模隧道契约定义在 agent_tunnel.proto协议逻辑单独抽成 AgentProtocol 项目服务端与 Agent 共享同一份 proto永不失配。能力复用站点内的 UniFi Console、SNMP、设备 SSH 都通过隧道 TCP 代理进来因此安全审计、Wi-Fi 优化、LAN 测速OpenSpeedTest 页面 iperf3在远程站点上功能不打折质量保障每个功能库都有独立测试项目模块化的收益在测试目录直接兑现tests/下 13 个 xunit 测试项目与src/一一对应。由于审计、Wi-Fi、SQM 等模块是无外部依赖的纯逻辑库测试无需 Mock 整个网络——例如 tests/NetworkOptimizer.Audit.Tests/ 覆盖分析器、规则、DNS 检测器等全部子系统。日常跑测试可用仓库脚本测试入口scripts/test.sh覆盖率scripts/coverage.sh scripts/coverage.runsettings编码与 AI 协作规范CODING_STANDARDS.md新手读源码的推荐路线结合上面的分层建议按这条路径入门从数据 → 规则 → 界面逐步深入src/NetworkOptimizer.Storage/README.md —— 5 分钟理解数据存哪里src/NetworkOptimizer.UniFi/UniFiApiClient.cs —— 看它如何与 UniFi Console 通信src/NetworkOptimizer.Audit/ —— 挑一条安全规则如IotVlanRule.cs看纯 C# 检查逻辑src/NetworkOptimizer.Web/Program.cs —— 回到组合根看服务如何被注册需要部署时参考 docker/DEPLOYMENT.md或按 docs/MACOS-INSTALLATION.md 做原生安装总结Network Optimizer 的架构可以浓缩成三句话功能即类库审计、Wi-Fi、监控、SQM、告警各自独立单向依赖可单独测试与演进存储双轨制SQLite 管事实、InfluxDB 管时序且后者可选降低自托管门槛Agent 打通多站点一条出站 gRPC 隧道让远程站点获得完整功能入站端口为零如果你正在规划自己的 .NET 自托管 NMS 或想学习 Blazor 大型应用的组织方式这套组合根 领域功能库 接口仓储的模板非常值得对照着仓库源码逐层阅读。赞分享【免费下载链接】NetworkOptimizerSelf-hosted optimization, monitoring (NMS), and security audit tool for UniFi Networks. Includes Wi-Fi Optimizer for wireless health scoring and channel optimization, advanced DNS/VLAN/firewall security checks, config optimization suggestions, centralized WAN and LAN speed test server w/ L2 tracing, CM, ONT, SFP, 5G modem stats more.​​​​​​​​​​​​​项目地址https://gitcode.com/gh_mirrors/ne/NetworkOptimizer点击查看免费下载相关推荐Network Traffic Analyzer 系统架构深度解析netanal 的模块化设计与数据流全览Network Traffic Analyzer 系统架构深度解析netanal 的模块化设计与数据流全览 本篇技术指南围绕 Cybersecurity Prdat架构设计模块化P2P文件共享系统的构建dat架构设计模块化P2P文件共享系统的构建 项目概述 dat是一个基于命令行的P2PPeer to Peer对等网络文件共享和实时同步工具。它允许用户数据工程开发工具Network Optimizer系列13搭建自托管时序监控——InfluxDBSNMP3D实时流量地图完全教程Network Optimizer系列13搭建自托管时序监控——InfluxDBSNMP3D实时流量地图完全教程 Network Optimizer 是一创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考