# 开始使用 (Get Started)

# EMQ X Edge 物联网边缘消息服务器简介

EMQ X Edge 边缘消息服务器是连接云端和本地设备之间的桥梁，作为物联网平台体系中的边缘计算节点上运行的消息代理，在边缘节点上使用业务规则引擎将大部分数据进行本地处理，也能够实时响应设备端的请求。

EMQ X Edge 与云端的 EMQ X 集群之间采用加密的传输协议，如果 Edge 节点和远程 EMQ X 之间由于传输网络问题导致连接断开，Edge 节点会自动保存指定的消息到本地的存储，并且在网络正常之后会自动将数据发送到云端的 EMQ X 集群。

EMQ X Edge 是基于 Erlang/OTP 平台开发的开源物联网 MQTT 消息服务器。Erlang/OTP 是出色的软实时(Soft-Realtime)、低延时(Low-Latency)、分布式(Distributed) 的语言平台。MQTT 是轻量的(Lightweight)、发布订阅模式(PubSub) 的物联网消息协议。

EMQ X Edge 产品特点:

多协议接入: EMQ Edge Broker 支持接入主流的物联网协议，以及支持自定义协议的扩展。
轻量级: EMQ X Edge 可以运行在各类工控机（支持 x86、ARM 架构）和树莓派等硬件上，支持各种流行的 Linux 发行版。软件安装包只有 20MB，对资源的消耗比较低，能轻松运行在各类边缘设备上。
消息路由和离线存储: 通过 EMQ X Edge 提供的消息路由和离线存储功能，可以实现对消息自动从边缘到云端的路由；同时在网络不可靠的时候实现本地的离线存储，网络恢复之后自动将本地缓存的消息发送到云端。
易管理: EMQ X Edge 可以通过 Dashboard 和 EMQ X edge stack (opens new window) 管理平台对边缘设备和集群进行可视化管理。
边缘端业务处理: EMQ X Edge 在边缘节点通过 MQTT 客户端消费、规则引擎、调用 Webhook 等方式和边缘计算服务连接，实现在边缘端的业务处理，减轻云端的业务处理瓶颈。

# 下载和安装

EMQ X Edge 支持 CentOS、Alpine、Raspbian、Debian、Ubuntu 等平台程序包与 Docker 镜像。

使用 Docker 快速启动:

# 拉取最新镜像
docker pull emqx/emqx-edge
# 启动容器并映射端口
docker run -d --name emqxedge -p 1883:1883 -p 18083:18083 emqx/emqx-edge

1
2
3
4
5

其他格式安装包下载地址: https://www.emqx.cn/downloads#edge (opens new window)

EMQ X Edge 消息服务默认允许匿名认证，启动后 MQTT 客户端可连接 1883 端口，启动运行日志输出在 log/ 目录。

# 源码编译

git clone https://github.com/emqx/emqx-rel.git

cd emqx-rel && make emqx-edge

cd _build/emqx-edge/rel/emqx && ./bin/emqx console

1
2
3
4
5

# 参考资料

EMQ X Edge 是基于 EMQ X Broker 的优化裁剪版本，大部分功能及使用方法与 EMQ X Broker 类似，本文档未尽事宜请参照以下资料：

EMQ X Broker 文档： https://docs.emqx.cn/cn/broker/latest (opens new window)
目录结构： https://docs.emqx.cn/cn/broker/latest/getting-started/directory.html (opens new window)
配置说明： https://docs.emqx.cn/cn/broker/latest/getting-started/config.html (opens new window)
管理控制台： https://docs.emqx.cn/cn/broker/latest/getting-started/dashboard.html (opens new window)

# EMQ X Edge 扩展插件列表

EMQ X Edge 支持丰富的扩展插件，包括扩展模块、多种认证方式、多种接入协议等，详细插件列表与插件机制参照： EMQ X 插件管理文档 (opens new window)

扩展插件通过 'bin/emqx_ctl' 管理命令行加载启用。例如启用 MySQL 认证插件:

./bin/emqx_ctl plugins load emqx_auth_mysql

# EMQ 边缘计算系列产品

EMQ X Kuiper (opens new window) : 基于 SQL 的轻量级边缘流式消息处理引擎，可以运行在资源受限的边缘设备上
EMQ X Neuron (opens new window) : 物联网边缘工业协议网关，数十种工业协议一站式接入，支持构建 5G 时代工业 4.0 平台
EMQ X Edge Stack (opens new window) : 整合了所有 EMQ 边缘软件，用户可以通过一键式部署开始使用 Edge Stack

# 开源 MQTT 客户端项目

GitHub: https://github.com/emqx (opens new window)

emqttc (opens new window)	Erlang MQTT客户端库
emqtt_benchmark (opens new window)	MQTT连接测试工具
CocoaMQTT (opens new window)	Swift语言MQTT客户端库
QMQTT (opens new window)	QT框架MQTT客户端库

Eclipse Paho: https://www.eclipse.org/paho/ (opens new window)

MQTT.org: https://github.com/mqtt/mqtt.github.io/wiki/libraries (opens new window)

← 概览 (Introduction) 程序安装 (Installation) →