create emqx project

zhanghongtong bfc6c3aa42 chore(release): update emqx release version пре 4 година
.ci b92940af29 test(ci): add plugin list status check after relup new vsn install пре 4 година
.github 2c0916ff05 chore(CI): upload rebar3.crashdump file when slim build failure пре 4 година
apps 1a438125c7 chore(review): review 4.3.4 пре 4 година
bin 99c22eb2a8 fix(relup): fix relup badfun пре 4 година
data 3aba50605a chore(nodetool): ensure correct lib dirs пре 4 година
deploy 6b8910e26c feat(helm): Add flag to force pod recreation as part of helm upgrade (#4898) пре 4 година
etc 1f57968c9b chore(conf): change default number of gen_rpc connections to 1 пре 4 година
include bfc6c3aa42 chore(release): update emqx release version пре 4 година
lib-ce b92940af29 test(ci): add plugin list status check after relup new vsn install пре 4 година
lib-extra 6a07c8ef6d chore(extra-plugin): statement plugin tag пре 4 година
priv 69ef5cbdc3 Merge pull request #4979 from zmstone/chore-config-rpc-connections-default-to-one пре 4 година
scripts b92940af29 test(ci): add plugin list status check after relup new vsn install пре 4 година
src 1a438125c7 chore(review): review 4.3.4 пре 4 година
test cddfa928b1 test: deterministic tests пре 4 година
.editorconfig 7f12db0180 add editorconfig for emqx пре 7 година
.gitattributes b397b56db7 chore(gitattributes): fix file classification. пре 4 година
.gitignore 6595d53962 build(relup): update build script for support relup пре 4 година
.tool-versions 61bd95fdde build: pin otp 24 for dev пре 4 година
CONTRIBUTING.md ca47dae699 docs: format contributing пре 5 година
LICENSE 94c3e69b44 Licensed under the Apache, Version 2.0 пре 10 година
Makefile 0452bdb056 build: upgrade to rebar3 version 3.14.3-emqx-8 пре 4 година
README-CN.md ad7628dd24 docs(README): add youtube channel badge пре 4 година
README-JP.md ad7628dd24 docs(README): add youtube channel badge пре 4 година
README-RU.md ad7628dd24 docs(README): add youtube channel badge пре 4 година
README.md ad7628dd24 docs(README): add youtube channel badge пре 4 година
Windows.md 96bd561790 feat(windows): Support environment variable override for windows пре 4 година
build 934d3c405d chore(CI): update build workflows пре 4 година
docker.mk cd53568f36 build: pin otp 23.2.7.2-emqx-2 пре 4 година
elvis.config 5b126d60ad style(elvis): force spaces around | and || пре 4 година
pkg-vsn.sh 387d7f5913 chore(pkg-vsn.sh): add some comments пре 4 година
rebar.config 0184a1b3e8 fix(minirest): encode response message failed (#4965) пре 4 година
rebar.config.erl bed45417dc chore(relup): add relup dependency injection пре 4 година

README-CN.md

EMQ X Broker

GitHub Release Build Status Coverage Status Docker Pulls Slack Invite Twitter Community YouTube

最棒的物联网 MQTT 开源团队期待您的加入

English | 简体中文 | 日本語 | русский

EMQ X 是一款完全开源,高度可伸缩,高可用的分布式 MQTT 消息服务器,适用于 IoT、M2M 和移动应用程序,可处理千万级别的并发客户端。

从 3.0 版本开始,EMQ X 完整支持 MQTT V5.0 协议规范,向下兼容 MQTT V3.1 和 V3.1.1,并支持 MQTT-SN、CoAP、LwM2M、WebSocket 和 STOMP 等通信协议。EMQ X 3.0 单集群可支持千万级别的 MQTT 并发连接。

安装

EMQ X 是跨平台的,支持 Linux、Unix、macOS 以及 Windows。这意味着 EMQ X 可以部署在 x86_64 架构的服务器上,也可以部署在 Raspberry Pi 这样的 ARM 设备上。

Windows 上编译和运行 EMQ X 的详情参考:Windows.md

EMQ X Docker 镜像安装

docker run -d --name emqx -p 1883:1883 -p 8081:8081 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx

二进制软件包安装

需从 EMQ X 下载 页面获取相应操作系统的二进制软件包。

从源码构建

3.0 版本开始,构建 EMQ X 需要 Erlang/OTP R21+。

4.3 及以后的版本:

git clone https://github.com/emqx/emqx.git
cd emqx
make
_build/emqx/rel/emqx/bin console

对于 4.3 之前的版本,通过另外一个仓库构建:

git clone https://github.com/emqx/emqx-rel.git
cd emqx-rel
make
_build/emqx/rel/emqx/bin/emqx console

快速入门

如果 emqx 从源码编译,cd _build/emqx/rel/emqx。 如果 emqx 通过 zip 包安装,则切换到 emqx 的根目录。

# Start emqx
./bin/emqx start

# Check Status
./bin/emqx_ctl status

# Stop emqx
./bin/emqx stop

EMQ X 启动,可以使用浏览器访问 http://localhost:18083 来查看 Dashboard。

测试

执行所有测试

make eunit ct

执行部分应用的 common tests

make apps/emqx_bridge_mqtt-ct

静态分析(Dialyzer)

分析所有应用程序
make dialyzer
要分析特定的应用程序,(用逗号分隔的应用程序列表)
DIALYZER_ANALYSE_APP=emqx_lwm2m,emqx_auth_jwt,emqx_auth_ldap make dialyzer

社区

FAQ

访问 EMQ X FAQ 以获取常见问题的帮助。

问答

GitHub Discussions EMQ 中文问答社区

参与设计

如果对 EMQ X 有改进建议,可以向EIP 提交 PR 和 ISSUE

插件开发

如果想集成或开发你自己的插件,参考 lib-extra/README.md

联系我们

你可通过以下途径与 EMQ 社区及开发者联系:

欢迎你将任何 bug、问题和功能请求提交到 emqx/emqx

MQTT 规范

你可以通过以下链接了解与查阅 MQTT 协议:

MQTT Version 3.1.1

MQTT Version 5.0

MQTT SN

开源许可

Apache License 2.0, 详见 LICENSE