nekmo/amazon-dash

nekmo/amazon-dash 镜像说明

镜像概述

本镜像基于Python实现，可让您的Amazon Dash按钮执行自定义操作（如运行命令、调用API、控制智能家居等），无需专业编程知识。适用于树莓派、低配置电脑等设备，支持守护进程模式运行。

核心功能

• 执行系统命令：按下按钮时运行指定命令（支持本地或SSH远程执行）。
• 调用Webhook：发送HTTP请求触发Web服务（支持POST/GET方法、JSON参数）。
• 智能家居集成：与HomeAssistant、OpenHAB联动，触发设备状态变更。
• IFTTT联动：通过IFTTT API触发第三方服务（如发送通知、更新表格）。
• 确认消息：支持***/Pushbullet发送操作成功/失败通知。

使用场景

• 智能家居控制：一键开关灯光、调节温度。
• 快捷操作：启动音乐播放器、发送消息、更新购物清单。
• 自动化工作流：触发数据同步、备份任务或API调用。

配置说明

1. 发现Dash按钮MAC地址

运行镜像进入发现模式，按下按钮获取MAC：

bash
docker run -it --network=host nekmo/amazon-dash:latest amazon-dash discovery

2. 编辑配置文件

创建amazon-dash.yml配置文件（示例）：

yaml
settings:
  delay: 10  # 按钮重复触发间隔（秒）
devices:
  0C:47:C9:98:4A:12:  # 按钮MAC地址
    name: 音乐按钮
    cmd: spotify  # 本地执行命令
  AC:63:BE:67:B2:F1:
    name: 灯光控制
    url: http://your-homeassistant.com/api/services/light/toggle
    method: post
    headers: {"Authorization": "Bearer YOUR_TOKEN"}
    body: '{"entity_id": "light.kitchen"}'
confirmations:
  send-tg:
    service: telegram
    token: "YOUR_TELEGRAM_BOT_TOKEN"
    to: YOUR_CHAT_ID

3. 运行Docker容器

bash
docker run -d --network=host \
  -v /path/to/your/amazon-dash.yml:/config/amazon-dash.yml \
  nekmo/amazon-dash:latest \
  amazon-dash run --ignore-perms --root-allowed --config /config/amazon-dash.yml

注意事项

• 避免误购：配置按钮时跳过Amazon官方的商品关联步骤（仅完成网络连接）。
• 网络权限：需使用--network=host模式以捕获Dash按钮的网络请求。
• 配置更新：修改amazon-dash.yml后需重启容器生效。