懒猫微服 GPTWOL + 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，左侧为设备列表，右侧提供手动唤醒与计划任务。

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

网络与安全位置

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

How - 如何配置与使用？

一、在 GPTWOL 手动唤醒

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

二、在 GPTWOL 使用 cron 定期唤醒

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

三、在 WolGoWeb 中通过 curl/cron 按需唤醒

1. 默认 WolGoWeb 未配置认证方式，如果你对安全有要求，可以通过环境变量开启认证。
2. 通过懒猫微服内网穿透访问 API（无需额外 DDNS），例如：

   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 来获取详细的帮助信息。
• 应用默认界面介绍的信息不太准确
• API 使用说明
• 
• crontab 定时调用
• 

四、调试与排障技巧

• 网卡未唤醒：检查 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 等自动化系统。跟随该配置步骤，就能快速搭建符合自身节奏的局域网唤醒策略，让家庭与工作网络随叫随到。