懒猫微服用 GPTWOL + WolGoWeb 让你在任何网络瞬时远程唤醒同局域网设备

# 懒猫微服 GPTWOL + WolGoWeb 让局域网唤醒更简单

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.gptwol

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.liu.wolgoweb


## Why - 为什么需要 WOL 应用？

### 使用场景
- **远程开机**：人在办公室或外网时，通过懒猫微服即可唤醒家中 NAS、工作站等设备。
- **节能管理**：闲置时关机，需要用时再唤醒，避免长期待机耗电。
- **批量维护**：夜间统一唤醒一批主机执行备份、同步，再自动休眠。

### 解决的痛点
- 不再需要记忆或手动发送复杂的 `wakeonlan` 命令。
- 通过 GPTWOL 可视化界面统一管理 MAC 地址、别名及 SecureOn。
- 通过 WolGoWeb 对接 curl、cron、CI，借助懒猫微服内网穿透远程唤醒局域网设备，无需再折腾 DDNS、端口映射。

## What - WOL 是什么？

### WOL 基础
- Wake-on-LAN（WOL）是网卡在断电或待机状态下仍监听特定“魔术包”的机制。
- 收到匹配 MAC 地址的魔术包后，支持 WOL 的主板会触发加电，恢复系统运行。

### 懒猫微服两款应用的分工
- **GPTWOL**：可视化设备清单、远程一键唤醒、内置 cron 计划管理。
- **WolGoWeb**：提供面向脚本的 HTTP API，可由 浏览器、curl、其他系统或独立的 cron 调度调用。

## Who - 谁应该使用？

### 目标人群
- 需要集中管理多台局域网主机的家庭/工作室管理员。
- 想让懒猫微服自动触发备份、渲染、下载任务的个人用户。
- 远程办公或经常旅行，希望随时唤醒本地设备的工程师。

### 前置准备
- 目标设备 BIOS/UEFI 已启用 WOL，操作系统允许网卡待机供电。
- 设备与懒猫微服处于同一二层网络，或路由器支持广播转发。
- 已在 GPTWOL 中录入设备名称、MAC 地址。

## When - 在什么时刻使用？

### 关键节点
- 需要临时远程访问 NAS、媒体服务器或开发机器时。
- 夜间定时运行备份、更新、渲染前，先唤醒目标主机。
- 自动化脚本需要按需启停算力资源，避免 7x24 小时运行。

### 使用节奏
- 日常手动：依靠 GPTWOL，随用随唤醒，任务完成后让设备休眠。
- 周期任务：在 GPTWOL 内配置 cron 规则，按固定节奏自动唤醒。
- 按需触发：在 WolGoWeb 中获取 Token，通过外部 cron、curl、Webhook、CI 等场景唤醒。

## Where - 在哪里设置与执行？

### 操作入口
- 在应用市场安装 **GPTWOL**：桌面入口打开 Web UI，左侧为设备列表，右侧提供手动唤醒与计划任务。

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.gptwol

- 另行安装 **WolGoWeb**：提供 API Token、免认证策略等配置页面。

### 网络与安全位置
- 与目标设备保持同网段或开启路由器的广播转发（Directed Broadcast）。
- 若需跨网段唤醒，可在路由器上将 UDP 7/9 转发到懒猫微服，再由 GPTWOL 广播；而 WolGoWeb 依托懒猫微服自带的内网穿透通道，用户无需再配置 DDNS/端口映射即可远程触发。
- WolGoWeb 并按需求启用 API Key 或开放匿名访问。

## How - 如何配置与使用？

### 一、在 GPTWOL 手动唤醒
1. 打开 GPTWOL，确认“设备列表”已录入目标机器。
2. 点击设备右侧“唤醒”，或在移动端小组件中选择设备后点击唤醒。
3. 观察页面日志/通知，确认魔术包发送成功；若设备支持 BMC，可在 BMC 中验证状态。
4. 如需批量唤醒，勾选多台设备后点击“批量唤醒”，GPTWOL 会依次发送魔术包。

