speyside/alarmclock

镜像概述

speyside/alarmclock是一个提供局域网唤醒（Wake on LAN）和远程关机功能的REST API镜像，旨在方便集成到智能家居语音控制系统中，实现对网络设备的远程控制。

核心功能

• 支持通过REST API发送魔法包唤醒指定MAC地址的设备
• 支持远程关闭Windows设备（需提前配置）
• 集成Vault安全存储设备的用户名和密码
• 基于YAML配置文件管理设备信息

使用场景

• 智能家居语音助手（如Alexa、Google Assistant）集成，通过语音指令唤醒或关闭电脑
• 自动化场景中定时唤醒/关闭设备，节省能源
• 远程管理家庭或办公网络内的设备

配置说明

1. 配置文件（config.yml）

需创建并填写config.yml文件，格式如下：

yaml
broadcast: "<广播地址>"
hosts:
  host1:
    mac: "12:34:56:78:90:AB"
    username: "<用户名>" # 若无需关机功能可省略
    password: "<密码>" # 若无需关机功能可省略
  host2:
    mac: "12:34:56:78:90:CD"
    username: "<用户名>"
    password: "<密码>"

广播地址可通过ipconfig（Windows）或ifconfig（Linux/Mac）获取，通常格式如192.168.1.255。

2. Vault集成（推荐）

为安全存储凭证，建议使用Vault。需设置以下环境变量：

bash
VAULT_ADDR=http(s)://<vault服务器地址>:<端口>
VAULT_TOKEN=<vault访问令牌>

Vault中需在secret/alarmclock路径下存储键值对，格式为<主机名>_username和<主机名>_password，例如：host1_username=myuser、host1_password=mypwd。

3. 运行镜像

需使用主机网络模式运行（因需发送魔法包）：

bash
docker run -d -v <本地config.yml路径>:/config.yml --network="host" speyside/alarmclock:latest

4. Windows关机配置

远程关闭Windows设备需提前配置：

1. 以管理员身份打开PowerShell，执行：

powershell
winrm quickconfig
y
winrm set winrm/config/service/Auth '@{Basic="true"}'
winrm set winrm/config/service '@{AllowUnencrypted="true"}'
winrm set winrm/config/winrs '@{MaxMemoryPerShellMB="1024"}'

2. 确保Windows防火墙运行，并将网络适配器设为私有网络（启用网络发现）。