扩展插件
- 扩展插件

扩展插件

EMQ X 消息服务器通过模块注册和钩子(Hooks)机制，支持用户开发扩展插件定制服务器认证鉴权与业务功能。

EMQ X 官方提供的插件包括：

插件	配置文件	说明
emqx_dashboard (opens new window) +	etc/plugins/emqx_dashbord.conf	Web 控制台插件(默认加载)
emqx_management (opens new window) +	etc/plugins/emqx_management.conf	HTTP API 与 CLI 管理插件
emqx_psk_file (opens new window) +	etc/plugins/emqx_psk_file.conf	PSK 支持
emqx_web_hook (opens new window) +	etc/plugins/emqx_web_hook.conf	Web Hook 插件
emqx_lua_hook (opens new window) +	etc/plugins/emqx_lua_hook.conf	Lua Hook 插件
emqx_retainer (opens new window) +	etc/plugins/emqx_retainer.conf	Retain 消息存储模块
emqx_rule_engine (opens new window) +	etc/plugins/emqx_rule_engine.conf	规则引擎
emqx_bridge_mqtt (opens new window) +	etc/plugins/emqx_bridge_mqtt.conf	MQTT 消息桥接
emqx_delayed_publish (opens new window) +	etc/plugins/emqx_delayed_publish.conf	客户端延时发布消息支持
emqx_coap (opens new window) +	etc/plugins/emqx_coap.conf	CoAP 协议支持
emqx_lwm2m (opens new window) +	etc/plugins/emqx_lwm2m.conf	LwM2M 协议支持
emqx_sn (opens new window) +	etc/plugins/emqx_sn.conf	MQTT-SN 协议支持
emqx_stomp (opens new window) +	etc/plugins/emqx_stomp.conf	Stomp 协议支持
emqx_recon (opens new window) +	etc/plugins/emqx_recon.conf	Recon 性能调试
emqx_reloader (opens new window) +	etc/plugins/emqx_reloader.conf	Reloader 代码热加载插件
emqx_plugin_template (opens new window) +	etc/plugins/emqx_plugin_template.conf	插件开发模版

其中插件的加载有四种方式：

默认加载
命令行启停插件
使用 Dashboard 启停插件
调用管理 API 启停插件

开启默认加载

如需在系统启动时就默认启动某插件，则直接在 data/loaded_plugins 配置入需要启动的插件，例如默认开启的加载的插件有：

emqx_management.
emqx_rule_engine.
emqx_recon.
emqx_retainer.
emqx_dashboard.

命令行启停插件

在运行过程中，我们可以通过 CLI 命令的方式查看可用的插件列表、和启停某插件：

## 显示所有可用的插件列表
./bin/emqx_ctl plugins list

## 加载某插件
./bin/emqx_ctl plugins load emqx_auth_username

## 卸载某插件
./bin/emqx_ctl plugins unload emqx_auth_username

## 重新加载某插件
./bin/emqx_ctl plugins reload emqx_auth_username

使用 Dashboard 启停插件

如果 EMQ X 开启了 Dashbord 的插件(默认开启) 还可以直接通过访问 http://localhost:18083/plugins 中的插件管理页面启停、或者配置插件。