dirigera-control

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

🥥5总安装量 1评分人数 1
100% 的用户推荐

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

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 无危险函数(eval/exec/system),代码执行路径安全可控
  • ✅ Token 生成强制物理按钮确认,有效防止未授权访问
  • ✅ 所有通信限于本地网络,无云端数据上传或静默收集
  • ⚠️ Token 生成使用 `verify=False` 绕过自签名证书验证(Dirigera Hub 必要配置)
  • ⚠️ IP 发现脚本使用 subprocess 执行硬编码系统命令(无注入风险但依赖系统环境)

使用说明

核心用法

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
请选择文件