lordmike/blueriiot2mqtt
lordmike
2 次收藏下载次数: 0状态：社区镜像维护者：lordmike仓库类型：镜像最近更新：2 个月前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
BlueRiiot2MQTT
This is a proxy application to translate the status of a Blue Riiot pool manager, to Home Assistant using MQTT. You can run this application in docker, and it will periodically poll the Blue Riiot API for updates.
This project is not affiliated with or endorsed by Blue Riiot.
Features
- Creates sensors for each pool in Blue Riiot
- Tracks the latest measurements for pH, temperature, Cyanuric Acid and Alkalinity
- Tracks warning / danger levels for the measurements
- Weather forecast, with temperature, UV index and weather type e.g. 'rain'
- Notifies when actions need to be done (use the Blue Riiot app to get more details on steps)
Todo:
- Track battery status
- Identify MIA Blue Connects
- Get more detailed states from Blue Connect (warnings and errors)
- Adjust the polling interval automatically
Setup
Environment Variables
| Name | Required | Default | Note |
|---|---|---|---|
| MQTT__Server | yes | A hostname or IP address | |
| MQTT__Port | 1883 | ||
| MQTT__Username | |||
| MQTT__Password | |||
| MQTT__ClientId | blueriiot2mqtt-RANDOM | ||
| MQTT__ReconnectInterval | 00:00:30 | How long to wait before reconnecting to MQTT | |
| HASS__DiscoveryPrefix | homeassistant | Prefix of HASS discovery topics | |
| HASS__BlueRiiotPrefix | blueriiot2mqtt | Prefix of state and attribute topics | |
| BlueRiiot__Username | yes | ||
| BlueRiiot__Password | yes | ||
| BlueRiiot__UpdateInterval | 01:00:00 | Update interval, default: 1 hour | |
| BlueRiiot__Language | en | Language for the API. Used for messages from BlueRiiot | |
| Proxy__Uri | Set this to pass BlueRiiot API calls through an HTTP proxy |
Run in Docker CLI
docker run -d -e MQTT__Server=myqueue.local -e BlueRiiot__Username=myuser -e BlueRiiot__Password=mypassword lordmike/blueriiot2mqtt:latest
Run in Docker Compose
yaml# docker-compose.yml version: '2.3' services: blueriiot2mqtt: image: lordmike/blueriiot2mqtt:latest environment: MQTT__Server: myqueue.local BlueRiiot__Username: myuser BlueRiiot__Password: mypassword
How
Officially, Blue Riiot does not have any API available. They have a number of integrations with select third parties, such as Alexa or IFTTT. I found these to be lacking for me, as I want to bring all my data into my domain, such as in my local HASS setup.
The API used here is reverse engineered from the apps that Blue Riiot offers.
Troubleshooting
Log level
Adjust the logging level using this environment variable:
Logging__MinimumLevel__Default: Error | Warning | Information | Debug | Verbose
HTTP Requests logging
Since this is a reverse engineering effort, sometimes things go wrong. To aid in troubleshooting, the requests and responses from the Blue Riiot API can be dumped to the console, by enabling trace logging.
Enable request logging with this environment variable:
Logging__MinimumLevel__Override__MBW.Client.BlueRiiotApi: Verbose
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 blueriiot2mqtt 镜像标签
docker pull docker.xuanyuan.run/lordmike/blueriiot2mqtt:<标签>
DockerHub 原生拉取命令
docker pull lordmike/blueriiot2mqtt:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"