在 Windows 上安装并运行 EMQX Edge

本指南帮助你在 Windows 上安装并运行 EMQX Edge，同时介绍 Windows 版本可用的功能，以及如何将 EMQX Edge 作为 Windows Service 运行。

你可以从 EMQX 网站下载 EMQX Edge Windows 发行版。

安装步骤

假设你已经下载 emqx-edge-1.1.0-windows-x86_64.zip：

1. 将 ZIP 压缩包解压到你选择的目录。

2. 打开 PowerShell，并进入包含 emqx-edge.exe 的解压目录：

   cd path\to\emqx-edge-1.1.0-windows-x86_64

3. 启动 EMQX Edge：

   ./emqx-edge start

4. 打开浏览器并访问 http://localhost:8081 进入 Dashboard。

   有关访问和使用 EMQX Edge Dashboard 的更多信息，请参见：访问 EMQX Edge Dashboard。

将 EMQX Edge 作为 Windows Service 启动

EMQX Edge 支持作为 Windows Service 运行，以便随系统自动启动。但该设置当前需要使用 Windows 工具 instsrv 和 srvany 手动配置。

注意： 该方式涉及编辑 Windows Registry。修改前请备份注册表。未来版本可能会提供更易用的方案。

第 1 步：下载并解压 EMQX Edge

1. 下载最新 Windows 版本 EMQX Edge，例如 emqx-edge-1.1.0-windows-x86_64.zip。
2. 将其解压到 C:\emqx-edge。

解压后的目录应包含类似以下文件：

ls C:\emqx-edge
Directory: C:\emqx-edge
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2025/9/25     11:14                dist
d-----         2025/9/25     11:14                etc
d-----         2025/9/25     11:14                tmp
-a----         2025/9/24     11:00          94325 libwinpthread-1.dll
-a----         2025/9/24     11:00           5405 nanomq.conf
-a----         2025/9/24     11:10        5920768 emqx-edge.exe
-a----         2025/9/24     11:00            191 nanomq.lic
-a----         2025/9/24     11:10        1961984 nanomq_cli.exe
-a----         2025/9/24     11:10             40 start.md

第 2 步：添加 instsrv 和 srvany

该步骤使用两个 Windows 工具 instsrv.exe 和 srvany.exe 设置 EMQX Edge service wrapper。这些工具允许普通可执行文件（emqx-edge.exe）以 Windows Service 方式运行。

1. 将 instsrv.exe 和 srvany.exe 复制到 C:\emqx-edge 目录。

   这些工具属于 Windows Server 2003 Resource Kit，可能需要从可信来源单独下载。

2. 以管理员身份打开 PowerShell。

3. 进入目录：

   cd "C:\emqx-edge"

4. 将 EMQX Edge 注册为服务：

   .\instsrv.exe EMQX-Edge C:\emqx-edge\srvany.exe

第 3 步：配置注册表

该步骤配置 EMQX Edge Windows Service，使其在正确目录中自动运行 emqx-edge.exe start。你需要使用 Windows Registry Editor 配置服务启动方式和要运行的可执行文件。

警告

编辑 Windows Registry 可能影响系统行为。请谨慎按照步骤操作，并在需要时备份注册表。

1. 在 PowerShell 终端或开始菜单中输入 regedit，启动 Registry Editor。

2. 在 Registry Editor 中进入以下路径，找到 EMQX-Edge Service：

   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EMQX-Edge

3. 在 Edit 菜单中（或右键点击 EMQX-Edge），选择 New -> Key。输入以下内容并点击 OK：

   Key Name: Parameters
   Class: <leave blank>

4. 选择新建的 Parameters key。

5. 在 Edit 菜单中（或右键点击右侧面板），选择 New -> String Value。输入以下内容并点击 OK：

   Value Name: Application
   Data Type: REG_SZ
   String: C:\emqx-edge\emqx-edge.exe

6. 重复该过程，添加接下来的两个字符串值：

   Value Name: AppDirectory
   Data Type: REG_SZ
   String: C:\emqx-edge\

   Value Name: AppParameters
   Data Type: REG_SZ
   String: start

这些注册表项会告知 Windows Service Manager，在启动 EMQX-Edge 服务时，从 C:\emqx-edge\ 目录运行 emqx-edge.exe start。

第 4 步：启动和停止服务

启动服务：

net start EMQX-Edge

停止服务：

net stop EMQX-Edge

你也可以在 Windows Task Manager -> Services 标签页中管理该服务。

Windows 功能支持

下表列出了 EMQX Edge Windows 版本可用的功能，以及平台特定支持和限制说明。

注意： 该功能列表基于 EMQX Edge v1.2.0。

Linux 版本默认支持所有列出的功能。在 Windows 上，部分功能因平台限制或依赖原因当前不可用。

Feature	Supported ✅ / ❌	Notes
MQTT Broker	✅	支持 MQTT v3.1、v3.1.1、v5.0
TCP Listener	✅	基于 TCP 的 MQTT 连接
TLS Listener	✅	静态构建，无需额外依赖
WS / WSS Listener	✅	WebSocket 和 Secure WebSocket 支持
MQTT Bridge	✅	跨 Broker MQTT 桥接
TCP Bridging	✅	MQTT over TCP 桥接
TLS Bridging	✅	MQTT over TLS 桥接
Dashboard	✅	用于配置和监控的 Web UI
REST API	✅	通过 REST 管理和操作 EMQX Edge
Authentication & Authorization	✅	支持配置文件、HTTP 和基于 ACL 的控制
Rule Engine	✅	事件处理和规则触发
SQLite Caching	✅	将消息持久化到 SQLite
WebHook	✅	使用用户自定义 hook 触发事件
CLI Tool	✅	用于快速调试的命令行接口
JWT Authentication	✅	支持通过 HTTP 使用 JWT
ZMQ Integration	❌	当前仅 Linux 支持
QUIC Bridging	❌	MQTT over QUIC 仅 Linux 支持