chtake/pi-wol

pi-wol

镜像概述和主要用途

pi-wol是一个基于Web的局域网唤醒（Wake on LAN）服务，可运行在任何支持dotnet运行时的系统（如Linux、macOS、Windows）。该服务最初为树莓派开发，但也可在其他平台上运行，通过网页界面实现局域网设备的远程唤醒。

核心功能和特性

• Web界面管理：通过网页添加和管理支持局域网唤醒的设备，并执行唤醒操作
• 跨平台运行：支持Linux、macOS、Windows等所有dotnet运行时兼容系统
• 网络兼容性：需与唤醒目标设备处于同一网络，可通过***或局域网间接唤醒不同子网设备
• 访问控制：支持通过IP地址或网络范围限制访问，可配置多个单主机或网络规则
• 移动友好：可添加到移动设备主屏幕，便于移动场景使用

使用场景和适用范围

• 家庭网络：通过网页远程唤醒家中电脑、NAS等设备
• 小型办公室：集中管理和唤醒办公设备，提高设备使用效率
• 远程访问场景：结合***，从外部网络通过pi-wol唤醒内网设备

安全建议：强烈建议通过路由器/防火墙限制互联网访问，仅在本地局域网或通过***访问该服务，避免直接暴露在公网环境。

使用方法和配置说明

前置要求

• 运行环境需支持dotnet运行时
• 容器必须使用host网络模式，以确保唤醒魔术包正常工作

数据持久化

需挂载数据卷以持久化配置和设备信息，默认路径：

yaml
volumes:
  - /srv/docker/pi-wol/data:/app/data  # 本地路径可根据需求修改

Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  pi-wol:
    image: chtake/pi-wol:latest
    network_mode: "host"
    volumes:
      - /srv/docker/pi-wol/data:/app/data
    environment:
      - ASPNETCORE_URLS=http://+:8080  # 配置Web服务端口
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

Docker Run 部署

直接运行容器：

bash
docker run --network="host" \
           -v /srv/docker/pi-wol/data:/app/data \
           -e "ASPNETCORE_URLS=http://+:8080" \
           --restart unless-stopped \
           chtake/pi-wol:latest

访问和使用

1. 服务启动后，通过http://<主机IP>:8080访问Web界面
2. 在界面中添加支持局域网唤醒的设备（需提供设备MAC地址等信息）
3. 点击设备对应的唤醒按钮执行唤醒操作

限制访问

在应用设置中配置IP访问规则，支持：

• 单个IP地址限制
• 网络范围限制（如192.168.1.0/24）
• 多规则组合配置

移动设备使用

在移动浏览器中访问服务页面，使用浏览器的"添加到主屏幕"功能，可将Web应用添加为桌面图标，提升使用体验。