anjia0532/wakeonlan

wakeup工具镜像

镜像概述

本镜像基于mpolden/wakeup项目构建，提供HTTP API和JavaScript前端界面，用于发送Wake-on-LAN（局域网唤醒）消息，支持设备唤醒、历史设备管理，还包含wakeupbr工具实现跨网络段的唤醒包转发。

核心功能

1. HTTP API操作：通过API实现设备唤醒、历史唤醒设备列表查询、设备删除。
2. 前端界面：内置基础前端页面，可通过指定静态资源目录启用。
3. 跨网段桥接：使用wakeupbr工具转发不同网络接口的唤醒包，解决跨网段唤醒问题。

使用场景

• 家庭网络：远程唤醒NAS、电脑等设备。
• 企业网络：跨部门网段唤醒服务器或办公设备。
• 个人开发：快速搭建局域网唤醒服务，简化设备管理流程。

配置说明

wakeup工具参数

wakeup [OPTIONS]
Application Options:
  -c, --cache=FILE     缓存文件路径（存储历史唤醒设备）
  -b, --bind=IP        发送WOL包时绑定的IP地址
  -l, --listen=ADDR    监听地址（默认：:8080）
  -s, --static=DIR     静态资源目录路径（用于前端界面）
Help Options:
  -h, --help           显示帮助信息

wakeupbr工具参数

wakeupbr [OPTIONS]
Application Options:
  -l, --listen=IP     监听WOL包的地址（默认：0.0.0.0:9）
  -o, --forward=IP    转发WOL包的目标接口地址
Help Options:
  -h, --help          显示帮助信息

API示例

1. 唤醒设备：

bash
curl -XPOST -d '{"macAddress":"AB:CD:EF:12:34:56"}' http://localhost:8080/api/v1/wake

带设备名称：

bash
curl -XPOST -d '{"name":"我的NAS","macAddress":"AB:CD:EF:12:34:56"}' http://localhost:8080/api/v1/wake

2. 查询历史设备：

bash
curl -s http://localhost:8080/api/v1/wake | jq .

3. 删除设备：

bash
curl -XDELETE -d '{"macAddress":"AB:CD:EF:12:34:56"}' http://localhost:8080/api/v1/wake

前端界面启用

通过-s参数指定静态资源目录，例如：

bash
wakeup -s ./static

桥接示例

假设设备有无线接口（wlan0，地址10.0.0.10）和有线接口（eth0，地址172.16.0.10），需将无线网段的唤醒包转发到有线网段：

bash
wakeupbr -l 10.0.0.10 -o 172.16.0.10

若避免使用特权端口9，可通过iptables重定向：

bash
# 重定向UDP 9端口到9000
iptables -t nat -A PREROUTING -i wlan0 -p udp --dport 9 -j REDIRECT --to-port 9000
# 允许9000端口输入
iptables -A INPUT -p udp --dport 9000 -j ACCEPT
# 运行wakeupbr监听9000端口
wakeupbr -l 10.0.0.10:9000 -o 172.16.0.10

Docker部署示例

1. 基础运行：

bash
docker run -d -p 8080:8080 anjia0532/wakeonlan

2. 启用前端界面：

bash
# 假设本地static目录存在前端资源
docker run -d -p 8080:8080 -v $(pwd)/static:/app/static anjia0532/wakeonlan wakeup -s /app/static

3. 运行桥接工具：

bash
docker run --network host anjia0532/wakeonlan wakeupbr -l 10.0.0.10:9000 -o 172.16.0.10

（注：桥接工具需访问网络接口，建议使用--network host模式）