介紹

wol 是一個由 Trugamr 開發的開源命令行工具，旨在通過發送 Wake-On-LAN（WOL）魔術包來喚醒網絡中的設備。該工具既提供命令行界面（CLI）也提供網頁界面，方便用戶根據需求選擇使用。

主要功能

• 多種喚醒方式：支持通過命令行或網頁界面發送 WOL 魔術包，滿足不同用戶的操作習慣。
• 設備管理：允許配置多個設備的名稱、MAC 地址和 IP 地址，便于管理和快速訪問。
• 設備列表：提供已配置設備的列表，方便查看和管理。
• 網頁界面：提供直觀的網頁界面，用戶可以輕松地通過瀏覽器喚醒設備。
• Docker 支持：支持通過 Docker 部署，簡化安裝和配置過程。

支持的系統

wol 提供預編譯的二進制文件，支持以下平臺：

• Linux：支持 x86_64、arm64 和 armv7 架構。
• macOS：支持 x86_64 和 arm64 架構。
• Windows：支持 x86_64 架構。

此外，用戶也可以使用 Go 語言進行安裝，或通過 Docker 進行部署，進一步提高了跨平臺的兼容性。

安裝與配置

預編譯二進制文件：用戶可以從發布頁面下載適合自己平臺的最新版本。

• 使用 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:lates

• 或者使用 docker-compose：

services:
  wol:
    image: ghcr.io/trugamr/wol:latest
    command: serve # 啟動網頁界面
    network_mode: "host"
    volumes:
      - ./config.yaml:/etc/wol/config.yaml

配置文件 config.yaml 應放置在以下位置之一（按優先級排序）：

• 當前目錄下的 ./config.yaml
• 用戶主目錄下的 ~/.wol/config.yaml
• 系統范圍內的 /etc/wol/config.yaml

示例配置：

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: "192.168.1.101" # 可選，用于狀態檢查

server:
  listen: ":7777" # 可選，默認為 :7777

使用方法

(1) 命令行界面：

• 列出所有已配置的設備：

wol list

• 通過設備名稱喚醒設備：

wol send --name desktop

• 通過 MAC 地址喚醒設備：

wol send --mac "00:11:22:33:44:55"

• 啟動網頁界面：

wol serve

• 顯示版本信息：

wol version

(2) 網頁界面：在運行 wol serve 命令后，網頁界面可通過 http://localhost:7777 訪問，提供以下功能：

• 查看所有已配置的設備列表
• 一鍵喚醒設備
• 實時監控設備狀態（需配置 IP 地址）
• 查看版本信息
• 訪問文檔和支持鏈接

優勢

• 多平臺支持：wol 提供適用于多種操作系統的預編譯二進制文件，并支持通過 Go 安裝和 Docker 部署，確保在不同環境下的兼容性。
• 多種操作界面：同時提供命令行和網頁界面，滿足不同用戶的使用偏好。
• 易于配置和管理：支持通過配置文件管理多個設備，提供設備列表功能，方便用戶查看和管理已配置的設備。
• 開源社區支持：作為一個開源項目，wol 歡迎社區貢獻，用戶可以根據自身需求進行定制和擴展。

截圖

總結

wol 是一個功能強大且易于使用的工具，適合需要遠程喚醒網絡設備的用戶。

地址

項目地址：https://github.com/Trugamr/wol