本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
访问 emqx.io 获取完整文档、示例和指南。
。本项目旨在简化和自动化EMQX集群的配置过程。
EMQX Operator的核心功能包括但不限于:
简化EMQX部署:通过EMQX自定义资源声明EMQX集群并快速部署。详情请参见快速开始。
管理EMQX集群:自动化EMQX的运维操作,包括集群升级、运行时数据持久化、基于EMQX状态更新Kubernetes资源等。详情请参见管理EMQX。

| EMQX Enterprise 版本 | EMQX Operator 版本 | APIVersion | Kind |
|---|---|---|---|
| 5.6.0(含)~ 最新 | 2.2.24 ~ 最新 | apps.emqx.io/v2beta1 | EMQX |
| 5.1.1(含)~ 最新 | 2.2.0 ~ 最新 | apps.emqx.io/v2beta1 | EMQX |
| 5.0.0(含)~ 5.0.23 | 2.0.0, 2.0.1, 2.0.2, 2.0.3, 2.1.0, 2.1.1 | apps.emqx.io/v2alpha1 | EMQX |
| 4.4.14(含)或更高4.4.x | 2.1.0, 2.1.1 | apps.emqx.io/v1beta4 | EmqxEnterprise |
| 4.4.8(含)~ 4.4.14 | 1.2.6, 1.2.7, 1.2.8, 2.0.0, 2.0.1, 2.0.2, 2.0.3 | apps.emqx.io/v1beta3 | EmqxEnterprise |
| 4.4.6(含)~ 4.4.8 | 1.2.5 | apps.emqx.io/v1beta3 | EmqxEnterprise |
| 4.3.x(含)~ 4.4 | 1.2.1, 1.2.2, 1.2.3 | apps.emqx.io/v1beta3 | EmqxEnterprise |
| EMQX 开源版版本 | EMQX Operator 版本 | APIVersion | Kind |
|---|---|---|---|
| 5.6.0(含)~ 最新 | 2.2.24 ~ 最新 | apps.emqx.io/v2beta1 | EMQX |
| 5.1.1(含)~ 最新 | 2.2.0 ~ 最新 | apps.emqx.io/v2beta1 | EMQX |
| 5.0.14(含)~ 5.0.23 | 2.1.0, 2.1.1 | apps.emqx.io/v2alpha1 | EMQX |
| 5.0.8(含)~ 5.0.14 | 2.0.2 | apps.emqx.io/v2alpha1 | EMQX |
| 5.0.6(含)~ 5.0.8 | 2.0.0, 2.0.1, 2.0.3 | apps.emqx.io/v2alpha1 | EMQX |
| 4.4.14或更高4.4.x | 2.1.0, 2.1.1 | apps.emqx.io/v1beta4 | EmqxBroker |
| 4.4.6(含)~ 4.4.8 | 1.2.5 | apps.emqx.io/v1beta3 | EmqxBroker |
| 4.4.8(含)~ 4.4.14 | 1.2.6, 1.2.7, 1.2.8, 2.0.0, 2.0.1, 2.0.2, 2.0.3 | apps.emqx.io/v1beta3 | EmqxBroker |
| 4.3.x(含)~ 4.4 | 1.2.1, 1.2.2, 1.2.3 | apps.emqx.io/v1beta3 | EmqxBroker |
EMQX Operator要求Kubernetes集群版本>=1.24。
| Kubernetes 版本 | EMQX Operator 兼容性 | 说明 |
|---|---|---|
| 1.24(含)~ 最新 | 支持所有功能 | |
| 1.22(含)~ 1.23 | 支持,但不支持MixedProtocolLBService | EMQX集群在Load***类型的Service中只能使用一种协议(如TCP或UDP)。 |
| 低于1.22 | 不支持 | 会出现unknown field "x-kubernetes-validations" in io.k8s.apiextensions-apiserver.pkg.apis.apiextensions.v1.JSONSchemaProps]错误。 |
EMQX Operator的核心功能是监控Kubernetes API服务器中特定对象的变更,并确保运行中的EMQX部署与这些对象保持一致。
Operator对以下自定义资源定义(CRDs)生效:
有关EMQX的更多详情,请参见参考文档。
EMQX Operator会自动检测上述任何自定义资源对象的变更,并确保运行中的部署与变更保持同步。
如需快速上手,请参见快速开始文档。
| 公有云平台 | 部署指南 |
|---|---|
| AWS | 在Amazon Elastic Kubernetes Service上部署EMQX |
| Azure | 在Azure Kubernetes Service上部署EMQX |
| Google Cloud | 在Google Cloud GKE上部署EMQX |
| 阿里云 | 在阿里云ACK上部署EMQX |
| 华为云 | 在华为云CCE上部署EMQX |
| 腾讯云 | 在腾讯云TKE上部署EMQX |
make telepresence
./bin/telepresence connect
本仓库中的许多文件(API、配置、控制器、hack等)是自动生成的。在提交拉取请求前:
make和make manifests有关常见问题和常见问题解答(FAQ),请参见故障排除文档。
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429