热门搜索:
cronuxs/elgato2mqtt
cronuxs
elgato2mqtt镜像提供Elgato灯光设备与MQTT端点之间的接口，实现两者间的数据通信与控制。
下载次数: 0状态：社区镜像维护者：cronuxs仓库类型：镜像最近更新：4 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
elgato2mqtt Docker镜像文档
镜像概述
elgato2mqtt是一个轻量级工具，旨在建立Elgato灯光设备与MQTT协议端点之间的通信桥梁。通过该镜像，用户可实现Elgato灯光设备状态（如亮度、色温、开关状态）与MQTT消息系统的双向同步，便于集成到智能家居、自动化系统或自定义监控平台中。
核心功能与特性
- 双向数据通信：支持Elgato灯光设备状态（亮度、色温、开关）实时发布至MQTT主题，同时接收MQTT指令控制设备
- 设备自动发现：可自动检测网络中的Elgato灯光设备（如Key Light、Key Light Air等）
- MQTT协议兼容：支持标准MQTT v3.1.1协议，兼容主流MQTT broker（如Mosquitto、EMQX、HiveMQ等）
- 配置灵活：通过环境变量或配置文件自定义MQTT连接参数、设备发现规则及状态更新频率
使用场景
- 智能家居集成：与Home Assistant、OpenHAB等智能家居平台联动，通过MQTT控制Elgato灯光
- 自动化脚本：结合定时任务或事件触发（如日出/日落、系统状态变化），通过MQTT消息自动调节灯光
- 远程监控与控制：通过MQTT协议实现对Elgato灯光设备的远程状态监控和控制
- 多设备统一管理：集中管理多个Elgato灯光设备，通过MQTT主题区分设备状态与控制指令
使用方法与配置说明
基本使用（Docker Run）
bashdocker run -d \ --name elgato2mqtt \ -e MQTT_BROKER=mqtt://your-mqtt-broker:1883 \ -e MQTT_USER=your-mqtt-username \ -e MQTT_PASSWORD=your-mqtt-password \ -e ELGATO_DISCOVERY=true \ -e UPDATE_INTERVAL=5 \ --network host \ ghcr.io/username/elgato2mqtt:latest
Docker Compose配置
yamlversion: '3' services: elgato2mqtt: image: ghcr.io/username/elgato2mqtt:latest container_name: elgato2mqtt environment: - MQTT_BROKER=mqtt://mqtt-broker:1883 - MQTT_USER=mqtt-user - MQTT_PASSWORD=mqtt-pass - ELGATO_DISCOVERY=true - ELGATO_DEVICES=192.168.1.100,192.168.1.101 # 可选，指定固定设备IP，覆盖自动发现 - UPDATE_INTERVAL=5 # 状态更新间隔（秒） - MQTT_TOPIC_PREFIX=elgato # MQTT主题前缀，默认"elgato" network_mode: host # 需使用host网络以支持设备发现 restart: unless-stopped
环境变量配置说明
| 环境变量 | 描述 | 可选值 | 默认值 |
|---|---|---|---|
| MQTT_BROKER | MQTT broker地址（含协议） | 如mqtt://、mqtts:// | 无（必填） |
| MQTT_PORT | MQTT broker端口 | 1883（非加密）、8883（加密）等 | 1883 |
| MQTT_USER | MQTT连接用户名 | 字符串 | 无（如broker无需认证可省略） |
| MQTT_PASSWORD | MQTT连接密码 | 字符串 | 无（如broker无需认证可省略） |
| ELGATO_DISCOVERY | 是否启用设备自动发现 | true/false | true |
| ELGATO_DEVICES | 固定设备IP列表（逗号分隔），启用时覆盖自动发现 | IP地址列表 | 无 |
| UPDATE_INTERVAL | 设备状态更新间隔（秒） | 正整数 | 5 |
| MQTT_TOPIC_PREFIX | MQTT主题前缀 | 字符串 | "elgato" |
| LOG_LEVEL | 日志级别 | debug/info/warn/error | info |
MQTT主题说明
状态发布主题（设备→MQTT）
- 设备状态：
{MQTT_TOPIC_PREFIX}/{device_name}/state
示例：elgato/key_light_1/state
payload格式：{"on": true, "brightness": 80, "temperature": 4500}
控制指令主题（MQTT→设备）
- 开关控制：
{MQTT_TOPIC_PREFIX}/{device_name}/command/on
payload：true（开）/false（关） - 亮度控制：
{MQTT_TOPIC_PREFIX}/{device_name}/command/brightness
payload：0-100（整数） - 色温控制：
{MQTT_TOPIC_PREFIX}/{device_name}/command/temperature
payload：2900-7000（整数，单位K）
注意事项
- 设备发现需使用host网络模式（
--network host），否则可能无法检测到Elgato设备 - 确保Elgato灯光设备与容器在同一网络，且设备已开启网络连接
- MQTT broker需支持MQTT v3.1.1协议，且网络可达
- 若使用固定设备IP（ELGATO_DEVICES），需确保IP地址正确且设备在线
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 elgato2mqtt 镜像标签
docker pull docker.xuanyuan.run/cronuxs/elgato2mqtt:<标签>
DockerHub 原生拉取命令
docker pull cronuxs/elgato2mqtt:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"