dirigera-control

🏠 IKEA智能家居本地控制中心

基于官方dirigera库控制IKEA智能家居设备,支持灯光、插座、场景管理,需物理按钮确认Token生成,适合本地局域网自动化控制。

收藏
20.6k
安装
4.3k
版本
v1.0.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Dirigera Control 是一款面向 IKEA 智能家居生态的自动化控制技能,通过 Python 的 dirigera 库与 Dirigera Hub 进行本地网络通信。用户可完成设备发现(灯光、插座、控制器、场景)、状态查询、开关控制、亮度/色温调节、场景触发等操作。Token 生成采用物理按钮确认机制,确保授权安全。

显著优点

1. 本地化控制:所有通信均在本地局域网完成,无云端依赖,响应速度快且隐私性强。
2. 物理安全确认:Token 生成必须用户亲自按压 Hub 底部按钮,杜绝远程未授权访问。

3. 完善的输入验证:IP 地址、子网、端口均有严格校验,防止配置错误导致的安全问题。

4. 清晰的设备抽象:通过 .attributes 统一访问设备状态,配合 is_reachable 检查避免操作不可达设备。

5. 丰富的辅助工具:提供 IP 自动发现、Token 生成包装器、电池监控等实用脚本。

潜在缺点与局限性

1. 网络限制:依赖本地局域网,跨网络控制需额外配置 Cloudflare Tunnel 等反向代理。
2. T3 来源风险:作者为个人开发者,虽代码已审计,但长期维护与更新存在不确定性。

3. HTTPS 自签名证书:Token 生成时强制 verify=False,虽为必要配置,但理论上存在中间人攻击风险(需配合物理按钮确认缓解)。

4. 设备生态封闭:仅支持 IKEA Dirigera 生态,无法直接控制其他品牌 Zigbee 设备。

5. 并发性能:建议命令间隔 0.5 秒,高频批量操作可能受限。

适合的目标群体

  • IKEA 智能家居用户,希望通过 AI 助手实现语音/自动化控制
  • 家庭自动化爱好者,需要批量管理灯光、插座、场景
  • 开发者构建本地智能家居中控系统
  • 注重隐私、偏好本地控制而非云端方案的用户

使用风险

  • Token 泄露风险:保存的 Token 文件需妥善保管,避免未授权访问
  • 网络隔离失效:若 Hub 暴露至公网,可能遭受扫描攻击(建议严格限制内网访问)
  • 依赖维护dirigera 库为社区维护,IKEA 官方 API 变更可能导致兼容性问题
  • 子进程调用:IP 发现脚本执行 arp -agenerate-token,虽为硬编码命令,但在受限环境中可能受限

dirigera-control 内容

references文件夹
scripts文件夹
手动下载zip · 14.5 kB
api.mdtext/markdown
请选择文件