aecampos/wakeupbr

wakeupbr-docker

https://img.shields.io/docker/cloud/build/aecampos/wakeupbr.svg?label=build](https://hub.docker.com/r/aecampos/wakeupbr)

这是 https://github.com/mpolden/wakeup#bridge 的容器化版本，作为Wake-on-LAN（WOL）数据包的桥接工具。程序会在入站接口监听WOL数据包，并将收到的数据包转发到出站接口，适用于允许其他容器在不使用host网络模式的情况下发送WOL数据包。

快速开始

启动 wakeupbr：

docker run --net=host --name wakeupbr aecampos/wakeupbr -o <接口地址>

例如：

docker run --net=host --name wakeupbr aecampos/wakeupbr -o 192.168.1.255

也可以指定其他命令行参数（如 -h、-l）。

注意：通常需要 --net=host 才能让魔法包（WOL数据包）到达局域网。

Docker Compose

以下是使用 docker-compose 运行wakeupbr的示例，监听 0.0.0.0:9（默认，所有接口）并将WOL数据包转发到 192.168.1.255：

yaml
version: '3.6'
services:
  wakeupbr:
    image: aecampos/wakeupbr
    network_mode: host
    command: -l 0.0.0.0:9 -o 192.168.1.255
    restart: always

也可以使用示例 https://github.com/adriancampos/wakeupbr-docker/blob/master/docker-compose.yml 文件，通过 docker compose up 启动容器。

wakeupbr 使用方法

$ wakeupbr -h
用法:
  wakeupbr [选项]

应用选项:
  -l, --listen=IP     监听WOL数据包的地址（默认：0.0.0.0:9）
  -o, --forward=IP    接收的WOL数据包应转发到的接口地址

帮助选项:
  -h, --help          显示帮助信息

wakeupbr 详细说明

wakeupbr 程序作为WOL数据包的桥接工具，监听入站接口的WOL数据包并转发到出站接口。

示例： 某设备有两个接口：有线接口 eth0（地址 172.16.0.10）和无线接口 wlan0（地址 10.0.0.10）。要唤醒的设备在有线网络，希望接收无线网络的WOL数据包并转发到有线网络，可执行以下命令：

$ wakeupbr -l 10.0.0.10 -o 172.16.0.10  

无线网络广播的任何WOL数据包都会被转发。当数据包被接收并转发时，会记录日志：

2017/07/28 19:34:54 Forwarded magic packet for AA:BB:CC:12:34:56 to 172.16.0.10

上述命令监听UDP端口9的WOL数据包。由于端口9是特权端口，wakeupbr 必须以root身份运行。为避免绑定特权端口，可使用 iptables 规则：

$ iptables -t nat -A PREROUTING -i wlan0 -p udp --dport 9 -j REDIRECT --to-port 9000

还需确保UDP端口9000的流量被 INPUT 链接受：

$ iptables -A INPUT -p udp --dport 9000 -j ACCEPT

这会将所有UDP端口9的数据包重定向到端口9000。wakeupbr 可监听端口9000并以普通用户身份运行：

$ wakeupbr -l 10.0.0.10:9000 -o 172.16.0.10

Example: HomeAssistant

该桥接工具适用于例如让 http://home-assistant.io/ 容器在不使用 net=host 的情况下发送WOL数据包。

可正常使用 https://www.home-assistant.io/integrations/wake_on_lan/%EF%BC%9A

yaml
switch:
  - platform: wake_on_lan
    mac: "ab:cd:ef:gh:ij:jk"  

并依赖 wakeupbr 将WOL数据包转发到局域网其他设备。