v0.2.1 - 修复 trusted_proxies 自动修复路径问题

简介

这是 Cloudflared Tunnel Home Assistant add-on 的 v0.2.1 修复版本。

这个版本主要修复了自动反代修复功能在部分 Home Assistant / Supervisor 环境下无法找到 configuration.yaml 的问题。

本次修复内容

• 修复 auto_trust_local_proxy 开启后，脚本将 Home Assistant 配置文件路径写死为 /config/configuration.yaml 的问题
• 改为自动探测多个常见配置挂载路径：
  • /config/configuration.yaml
  • /homeassistant/configuration.yaml
  • /homeassistant_config/configuration.yaml
• 补充文档说明，明确不同 HAOS / Supervisor 环境下可能存在的配置挂载差异

影响范围

如果你在 v0.2.0 中开启了以下选项：

auto_trust_local_proxy: true
auto_restart_core_after_proxy_patch: true

v0.2.0 - 首个公开发布版本

简介

这是 Cloudflared Tunnel Home Assistant add-on 的首个公开发布版本。

这个版本面向 Home Assistant OS 用户，支持通过 Cloudflare Tunnel 暴露 Home Assistant 以及宿主机上的其他本地服务，并重点处理国内用户在真实部署中最常见的几个问题。

主要特性

• 支持 Tunnel Token 远程托管模式
• 支持 host_network: true
• 支持访问宿主机上的其他本地端口
• 支持可选的 trusted_proxies 自动修复
• 重点兼容 127.0.0.1 / ::1 反向代理来源场景
• 支持 additional_args: "--protocol http2"，适合 QUIC 不稳定环境
• 文档采用中文优先、英文补充的方式整理
• 提供 zh-Hans 配置翻译

重点说明

如果你通过 Cloudflare 访问 Home Assistant 时返回 400 Bad Request，请优先检查 trusted_proxies。

在冬瓜 HAOS、国产盒子、以及某些宿主机网络包装较多的环境里，Home Assistant 看到的代理来源可能是：

• 127.0.0.1
• ::1

这也是本加载项提供 auto_trust_local_proxy 开关的主要原因。

推荐配置

如果你的网络环境中 QUIC 不稳定，建议在 add-on 配置中使用：

additional_args: "--protocol http2"