1. 项目概述：一个开源的网络监控“魔方”

如果你和我一样，管理着一个小型办公室、家庭实验室，甚至是一个智能家居网络，那么“网络是否健康”这个问题，可能时不时就会跳出来困扰你。路由器是不是又偷偷重启了？NAS服务器还在线吗？门口的IP摄像头信号还稳不稳定？以前，我可能会选择在电脑上开个命令行窗口一直 ping ，或者部署一套复杂的监控系统，前者太原始，后者又过于笨重和耗电。

直到我动手做了这个Ping-Cube。它的核心想法极其简单：用一个低功耗、始终在线的硬件设备，持续 ping 你指定的关键网络设备（比如路由器、服务器、智能设备），并通过最直观的方式——灯光和网页——告诉你一切是否正常。一旦某个设备失联，它不仅能通过本地的一个小立方体亮起红灯报警，还能通过继电器触发外接的语音拨号器，打电话通知你。最关键的是，它完全开源，从软件、硬件到那个颇具设计感的亚克力外壳，所有文件你都能拿到手，随意修改。

这个项目基于经典的Arduino Mega 2560平台，这意味着它有丰富的IO口和社区支持，你可以轻松地添加温湿度传感器、更多的状态指示灯，甚至是一个小屏幕，把它变成你的网络监控中枢。它不依赖高性能PC，功耗极低，可以7x24小时默默蹲在角落替你守望网络。接下来，我就带你从设计思路到焊接调试，完整地复现这个能让你的局域网尽在掌握的“魔方”。

2. 核心设计思路与方案选型

为什么选择自己动手做一个专用的硬件监控设备，而不是用现成的软件方案？这是设计之初首先要回答的问题。

2.1 需求分析与现有方案对比

我的核心需求很明确： 持续、低功耗、直观、可扩展的网络连通性监控 。市面上常见的方案主要有几种：

1. 软件监控工具（如PRTG、Zabbix Agent） ：功能强大，但通常需要运行在一台常开的电脑或服务器上，功耗大，且配置较为复杂，对于仅需 ping 通断告警的场景有点“杀鸡用牛刀”。
2. 路由器自带功能 ：部分中高端路由器有内置的设备在线检测，但告警方式有限（可能只有日志），且无法自定义监控频率和复杂的告警逻辑。
3. 智能家居平台插件 ：通过Home Assistant等平台集成，灵活性高，但同样依赖中心服务器（如树莓派）持续运行，一旦平台本身出问题，监控也就失效了。

Ping-Cube的方案瞄准了这些痛点。它采用 单片机（MCU） 作为核心，功耗通常只有几瓦甚至更低，非常适合7x24小时运行。其功能单一而专注，就是 ping 和告警，稳定性极高。通过硬件指示灯和继电器，它提供了 脱离于主监控网络的独立告警通道 ，即使你的主监控系统所在的网络段出了问题，它依然能通过电话（外接拨号器）通知你，这是一个非常重要的冗余设计。

2.2 硬件平台选型：为什么是Arduino Mega 2560？

选择Arduino Mega 2560，是基于以下几点考量：

• 丰富的IO资源 ：它拥有54个数字IO口和16个模拟输入口。这对于本项目来说绰绰有余，使得未来扩展变得非常容易。例如，我可以为每一个被监控的设备分配一个独立的LED指示灯，或者连接多个继电器用于分级告警。
• 强大的社区与生态 ：Arduino拥有最庞大的开源硬件社区。几乎所有你能想到的传感器、显示屏、通信模块都有现成的库和示例代码，极大降低了开发难度。基于此平台的 Ethernet Shield （网络扩展板）也非常成熟稳定，这是实现网络 ping 功能的基础。
• 成本与可获得性 ：Arduino Mega 2560及其兼容板价格适中，在全球各地都容易采购，保证了项目的可复现性。
• 性能足够 ：对于执行周期性的 ping 命令、管理几个GPIO状态、运行一个轻量级的Web服务器来说，Mega 2560的16MHz主频和8KB RAM完全够用。

注意 ：虽然UNO板更常见，但其IO口和内存较少，在需要同时驱动较多LED或未来扩展时可能捉襟见肘。Mega 2560提供了充足的“余量”，让项目更从容。

2.3 系统架构设计

整个Ping-Cube的架构可以分为三层：

