📚 课程目录第4章边缘节点部署

4. 边缘节点部署：硬件选型、系统裁剪与Agent安装

边缘节点部署这件事，说白了就是给云平台找一群靠谱的“哨兵”。

我在多个项目中踩过不少坑，从硬件选型到系统裁剪，每一步都有讲究。今天咱们就聊聊，怎么把边缘节点从零搭起来，让它稳定、安全、还能跟云平台好好配合。

4.1 硬件选型：别光看参数，得看场景

硬件选型是第一步，也是最容易出问题的一步。我见过有人拿工控机跑AI推理，结果散热跟不上；也有人用树莓派做视频流处理，结果带宽直接打满。

我个人习惯把边缘节点分成三类：

类型	典型场景	推荐配置	注意事项
轻量型	传感器数据采集、简单告警转发	ARM Cortex-A72, 2GB RAM, 32GB eMMC	功耗控制在5W以内，无风扇设计
标准型	视频流分析、本地规则引擎	x86 J4125, 8GB RAM, 128GB SSD	需要硬件编解码支持，注意散热
高性能型	AI推理、多路视频并发处理	NVIDIA Jetson Orin, 16GB RAM, 256GB NVMe	必须带GPU或NPU，预留PCIe扩展

我的经验：别只看CPU主频。边缘节点往往跑在恶劣环境里，宽温、防尘、防震比性能更重要。我曾经在工厂车间部署了一批普通工控机，三个月后坏了三台——全是灰尘堵了风扇。

4.2 操作系统裁剪：少即是多

边缘节点的操作系统，不能像服务器那样装个Ubuntu Desktop就完事。你想想看，一个只有2GB存储的设备，装个完整系统就占掉一半，哪还有空间跑业务？

我一般用Yocto或Buildroot做系统裁剪。核心原则就一条：只留必要的。

4.2.1 裁剪清单

内核模块：只保留网络、存储、GPIO、I2C、SPI等驱动，去掉蓝牙、Wi-Fi（除非需要）、声卡、显卡等
用户空间：busybox替代coreutils，dropbear替代openssh，去掉X11、桌面环境
运行时：只保留Docker或containerd，去掉snap、flatpak等包管理
日志系统：用systemd-journald替代rsyslog，限制日志大小

裁剪后的系统大小参考：

内核：8-15MB
根文件系统：50-80MB
Docker运行时：30-50MB
总计：100-150MB

4.2.2 裁剪示例（Buildroot配置片段）

# buildroot/.config 关键配置
BR2_arm=y
BR2_cortex_a72=y
BR2_TOOLCHAIN_EXTERNAL=y

# 只保留最小系统
BR2_PACKAGE_BUSYBOX=y
BR2_PACKAGE_DROPBEAR=y
BR2_PACKAGE_DOCKER_ENGINE=y
BR2_PACKAGE_CA_CERTIFICATES=y

# 去掉不需要的
# BR2_PACKAGE_XORG7 is not set
# BR2_PACKAGE_ALSA_UTILS is not set
# BR2_PACKAGE_WPA_SUPPLICANT is not set

# 内核配置
BR2_LINUX_KERNEL_CUSTOM_DTS_PATH="board/myedge/device-tree.dts"
BR2_LINUX_KERNEL_INTREE_DTS_NAME="myedge"

注意：裁剪时一定要保留ca-certificates包。边缘节点跟云平台通信全靠TLS，没有根证书，Agent连注册都过不去。我吃过这个亏，排查了一整天。

4.3 Agent安装与注册：让边缘节点“入网”

系统准备好了，接下来就是安装Agent。Agent是边缘节点跟云平台之间的桥梁，负责心跳上报、告警推送、配置下发。

4.3.1 Agent安装方式

我推荐两种方式：

容器化安装（推荐）：用Docker或Podman跑Agent镜像，方便升级和回滚
二进制安装：直接部署编译好的二进制文件，适合资源极度受限的设备

容器化安装示例：

# 拉取Agent镜像
docker pull registry.mycloud.com/edge-agent:2.1.0

# 运行Agent容器
docker run -d \
  --name edge-agent \
  --restart=always \
  --network=host \
  -v /etc/edge-agent:/etc/edge-agent \
  -v /var/log/edge-agent:/var/log/edge-agent \
  registry.mycloud.com/edge-agent:2.1.0 \
  --config /etc/edge-agent/config.yaml

4.3.2 注册流程

Agent启动后，需要向云平台注册。注册的核心是身份认证和设备绑定。

生成设备指纹：基于CPU序列号、MAC地址、TPM芯片生成唯一ID
获取注册令牌：从云平台管理界面生成一次性令牌
发起注册请求：Agent携带令牌和设备指纹，向云平台注册
下发证书：云平台验证通过后，下发TLS客户端证书
建立长连接：使用证书建立MQTT或gRPC连接，开始心跳

避坑指南：我曾经遇到过设备指纹重复的问题——同一批工控机的CPU序列号全是空的。后来我改用TPM芯片的EK公钥哈希作为指纹，才彻底解决。

4.3.3 注册配置示例

# /etc/edge-agent/config.yaml
agent:
  node_id: "edge-node-001"
  fingerprint_source: "tpm"  # 可选: cpu, mac, tpm
  register_token: "tok_xxxxxxxxxxxxx"

cloud:
  endpoint: "wss://cloud.myplatform.com/mqtt"
  ca_cert: "/etc/edge-agent/ca.pem"
  client_cert: "/etc/edge-agent/client.pem"
  client_key: "/etc/edge-agent/client.key"

heartbeat:
  interval: 30s
  timeout: 10s

logging:
  level: "info"
  max_size: 10MB
  max_files: 3

4.4 整体部署流程

把上面这些串起来，就是完整的边缘节点部署流程。我画了张图，方便你理解：

4.5 部署后的验证

节点部署完，别急着走。我习惯做三件事验证：

心跳检查：在云平台看节点是否在线，心跳间隔是否正常
告警注入测试：手动触发一个本地告警，看能否成功上报到云平台
断网恢复测试：拔掉网线，等几分钟再插上，看节点能否自动重连

验证命令示例：

# 检查Agent进程
ps aux | grep edge-agent

# 查看心跳日志
tail -f /var/log/edge-agent/heartbeat.log

# 手动触发测试告警
curl -X POST http://localhost:8080/api/v1/test-alert \
  -H "Content-Type: application/json" \
  -d '{"type":"temperature","value":85,"threshold":80}'

嗯，到这里边缘节点的部署就完成了。硬件选对、系统剪好、Agent装好、注册通过，剩下的就是让它在角落里默默干活了。