什么是 MQTT.Cool？

MQTT.Cool 是一个网关，旨在通过扩展现有 MQTT 代理的原生功能，为其添加新的开箱即用的实用特性。

有关 MQTT.Cool 服务器及相关产品的更多信息和下载，请访问 mqtt.cool。

![]([***]

如何使用此镜像

启动与运行

使用默认配置启动容器：

$ docker run --name mc-server -d -p 8080:8080 mqttcool/mqtt.cool

此命令会将容器内的 8080 端口映射到本地主机的 8080 端口。然后在浏览器中访问 http://localhost:8080，即可看到欢迎页面，从该页面可启动测试客户端（一个用于测试 MQTT.Cool 服务器与任何外部 MQTT 代理之间交互的便捷工具）。

此外，你可以跳转到 GitHub 上的源代码示例。

自定义设置

可以自定义容器中运行的 MQTT.Cool 实例的各个方面。例如，可按如下方式提供特定的配置文件：

$ docker run --name mc-server -v /path/to/my-mqtt_master_connector_conf.xml:/mqtt.cool/mqtt_connectors/mqtt_master_connector_conf.xml -d -p 8080:8080 mqttcool/mqtt.cool

同样，你可以提供自定义的日志配置，此时可能还需要指定专用卷以确保日志文件的持久化和容器的更好性能：

$ docker run --name mc-server -v /path/to/my-mqtt_master_connector_log_conf.xml:/mqtt.cool/mqtt_connectors/mqtt_master_connector_conf.xml -v /path/to/logs:/mqtt.cool/logs -d -p 8080:8080 mqttcool/mqtt.cool

如果在 my-mqtt_master_connector_log_conf.xml 文件中将默认日志路径从 ../logs 更改为 /path/to/dest/logs，则命令如下：

$ docker run --name mc-server -v /path/to/my-mqtt_master_connector_log_conf.xml:/mqtt.cool/mqtt_connectors/mqtt_master_connector_conf.xml -v /path/to/hosted/logs:/path/to/dest/logs -d -p 8080:8080 mqttcool/mqtt.cool

或者，可通过 Dockerfile 构建新镜像来完成上述任务，如下所示：

FROM mqttcool/mqtt.cool

# 仅为所需的自定义配置文件指定 COPY 命令
COPY my-mqtt_master_connector_conf.xml /mqtt.cool/mqtt_connectors/mqtt_master_connector_conf.xml
COPY my-mqtt_master_connector_log_conf.xml /mqtt.cool/mqtt_connectors/mqtt_master_connector_log_conf.xml

其中 my-mqtt_master_connector_conf.xml 和 my-mqtt_master_connector_log_conf.xml 是你的自定义配置文件，需放在与 Dockerfile 相同的目录中。只需运行以下命令：

$ docker build -t my-mqttcool .

即可构建包含所提供文件的新镜像。之后，启动容器：

$ docker run --name mc-server -d -p 8080:8080 my-mqttcool

有关如何配置 MQTT.Cool 服务器的更多详细信息，请参阅安装目录下 mqtt_connectors 文件夹中的 mqtt_master_connector_conf.xml 和 mqtt_master_connector_log_conf.xml 文件中的内联文档。

Web 服务器页面部署

在某些情况下，你可能希望为 MQTT.Cool 服务器的内部 Web 服务器提供自定义页面。此时，也可使用上述相同的方法自定义容器。

例如，通过以下命令可以完全替换默认的 pages 文件夹：

$ docker run --name mc-server -v /path/to/custom/pages:/mqtt.cool/pages -d -p 8080:8080 mqttcool/mqtt.cool

其中 /path/to/custom/pages 是主机中包含替换 Web 内容文件的路径。

许可证

查看此镜像中包含的软件的 许可证信息。