1. 感知与控制层 ：由Arduino Mega 2560主板、Ethernet网络扩展板、状态指示灯LED阵列、告警继电器模块构成。这是系统的“四肢”，负责执行 ping 操作和物理状态输出。
2. 逻辑处理层 ：运行在Arduino上的固件（Firmware）。它包含了定时调度器（何时 ping 哪个IP）、网络通信逻辑（ICMP包发送与接收分析）、状态判断逻辑（连续几次失败才算故障）以及Web服务器（提供状态查看界面）。
3. 交互与告警层 ：
   • 本地交互 ：通过彩色LED（如绿色正常、红色故障）和物理按钮（如静音、测试）。
   • 远程状态查看 ：内嵌的Web服务器，允许同一局域网内的任何设备通过浏览器访问一个简单的网页，查看所有监控目标的状态。
   • 远程告警 ：通过继电器输出的干接点信号，可以控制一个外置的“语音拨号器”。当故障发生时，继电器闭合，触发拨号器拨打预设的电话号码，播放录制好的语音告警信息（如“警告，路由器离线”）。

这个架构清晰地将数据采集、逻辑判断和告警输出分离，使得每一部分都可以独立调整和优化。

3. 硬件组装与核心电路解析

有了设计图，接下来就是动手将想法变为现实。硬件部分是整个项目的基础，稳定的硬件是可靠监控的前提。

3.1 物料清单（BOM）与准备

你需要准备以下核心组件：

• 主控板 ：Arduino Mega 2560 R3 开发板 1块。
• 网络模块 ：Arduino官方Ethernet Shield W5500 或兼容板 1块。建议使用W5500芯片的版本，其硬件协议栈比旧的W5100更稳定高效。
• 状态指示 ：高亮LED（建议颜色：绿色×N，红色×1），数量取决于你想独立监控的设备数+1个总状态红灯。另需对应阻值的限流电阻（通常220Ω-1kΩ）。
• 告警输出 ：5V继电器模块（1路或多路）1个。用于控制外部拨号器。
• 电源 ：5V/2A以上的直流电源适配器1个，及对应的DC插头（通常为5.5*2.1mm）。
• 外壳 ：开源设计的激光切割亚克力板套件，或根据图纸自行切割。
• 辅助材料 ：杜邦线（公对公、母对母）、面包板（用于原型测试）、焊接工具、螺丝螺母包。

3.2 电路连接详解与原理

连接的核心是让Arduino能够控制网络、指示灯和继电器。以下是详细的接线图与原理说明。

1. 网络扩展板连接： 这是最简单的一步。直接将Ethernet Shield插在Arduino Mega 2560的插针上，确保方向正确、引脚对齐。它通过SPI总线（D50-D53引脚）与主控通信，并占用D10、D4、D5等引脚用于片选和中断。库文件会处理好底层驱动，我们无需手动接线。

2. LED指示灯电路： 每个LED需要串联一个限流电阻，然后连接到Arduino的数字IO口。这是最基础的数字输出电路。

• 原理 ：Arduino的IO口在输出模式下，可以输出5V高电平或0V低电平。当设置为 HIGH 时，电流从IO口流出，经过LED和电阻到GND，LED发光。限流电阻的作用是防止电流过大烧毁LED或IO口。电阻值R可以通过公式 R = (Vcc - Vf) / I 计算。其中Vcc=5V，Vf是LED正向压降（通常红/绿/黄LED约1.8-2.2V，蓝/白约3.0-3.4V），I是期望电流（通常3-20mA）。以绿色LED（Vf=2.1V， I=10mA）为例： R = (5 - 2.1) / 0.01 = 290Ω ，选择最接近的标准值330Ω即可。
• 接线示例 ：假设我们用D22控制“路由器状态”绿灯，D23控制“总故障”红灯。
  • LED长脚（正极）接330Ω电阻一端。
  • 电阻另一端接Arduino的D22（或D23）。
  • LED短脚（负极）接Arduino的GND引脚。

3. 继电器模块连接： 常见的5V继电器模块通常有3个输入引脚：VCC、GND、IN。

• 接线 ：VCC接Arduino 5V，GND接Arduino GND，IN接一个数字IO口（例如D24）。
• 工作原理 ：当Arduino向该IO口输出 HIGH （5V）时，继电器模块内部电路导通，继电器吸合，其公共端（COM）与常开端（NO）接通；输出 LOW 时，继电器释放，COM与常闭端（NC）接通。我们将外接拨号器的触发线接在COM和NO上，这样当故障发生时，Arduino输出 HIGH ，继电器吸合，相当于“按下”了拨号器的触发按钮，启动拨号告警流程。

