PowerControl

🚀 轻量级远程设备电源管理系统 - Go 重构版

GitHub Workflow Status License Go Version GitHub Stars

基于 viklion/PowerControl 原 Python 版本重构 本项目使用 Go 语言重写，大幅提升性能并降低资源占用，同时保持与原版本的完全兼容。

✨ 特性亮点

核心功能

✅ 网络唤醒 (WOL) - 远程唤醒
✅ 远程关机 - 支持 SSH、SMB/RPC、自定义命令
✅ 状态监控 - 自动 Ping 检测设备在线状态
✅ 多设备管理 - 支持无限设备，批量操作
✅ REST API - 完整的 HTTP API 接口
✅ Webhook 推送 - 自定义消息通知
✅ 米家集成 - 通过巴法云接入小爱同学
✅ Web 界面 - 简洁直观的管理页面

📦 快速开始

Docker 部署（推荐）


docker run -d \
  -v /your/path:/app/data \
  -e WEB_PORT=7678 \
  -e WEB_KEY=admin \
  --network host \
  --restart unless-stopped \
  --name powercontrol \
  ghcr.io/ilay1678/powercontrol-go:latest

Docker Compose


services:
  powercontrol:
    image: ghcr.io/ilay1678/powercontrol-go:latest
    container_name: powercontrol
    volumes:
      - ./data:/app/data
    environment:
      - WEB_PORT=7678
      - WEB_KEY=admin
      - TZ=Asia/Shanghai
    restart: unless-stopped
    network_mode: host

本地编译


# 克隆仓库
git clone https://github.com/iLay1678/PowerControl-go.git
cd PowerControl-go

# 编译并运行
go mod download
go build -o powercontrol ./cmd/powercontrol

🔧 环境变量

变量	说明	默认值	备注
`WEB_PORT`	Web 服务端口	`7678`	-
`WEB_KEY`	API 访问密钥	`admin`	⚠️ 生产环境必须修改
`DATA_DIR`	数据目录路径	`/app/data`	-
`TZ`	时区设置	`Asia/Shanghai`	-

⚠️ 安全提示: WEB_KEY 默认值为 admin，请在生产环境中通过环境变量设置为强密码！

📖 使用文档

Web 界面

访问 http://your-ip:7678 进入 Web 管理界面。

API 接口

设备控制


# 网络唤醒
curl "http://localhost:7678/wol/device_id?key=admin"

# 远程关机
curl "http://localhost:7678/shutdown/device_id?key=admin"

# Ping 检测
curl "http://localhost:7678/ping/device_id?key=admin"

批量操作


# 批量唤醒
curl -X POST "http://localhost:7678/device/batch/wol?key=admin" \
  -H "Content-Type: application/json" \
  -d '{"device_ids": ["device1", "device2"]}'

# 全部唤醒
curl -X POST "http://localhost:7678/device/wol/all?key=admin"

# 全部关机
curl -X POST "http://localhost:7678/device/shutdown/all?key=admin"