Docker Home Assistant 反向代理配置

学习笔记作者:admin日期:2025-06-21点击:34

摘要:详细介绍了如何通过修改 Home Assistant 配置文件并结合反向代理解决外网访问问题。

Docker Home Assistant 反向代理配置

问题描述

      默认情况下,Home Assistant 不允许外网直接访问,若直接配置反向代理,可能会出现 400 错误。

解决方案

1. 修改配置文件

      进入 Docker 容器的配置目录,编辑 configuration.yaml 文件:

docker/home-assistant/config/configuration.yaml

      在文件中添加以下内容:

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.0.0/24   # 替换为反向代理所在子网
    - 172.17.0.0/24    # Docker 默认网段

2. 重启服务

      执行以下命令重启容器以应用更改:

docker compose restart

注意事项

      确保反向代理已正确设置 X-Forwarded-ForX-Forwarded-Proto 请求头;若使用 HTTPS,需额外配置 SSL。

上一篇      下一篇