spaceinvaderone/ha_inabox

HomeAssistant_inabox

HomeAssistant_inabox 是一个功能强大、易于使用的Docker容器，旨在无缝下载并在Unraid服务器上安装功能齐全的Home Assistant虚拟机。它通过直接集成来自官方Home Assistant源的虚拟机设置，简化了Home Assistant的安装和管理。

核心功能与特性

• 直接下载与安装：自动从官方Home Assistant发布仓库下载Home Assistant .qcow2镜像，并将其安装到Unraid服务器上。
• 自动化虚拟机设置：处理新虚拟机配置的创建，根据环境和可用的最高QEMU版本动态构建XML模板。
• 自动虚拟机监控：定期检查虚拟机状态，如意外关闭则重启，确保Home Assistant始终可用。
• 与Docker和虚拟机网页界面无缝集成：将Docker容器管理与虚拟机监控相结合，从Unraid Docker标签点击“WebUI”链接会自动重定向到虚拟机内的Home Assistant网页界面。
• 动态IP管理：自动确定Home Assistant虚拟机的内部IP地址并更新Docker网页界面重定向，即使虚拟机IP地址变化也能保持访问。

快速开始

按照以下说明在Unraid服务器上安装和配置HomeAssistant_inabox容器。

安装步骤

1. 进入Unraid应用标签（也称为CA社区应用）。
2. 搜索HomeAssistant_inabox 并点击安装。
3. 按照下文“配置”部分所述配置容器变量。
4. 启动容器。HomeAssistant_inabox将自动下载最新的Home Assistant镜像、创建虚拟机并设置必要的配置文件。
5. 设置完成后，点击容器的“WebUI”按钮访问Home Assistant实例。

配置说明

HomeAssistant_inabox依赖于一些必须通过Unraid Docker模板设置的关键变量。以下是每个选项及其用途的详细说明：

容器变量

1. VMNAME

   • 描述：设置Home Assistant虚拟机的名称。
   • 默认值：Home Assistant
   • 用途：这是将在Unraid虚拟机管理器中显示的虚拟机名称。

2. VM Images Location

   • 描述：指定存储虚拟机镜像的位置（例如，Domains共享目录）。
   • 示例：/mnt/user/domains/
   • 用途：定义Home Assistant虚拟机文件在Unraid服务器上的存储路径。

3. Appdata Location

   • 描述：设置HomeAssistant_inabox存储其应用数据和配置文件的路径。
   • 默认值：/mnt/user/appdata/homeassistantinabox/
   • 用途：指定容器内部配置和脚本的存储位置。

4. Keep VM Running

   • 描述：若设置为Yes，容器将自动监控Home Assistant虚拟机，如未运行则重启。
   • 默认值：Yes
   • 用途：确保Home Assistant即使意外关闭也能保持可用。

5. Check Time

   • 描述：定义检查Home Assistant虚拟机状态的频率（以分钟为单位）。
   • 默认值：15
   • 用途：确定容器检查虚拟机是否运行及是否需要启动的间隔时间。

6. WEBUI_PORT

   • 描述：设置通过容器网页界面重定向访问Home Assistant网页界面的端口。
   • 默认值：8123
   • 用途：允许配置Home Assistant的网页界面访问端口。

工作原理

HomeAssistant_inabox通过将Docker容器与完整虚拟机环境相结合，提供了一个可靠的解决方案：

1. 直接下载与安装：

   • 容器启动时，自动从官方Home Assistant源下载最新的Home Assistant .qcow2磁盘镜像。
   • 然后将镜像提取并移动到Unraid服务器指定的domains位置。

2. 动态虚拟机设置：

   • 容器使用可用的最新QEMU版本为Home Assistant动态构建虚拟机XML模板。
   • 该模板随后用于在Unraid服务器上定义新虚拟机。

3. 自动IP检测：

   • 虚拟机启动后，容器使用QEMU访客代理检索虚拟机的内部IP地址。
   • 该IP地址用于配置Docker容器内的重定向，使Unraid Docker标签中的“WebUI”链接直接指向虚拟机内的Home Assistant网页界面。

4. 监控与重启功能：

   • 若RESTART设置为Yes，容器将定期检查Home Assistant虚拟机是否运行。
   • 如发现虚拟机已关闭或暂停，容器将尝试自动启动它。

5. 网页界面集成：

   • 点击HomeAssistant_inabox容器的WebUI按钮时，会使用上次检查中获取的IP地址动态重定向到虚拟机内的Home Assistant网页界面。

使用场景示例

1. 场景：希望在Unraid服务器上运行Home Assistant，同时通过Docker界面而非单独的虚拟机管理标签进行管理，无需手动使用浏览器登录。
2. 解决方案：安装HomeAssistant_inabox并配置必要变量。通过此设置，Home Assistant将作为虚拟机运行，但可直接从Docker WebUI链接访问。
3. 结果：简化环境并提供Home Assistant的单一访问点，结合了Docker管理的便利性与专用虚拟机的强大功能和灵活性。

贡献与支持

欢迎通过提交拉取请求或创建问题为HomeAssistant_inabox的开发做出贡献。如需支持和提问，请加入Unraid社区论坛中HomeAssistant_inabox的讨论主题。

许可证

本项目采用MIT许可证。详情请参见LICENSE文件。

致谢

特别感谢Unraid社区的支持与贡献，以及Home Assistant团队提供的强大家庭自动化平台。