Saltar al contenido principal

Configuración de SecureVu

Para instalaciones de la aplicación Home Assistant, el archivo de configuración debe estar en /addon_configs/<addon_directory>/config.yml, donde <addon_directory> es específico para la variante de la aplicación SecureVu que estás ejecutando. Consulta la lista de directorios aquí.

Para todos los demás tipos de instalación, el archivo de configuración debe estar mapeado a /config/config.yml dentro del contenedor.

Puede llamarse config.yml o config.yaml, pero si existen ambos archivos se preferirá config.yml y config.yaml será ignorado.

Se recomienda comenzar con una configuración mínima e ir añadiendo según se describe en esta guía y utilizar el editor de configuración integrado en la interfaz de SecureVu, que admite validación.

mqtt:
  enabled: False

cameras:
  dummy_camera: # <--- esto se cambiará por tu cámara real más adelante
    enabled: False
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:554/rtsp
          roles:
            - detect

Acceso al directorio de configuración de la aplicación Home Assistant​

Al ejecutar SecureVu a través de la aplicación HA, el directorio /config de SecureVu se mapea a /addon_configs/<addon_directory> en el host, donde <addon_directory> es específico para la variante de la aplicación SecureVu que estás ejecutando.

Variante de la aplicaciónDirectorio de configuración
SecureVu/addon_configs/ccab4aaf_securevu
SecureVu (Acceso Completo)/addon_configs/ccab4aaf_securevu-fa
SecureVu Beta/addon_configs/ccab4aaf_securevu-beta
SecureVu Beta (Acceso Completo)/addon_configs/ccab4aaf_securevu-fa-beta

Siempre que veas /config en la documentación, hace referencia a este directorio.

Por ejemplo, si estás ejecutando la variante estándar de la aplicación y usas la aplicación VS Code para explorar tus archivos, puedes hacer clic en Archivo > Abrir carpeta... y navegar a /addon_configs/ccab4aaf_securevu para acceder al directorio /config de SecureVu y editar el archivo config.yaml. También puedes usar el editor de archivos integrado en la interfaz de SecureVu para editar el archivo de configuración.

Esquema de Configuración de VS Code​

VS Code admite esquemas JSON para validar automáticamente los archivos de configuración. Puedes habilitar esta función añadiendo # yaml-language-server: $schema=http://securevu_host:5000/api/config/schema.json al inicio del archivo de configuración. Reemplaza securevu_host con la dirección IP o el nombre de host de tu servidor SecureVu. Si usas tanto VS Code como SecureVu como aplicación, debes usar ccab4aaf-securevu en su lugar. Asegúrate de exponer el puerto interno no autenticado 5000 cuando accedas a la configuración desde VS Code en otra máquina.

Sustitución de Variables de Entorno​

SecureVu admite el uso de variables de entorno que comiencen con SECUREVU_ únicamente donde se indique específicamente en la configuración de referencia. Por ejemplo, los siguientes valores pueden ser reemplazados en tiempo de ejecución usando variables de entorno:

mqtt:
  host: "{SECUREVU_MQTT_HOST}"
  user: "{SECUREVU_MQTT_USER}"
  password: "{SECUREVU_MQTT_PASSWORD}"
- path: rtsp://{SECUREVU_RTSP_USER}:{SECUREVU_RTSP_PASSWORD}@10.0.10.10:8554/unicast
onvif:
  host: "192.168.1.12"
  port: 8000
  user: "{SECUREVU_RTSP_USER}"
  password: "{SECUREVU_RTSP_PASSWORD}"
go2rtc:
  rtsp:
    username: "{SECUREVU_GO2RTC_RTSP_USERNAME}"
    password: "{SECUREVU_GO2RTC_RTSP_PASSWORD}"
genai:
  api_key: "{SECUREVU_GENAI_API_KEY}"

Ejemplos de configuración comunes​

A continuación se presentan algunos ejemplos de configuración inicial comunes. Consulta la configuración de referencia para obtener información detallada sobre todos los valores de configuración.

Raspberry Pi con la aplicación Home Assistant y Coral USB​

  • Cámara única con flujo de 720p a 5 fps para detección
  • MQTT conectado a la aplicación Mosquitto de Home Assistant
  • Aceleración por hardware para decodificación de video
  • Detector Coral USB
  • Guardar todo el video con cualquier movimiento detectable durante 7 días independientemente de si se detectaron objetos o no
  • Conservar todo el video que haya calificado como alerta o detección durante 30 días
  • Guardar capturas durante 30 días
  • Máscara de movimiento para la marca de tiempo de la cámara
