brainic/tado-assistant

Tado Auto-Assist 替代方案镜像

镜像概述

该Docker镜像是一款免费开源的Tado Auto-Assist替代方案，专为Tado智能温控系统用户设计，提供无需订阅费用的自动辅助功能。通过集成多账户管理、智能开窗检测及直观的用户界面，帮助用户优化温控体验并实现节能目标。

核心功能与特性

多账户管理

支持添加和管理多个用户账户，满足家庭或小型办公环境中不同用户的独立温控偏好设置需求，实现个性化温控管理。

智能开窗检测

内置开窗检测算法，可自动识别窗户开启状态，并根据预设策略联动Tado温控设备（如暂时关闭暖气或空调），有效避免能源浪费。

用户友好界面

提供简洁直观的Web操作界面，无需专业技术知识即可完成账户配置、检测参数调整及设备状态监控，降低使用门槛。

免费开源

完全免费使用，无需支付订阅费用；源代码开放，支持用户根据需求自定义功能或进行二次开发，确保功能透明度和安全性。

使用场景与适用范围

• 家庭智能温控用户：已部署Tado智能温控系统，但希望替代官方Auto-Assist服务以降低使用成本的家庭用户。
• 多用户家庭环境：需要为家庭成员分配独立账户，管理各自温控偏好的场景（如不同房间温度设置）。
• 节能需求场景：注重能源节约，希望通过开窗检测功能自动调节温控设备，减少不必要能耗的用户。
• 开源技术爱好者：倾向于使用开源解决方案，追求功能可定制性和数据隐私保护的技术用户。

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 拥有Tado智能温控系统及相关设备
• 网络环境可访问Tado设备及镜像仓库

基本部署命令（Docker Run）

通过以下命令快速部署镜像：

bash
docker run -d \
  --name tado-assist-alternative \
  -p 8080:8080 \
  -e TZ=Asia/Shanghai \
  -e MULTI_ACCOUNT_ENABLED=true \
  -v ./config:/app/config \
  --restart unless-stopped \
  [镜像名称]:latest

参数说明：

• -p 8080:8080：映射容器内Web界面端口到主机8080端口（可根据需求修改主机端口）
• -e TZ=Asia/Shanghai：设置时区（默认UTC，建议根据实际位置调整）
• -e MULTI_ACCOUNT_ENABLED=true：启用多账户功能（默认启用，设为false可关闭）
• -v ./config:/app/config：挂载本地目录用于持久化配置文件（包含账户信息、检测规则等）
• --restart unless-stopped：容器退出时自动重启（除手动停止外）

环境变量配置详解

访问与初始化配置

1. 部署完成后，通过浏览器访问 http://<主机IP>:8080 打开Web界面
2. 根据引导完成初始设置：
   • 添加Tado账户信息（支持多个账户）
   • 配置开窗检测灵敏度及联动策略
   • 设置用户权限（如多账户场景下的权限分配）
3. 保存配置后，系统将自动启动温控辅助服务

数据持久化

建议通过 -v 参数挂载本地目录（如示例中的 ./config），确保配置文件、账户数据及运行日志在容器重启或升级后不丢失。挂载目录权限需确保容器内进程可读写（建议设置权限为 755）。