遮罩

本页详细说明 Securex NVR 中“遮罩”的用途、依赖关系、配置方法、验证步骤和排错思路。配置前请确认摄像头基础取流、系统存储和当前核心版本均正常。

适用场景

“遮罩”属于 Securex NVR 的功能配置之一。它应根据实际业务场景启用，而不是为了“功能全开”而默认打开。功能越多，对 CPU/GPU、存储、网络和维护的要求也越高。

配置前检查

确认当前 Securex 核心版本与本页字段相匹配。
导出一份当前可用配置。
确认相关摄像头 Live、Detect、Record 基础链路没有报错。
确认所需硬件、模型、网络端口或存储已经准备好。

实施步骤

先在一台测试摄像头或测试环境启用“遮罩”。
使用 UI 配置页优先完成基础设置；需要高级参数时再编辑 YAML。
运行配置验证并应用。
查看服务日志，处理所有 ERROR 以及与该功能直接相关的 WARNING。
用真实事件验证输出，再逐步推广到其他摄像头。

验证原则

“页面能打开”不等于功能已经生效。应检查实际输入、运行状态和最终输出三层：输入是否存在；后端是否处理；UI/API/录像/通知是否出现预期结果。

排错顺序

先撤销最近一次修改，确认问题是否由新配置引入。
把问题缩小到单摄像头、单功能、单模型。
查看日志中第一条根因错误，不要只处理后续连锁报错。
如果涉及媒体，先查 go2rtc/FFmpeg；涉及 AI，检查模型、标签、尺寸、runtime；涉及 UI/API，检查认证和反向代理。

生产建议

正式环境中一次只变更一个功能块，并记录变更前后的版本和配置。更新 Securex 核心后，先查看兼容性说明，再复核该功能的字段和默认值。

Masks

This page explains the purpose, dependencies, configuration workflow, verification, and troubleshooting for Masks in Securex NVR. Verify the base camera, storage, and current core version before enabling advanced behavior.

When to use it

Masks should be enabled because the deployment needs it, not simply to turn on every available feature. More features increase compute, storage, network, and maintenance requirements.

Before configuration

Confirm the documentation matches the installed Securex core.
Export a known-good configuration.
Confirm the related cameras have healthy Live/Detect/Record paths.
Prepare any required hardware, model, ports, or storage.

Implementation workflow

Enable Masks on one test camera/system first.
Use the UI for baseline settings and YAML only for advanced options.
Validate and apply the configuration.
Read logs and resolve relevant errors/warnings.
Validate with a real event before scaling out.

Verification principle

A page loading does not prove the feature is working. Verify input, backend processing, and final output separately.

Troubleshooting order

Revert the most recent change.
Reduce to one camera, one feature, one model.
Fix the first root-cause error in logs.
For media inspect go2rtc/FFmpeg; for AI inspect model/labels/shapes/runtime; for UI/API inspect auth/proxy.

Production practice

Change one functional block at a time and record version/config deltas. Recheck fields and defaults after a core upgrade.

Máscaras

Esta página explica propósito, dependencias, configuración, verificación y diagnóstico de Máscaras en Securex NVR.

Cuándo usarlo

Active Máscaras cuando el despliegue lo necesite, no solo para habilitar todas las funciones.

Antes de configurar

Compruebe la versión instalada.
Exporte una configuración válida.
Compruebe Live/Detect/Record.
Prepare hardware, modelo, puertos o almacenamiento.

Proceso

Active Máscaras primero en una cámara de prueba.
Use la UI para lo básico y YAML para opciones avanzadas.
Valide y aplique.
Revise logs.
Valide con un evento real antes de ampliar.

Verificación

Que la página abra no prueba que la función esté activa. Compruebe entrada, procesamiento y salida.

Diagnóstico

Revierta el último cambio.
Reduzca a una cámara/función/modelo.
Corrija el primer error raíz.
Media: go2rtc/FFmpeg; IA: modelo/labels/shapes/runtime; UI/API: auth/proxy.

Producción

Cambie un bloque cada vez y revise compatibilidad tras actualizar el core.