FasterEdge
对称的云边协作组件框架 · 对称、可靠、安全的多场景边缘计算框架
架构理念
Core framework + External components
主框架负责统一的组件模型、生命周期与调用协议;外置组件负责进程管理、代理、WebShell、时间服务和工业协议桥接。
数据流示例
NetMapAbility → OneKeyAbility → FileTransferAbility → AlgorithmDistributionAbility → DontCrack
NetMapAbility 注册节点 → OneKeyAbility 签发短期令牌 → FileTransferAbility 上传算法包 → AlgorithmDistributionAbility 记录并分发版本 → DontCrack 托管目标业务进程。
Thread safety
sync.RWMutex / atomic · strict-typed args
核心组件使用 sync.RWMutex / atomic 保护共享状态;命令参数为严格类型,nil、类型错误与空白必填字段统一返回 types.ErrInvalidArguments。
Reliability boundary
FasterEdge / DontCrack / Transport
FasterEdge 管理组件注册、命令调用与 Runner 生命周期;DontCrack 管理独立 OS 进程的启停、探针与自动重启;Docker/Kubernetes 通过注入的 Transport 对接;ProxyArea 与 SimpleWebShell 属于高权限网络组件,需配置认证与网络边界。
核心组件
FasterEdge 框架的五大原子抽象
Atom
节点内所有 Data 与 Ability 的容器。注册名称必须唯一;查找返回接口而不是内部 map,负责注册、查找与生命周期编排。
Data
节点状态与配置,承载持久化或运行时数据。当前标准骨架内置 BaseData / NetMapData / KeyringData / ConfigData,支持用户自定义扩展。
内置 10 个 Data:Base / NetMap / Keyring / Config / MySQL / PostgreSQL / SQLite / Redis / MongoDB / InfluxDB;数据库密码与 Token 仅保存在 Data 私有内存,快照与 JSON 序列化均不返回明文,支持用户自定义扩展。
Ability
节点能力,通过统一 Command(atom, act, args) 暴露严格类型命令;当前覆盖 Time / NetMap / OneKey / Role / Terminal / Industrial / Container,可选实现 Runner / Unmounter 等扩展接口。
内置 21 个 Ability:Base / Role / Time / NetMap / OneKey / CloudRole / EdgeRole / Cmd / Sh / Bash / ConfigFile / FileTransfer / AlgorithmDistribution / Modbus / Serial / TSN / MQTT / InfluxDB / EKuiper / Docker / Kubernetes;外部依赖统一经 Transport 注入。
Command
Ability 与 Data 的统一调用入口。Command(atom, act, args) 返回 CommandOutput: Name / Value / Err。参数为严格类型,nil / 类型错误 / 空白必填字段统一返回 types.ErrInvalidArguments。
Command(atom *types.Atom, act string, args any) 返回 CommandOutput: Name / Value / Err。
Transport
外部依赖抽象。由使用方注入网络、MQTT、Docker、K8s、串口、Modbus、HTTP 等真实驱动;单测可注入 fake Transport。框架不绑定具体 SDK。
不直接绑定 SDK,而是定义 Transport 接口;使用方注入网络、MQTT、Docker、K8s、串口、Modbus、HTTP 等真实驱动,单测可使用 fake Transport。
开源组件
FasterEdge 组织的全部公开仓库:主框架、组件集、硬件移植、模型工具链与边缘操作系统
[主框架与运行时]主框架、完整示例与离线模拟编排器3
[工具集]运维、调试、转换与可视化工具12
SimpleWebShell
通用 WebShell:GET/POST 命令执行、会话持久化、文件上传下载与 RESTful API,仅用于已授权设备。
→ GitHub[desktop]SimpleWebShell-Desktop
SimpleWebShell 桌面客户端(Tauri 2 + Vue 3):把多个远程服务集中到设备列表,统一连接、执行命令与管理会话。
→ GitHub[cli]SimpleWebShell-RemoteUpdate
基于 SimpleWebShell 的非侵入式远程更新工作流:不落盘常驻 agent,按工作流步骤推送并执行更新。
→ GitHub[service]SimpleTimeService
本地与 NTP 时间服务:JSON 接口输出本地时间、可偏移时间与 NTP 校时结果,统一 RFC3339Nano 格式。
→ GitHub[cli]Any2UTF8
文本 / 文件转 UTF-8 工具:批量探测编码并转写,兼作 FasterEdge 系统初始工具。
→ GitHub[cli]Any2Pcd
文本 / 二进制点云转 PCD 工具:多源点云统一为 PCD 并保持时序。
→ GitHub[cli]MiniGreat-Sender
全方面多协议请求调试发送工具:构造并发送各类协议请求,便于联调。
→ GitHub[service]MiniGreat-Receiver
全方面多协议调试接收工具:捕获并回显任意协议请求内容。
→ GitHub[web]ImageMarker
免费在线照片标注工具:浏览器打开即用,用于数据集标注与框选。
→ GitHub[web]NetMap
网络拓扑管理器:带 Web 前端的独立节点拓扑可视化管理,对应 NetMapData / NetMapAbility。
→ GitHub[service]FasterEdge2Api
FasterEdge 集群拓扑与管理操作 HTTP API:把集群节点与能力统一暴露为 HTTP 接口。
→ GitHub[cli]FasterEdgeDoctor
FasterEdge 诊断工具:本地与远端一键体检,覆盖主仓库与 MCU / FPGA 移植仓的工具链、工程标记检查。
→ GitHub[进程托管]跨平台进程托管与统一管理7
DontCrack4Windows
Windows 进程托管:捕获 stdout/stderr、自动重启、健康探针、Prometheus 指标与 Web UI,托管 .exe / .bat / .cmd / .ps1。
→ GitHub[supervisor]DontCrack4ManyLinux
通用 Linux(manylinux)进程托管:跨架构免 CGO,通过 systemd unit 或 CLI 拉起子进程。
→ GitHub[supervisor]DontCrack4Mac
macOS 进程管理器(Mach-O / universal binary):托管原生应用与命令行进程,提供探针与自动重启。
→ GitHub[supervisor]DontCrack4AndroidLinuxKernelSide
Android Linux Kernel 进程托管:通过 init.rc service 接入,自动识别 Android shell 路径。
→ GitHub[supervisor]DontCrack4OpenHarmonyLinuxKernelSide
OpenHarmony Linux Kernel 进程托管:通过 init.cfg 接入,避免格式错误导致卡开机。
→ GitHub[manager]DontCrack-Manager
DontCrack 多进程根管理器:同时拉起并监管多个 DontCrack 实例,适合无进程管理器的精简系统。
→ GitHub[desktop]DontCrack-Desktop
DontCrack 统一管理桌面工具(Tauri 2 + Vue 3):集中查看多主机进程状态、日志与探针结果。
→ GitHub[网络与协议]代理、消息、流分析与视频流转码6
ProxyArea
轻量 REST 兼容 HTTP 转发器:纯 Go 标准库实现,固定路由按字节保留 body,支持目标白名单、超时与 Bearer / Key 认证。
→ GitHub[service]MqttBroker
MQTT Broker 封装板:开箱即用的 Broker 发行包,含配置、持久化与部署文件。
→ GitHub[library]MqttBrokerCore
轻量 MQTT 3.1.1 代理核心(基于 Hrotti):可作库集成,支持 TCP / WebSocket 多监听、QoS 0/1/2、遗嘱与保留消息。
→ GitHub[engine]B2C
超轻量物联网边缘流式分析引擎:LF Edge eKuiper 增强分支,用 SQL / Graph 规则在边缘完成接入、转换、分析与转发。
→ GitHub[service]RTSP2Other
多路 RTSP 视频流转码工具:Go 统一管理 ffmpeg 子进程,一路输入稳定输出任意多路,各输出独立重启互不影响。
→ GitHub[bridge]TsnHub
基于 open62541 的 TSN 仿真中间节点:在 OPC UA PubSub 收发之间加入用户态 TSN 调度器,模拟队列、优先级、门控与丢包。
→ GitHub