通过Nginx Proxy Manager加载项可快速配置Home Assistant，实现以域名形式通过HTTPS访问并隐藏端口。但默认配置下直接访问常出现400: Bad Request错误。本文详细讲解如何正确调整Home Assistant相关设置，配合反向代理规则，解决访问异常问题，确保通过域名稳定、安全地进入系统管理界面，提升远程访问体验与安全性。
1、 Home Assistant 是一个采用 Python 3 构建的开源智能家居控制平台，支持对网络内各类设备进行监控与自动化管理。默认情况下通过 8123 端口进行访问，但直接暴露端口存在安全风险，且使用不够便捷，不利于长期稳定运行与远程控制。
2、 若系统仅在内网运行，安全性相对较高；但若需对外提供服务或通过端口映射暴露在互联网中，使用HTTP端口访问时，数据易遭中间人窃取，一旦API密钥泄露，攻击者便可远程操控，带来严重的安全风险。
3、 实现域名访问的方法有多种，例如可在Home Assistant控制台的配置-系统-网络中设置Home Assistant URL（访问时需包含端口）。
4、 也可通过Lets Encrypt加载项配合NGINX实现HTTPS访问，但设置过程较为繁琐，涉及证书申请与反向代理配置，本文暂不详述相关内容。
5、 本文介绍如何通过Nginx Proxy Manager插件配置域名访问。
6、 进入配置页面的加载项商店，搜索并安装Nginx Proxy Manager，启动后检查日志。若出现数据库相关错误，可先安装MariaDB加载项，完成相应参数设置后再重试，确保服务正常运行。
7、 重启Nginx代理管理器后，检查运行日志，若显示内容，则表示已正常启动。
8、 Nginx Proxy Manager默认通过81端口提供管理界面，只需在浏览器中输入服务器IP地址加:81即可访问登录页面。初始用户名为admin@example.com，密码为changeme，首次登录后建议立即修改。可在页面右上角点击用户头像进入设置，完成密码更换，确保系统安全。
9、 在Host菜单中选择proxy host进入域名管理界面，点击右侧的Add proxy host按钮添加新的域名配置。待添加的域名需提前解析至服务器IP地址或前端服务映射IP，以便对外提供访问服务。在Forward Hostname / IP栏中，可直接填写homeassistant或用于访问管理界面的IP地址，端口设置为系统默认的8123，并确保启用WebSocket支持功能。当前阶段无需配置SSL证书，完成上述设置后点击保存，待服务生效即可通过HTTP方式进行访问测试，确认服务正常运行后再进行后续的HTTPS配置。
10、 直接在浏览器中访问之前设置的域名，若页面正常显示登录界面，表明配置无误，此时可进入Nginx Proxy Manager进行SSL证书的启用与配置。
11、 访问出现400错误时，需在Home Assistant中启用反向代理，并将相关地址加入白名单，以确保请求正常通过并完成连接。
12、 在Home Assistant配置中开启反向代理，设置IP白名单的详细步骤如下：
13、 先查系统日志中的错误信息，确定实际请求的IP地址。
14、 来自反向代理的请求由172.30.33.6发出，系统已接收并记录该连接信息，正在进行安全验证与处理流程，确保数据传输符合安全策略要求。
15、 日志中的172.30.33.6是真实请求IP，建议将其加入白名单。
16、 用文件编辑器打开并编辑位于/config/目录下的configuration.yaml文件。
17、 添加：
18、 保存后重启即可
19、 重启后即可通过域名直接访问，无需输入端口。
20、 在Nginx Proxy Manager中配置域名时，将SSL证书设为自动模式，即可完成HTTPS访问的启用设置。
21、 可预先准备证书，在设置SSL时选用已有证书即可。
22、 在SSL证书管理页面，点击右侧的添加SSL证书选项，可选择申请Lets Encrypt免费证书，或通过自定义证书导入已有的域名证书，满足不同场景下的证书配置需求。
23、 完成证书配置后，即可通过HTTPS方式访问控制台，同时API接口也支持安全传输，有效提升了系统的整体安全性。
