saveworldpig/wol repository overview

⁠Wake On LAN 管理工具 (Docker Overview)

这是一个轻量级、现代化的 Wake On LAN (WOL) 远程唤醒管理工具。通过简洁的 Web 界面，您可以轻松管理局域网内的设备，并随时随地远程唤醒它们。

⁠🌟 核心特性

• 设备管理: 轻松添加、查看和删除设备（支持名称、MAC 地址、IP 地址）。
• 实时在线状态: 自动通过 Ping 定期检测并显示设备的在线/离线状态。
• 一键唤醒: 点击按钮即可发送标准 WOL 魔法包（Magic Packet）。
• 数据持久化: 使用内置 SQLite 数据库，容器重启数据不丢失。
• 现代化 UI: 响应式界面，完美适配手机和桌面浏览器。

⁠🚀 快速开始

⁠方式一：使用 Docker Compose (推荐)

这是最简单且功能最完整的部署方式。

version: '3'
services:
  wol-manager:
    image: peiluming/wake-on-lan:latest
    container_name: wake-on-lan
    network_mode: host # 必须使用 host 模式以发送广播包
    restart: unless-stopped
    volumes:
      - ./devices.db:/app/devices.db
    environment:
      - TZ=Asia/Shanghai

执行启动命令：

docker-compose up -d

⁠方式二：使用 Docker CLI

docker run -d \
  --name wake-on-lan \
  --network host \
  -v $(pwd)/devices.db:/app/devices.db \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  peiluming/wake-on-lan:latest

访问地址：http://<宿主机IP>:8000

⁠⚠️ 重要注意事项

1. 网络模式 (Critical): 在 Docker 中部署时，必须使用 network_mode: host。WOL 依赖发送 UDP 广播包，默认的桥接网络（bridge）通常无法将广播包转发到局域网。
2. 设备准备:
   • 在目标设备的 BIOS/UEFI 中开启 Wake On LAN 功能。
   • 在目标操作系统的网卡设置中开启 魔术封包唤醒 (Wake on Magic Packet)。
3. 数据挂载: 为了保留添加的设备信息，请务必挂载 /app/devices.db 文件。

⁠🛠️ 技术栈

• 后端: FastAPI (Python), SQLAlchemy, APScheduler
• 前端: Tailwind CSS, JavaScript (Fetch API)
• 数据库: SQLite