ghcr.io/trugamr/wol:latest-armv7

wol 🦭

一个用于发送局域网唤醒（Wake-On-LAN, WOL）魔术包以唤醒网络设备的CLI工具。同时提供CLI命令和Web界面功能。

功能特性

• 通过CLI或Web界面发送WOL魔术包
• 配置多台设备并命名，方便访问
• 列出已配置的设备
• 用于便捷唤醒的Web界面
• 支持Docker

安装

预构建二进制文件

从https://github.com/trugamr/wol/releases%E4%B8%8B%E8%BD%BD%E9%80%82%E7%94%A8%E4%BA%8E%E6%82%A8%E5%B9%B3%E5%8F%B0%E7%9A%84%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82

支持平台：

• Linux（x86_64、arm64、armv7）
• macOS（x86_64、arm64）
• Windows（x86_64）

使用Go安装

go install github.com/trugamr/wol@latest

使用Docker

docker run --network host -v $(pwd)/config.yaml:/etc/wol/config.yaml ghcr.io/trugamr/wol:latest

或使用docker-compose：

# 方法1：使用绑定挂载
services:
  wol:
    image: ghcr.io/trugamr/wol:latest
    command: serve # 启动Web界面
    network_mode: "host"
    volumes:
      - ./config.yaml:/etc/wol/config.yaml

# 方法2：使用环境变量
services:
  wol:
    image: ghcr.io/trugamr/wol:latest
    command: serve # 启动Web界面
    network_mode: "host"
    environment:
      WOL_CONFIG: |
        machines:
          - name: desktop
            mac: "00:11:22:33:44:55"
            ip: "192.168.1.100" # 可选，用于状态检查
          - name: server
            mac: "AA:BB:CC:DD:EE:FF"
            ip: "server.local"
        server:
          listen: ":7777" # 可选，默认值为:7777
        ping:
          privileged: false # 可选，设为true以使用特权ping

查看examples/reverse-proxy.yml获取在反向代理后运行wol的示例，包括基本认证、HTTPS等配置。

[!NOTE] 配置文件应挂载到容器内的/etc/wol/config.yaml。为确保局域网唤醒包在本地网络正常工作，建议使用主机网络模式。

配置

在以下位置之一创建config.yaml文件（按优先级排序）：

• ./config.yaml（当前目录）
• ~/.wol/config.yaml（主目录）
• /etc/wol/config.yaml（系统级目录）

或者，您可以通过WOL_CONFIG环境变量提供配置：

export WOL_CONFIG='
machines:
  - name: desktop
    mac: "00:11:22:33:44:55"
    ip: "192.168.1.100" # 可选，用于状态检查
  - name: server
    mac: "AA:BB:CC:DD:EE:FF"
    ip: "server.local"

server:
  listen: ":7777" # 可选，默认值为:7777
'

配置示例：

machines:
  - name: desktop
    mac: "00:11:22:33:44:55"
    ip: "192.168.1.100" # 可选，用于状态检查
  - name: server
    mac: "AA:BB:CC:DD:EE:FF"
    ip: "server.local"

server:
  listen: ":7777" # 可选，默认值为:7777

ping:
  privileged: false # 可选，如需使用特权ping则设为true

使用方法

CLI命令

# 列出所有已配置的设备
wol list

# 按名称唤醒设备
wol send --name desktop

# 按MAC地址唤醒设备
wol send --mac "00:11:22:33:44:55"

# 启动Web界面
wol serve

# 显示版本信息
wol version

Web界面

运行serve命令后，Web界面可通过http://localhost:7777访问。其提供以下功能：

• 所有已配置设备的列表
• 一键唤醒按钮
• 实时设备状态监控（当配置IP时）
• 版本信息
• 文档和支持链接

从源码构建

# 克隆仓库
git clone https://github.com/trugamr/wol.git
cd wol

# 构建
go build

# 运行
./wol

已知问题

Docker容器Ping权限

在Docker容器中运行时，使用ping的设备状态功能可能因权限问题无法正常工作。这是因为应用程序使用https://github.com/prometheus-community/pro-bing%E5%8F%91%E9%80%81ping%EF%BC%8C%E8%80%8C%E8%AF%A5%E5%B7%A5%E5%85%B7%E9%9C%80%E8%A6%81%E7%89%B9%E5%AE%9A%E7%9A%84Linux%E5%86%85%E6%A0%B8%E8%AE%BE%E7%BD%AE%E3%80%82

要解决此问题，需在主机系统上设置以下sysctl参数：

sysctl -w net.ipv4.ping_group_range="0 2147483647"

要使此更改持久生效，请将其添加到您的/etc/sysctl.conf文件中。

您也可以尝试在配置中设置ping.privileged: true作为替代解决方案。

有关更多详情，请参见https://github.com/Trugamr/wol/issues/12%E3%80%82

许可协议

本项目采用MIT许可协议。详情请参见LICENSE文件。

贡献指南

欢迎贡献！请随时提交issue或拉取请求。