lmerza/frigate_plate_recognizer

Frigate Plate Recognizer

概述

Frigate Plate Recognizer是一个用于通过Plate Recognizer识别车牌，并将车牌作为子标签添加到Frigate的工具。它能够与Frigate集成，通过Plate Recognizer API识别车辆牌照，并将结果通过MQTT传递给Frigate，实现车牌信息与车辆对象的关联。

核心功能

• Frigate集成：通过MQTT协议与Frigate通信，将识别到的车牌作为子标签添加到车辆对象
• 车牌识别：利用Plate Recognizer API进行车牌识别，支持配置识别区域和最小置信度阈值
• 多摄像头支持：可同时配置多个Frigate摄像头进行车牌识别
• 灵活配置：支持MQTT认证、自定义日志级别、本地部署的Plate Recognizer API地址
• 免费额度：Plate Recognizer提供每月2500次免费查询额度

使用场景

适用于已部署Frigate监控系统，并需要对特定摄像头（如 driveway 摄像头、停车场摄像头）中的车辆进行车牌识别的场景。需确保Frigate已启用对应摄像头的车辆检测功能。

配置说明

配置文件（config.yml）

需在Docker卷中创建config.yml文件，配置内容如下：

yml
frigate:
  frigate_url: http://127.0.0.1:5000  # Frigate服务URL
  mqtt_server: 127.0.0.1              # MQTT服务器地址
  mqtt_auth: false                    # 是否启用MQTT认证
  mqtt_username: username             # MQTT用户名（启用认证时必填）
  mqtt_password: password             # MQTT密码（启用认证时必填）
  main_topic: frigate                 # Frigate主MQTT主题
  camera:                             # 需启用车牌识别的Frigate摄像头名称列表
    - driveway_camera
  min_score: .8                       # 车牌识别最小置信度阈值（0-1）
plate_recognizer:
  token: xxxxxxxxxx                   # Plate Recognizer API密钥
  regions:                            # 车牌识别区域（如us-ca表示美国加州）
    - us-ca
  api_url: http://HOST-IP:8080/v1/plate-reader  # 可选，自定义Plate Recognizer API地址
logger_level: INFO                    # 日志级别（INFO/DEBUG）

配置参数说明

• frigate：Frigate相关配置

  • frigate_url：Frigate服务的URL地址
  • mqtt_server：MQTT服务器地址
  • mqtt_auth：是否启用MQTT认证（true/false）
  • mqtt_username/mqtt_password：MQTT认证的用户名和密码（mqtt_auth为true时必填）
  • main_topic：Frigate的主MQTT主题
  • camera：需要启用车牌识别的摄像头名称列表（需与Frigate配置中的摄像头名称一致）
  • min_score：车牌识别结果的最小置信度阈值（默认0.8）

• plate_recognizer：Plate Recognizer相关配置

  • token：Plate Recognizer API密钥（必填）
  • regions：车牌识别区域（如us-ca、fr等，可指定多个）
  • api_url：可选，自定义Plate Recognizer API地址（用于本地部署的API）

• logger_level：日志级别，可选INFO（默认）或DEBUG

获取Plate Recognizer API密钥

1. 访问Plate Recognizer注册页面创建免费账号
2. 登录后获取API密钥（每月可免费使用2500次识别请求）
3. 确保Frigate中已为目标摄像头启用车辆检测功能

部署方法

Docker Run

bash
docker run -v /path/to/config:/config -e TZ=America/New_York -it --rm --name frigate_plate_recognizer lmerza/frigate_plate_recognizer:latest

• -v /path/to/config:/config：挂载本地配置目录到容器内的/config目录（需包含config.yml）
• -e TZ=America/New_York：设置时区
• --name frigate_plate_recognizer：容器名称

Docker Compose

yaml
services:
  frigate_plate_recognizer:
    image: lmerza/frigate_plate_recognizer:latest
    container_name: frigate_plate_recognizer
    volumes:
      - /path/to/config:/config  # 挂载配置目录
    restart: unless-stopped      # 除非手动停止，否则自动重启
    environment:
      - TZ=America/New_York      # 设置时区

调试

• 修改配置文件中的logger_level为DEBUG以启用详细日志：

  yaml
  logger_level: DEBUG
  

• 日志文件路径：/config/frigate_plate_recognizer.log（位于挂载的配置目录中）

相关链接

• https://github.com/ljmerza/frigate_plate_recognizer
• Plate Recognizer文档
• https://github.com/blakeblackshear/frigate