# Как настроить ИИ-видеонаблюдение без ложных тревог: зоны, пороги уверенности и проверка уведомлений

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-nastroit-ii-videonablyudenie-bez-lozhnyh-trevog-zon.html

## TL;DR
- Время выполнения: 45–60 минут на настройку + 24 часа на проверку уведомлений
- Уровень сложности: Intermediate
- Понадобится: Linux-сервер с Docker Engine и Compose v2; IP-камера с RTSP; Frigate (открытый NVR — сервер видеонаблюдения с ИИ-детекцией объектов); MQTT-брокер Mosquitto; Telegram-бот или Home Assistant; 20 ГБ свободного места

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/kak-nastroit-ii-videonablyudenie-bez-lozhnyh-trevog-zon-ru-1.jpg?v=1795164931)

- Linux-сервер или мини-ПК с Docker Engine и плагином Compose v2. Конкретные поддерживаемые версии сверьте с документацией Frigate.
- IP-камера с включённым RTSP (Real Time Streaming Protocol — протокол потокового видео). Узнайте точный URL потока в веб-интерфейсе камеры.
- MQTT-брокер (Mosquitto) — сервер сообщений, через который Frigate публикует события. Адрес, логин и пароль подготовьте заранее.
- Свободные порты: `5000` — веб-интерфейс Frigate, `1883` — MQTT, `554` — RTSP камеры.
- Права на создание каталогов и запуск контейнеров (пользователь в группе `docker`).

Проверьте, что камера отдаёт поток. Подставьте свои логин, пароль и IP:
```bash
ffprobe -v error -rtsp_transport tcp \
 -i "rtsp://<user>:<pass>@192.168.1.50:554/Streaming/Channels/101" \
 -show_entries stream=codec_name,width,height -of default=nw=1
```
**Пример ожидаемого вывода:**
```
codec_name=h264
width=1280
height=720
```
Если вывод пустой или появилась ошибка — сначала исправьте RTSP, до Frigate идти нет смысла.

Создайте рабочий каталог:
```bash
mkdir -p ~/frigate/config ~/frigate/media
cd ~/frigate
```
Почему это работает: Frigate читает `config/config.yml` и складывает записи в `media`; отдельные каталоги упрощают и диагностику.

Чек-лист готовности:
- [ ] `ffprobe` показывает кодек и разрешение камеры
- [ ] MQTT-брокер доступен: `mosquitto_pub -h 192.168.1.10 -t test -m ok`
- [ ] Свободно не менее 20 ГБ: `df -h ~/frigate`
- [ ] Порты `5000` и `1883` не заняты: `ss -ltnp | grep -E '5000|1883'`

## Шаг 1. Поднимите Frigate и подключите камеру
**Что сделать:** создайте `docker-compose.yml` и минимальный `config.yml`, затем запустите контейнер.

**Зачем:** без базового потока детекция не запустится, а зоны и пороги настраивать не на чем.

`docker-compose.yml`:
```yaml
services:
 frigate:
 image: ghcr.io/blakeblackshear/frigate:stable
 container_name: frigate
 restart: unless-stopped
 shm_size: "128mb"
 ports:
 - "5000:5000"
 volumes:
 - ./config:/config
 - ./media:/media/frigate
 environment:
 - TZ=Europe/Moscow
```
Тег `stable` — плавающий; конкретную версию и требования к `shm_size` сверьте с документацией.

`config/config.yml`:
```yaml
mqtt:
 host: 192.168.1.10
 port: 1883
 user: frigate
 password: "<mqtt-пароль>"

detectors:
 cpu1:
 type: cpu

cameras:
 front_door:
 ffmpeg:
 inputs:
 - path: rtsp://<user>:<pass>@192.168.1.50:554/Streaming/Channels/101
 roles:
 - detect
 detect:
 width: 1280
 height: 720
 fps: 5
```
`front_door` — имя камеры, оно попадёт в события и уведомления. `fps: 5` снижает нагрузку: для детекции объектов обычно достаточно 5 кадров в секунду.

Запуск:
```bash
docker compose up -d
docker compose logs -f frigate
```
**Как проверить:** в логах появится строка вида `Camera processor started for front_door`, а по адресу `http://192.168.1.20:5000` откроется веб-интерфейс с живым потоком. Точные формулировки логов зависят от версии — сверьтесь с документацией.

