mitterm/go-rest-wol

GoLang HTTP服务器：从CSV电脑列表远程发送WOL请求

镜像概述和主要用途

该Docker镜像包含一个Go语言编写的HTTP服务器，专门用于通过HTTP请求发送网络唤醒（Wake On Lan, WOL）数据包。它允许用户从预定义的CSV电脑列表中选择设备进行远程唤醒，提供直观的Web界面和便捷的API接口，简化网络设备唤醒流程。

核心功能和特性

• 简单的Bootstrap Web界面：提供用户友好的操作界面，便于手动选择设备进行唤醒
• REST API支持：通过API接口实现程序化唤醒控制，返回JSON格式响应
• CSV文件配置：使用CSV文件管理电脑列表，包含设备名称、MAC地址和广播IP信息
• 自定义端口：支持指定HTTP服务器监听端口，适应不同网络环境需求

Web界面预览

!https://github.com/daBONDi/go-rest-wol/raw/master/screenshot.PNG

使用场景和适用范围

• 家庭网络中需要远程唤醒多台电脑的场景
• 办公室环境下IT管理员批量唤醒设备
• 需要通过程序或脚本远程控制设备电源状态的自动化场景
• 无物理接触情况下唤醒局域网内设备

使用方法和配置说明

命令行参数

电脑列表CSV文件格式

列定义

<电脑名称>,<MAC地址>,<发送魔术包的广播IP:端口>

示例

创建名为computers.csv的文件：

csv
name,mac,ip
Computer1,64-07-2D-BB-BB-BF,192.168.10.254:9
Computer2,2D-F2-3D-06-17-00,192.168.10.254:9
Computer3,FF-B3-95-62-1C-DD,192.168.10.254:9

REST API使用

通过以下API端点唤醒设备：

• GET /api/computer/：唤醒指定名称的电脑

API响应示例

json
{
  "success": true,
  "message": "成功唤醒电脑 Computer1，MAC地址 64-07-2D-BB-BB-BF，广播IP 192.168.10.254:9",
  "error": null
}

Docker部署示例

使用docker run命令

bash
docker run -d \
  -p 8080:8080 \
  -v /path/to/your/config:/config \
  -e WOLFILE=/config/computers.csv \
  mitterm/go-rest-wol

使用docker-compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  wol:
    image: mitterm/go-rest-wol
    ports:
      - "8080:8080"  # 主机端口:容器端口
    environment:
      - "WOLFILE=/config/computer.csv"  # 指定CSV文件路径
    volumes:
      - "./config:/config"  # 将本地config目录挂载到容器内

启动服务：

bash
docker-compose up -d

credits

完整 credits 归 https://github.com/daBONDi/go-rest-wol 所有。