Industrial Edge Gateway

中文文档站点 | English

Edge X（工业边缘网关）是一款轻量级工业边缘计算网关软件，面向制造、能源、楼宇等现场部署。后端采用 Go，管理界面采用 Vue 3 + Vuetify。

产品概览

EdgeX 部署在工业现场，使命是打通 OT 设备 ↔ IT 系统 的数据通道——南向统一接入、边缘就地处理、北向灵活对接，一机完成采集到上报的闭环。功能覆盖南向 12 协议、边缘规则与北向多通道集成，并以工业级 SLA 与 Soak 长稳验证保障现场长期可靠运行。

• 统一接入：异构 PLC、表计、楼宇与网络设备，一套网关采集
• 边缘智能：本地规则与派生点位，联动控制、减轻上行
• 开放集成：对接云平台、SCADA 与企业应用，支持反向写控
• 工业级稳定：内置指标门控、Soak 长稳回归与 CI 五 gate，SLA 可观测、可验证

能力与指标详见 产品优势；完整说明见 产品说明（源码）。

为何叫 EdgeX？

每个工业现场都有一批「还没被接进来」的设备与数据——不同协议、不同年代、不同厂商，各自沉默在 OT 一侧。它们像是一群尚未被发现的潜能：有价值，却还没进入 IT 的视线。

我们把这个未知数叫作 X。

Edge 是它们所在的地方：产线旁的控制柜、楼宇的弱电间、站场的边缘机柜——离数据源最近、也最该做决策的位置。X 则是现场的交叉点：多协议在此汇聚，边缘规则在此运行，OT 与 IT 在此第一次真正对话。

如果你熟悉 X 战警，会认出这个隐喻：每个成员能力各异，组合起来才能守护一个复杂世界。EdgeX 的 12 种南向协议也是如此——Modbus、S7、OPC UA……各自施展所长，在边缘组成一支协同团队，把采集、派生计算与北向上报串成闭环。

EdgeX 因此不是两个字母的简单拼接，而是 Edge（边缘）+ X（未知潜能的交叉点）：部署在现场侧的那支「X 因子」——让沉默的设备开口说话，让边缘智能成为工业现场的可靠超能力，并以 SLA 与 Soak 长稳验证，把这种能力交付为可观测、可验证的工程承诺。

产品优势

工业级稳定性是 EdgeX 的核心卖点：在功能丰富（12 协议南向、规则引擎、北向多通道）的同时，通过内置指标门控、Soak 长稳回归与 CI 五 gate 持续验证 SLA，保障现场长期可靠运行。

EdgeX 产品能力分层总览：接入 → 采集 → 边缘 → 北向 → 质量层

完整说明见 产品说明 — 产品优势（源码）。

工业级 SLA 与稳定性验证

EdgeX SLA 验证闭环：运行时监测 → 可观测 → CI/Soak 验证

统计 SLA（非硬实时 PLC），内置门控与 GET /api/diagnostics/scan-engine 可观测。验证链路覆盖：运行时指标监测 → 诊断 API 可观测 → CI 五 gate 回归 → Soak 长稳验证。阈值定义、万 Tag 压测、Soak 长稳与部署建议见 产品说明 — 工业级 SLA（源码）；运维操作见 用户手册 — 运维诊断与 SLA 监控。

轻量灵活部署

功能索引

文档导航

架构图、组件职责与数据路径等运行时细节见 文档站点（本地源码见 docs/）：

部署流程

1. 编译方式

一键多平台打包（推荐）

项目使用 GoReleaser（.goreleaser.yml）统一构建前端与后端，并生成分平台安装包。GoReleaser 内置 nfpm，用于生成 .deb 包，无需单独安装 nfpm。

# 安装 GoReleaser（任选其一）
go install github.com/goreleaser/goreleaser/v2@latest
# 或 brew install goreleaser

# 在仓库根目录执行：清理 dist/ 并构建（snapshot 模式，不发布 GitHub Release）
goreleaser release --snapshot --clean

构建流水线（before.hooks）：

1. go mod tidy — 整理 Go 依赖
2. npm run build --prefix ./ui — 构建 Vue 前端至 ui/dist/

交叉编译目标（CGO_ENABLED=0，入口 ./cmd/main.go，二进制名 edgex）：

产物目录 ./dist/：

手动编译（开发 / 单平台）

git clone https://github.com/anviod/edgex.git
cd edgex
go mod tidy

# 后端：静态编译，无 CGO 依赖
CGO_ENABLED=0 go build -o edgex ./cmd/main.go

# 前端（生产环境推荐，产物由后端托管 ui/dist）
cd ui && npm install && npm run build && cd ..

2. 目录与配置

首次启动若 data/config.db 不存在，网关以安装模式启动，通过 Web UI 完成初始化。

3. 启动服务

# 默认配置目录 ./conf，HTTP 端口见 server 配置（常见 8080/8082）
./edgex

# 指定遗留 YAML 迁移目录
./edgex -conf ./conf/

访问 http://localhost:<port> 进入管理界面。默认账号见安装向导或 conf/users.yaml。

4. 生产部署参考

• systemd 服务、防火墙端口、配置初始化：见 用户手册 — 部署流程（源码）
• EdgeOS 集成与北向通道：见 EdgeOS 快速入门（源码）
• 多从站 Modbus 配置：见 多从站快速入门（源码）
• 完整部署文档索引：GitHub Pages 部署指南 · 源码

文档索引

分支与协作

日常开发在 **dev** 分支进行；功能与修复 PR 请以 **dev** 为合并目标。main 保留为稳定发布线，由维护者从 dev 按需合并。

快速开始（开发）

go mod tidy
go run cmd/main.go          # 后端，默认 -conf ./conf
cd ui && npm install && npm run build && cd ..   # 前端（可选）

# 短测门控（详见 test/README.md）
make test-short

默认管理端口取决于 server 配置；BACnet 需开放 UDP 47808。

相关文档

• 产品说明：在线阅读 · 源码
• 用户手册：在线阅读 · 源码

English documentation: README.en.md