dersimn/mqtt-smarthome-webui
dersimn
自动构建
这是一个用于智能家居的Web界面Docker镜像，支持通过WebSocket连接MQTT broker，提供自定义页面结构配置，支持SSL/HTTPS及客户端认证，适用于智能家居设备监控与控制。
下载次数: 0状态：自动构建维护者：dersimn仓库类型：镜像最近更新：4 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
!https://raw.githubusercontent.com/dersimn/mqtt-smarthome-webui/master/docs/title.png
镜像概述
dersimn/mqtt-smarthome-webui 是一个用于构建智能家居Web界面的Docker镜像，通过WebSocket与MQTT broker通信，支持自定义页面结构配置，提供安全访问控制及日志功能，适用于智能家居系统的设备监控与控制场景。
支持的标签
- 标签基于SemVer规范，例如：
2、2.1、2.1.6指向同一镜像（至少在某一时间点）。 - 简单版本标签会在基础镜像更新时同步更新，因此例如
2.1.6在Docker Hub上基础镜像更新后会有不同的SHA值。 - 若需固定使用同一镜像且不接收更新，可使用时间戳标签，例如：
2.1.6-build20230915T0815。
核心功能与特性
- 自定义页面结构：通过
data.yaml配置文件定义Web界面布局 - MQTT WebSocket代理：支持通过环境变量
WS_PROXY代理MQTT broker的WebSocket连接 - SSL/HTTPS支持：可通过提供SSL证书启用HTTPS加密访问
- 客户端认证：支持基于SSL证书的客户端身份验证
- 访问控制：内置本地IP白名单，可自定义IP范围
- 详细日志：支持启用详细访问日志，兼容logfmt格式
使用场景
- 智能家居系统的Web监控面板
- MQTT设备状态可视化与控制界面
- 本地或远程访问的智能家居控制中心
配置与使用方法
基础配置
需提供data.yaml文件定义页面结构，参考https://github.com/dersimn/mqtt-smarthome-webui/blob/master/www/data.yaml%E3%80%82
通过环境变量WS_PROXY设置MQTT broker的WebSocket代理，需先在broker上启用WebSocket（参考https://hub.docker.com/_/eclipse-mosquitto%E7%9A%84https://github.com/dersimn/mqtt-smarthome-webui/tree/master/contrib%EF%BC%89%E3%80%82
基础启动命令：
bashdocker run -d --restart=always \ -v $(pwd)/yourconfig.yaml:/www/data.yaml:ro \ --add-host=host.docker.internal:host-gateway \ -e "WS_PROXY=host.docker.internal:9001" \ -p 80:80 \ docker.xuanyuan.run/dersimn/mqtt-smarthome-webui
SSL / HTTPS 配置
通过挂载/ssl目录提供SSL证书对可启用HTTPS：
/ssl/nginx.key：SSL私钥/ssl/nginx.crt：SSL证书
如需启用客户端证书认证，需额外提供：
/ssl/client.crt：客户端CA证书
若需吊销客户端，可提供：
/ssl/client.crl：证书吊销列表
生成自签名证书可参考教程。
启用HTTPS的启动命令：
bashdocker run -d --restart=always \ -v $(pwd)/yourconfig.yaml:/www/data.yaml:ro \ -v $(pwd)/ssl:/ssl:ro \ --add-host=host.docker.internal:host-gateway \ -e "WS_PROXY=host.docker.internal:9001" \ -p 80:80 \ -p 443:443 \ docker.xuanyuan.run/dersimn/mqtt-smarthome-webui
如需修改默认端口：
bash-p 8001:80 -p 8443:443 -e "HTTPS_REDIRECT_PORT=8443"
IP白名单设置
本地IP（以下范围）默认可不强制SSL和客户端认证：
- 10.0.0.0/8
- 172.16.0.0/12
- 192.168.0.0/16
环境变量配置：
WHITELIST_LOCAL_IP=false：强制所有客户端使用SSL和客户端认证WHITELIST_IP="10.1.1.0/24 192.168.1.0/24"：添加自定义IP白名单范围
详细访问日志
提供/nginx.log文件可启用logfmt格式的详细访问日志，支持常规文件或FIFO（可配合https://docs.influxdata.com/telegraf/v1/data_formats/input/logfmt/%E7%AD%89%E5%B7%A5%E5%85%B7%E5%A4%84%E7%90%86%E6%97%A5%E5%BF%97%E6%95%B0%E6%8D%AE%EF%BC%89%E3%80%82
源码地址
https://github.com/dersimn/mqtt-smarthome-webui
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 mqtt-smarthome-webui 镜像标签
docker pull docker.xuanyuan.run/dersimn/mqtt-smarthome-webui:<标签>
DockerHub 原生拉取命令
docker pull dersimn/mqtt-smarthome-webui:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"