viklion/powercontrol

PowerControl

简介

PowerControl是一个Docker容器，用于远程网络唤醒或关闭Windows、Linux、MacOS设备。支持添加多设备管理，可通过访问API进行控制，并能依赖巴法云接入米家（需配合小爱音箱实现语音操作），同时支持接入HomeAssistant。
注：米家控制受米家、巴法平台稳定性因素影响
支持架构：linux/amd64, linux/arm/v7, linux/arm64, linux/386

核心功能和特性

1. 支持多种方式唤醒或关闭Windows、Linux、MacOS设备
2. 通过巴法云接入米家，可使用小爱音箱语音控制设备开机/关机
3. 提供API接口实现开机/关机控制，端口转发或反向代理后支持远程操作
4. 支持接入HomeAssistant，通过HomeAssistant进行设备管理
5. 可通过自定义指令打开/关闭虚拟机
6. 支持多设备统一管理
7. 集成消息推送功能

部署资源

• https://github.com/viklion/PowerControl
• 视频教程（Bilibili）
• 小白级详细部署教程：https://github.com/viklion/PowerControl/blob/main/UNRAID.md • https://github.com/viklion/PowerControl/blob/main/DSM.md • https://github.com/viklion/PowerControl/blob/main/FNOS.md • https://github.com/viklion/PowerControl/blob/main/iStoreOS.md

使用方法和配置说明

重要提示：不要直接复制命令运行，需根据实际情况修改参数

1. 将容器/app/data目录映射到主机目录，用于存放配置文件和日志文件：
   修改/your/path为实际主机目录
2. 配置环境变量：
   WEB_PORT：网页访问端口
WEB_KEY：访问密钥
   不设置环境变量则使用默认参数：端口7678，密钥admin
   网络模式支持host、ipvlan、macvlan，不支持bridge

Docker CLI部署

默认root用户运行

bash
docker run -d -v /your/path:/app/data -e WEB_PORT=7678 -e WEB_KEY=admin --network host --restart unless-stopped --name powercontrol viklion/powercontrol:latest

指定用户运行（环境变量PUID和PGID）

重要：切换非root用户运行时，如遇写入错误，请递归修改映射目录的读写权限（配置文件、日志文件）

bash
docker run -d -v /your/path:/app/data -e WEB_PORT=7678 -e WEB_KEY=admin -e PUID=1000 -e PGID=100 --network host --restart unless-stopped --name powercontrol viklion/powercontrol:latest

Docker Compose部署

yaml
services:
  powercontrol:
    image: viklion/powercontrol:latest
    container_name: powercontrol
    volumes:
      - /your/path:/app/data
    environment:
      - WEB_PORT=7678
      - WEB_KEY=admin
      # 默认root用户运行，去掉下两行的#，设置指定用户运行
      #- PUID=1000
      #- PGID=100
    restart: unless-stopped
    network_mode: host

配置说明

访问ip:端口进入首页，输入密钥（WEB_KEY）后跳转至设备总览页，点击设备卡片进入配置页面。
一般无需手动修改配置文件，可通过网页界面完成所有配置。https://github.com/viklion/PowerControl/blob/main/YAML.md

界面展示

!https://github.com/user-attachments/assets/3df4b928-0cf9-4deb-a478-5681dc77b586
!https://github.com/user-attachments/assets/c9cf79ba-c624-46fe-b47a-00bec12bd265
!https://github.com/user-attachments/assets/d272cbd9-0133-4785-a5c0-fba1bcd423f4