后端网络运维数据可视化【免费下载链接】NetAlertXCentralized network visibility and continuous asset discovery. Monitor devices, detect change, and stay aware across distributed networks.项目地址https://gitcode.com/gh_mirrors/ne/NetAlertX点击查看免费下载导读NetAlertX 的newdev_template插件New Devices是一个数据库条目型核心模板插件每当网络扫描发现一台此前从未出现过的新设备时系统就会以该插件在Settings New Devices中定义的默认值来初始化这条设备记录。本文将完整拆解该模板插件提供的全部配置项忽略规则、名称清洗正则、设备字段默认值等并深入 device_handling.py 与 name_resolution.py 的源码说明这些设置如何在新设备入库 → 名称解析 → 图标/类型推断 → 忽略过滤的完整链路中被真正消费帮助你在部署 NetAlertX 时精准控制新设备的接入行为。插件定位与工作原理newdev_template本身不执行任何扫描也不产出设备对象它是一个纯粹的默认值模板。其定位可以从 config.json 的头部声明中直接读出template_type: database-entry指明这是数据库条目模板类型unique_prefix: NEWDEV所有由它生成的设置项都以NEWDEV_为前缀写入Settings表plugin_type: core属于核心插件随系统启用enabled: truedata_source: template数据源为模板而非网络发现show_ui: false插件本身不在插件列表 UI 中展示它只通过 Settings 页的 New Devices 分组呈现。从源码调用看device_handling.py 中生成新设备记录的 SQL 会直接读取NEWDEV_*全局设置并注入到INSERT语句中见 device_handling.py#L770-L786前端 deviceDetailsEdit.php 则在编辑设备时按setGroup NEWDEV过滤、以NEWDEV_前缀映射到Devices表的字段见 deviceDetailsEdit.php#L90-L93。这就是模板生成可编辑设置再由 device.py 使用这些设置初始化新值这一机制README 的 Notes 所述的完整实现闭环。快速使用进入设置页面按 README 指引只需进入Settings New Devices设置分组页即可调整所有默认值。这里的每一项设置都对应NEWDEV_*键设置项函数名默认值说明ignored_MACs[]空需要忽略的 MAC 列表支持%通配符ignored_IPs[]空需要忽略的 IP 列表支持%/_通配符NAME_CLEANUP_REGEX12 条内置正则base64 存储新设备名称清洗规则按顺序执行IP_MATCH_NAMEtrue是否允许按 IP 猜测设备名replace_preset_iconfalse是否用推断的厂商/设备图标覆盖预设图标devMac/devLastIP空自动检测不可编辑devName(unknown)新设备默认名称为(unknown)或(name not found)时尝试自动发现devIcon空默认图标含图标选择器与实时预览devOwner/devType/devVendor/devGroup/devLocation空所有者、类型、厂商、分组、位置的默认值多为下拉选择devComments空默认备注textareadevFirstConnection/devLastConnection/devLastNotification空自动检测不可编辑时间戳devFavorite0默认是否标记为收藏设备devStaticIP0默认是否静态 IPdevScan1默认是否对该设备执行扫描devLogEvents1默认是否记录设备事件devAlertEvents1默认是否对设备事件告警Down 与新设备通知默认总是发送除非在NTFPRCS_INCLUDED_SECTIONS中取消勾选devAlertDown0默认是否在设备掉线时告警受NTFPRCS_alert_down_time影响devCanSleep0默认是否允许设备在缺席小于NTFPRCS_sleep_time时显示为SleepingdevSkipRepeated0重复通知抑制时长小时0全部通知11h88h241天1681周devPresentLastScan1默认上一次扫描是否在场devIsNew1默认是否视为新设备影响 New Devices 过滤器与列表展示不影响通知devIsArchived0默认是否归档归档且离线时从 My Devices 隐藏devParentMAC/devParentRelType/devParentPort空 /default/0网络拓扑父节点默认值父 MAC、关系类型、端口devSSID/devSite/devVlan空无线 SSID、网络站点、VLAN 默认值devSyncHubNode空Sync 节点名启用 sync 插件 后自动填充devCustomProps内置删除设备动作自定义属性的默认模板devFQDN/devPrimaryIPv4/devPrimaryIPv6空自动检测不可编辑FQDN 可由REFRESH_FQDN自动刷新devReqNicsOnline0是否要求所有关联 NIC 在线才判定设备在线devForceStatusdont_force强制状态online/offline/dont_force自动检测忽略规则ignored_MACs 与 ignored_IPs这是两个数组型设置作用是从监控与告警中彻底剔除不需要的设备被忽略的设备不会出现在任何 UI 列表和通知中。通配符语义描述文本明确指出%匹配任意字符序列含空序列_精确匹配单个字符。例如02:42:ac:%可过滤掉 Docker 容器其 MAC 通常以02:42:ac开头192.168.3.%可过滤整个 IP 网段。底层实现过滤动作发生在扫描数据落库之前。exclude_ignored_devices 将NEWDEV_ignored_MACs、NEWDEV_ignored_IPs通过list_to_where(OR, ...)组装成LIKE条件直接对CurrentScan表执行DELETEmac_condition list_to_where(OR, scanMac, LIKE, get_setting_value(NEWDEV_ignored_MACs)) ip_condition list_to_where(OR, scanLastIP, LIKE, get_setting_value(NEWDEV_ignored_IPs)) # DELETE FROM CurrentScan WHERE (scanMac LIKE ... OR scanLastIP LIKE ...)注意SQLite 的LIKE天然支持%与_通配符与设置描述中的语义一致若两列表均为空则执行WHERE 11 AND 10的空条件保护避免误删整表见 device_handling.py#L84。名称清洗NAME_CLEANUP_REGEX 与 IP_MATCH_NAME新设备名称质量直接影响列表可读性与后续匹配NetAlertX 通过两层机制处理1. 名称清洗正则NAME_CLEANUP_REGEX数组中每条正则按顺序对设备名执行re.sub(rgx, , name)替换为空串。内置 12 条默认正则config.json 中以 base64 存储解码后如下\._airplay # 去除 mDNS 服务类型后缀 _airplay \._tcp # 去除 ._tcp \.localdomain # 去除 .localdomain \.local # 去除 .local \._esphomelib # 去除 ._esphomelib \._googlecast # 去除 ._googlecast \.lan # 去除 .lan \.home\.arpa # 去除 .home.arpa \.home # 去除 .home -[a-fA-F0-9]{32} # 去除 32 位十六进制后缀如某些随机主机名 #.* # 去除 # 及之后内容 \.$ # 去除结尾点号执行逻辑位于 NameResolver.clean_device_name按序遍历正则列表执行替换随后强制re.sub(r\.$, , name)收尾并修复. (IP match)间隔问题。这是列表型设置可自由增删——例如可加入-iPhone$之类的正则来清理移动设备名。2. 按 IP 匹配名称IP_MATCH_NAME默认开启true。当按 MAC 在Plugins_Objects表中找不到名称时若开启此项则再按 IPobjectSecondaryId尝试匹配见 name_resolution.py#L36-L47。该方案在 IP 基本静态的网络中有效匹配成功时名称会附加(IP match)标记以示来源。若你的网络大量使用 DHCP 且地址频繁变动可关闭此项以减少误匹配。新设备入库流程NEWDEV_* 默认值的消费位置理解模板默认值如何落地需要看新设备创建主流程。位于 update_and_insert_devices源码约 device_handling.py#L744-L909收集候选从CurrentScan中选取scanCreatesDevice 1且 MAC 非空的记录拼接默认值将NEWDEV_devAlertEvents、NEWDEV_devAlertDown、NEWDEV_devPresentLastScan、NEWDEV_devIsArchived、NEWDEV_devIsNew、NEWDEV_devSkipRepeated、NEWDEV_devScan、NEWDEV_devOwner、NEWDEV_devFavorite、NEWDEV_devGroup、NEWDEV_devComments、NEWDEV_devLogEvents、NEWDEV_devLocation、NEWDEV_devCustomProps、NEWDEV_devParentRelType、NEWDEV_devReqNicsOnline等设置值经safe_int/sanitize_SQL_input处理后注入INSERT见 device_handling.py#L770-L786安静模式quiet若某 MAC 的扫描行存在scanNotificationMode quiet则改用newDevDefaults_quiet变体将告警相关默认值硬编码为0从而在新设备整个生命周期内静默抑制 Down/Disconnected 通知见 device_handling.py#L788-L804类型回退扫描未提供类型时回退到NEWDEV_devType见 device_handling.py#L887-L889父节点守卫NEWDEV_devParentMAC指向的 MAC 若已不存在设备被删除则视为未设置避免向新设备注入悬空引用见 device_handling.py#L834-L848。图标与类型推断replace_preset_icon 的取舍replace_preset_iconOverwrite Preset Icon默认关闭。其消费逻辑在 update_icons_and_types开启时查询范围扩大为devIcon为空或等于默认图标NEWDEV_devIcon的设备随后用guess_icon()依据厂商、MAC、IP、名称推断更贴合的图标并覆盖之关闭时仅对图标为空NULL 等价的设备做推断保留手动设置的预设图标NEWDEV_devIcon。config.json 的描述给出了一条重要警告若开启此项请避免手动把该图标分配给设备因为它可能被自动替换。同理devType为空时由guess_type()按相同维度推断见 device_handling.py#L456-L477。注意devType描述提到NETWORK_DEVICE_TYPES中自定义的网络设备类型不会自动加入下拉选项需要在该设备上通过按钮手动添加。前端编辑联动设备详情页如何使用这些设置模板设置同时也是设备详情编辑页的字段来源编辑页通过filterColumn: setGroup, filterValue: NEWDEV只加载 NEWDEV 分组设置见 deviceDetailsEdit.php#L90-L93保存时以NEWDEV_devName、NEWDEV_devOwner、NEWDEV_devType、NEWDEV_devVendor、NEWDEV_devIcon等 ID 读取输入并映射回Devices表字段见 deviceDetailsEdit.php#L435-L439NEWDEV_devScan与NEWDEV_devPresentLastScan属于隐藏字段见 deviceDetailsEdit.php#L111新增设备mac new时禁用自动检测类字段devLastNotification、devFirstConnection、devLastConnection、devFQDN、devPrimaryIPv4、devPrimaryIPv6、devSyncHubNode而已有设备则额外禁用devMac、devLastIP的编辑见 deviceDetailsEdit.php#L113。因此修改模板默认值不仅影响未来发现的新设备也会作为设备编辑表单的初始值出现。此外 app.css 中隐藏了设置页里NEWDEV插件的若干添加选项/复制图标按钮避免在模板层面误操作。结语与最佳实践newdev_template是 NetAlertX 新设备策略的总开关配置建议归纳如下先配忽略规则用02:42:ac:%类通配符过滤 Docker 容器、用192.168.3.%过滤测试网段从源头减少噪声设备保留默认名称清洗正则它们专门针对 mDNS/多播设备名后缀若手动替换请务必保留\.local、\.lan等高频项按需开启图标覆盖想让新设备自动获得厂商图标可开启replace_preset_icon但需接受手动图标可能被覆盖审计通知默认值devAlertDown默认关、devSkipRepeated默认 0全部通知与NTFPRCS_alert_down_time、NTFPRCS_sleep_time、NTFPRCS_INCLUDED_SECTIONS联动决定新设备上线后的告警行为静态 IP 环境可保留IP_MATCH_NAME动态 DHCP 环境建议评估误匹配风险后关闭。所有配置项均可在 config.json 中查阅原始定义含 SQL 选项来源、base64 默认值与字段约束并在 device_handling.py、name_resolution.py 中追踪其实际消费逻辑——这使新设备接入策略完全可预测、可审计。赞分享后端网络运维数据可视化【免费下载链接】NetAlertXCentralized network visibility and continuous asset discovery. Monitor devices, detect change, and stay aware across distributed networks.项目地址https://gitcode.com/gh_mirrors/ne/NetAlertX点击查看免费下载相关推荐ungoogled-chromium 默认设置详解14 项出厂默认值的变更与底层补丁实现ungoogled chromium 默认设置详解14 项出厂默认值的变更与底层补丁实现 ungoogled chromium 在构建时对 Chromium开发工具网络安全Multipass 设置详解local.privileged-mounts 挂载权限开关的配置、默认值与底层实现Multipass 设置详解local.privileged mounts 挂载权限开关的配置、默认值与底层实现 local.privileged mount虚拟化开发工具云原生fabio 的 runtime.gomaxprocs 配置详解GOMAXPROCS 的优先级、默认值与底层实现fabio 的 runtime.gomaxprocs 配置详解GOMAXPROCS 的优先级、默认值与底层实现 runtime.gomaxprocs 是 fa后端API网关微服务上一篇突破性能瓶颈uWebSockets零拷贝缓冲区管理技术深度解析下一篇tf_efficientnetv2_s.in21k_ft_in1k代码解读深入理解EfficientNetV2架构创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考