![Shot 2025.11.23 at 16.54.30.png](https://dl.playground.lazycat.cloud/guidelines/703/de2e9fc2-eaf3-4183-85ca-05acd0ebd734.png "Shot 2025.11.23 at 16.54.30.png")

### 二、在 GPTWOL 使用 cron 定期唤醒
1. 进入“计划任务”面板新增计划，选择设备或分组。
2. 填写 cron 表达式，例如 `0 3 * * *` 代表每天凌晨 3 点唤醒。
3. 配置“失败重试次数”“通知渠道”等选项，确保异常时收到告警。
4. 保存计划后，GPTWOL 将在指定时间执行，可在“执行日志”中查看每次结果。

### 三、在 WolGoWeb 中通过 curl/cron 按需唤醒
https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.liu.wolgoweb

1. 默认 WolGoWeb 未配置认证方式，如果你对安全有要求，可以通过环境变量开启认证。
2. 通过懒猫微服内网穿透访问 API（无需额外 DDNS），例如：
   ```bash
   curl https://wolgoweb.${box-name}.heiyu.space/wol?mac=[MAC-address]
   ```
3. 将上述命令写入脚本，由外部 cron、CI、Webhook 或 Workflow 调用，实现按需唤醒。
4. 若需要批量唤醒，可执行多个 curl 命令，或编写循环脚本。

#### 使用帮助
- 在安装完成 WolGoWeb 后，你可以通过访问 https://wolgoweb.{box-name}.heiyu.space/readme 来获取详细的帮助信息。
- 应用默认界面介绍的信息不太准确 ![Shot 2025.11.23 at 17.58.16.png](https://dl.playground.lazycat.cloud/guidelines/703/a1976e74-8e5b-45b6-bdd7-f9111a64f863.png "Shot 2025.11.23 at 17.58.16.png")
- API 使用说明
- ![Shot 2025.11.23 at 18.01.00.png](https://dl.playground.lazycat.cloud/guidelines/703/42c821e0-8f73-4f3f-9a3d-386c9bc3b7be.png "Shot 2025.11.23 at 18.01.00.png")
- crontab 定时调用
- ![Shot 2025.11.23 at 18.01.59.png](https://dl.playground.lazycat.cloud/guidelines/703/dda4b61c-1760-4c2c-98e9-5591aa13bea8.png "Shot 2025.11.23 at 18.01.59.png")

### 四、调试与排障技巧
- **网卡未唤醒**：检查 BIOS WOL、主板供电、系统驱动是否开启“允许设备唤醒计算机”。
- **广播未到达**：确认路由器未屏蔽 UDP 9/7 端口的广播，或在 GPTWOL 中填写“定向广播地址”。

## How Much - 成本与维护

### 时间成本
- 初次录入设备信息与验证约 5 分钟，后续手动唤醒仅需 1～2 秒。
- 配置 cron 或集成 curl/自动化脚本，多数场景 10 分钟内完成。

### 资源成本
- WOL 魔术包体积小，仅需局域网可达，无额外带宽与计算资源。
- GPTWOL 与 WolGoWeb 均运行于懒猫微服，无需额外服务器或 SSL 证书维护。

### 维护成本
- 定期检查 GPTWOL 设备列表中 MAC、SecureOn 是否随网卡更换而更新。
- 关注 GPTWOL 与 WolGoWeb 的版本更新，以获取最新 API 能力与安全补丁。
- 为关键定时任务配置通知渠道，确保唤醒失败时能及时处理。

## 结语

通过 GPTWOL + WolGoWeb 的双应用组合，可以将手动唤醒与内置 cron 调度留在可视化界面中管理，同时把按需唤醒能力开放给 curl、cron、CI、Webhook 等自动化系统。跟随该配置步骤，就能快速搭建符合自身节奏的局域网唤醒策略，让家庭与工作网络随叫随到。