## Шаг 2. Настройте зоны и пороги уверенности
![Иллюстрация к разделу «Шаг 2. Настройте зоны и пороги уверенности»](https://ai-release.org/guides/img/kak-nastroit-ii-videonablyudenie-bez-lozhnyh-trevog-zon-ru-2.jpg?v=1795164936)

**Что сделать:** ограничьте детекцию зоной и задайте пороги `threshold`, `min_score`, `min_area`.

**Зачем:** `score` — уверенность модели от 0 до 1. `threshold` — минимум, чтобы объект начали отслеживать; `min_score` — минимум, чтобы продолжать отслеживать; `min_area` — минимальная площадь объекта в пикселях, отсекает мелкие блики. Зона отсекает события в ненужной части кадра: тротуар, соседний участок, качающиеся ветки.

```yaml
 objects:
 track:
 - person
 - car
 filters:
 person:
 min_area: 2000
 min_score: 0.60
 threshold: 0.70
 car:
 min_area: 5000
 min_score: 0.65
 threshold: 0.75
 zones:
 driveway:
 coordinates: 0.08,0.45,0.62,0.45,0.62,0.95,0.08,0.95
 objects:
 - person
 - car
```
Координаты зоны нормализованы: `0,0` — левый верхний угол кадра, `1,1` — правый нижний. Удобнее взять их в редакторе зон веб-интерфейса; расположение кнопки сверьте с документацией вашей версии.

**Пример:** камера смотрит на двор и дорогу. Зона `driveway` покрывает только двор. Человек на дороге получает `score: 0.82`, но в событии будет `"current_zones": []` — уведомление по такому событию не отправляем.

| Параметр | Что делает | Слишком низко | Слишком высоко |
|---|---|---|---|
| `threshold` | старт отслеживания | тени и кусты становятся «person» | пропуск реальных людей |
| `min_score` | продолжение отслеживания | событие долго не закрывается | объект теряется на полпути |
| `min_area` | минимальная площадь | ловит блики и насекомых | не видит человека вдали |
| `zones` | область интереса | уведомления из всей сцены | пропуск событий у границы зоны |

**Как проверить:** подпишитесь на события и пройдите по зоне:
```bash
mosquitto_sub -h 192.168.1.10 -t 'frigate/events' -v
```
**Пример ожидаемого фрагмента:**
```json
{"after":{"camera":"front_door","label":"person","score":0.82,"current_zones":["driveway"]}}
```
Если `current_zones` пуст — координаты зоны не совпадают с реальным положением, перерисуйте полигон.

Детекция выполняется локально на вашем сервере. Если сравниваете локальную и облачную обработку, логика выбора описана в гайде [Локальная модель или облако на iPhone: как настроить гибридный роутинг ИИ-запросов](https://ai-release.org/guides/lokalnaya-model-ili-oblako-na-iphone-kak-nastroit-gibri.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

## Шаг 3. Проверьте уведомления и отфильтруйте ложные события
![Иллюстрация к разделу «Шаг 3. Проверьте уведомления и отфильтруйте ложные события»](https://ai-release.org/guides/img/kak-nastroit-ii-videonablyudenie-bez-lozhnyh-trevog-zon-ru-3.jpg?v=1795164944)

**Что сделать:** соберите уведомления из MQTT, оставляя только события типа `new`, нужного класса и нужной зоны.

**Зачем:** одно событие публикуется несколько раз (`new`, `update`, `end`). Без фильтра вы получите несколько сообщений на один проход человека.

```bash
mosquitto_sub -h 192.168.1.10 -t 'frigate/events' -v | while read -r line; do
 payload="${line#* }"
 type=$(echo "$payload" | jq -r '.type')
 label=$(echo "$payload" | jq -r '.after.label')
 zones=$(echo "$payload" | jq -r '.after.current_zones | join(",")')
 score=$(echo "$payload" | jq -r '.after.score')

 if [ "$type" = "new" ] && [ "$label" = "person" ] && \
 echo "$zones" | grep -q "driveway" && \
 awk "BEGIN{exit !($score >= 0.70)}"; then
 curl -s -X POST "https://api.telegram.org/bot<TOKEN>/sendMessage" \
 -d chat_id="<CHAT_ID>" \
 -d text="person в driveway, score=$score"
 fi
done
```
`<TOKEN>` — токен бота от BotFather, `<CHAT_ID>` — идентификатор чата. Почему это работает: `jq` разбирает JSON, условия отсекают события вне зоны и с низкой уверенностью, `curl` отправляет сообщение в Telegram.

**Как проверить:** запустите скрипт, пройдите через зону и убедитесь, что пришло ровно одно сообщение. Затем запустите контрольный прогон на 24 часа:
- [ ] Ни одного уведомления о человеке вне зоны `driveway`
- [ ] Каждое уведомление содержит `score` не ниже `0.70`
- [ ] На один реальный проход — одно сообщение
- [ ] Ложные события от теней и растений не проходят фильтр
- [ ] После перезапуска контейнера подписка снова активна

Для дежурства и мониторинга канала уведомлений удобно использовать подход из гайда [Как настроить мониторинг VPS через Telegram-бота с Mini App](https://ai-release.org/guides/kak-nastroit-monitoring-vps-cherez-telegram-bota-s-mini.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

## Возможные проблемы и решения

**Проблема. Контейнер перезапускается, веб-интерфейс не открывается**
- Ошибка: `while parsing a block mapping ... did not find expected key`
- Причина: нарушен отступ в YAML. В YAML вложенность задаётся пробелами, табуляция запрещена.
- Решение: проверьте отступы и запустите валидацию:
```bash
docker compose exec frigate python -m frigate --validate-config
```
Если команда недоступна в вашей версии — сверьтесь с документацией. После исправления: `docker compose restart frigate`.

**Проблема. Камера есть в конфиге, но поток чёрный**
- Ошибка: `Unable to open input rtsp://192.168.1.50:554/...`
- Причина: неверный путь RTSP, истёкший пароль или камера не принимает TCP-транспорт.
- Решение: проверьте поток тем же `ffprobe` с флагом `-rtsp_transport tcp`. Если `ffprobe` работает, а Frigate нет — проверьте, что логин и пароль в `path` не содержат незаэкранированных символов `@`, `:`, `/`.

**Проблема. Frigate запущен, но события в MQTT не приходят**
- Ошибка: `ConnectionRefusedError: [Errno 111] Connection refused`
- Причина: неверный адрес или порт брокера, либо MQTT-брокер не запущен.
- Решение: проверьте доступность и подписку вручную:
```bash
mosquitto_pub -h 192.168.1.10 -p 1883 -u frigate -P '<mqtt-пароль>' -t test -m ok
mosquitto_sub -h 192.168.1.10 -p 1883 -u frigate -P '<mqtt-пароль>' -t 'frigate/#' -v
```
Если `mosquitto_pub` не подключается — исправьте брокер или учётные данные в `config.yml`.

## Резюме и следующие шаги
Вы подняли Frigate, ограничили детекцию зоной и настроили пороги, а уведомления проверили на реальном проходе и 24-часовом прогоне. Дальше добавьте вторую камеру с отдельной зоной и вынесите отправку уведомлений в Home Assistant, чтобы хранить историю событий.

## FAQ
**Почему камера не подключается к Frigate по RTSP?**
Чаще всего неверен путь потока или транспорт. Проверьте URL через `ffprobe -rtsp_transport tcp`; если там ошибка, Frigate тоже не подключится.

**Какое значение threshold ставить для человека?**
Начните с `0.70` и `min_score: 0.60`. Если идут ложные срабатывания — повышайте шагом `0.05`, если пропускаются люди — понижайте.

**Как убрать ложные срабатывания на тени и растения?**
Ограничьте область зоной `driveway`, поднимите `min_area` и `threshold`, а уведомления фильтруйте по `current_zones`. Одного порога обычно недостаточно.

**Можно ли отправлять уведомления в Telegram без Home Assistant?**
Да, через `mosquitto_sub` и `curl` к Telegram Bot API, как в Шаге 3. Home Assistant нужен, если требуется история, несколько каналов и сложные условия.