实操心得 ：在焊接或使用面包板搭建原型时，务必先断开电源。使用万用表通断档检查线路，防止短路。给每个LED和继电器连接的IO口在代码中做好清晰的宏定义，例如 #define ROUTER_LED 22 ，这会极大提高代码的可读性和可维护性。

3.3 外壳的制作与组装

开源项目的一大亮点是提供了完整的激光切割图纸。你可以将图纸交给亚克力板加工商，或者如果有条件，自己用激光切割机完成。

1. 材料选择 ：推荐使用3mm厚的磨砂亚克力板，既能透光显示LED状态，又不会让内部电路一览无余，外观更精致。
2. 切割与处理 ：切割完成后，撕掉保护膜。对于需要安装按钮、LED的孔位，图纸已经设计好。如项目描述所说，如果需要额外的、非标淮的开孔（例如为未来扩展的传感器开孔），可以用记号笔标记，然后用美工刀（手术刀）和直尺，多次轻轻划切，最后小心掰下，边缘用砂纸打磨光滑。这种方法比用电钻或锉刀更容易获得整洁的方孔。
3. 组装 ：按照图纸说明，使用提供的螺丝螺母将六面亚克力板固定成一个立方体。建议先组装底部和四壁，将安装好元件的Arduino主板用铜柱或螺丝固定到底板上，连接好所有内部线缆，最后再盖上顶板。这样便于调试和维修。

4. 固件开发与核心代码剖析

硬件是躯体，固件（Firmware）则是灵魂。这部分代码负责实现所有的监控逻辑。

4.1 开发环境与库依赖

首先，你需要安装Arduino IDE，并导入必要的库：

• Ethernet库 ：通常Arduino IDE已内置。确保使用支持W5500的版本。
• ICMP Ping库 ：Arduino原生不支持 ping ，我们需要第三方库。推荐使用 Ethernet 库配合 ICMPPing 库，或者更通用的 ESP32Ping （但需调整）。这里我们使用一个名为 Ping 的库（作者可能是“Blake Foster”等），可以通过Arduino IDE的库管理器搜索“Ping”安装。
• 代码开头需要引入这些库：

#include <SPI.h>
#include <Ethernet.h>
#include <Ping.h>

4.2 网络配置与初始化

设备需要融入你的本地网络，并启动Web服务器。

// 网络配置
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED }; // 设置一个唯一的MAC地址
IPAddress ip(192, 168, 1, 177); // 为Ping-Cube设置静态IP，避免DHCP租约变化
IPAddress gateway(192, 168, 1, 1); // 你的路由器网关
IPAddress subnet(255, 255, 255, 0); // 子网掩码

EthernetServer server(80); // 在80端口创建Web服务器对象

void setup() {
  Serial.begin(9600);
  
  // 初始化以太网连接
  if (Ethernet.begin(mac) == 0) {
    Serial.println("Failed to configure Ethernet using DHCP");
    // 如果DHCP失败，则使用我们设置的静态IP
    Ethernet.begin(mac, ip, gateway, gateway, subnet);
  }
  server.begin(); // 启动Web服务器
  Serial.print("Server is at ");
  Serial.println(Ethernet.localIP());

  // 初始化LED引脚为输出模式
  pinMode(ROUTER_LED, OUTPUT);
  pinMode(ALARM_LED, OUTPUT);
  pinMode(RELAY_PIN, OUTPUT);
  digitalWrite(RELAY_PIN, LOW); // 确保继电器初始为断开状态
}

重要提示 ：务必为Ping-Cube设置静态IP（如上述代码），或者在你的路由器DHCP服务器中为其MAC地址分配固定的IP。这是保证你能通过浏览器稳定访问它的关键。

4.3 监控逻辑实现：Ping与状态机

核心监控逻辑是一个 状态机 。我们周期性地对每个目标IP执行 ping 操作，并根据连续成功/失败的次数来判断设备状态。

// 定义监控目标
IPAddress targetRouter(192, 168, 1, 1);
IPAddress targetNAS(192, 168, 1, 100);
// ... 可以定义更多目标

// 状态变量
bool routerOnline = false;
bool nasOnline = false;
int routerFailCount = 0;
const int MAX_FAIL_COUNT = 3; // 连续失败3次才判定为离线

