# 边缘节点部署

> *“真正需要管理工具的，往往不是机房里那台 64 核 256GB 的服务器，而是弱电箱里那块连散热片都没有的 ARM 开发板。”*

---

## 真实场景

frpc-console 对边缘节点的支持，不是来自“市场调研”。

它来自以下设备：

- **全志 H3**（256MB / 512MB 内存），运行社区的精简版 ARMbian 或官方剪枝版 Debian，放在弱电箱里跑 frp 穿透
- **RK3506**（128MB / 256MB 版本共存），没有 Docker，甚至没有 systemd
- 老旧 ARM 开发板（ARMv7l / ARM-HF），原本可能是一块电视盒子，刷上 ARMbian 之后被重新利用

这些设备的共同特征：

- 存储介质：SD 卡 / eMMC（便宜，容量大，但读写速度不敏感）
- 内存：128MB ~ 512MB（**没有任何拓展条件**）
- 系统环境：极简化，不常用的工具基本都被剪枝，极端情况下很可能只有 Kernel + BusyBox + init
- 网络环境：长期在线，但带宽有限
- 物理位置：没有理由长期触及（弱电箱、吊顶、室外机柜）

它们承担的工作却并不边缘：

- 内网穿透
- 远程维护通道
- IoT 设备接入
- 边缘计算节点

---

## 边缘环境特征

### 存储 vs 内存：成本结构的倒挂

在边缘设备上，存储和内存的成本结构与服务器完全不同：

| | 服务器 | 边缘设备 |
|---|---|---|
| 存储 | 昂贵（NVMe SSD） | 便宜（SD 卡 / eMMC） |
| 内存 | 便宜（可扩展） | 昂贵（不可扩展，BGA 焊接） |

这意味着：

**镜像大几十 MB，可以接受。内存多占 10MB，不能接受。**

所以 frpc-console 的 Docker 镜像虽然包含了完整的构建环境和依赖，但它不会在运行时消耗额外内存。镜像大小和运行时内存占用，在边缘场景下是两个独立且优先级完全不同的指标。

### 缺失的依赖

边缘设备可能缺失以下内容：

- **Docker**：很多 ARMHF 设备跑不动 Docker，或者根本没有 Docker 的预编译包
- **systemd**：精简系统中可能只有 init 或 busybox-init
- **glibc**：某些环境只提供 uClibc 或 musl
- **包管理器**：内存小到一定程度的时候，它的存在堪称奢望

因此，**二进制部署是边缘节点的唯一可行方案**。

---

## frpc-console 对边缘节点的适配

### 1. 二进制静态编译

frpc-console 采用 Go 编写，编译时使用 `CGO_ENABLED=0`：

- 不依赖 glibc
- 单一二进制文件
- 可运行于 musl 环境（Alpine、BusyBox）
- 不需要任何运行时依赖

### 2. 多架构支持

| 架构 | 说明 |
|---|---|
| x86_64 / AMD64 | 标准服务器 |
| ARM64 / Aarch64 | 现代 ARM 设备（树莓派 3/4/5） |
| ARMHF / ARMv7l | 老旧 ARM 设备（全志 H3、RK3506） |

### 3. 无 systemd 运行方式

在只有 init + BusyBox 的环境中：

```bash
# 直接运行
./frpc-console &

# 或通过 init 启动（写入 /etc/init.d/）
```

frpc-console 自身会通过 `Setsid` 为 frpc 创建独立会话，确保 frpc 在 console 退出后仍被 PID 1 接管。

### 4. 数据目录设计

```
/opt/frpc-console/data/
├── frpc-console.db    # SQLite 数据库
├── frpc.toml          # FRP 配置文件
├── frpc               # FRP 二进制（内置，无需额外下载）
├── frpc.pid           # frpc 进程 PID
├── frpc.log           # frpc 日志（可选）
└── version.ini        # 当前版本标识
```

所有数据在同一个目录下，备份只需复制整个文件夹。

### 5. 无日志默认策略

边缘设备存储有限，所以：

- 默认不写入日志文件
- 日志仅在用户明确开启时写入
- 避免 SD 卡被日志写满导致设备不可用

---

## 部署注意事项

### 推荐的最小硬件规格

| 场景 | CPU | 内存 | 存储 |
|---|---|---|---|
| 最小运行 | ARMv7 / ARM-HF | 128MB | 50MB（二进制 + 数据库） |
| 推荐运行 | ARMv7 / ARM64 | 256MB | 100MB |
| 舒适运行 | ARM64 / x86_64 | 512MB | 200MB |

### 不建议部署的场景

- **内存低于 64MB**：很极限，需要系统本身有极强的剪枝水准，以保证基础内存消耗不高于20M，但这并不现实
- **存储低于 20MB**：没有足够的空间存放二进制和数据
- **内核版本过低**（< 3.x）：某些系统调用可能不支持
- **刷了OpenWRT的软/硬路由**：这种建议去下opkg的源包，而不是看向我们这个项目。

### 网络要求

- 边缘节点的网络出口带宽一般有限，首次访问 WebUI 时加载的静态资源（约 1-2MB）可能需要稍长时间
- 后续操作仅传输 JSON 数据，流量极小

---

## 为什么这件事值得单独记录？

因为主流开源项目在讨论 ARM 支持时，讨论的是“树莓派 4B（4GB 版本）”。

而真正部署在边缘的设备，可能只有 256MB 内存，甚至连 Docker 都没有。

frpc-console 对 ARMHF 的支持，不是“支持的架构列表里多了一项”，而是：

**这个工具可以跑到那些真正藏在弱电箱里、承担网络基础设施工作的小板子上。**

这才是边缘节点部署的意义。