jasonxh/arlo-mqtt

arlo-mqtt

镜像概述

arlo-mqtt是一个简单的Arlo与MQTT桥接工具，用于实现Arlo设备与MQTT协议的集成。该工具遵循https://homieiot.github.io/specification/spec-core-v4_0_0/%E8%A7%84%E8%8C%83%E6%9A%B4%E9%9C%B2%E8%AE%BE%E5%A4%87%E4%BF%A1%E6%81%AF%EF%BC%8C%E5%9F%BA%E4%BA%8Ehttps://github.com/twrecked/pyaarlo%E7%9A%84Arlo Python模块和https://github.com/mjcumming/homie4%E7%9A%84Homie4 Python模块开发。

核心功能和特性

• 实现Arlo设备与MQTT协议的双向桥接
• 遵循Homie v4.0.0规范组织MQTT主题结构
• 支持通过命令行参数或环境变量配置
• 提供调试日志功能
• 支持Arlo 2FA等高级配置（通过JSON格式的额外选项）

使用场景和适用范围

适用于需要将Arlo智能设备（如摄像头、传感器等）集成到基于MQTT的智能家居系统（如Home Assistant、OpenHAB等）的用户，实现设备状态监控和控制的统一管理。

使用方法和配置说明

命令行参数

usage: arlo-mqtt [-h] [-d] [--arlo-user ARLO_USER] [--arlo-pass ARLO_PASS] [--arlo-extras-json ARLO_EXTRAS_JSON]
                 [--broker BROKER] [--port PORT] [--mqtt-user MQTT_USER] [--mqtt-pass MQTT_PASS]

A simple bridge between Arlo and MQTT.

optional arguments:
  -h, --help            显示帮助信息并退出
  -d, --debug           启用调试日志

Arlo:
  --arlo-user ARLO_USER   Arlo用户名，也可通过环境变量ARLO_USER设置
  --arlo-pass ARLO_PASS   Arlo密码，也可通过环境变量ARLO_PASS设置
  --arlo-extras-json ARLO_EXTRAS_JSON   Pyaarlo额外选项（JSON格式），例如2FA配置，也可通过环境变量ARLO_EXTRAS_JSON设置

MQTT:
  --broker BROKER       MQTT broker地址，默认为localhost
  --port PORT           MQTT broker端口，默认为1883
  --mqtt-user MQTT_USER MQTT用户名，也可通过环境变量ARLO_MQTT_USER设置
  --mqtt-pass MQTT_PASS MQTT密码，也可通过环境变量ARLO_MQTT_PASS设置

Docker部署示例

bash
docker run --rm -it docker.xuanyuan.run/jasonxh/arlo-mqtt \
  --arlo-user "your_arlo_username" \
  --arlo-pass "your_arlo_password" \
  --broker "mqtt_broker_address" \
  --mqtt-user "mqtt_username" \
  --mqtt-pass "mqtt_password"

或使用环境变量配置：

bash
docker run --rm -it \
  -e ARLO_USER="your_arlo_username" \
  -e ARLO_PASS="your_arlo_password" \
  -e BROKER="mqtt_broker_address" \
  -e ARLO_MQTT_USER="mqtt_username" \
  -e ARLO_MQTT_PASS="mqtt_password" \
  docker.xuanyuan.run/jasonxh/arlo-mqtt

MQTT主题结构

TODO（待补充）