1thorsten/ewake

ewake

镜像概述和主要用途

ewake是一款用于管理支持WakeOnLan（WOL）功能计算机的Web应用。它允许用户通过Web前端直接唤醒计算机，无需SSH访问；提供REST API接口用于客户端的创建与删除管理；能够通过指定检查方式（如TCP端口检测）实时监控客户端运行状态，并记录操作日志以便问题排查。

核心功能和特性

• Web前端唤醒：用户可通过HTTP请求直接唤醒指定客户端，无需SSH权限

  http
  http://localhost:5555/etherwake?user=1thorsten
  

• REST API客户端管理：支持通过API创建和删除客户端配置

  http
  PUT http://localhost:5555/manageClients
  Content-Type: application/json
  
  {
    "name": "1thorsten",
    "description": "serv1",
    "mac": "E4:54:E8:A4:17:1F",
    "ip": "10.40.4.162",
    "check": "tcp:3389"
  }
  
  ###
  
  DELETE http://localhost:5555/manageClients
  Content-Type: application/json
  
  {
    "mac": "E4:54:E8:A4:17:1F",
    "ip": "10.40.4.162"
  }
  

• 运行状态检测：通过预配置的检查规则（如TCP端口检测）实时显示活跃客户端

  http
  http://localhost:5555/activeClients
  

• 操作日志记录：自动记录所有唤醒操作，便于问题追踪与排查

  http
  http://localhost:5555/check
  

使用场景和适用范围

• 家庭/办公网络远程唤醒：适用于需要远程唤醒多台计算机且无SSH访问权限的场景
• 集中化设备管理：企业或团队环境中，通过Web界面统一管理多台设备的唤醒状态
• 集群共享使用：支持多实例协同工作，通过HTTP/DAV协议实现客户端配置的集中存储与共享

详细使用方法和配置说明

网络模式配置

host网络模式（推荐，功能完整）

需使用--network host模式以启用所有功能（如MAC地址解析），适用于Linux系统。

• 本地文件管理客户端（非集群模式）
  通过卷挂载持久化存储客户端数据：

  bash
  docker run -d --restart unless-stopped --network host -e EWAKE_PORT=5555 -v ewake-clients:/ewake-clients --name ewake docker.xuanyuan.run/1thorsten/ewake:latest
  

• HTTP只读管理（集群模式）
  通过HTTP链接外部客户端配置文件：

  bash
  docker run -d --restart unless-stopped --network host -e EWAKE_PORT=5555 -e EWAKE_JSON_HTTP=https://raw.githubusercontent.com/1thorsten/ewake/main/src/resources/client.json --name ewake docker.xuanyuan.run/1thorsten/ewake:latest
  

• HTTP+DAV读写管理（集群可写模式）
  结合DAV服务（如http-over-all）实现多实例配置共享：

  bash
  docker run -d --restart unless-stopped --network host -e EWAKE_PORT=5555 -e EWAKE_JSON_HTTP=http://http-over-all:8338/mysamba/clients.json -e EWAKE_JSON_HTTP_WRITE=http://http-over-all:8338/dav/mysamba/clients.json --name ewake docker.xuanyuan.run/1thorsten/ewake:latest
  

bridge网络模式（兼容性模式）

Windows和macOS系统不支持host网络模式，需使用bridge模式并映射端口：

• 本地文件管理客户端

  bash
  docker run -d --restart unless-stopped -p 5555:5555 -v ewake-clients:/ewake-clients --name ewake docker.xuanyuan.run/1thorsten/ewake:latest
  

• HTTP只读管理（集群模式）

  bash
  docker run -d --restart unless-stopped -p 5555:5555 -e EWAKE_JSON_HTTP=https://raw.githubusercontent.com/1thorsten/ewake/main/src/resources/client.json --name ewake docker.xuanyuan.run/1thorsten/ewake:latest
  

• HTTP+DAV读写管理（集群可写模式）

  bash
  docker run -d --restart unless-stopped -p 5555:5555 -e EWAKE_JSON_HTTP=http://http-over-all:8338/mysamba/clients.json -e EWAKE_JSON_HTTP_WRITE=http://http-over-all:8338/dav/mysamba/clients.json --name ewake docker.xuanyuan.run/1thorsten/ewake:latest
  

环境变量说明

数据持久化

• 使用-v ewake-clients:/ewake-clients挂载卷以持久化存储客户端配置数据（本地文件管理模式）
• 集群模式下，配置数据通过EWAKE_JSON_HTTP指定的外部服务存储