用途:为 Home Assistant OS(HAOS)实例提供可从任意位置访问的 https://ha.<域名> 公网地址。原理是 HAOS 主动向 Cloudflare 建立出站长连接,DNS 用 CNAME 指向 cfargotunnel.com,不暴露家庭 IP,无需入站端口,TLS 在 Cloudflare 侧终止。资料中明确排除了 HA 原生 SSL、DuckDNS 端口转发、Nabu Casa(月费)、Tailscale(需客户端装应用)等方案。
主要能力与用法:先安装 brenner-tobias/cloudflared 附加组件,命令为 ssh ha 'bash -lc "ha store add https://github.com/brenner-tobias/ha-addons && ha store reload"',随后 ha apps install 9074a9fa_cloudflared。配置仅需 external_hostname(如 ha.<域名>),可通过 Supervisor API 或 UI 配置页设置,tunnel_token 留空由登录流程生成。启动后日志会输出 Cloudflare 授权链接,需用户登录并选择 zone 授权,cloudflared 会自动创建隧道与 DNS CNAME。验证方式为查看日志中 Registered tunnel connection 与 Added CNAME,并用 curl 检查返回 200。
限制与注意:需域名已在 Cloudflare 账户中作为 zone,并具备 HAOS 的 SSH 访问。Core ≥ 2026.8 的代理信任设置需用户在 UI 完成(Settings → System → Network),旧版本改 configuration.yaml,且 /config 为 root 所有需 sudo,改前备份并执行 ha core check。升级跨 2026.8 的机器会忽略 YAML,以 UI 值为准。UDP 7844 被阻断时回退 http2 属正常。公网暴露后建议启用 2FA、IP 封禁与登录尝试阈值,并做完整备份。资料未提供价格、性能数据或其它平台支持信息。