unsigned long previousPingMillis = 0;
const long pingInterval = 5000; // 每5秒ping一次

void loop() {
  unsigned long currentMillis = millis();
  
  // 定时执行Ping任务
  if (currentMillis - previousPingMillis >= pingInterval) {
    previousPingMillis = currentMillis;
    
    // Ping 路由器
    bool routerPingSuccess = Ping.ping(targetRouter);
    updateDeviceStatus(routerPingSuccess, &routerFailCount, &routerOnline, ROUTER_LED);
    
    // Ping NAS
    bool nasPingSuccess = Ping.ping(targetNAS);
    updateDeviceStatus(nasPingSuccess, &nasFailCount, &nasOnline, NAS_LED);
    
    // 更新总警报状态
    updateGlobalAlarm();
  }
  
  // 处理Web客户端请求
  handleWebClient();
}

void updateDeviceStatus(bool pingSuccess, int* failCount, bool* onlineStatus, int ledPin) {
  if (pingSuccess) {
    *failCount = 0; // 成功则清零失败计数
    if (!(*onlineStatus)) {
      *onlineStatus = true;
      digitalWrite(ledPin, HIGH); // 在线，点亮绿灯
    }
  } else {
    (*failCount)++;
    if ((*failCount) >= MAX_FAIL_COUNT) {
      if (*onlineStatus) {
        *onlineStatus = false;
        digitalWrite(ledPin, LOW); // 离线，熄灭绿灯（或点亮红灯，取决于你如何设计）
      }
    }
  }
}

void updateGlobalAlarm() {
  bool anyOffline = !routerOnline || !nasOnline; // 检查是否有任何设备离线
  if (anyOffline) {
    digitalWrite(ALARM_LED, HIGH); // 点亮总报警红灯
    digitalWrite(RELAY_PIN, HIGH); // 吸合继电器，触发外部告警
  } else {
    digitalWrite(ALARM_LED, LOW);
    digitalWrite(RELAY_PIN, LOW);
  }
}

这段代码实现了一个简单的 防抖动（Debounce） 机制。单次 ping 失败可能是网络波动，因此我们引入 MAX_FAIL_COUNT （例如3次）。只有连续多次失败，才判定设备离线，这有效避免了误报。

4.4 Web服务器与状态页面

一个简单的Web服务器能让监控状态一目了然。我们在 handleWebClient() 函数中处理HTTP请求。

void handleWebClient() {
  EthernetClient client = server.available();
  if (client) {
    boolean currentLineIsBlank = true;
    while (client.connected()) {
      if (client.available()) {
        char c = client.read();
        if (c == '\n' && currentLineIsBlank) {
          // 发送标准的HTTP响应头
          client.println("HTTP/1.1 200 OK");
          client.println("Content-Type: text/html");
          client.println("Connection: close");
          client.println();
          // 发送HTML页面内容
          client.println("<!DOCTYPE HTML>");
          client.println("<html><head><title>Ping-Cube Network Status</title>");
          client.println("<meta http-equiv=\"refresh\" content=\"5\">"); // 每5秒自动刷新
          client.println("</head><body>");
          client.println("<h1>Network Monitor Dashboard</h1>");
          client.print("<p>Router (192.168.1.1): ");
          client.println(routerOnline ? "<span style=\"color:green;\">ONLINE</span>" : "<span style=\"color:red;\">OFFLINE</span>");
          client.print("</p>");
          client.print("<p>NAS (192.168.1.100): ");
          client.println(nasOnline ? "<span style=\"color:green;\">ONLINE</span>" : "<span style=\"color:red;\">OFFLINE</span>");
          client.println("</p>");
          client.println("<p><em>Page auto-refreshes every 5 seconds.</em></p>");
          client.println("</body></html>");
          break;
        }
        // ... 处理HTTP请求头（此处简化）
      }
    }
    delay(1); // 给浏览器一点接收数据的时间
    client.stop(); // 关闭连接
  }
}

这个简单的服务器会生成一个包含当前状态、并每5秒自动刷新的网页。你可以根据需要美化这个页面，加入CSS，甚至绘制成图表。

5. 调试、部署与高级扩展

代码写完、硬件焊好，接下来就是让整个系统跑起来，并思考如何让它更强大。

5.1 上电调试与常见问题排查

按照以下步骤进行系统调试：