mqtt:
  host: core-mosquitto
  user: mqtt-user
  password: xxxxxxxxxx

ffmpeg:
  hwaccel_args: preset-rpi-64-h264

detectors:
  coral:
    type: edgetpu
    device: usb

record:
  enabled: True
  motion:
    days: 7
  alerts:
    retain:
      days: 30
      mode: motion
  detections:
    retain:
      days: 30
      mode: motion

snapshots:
  enabled: True
  retain:
    default: 30

cameras:
  name_of_your_camera:
    detect:
      width: 1280
      height: 720
      fps: 5
    ffmpeg:
      inputs:
        - path: rtsp://10.0.10.10:554/rtsp
          roles:
            - detect
    motion:
      mask:
        - 0.000,0.427,0.002,0.000,0.999,0.000,0.999,0.781,0.885,0.456,0.700,0.424,0.701,0.311,0.507,0.294,0.453,0.347,0.451,0.400

Mini PC Intel independiente con Coral USB​

  • Cámara única con flujo de 720p a 5 fps para detección
  • MQTT deshabilitado (no integrado con Home Assistant)
  • Aceleración por hardware VAAPI para decodificación de video
  • Detector Coral USB
  • Guardar todo el video con cualquier movimiento detectable durante 7 días independientemente de si se detectaron objetos o no
  • Conservar todo el video que haya calificado como alerta o detección durante 30 días
  • Guardar capturas durante 30 días
  • Máscara de movimiento para la marca de tiempo de la cámara
mqtt:
  enabled: False

ffmpeg:
  hwaccel_args: preset-vaapi

detectors:
  coral:
    type: edgetpu
    device: usb

record:
  enabled: True
  motion:
    days: 7
  alerts:
    retain:
      days: 30
      mode: motion
  detections:
    retain:
      days: 30
      mode: motion

snapshots:
  enabled: True
  retain:
    default: 30

cameras:
  name_of_your_camera:
    detect:
      width: 1280
      height: 720
      fps: 5
    ffmpeg:
      inputs:
        - path: rtsp://10.0.10.10:554/rtsp
          roles:
            - detect
    motion:
      mask:
        - 0.000,0.427,0.002,0.000,0.999,0.000,0.999,0.781,0.885,0.456,0.700,0.424,0.701,0.311,0.507,0.294,0.453,0.347,0.451,0.400

Mini PC Intel integrado con Home Assistant y OpenVino​

  • Cámara única con flujo de 720p a 5 fps para detección
  • MQTT conectado al mismo servidor MQTT que Home Assistant
  • Aceleración por hardware VAAPI para decodificación de video
  • Detector OpenVino
  • Guardar todo el video con cualquier movimiento detectable durante 7 días independientemente de si se detectaron objetos o no
  • Conservar todo el video que haya calificado como alerta o detección durante 30 días
  • Guardar capturas durante 30 días
  • Máscara de movimiento para la marca de tiempo de la cámara
mqtt:
  host: 192.168.X.X # <---- mismo broker MQTT que usa Home Assistant
  user: mqtt-user
  password: xxxxxxxxxx

ffmpeg:
  hwaccel_args: preset-vaapi

detectors:
  ov:
    type: openvino
    device: AUTO

model:
  width: 300
  height: 300
  input_tensor: nhwc
  input_pixel_format: bgr
  path: /openvino-model/ssdlite_mobilenet_v2.xml
  labelmap_path: /openvino-model/coco_91cl_bkgr.txt

record:
  enabled: True
  motion:
    days: 7
  alerts:
    retain:
      days: 30
      mode: motion
  detections:
    retain:
      days: 30
      mode: motion

snapshots:
  enabled: True
  retain:
    default: 30

cameras:
  name_of_your_camera:
    detect:
      width: 1280
      height: 720
      fps: 5
    ffmpeg:
      inputs:
        - path: rtsp://10.0.10.10:554/rtsp
          roles:
            - detect
    motion:
      mask:
        - 0.000,0.427,0.002,0.000,0.999,0.000,0.999,0.781,0.885,0.456,0.700,0.424,0.701,0.311,0.507,0.294,0.453,0.347,0.451,0.400