Skip to content

安装部署

PowerControlClient 支持 Windows 和 Linux 操作系统。您可以直接运行可执行文件,也可以将其安装为系统服务。

下载程序

请从发布页面下载对应您操作系统架构的可执行文件。

  • Windows: PowerControlClient.exe
  • Linux: PowerControlClient (amd64, arm64 等)

Windows 安装

前台运行 (测试)

在命令提示符 (CMD) 或 PowerShell 中运行:

powershell
.\PowerControlClient.exe

此时程序会输出日志并监听端口。关闭窗口程序即停止。

安装为系统服务 (推荐)

管理员身份打开 PowerShell,运行以下命令:

powershell
# 1. 安装服务
.\PowerControlClient.exe -install

# 2. 启动服务
.\PowerControlClient.exe -start

# 3. 检查状态
.\PowerControlClient.exe -status

安装成功后,服务将在后台运行,并且开机自启。

防火墙设置

Windows 防火墙可能会拦截外部请求。请确保放行 TCP 42000-42001 和 UDP 42002 端口。

卸载服务

powershell
.\PowerControlClient.exe -stop
.\PowerControlClient.exe -uninstall

Linux 安装

使用安装脚本 (推荐)

项目提供了 install.sh 脚本,可自动检测架构并配置 Systemd 服务。

bash
chmod +x install.sh
sudo ./install.sh

手动安装

  1. 创建安装目录并复制文件:

    bash
    sudo mkdir -p /opt/PowerControlClient
    sudo cp PowerControlClient /opt/PowerControlClient/
    sudo chmod +x /opt/PowerControlClient/PowerControlClient
  2. 创建 Systemd 服务文件 /etc/systemd/system/PowerControlClient.service

    ini
    [Unit]
    Description=PowerControlClient Service
    After=network.target
    
    [Service]
    Type=simple
    ExecStart=/opt/PowerControlClient/PowerControlClient
    Restart=on-failure
    
    [Install]
    WantedBy=multi-user.target
  3. 启动服务:

    bash
    sudo systemctl daemon-reload
    sudo systemctl enable PowerControlClient
    sudo systemctl start PowerControlClient

验证安装

安装完成后,打开浏览器访问:

http://localhost:42000/health

如果返回类似 {"status":"success", ...} 的 JSON 数据,说明服务运行正常。

Released under the MIT License.