1. 单独测试硬件 ：先不插网络扩展板，上传一个简单的 Blink 程序测试所有LED和继电器是否能被正确控制。
2. 连接网络 ：插上Ethernet Shield，上传完整代码。打开串口监视器（波特率9600），查看是否成功获取IP地址。
3. 测试Ping功能 ：在代码中暂时注释掉Web服务器部分，只保留Ping逻辑。通过串口监视器输出 ping 的结果，确认它能正确探测到目标IP。
4. 测试Web服务器 ：在同一局域网内的电脑浏览器中，输入Ping-Cube的IP地址，看是否能打开状态页面。
5. 模拟故障 ：拔掉某个被监控设备的网线，观察Ping-Cube的LED指示灯变化、Web页面状态更新以及继电器动作是否按预期进行。

常见问题与排查表：

问题现象	可能原因	排查步骤
串口显示“Failed to configure Ethernet”	网络线未接好；MAC地址冲突；路由器DHCP问题。	1. 检查网线，确保Ethernet Shield的Link灯亮。2. 尝试修改代码中的MAC地址最后一位。3. 直接使用静态IP配置（代码中已提供）。
Ping始终失败，但目标设备实际在线	防火墙阻止了ICMP回显请求；Ping库使用不当；目标IP错误。	1. 检查目标设备的防火墙设置，允许ICMP入站。2. 确保 Ping.ping() 函数参数正确（目标IP，超时时间，尝试次数）。3. 在电脑上用命令行 ping 该IP，确认可达。
Web页面无法访问	IP地址错误；浏览器缓存；代码中服务器未正确启动。	1. 从串口监视器确认Ping-Cube获取到的正确IP。2. 尝试使用浏览器无痕模式访问。3. 检查代码中 server.begin() 是否被执行。
继电器不动作	接线错误；IO口输出模式未设置；继电器模块需要高电平触发但输出低电平。	1. 用万用表测量继电器IN脚电压，触发时应接近5V。2. 确认代码中 digitalWrite(RELAY_PIN, HIGH); 被执行。3. 尝试将继电器IN脚接5V，看是否吸合，以测试继电器本身。
状态判断不稳定（频繁跳变）	网络延迟波动大； MAX_FAIL_COUNT 设置过小；Ping间隔太短。	1. 适当增加 MAX_FAIL_COUNT （例如5）。2. 增加 pingInterval （例如10000毫秒）。3. 考虑使用平均延迟或丢包率作为更复杂的判断依据。

5.2 部署与优化建议

• 位置选择 ：将Ping-Cube放置在网络中心位置，如路由器附近，确保其网络连接稳定。
• 电源保障 ：使用质量可靠的5V电源适配器。如果条件允许，可以考虑为其配备一个小型UPS（不间断电源），这样即使家庭短暂停电，它也能在路由器恢复供电后继续执行监控任务。
• 告警方式增强 ：
  • 电话告警 ：连接一个支持语音播报的GSM短信电话模块（如SIM800L），通过代码直接发送短信或拨打电话，无需外部分离的拨号器。
  • 互联网通知 ：集成Bark、PushDeer或企业微信/钉钉机器人API。当检测到故障时，通过HTTP请求发送告警信息到你的手机。这需要设备能访问互联网，并处理相应的JSON数据。
• 状态显示升级 ：增加一个I2C接口的OLED小屏幕，滚动显示所有监控目标的实时延迟和状态，比看网页更直观。

5.3 开源生态与社区贡献

正如项目初衷，Ping-Cube的所有设计文件、源代码都已在开源社区发布。你可以：

1. 复刻与修改 ：在GitHub或类似的代码托管平台找到项目仓库， Fork 一份到你自己的账户下，然后根据你的网络环境（监控IP、告警逻辑）修改代码。
2. 提交改进 ：如果你增加了新的功能（比如支持DNS解析主机名、增加历史日志记录），可以向原项目发起 Pull Request ，帮助完善这个项目。
3. 分享案例 ：将你的组装过程、遇到的问题和解决方案写成博客或教程，回馈社区。也许你的一个接线技巧或代码优化，就能帮到另一个遇到同样问题的爱好者。

这个项目的魅力在于，它从一个简单的需求出发，通过开源硬件和软件，变成了一个可深度定制、充满可能性的工具。它不仅仅是一个网络监控器，更是一个学习单片机编程、网络协议和系统设计的绝佳平台。从点亮第一个LED，到收到第一个自动拨打的告警电话，整个过程充满了动手的乐趣和解决问题的成就感。