Home Assistant 默认端口指南

什么是 Home Assistant？

Home Assistant（简称 HA）是一个开源的家庭自动化平台，支持本地控制、隐私优先，并可集成数百种智能设备。它通常运行在树莓派、NAS 或专用服务器上。

默认端口：8123

Home Assistant 默认使用 8123 端口提供 Web 界面服务。这意味着，当你在局域网中部署 Home Assistant 后，可通过以下地址访问：

• http://<你的HA设备IP>:8123
• 例如：http://192.168.1.100:8123

该端口用于 HTTP（非加密）通信。若启用 HTTPS，则通常使用 8124 或自定义端口。

如何修改默认端口？

如果你希望更改默认端口（例如避免冲突或增强安全性），可在 Home Assistant 的配置文件中设置：

• 对于使用 Home Assistant OS 或 Supervised 安装方式：通过系统设置或 configuration.yaml 修改网络配置较复杂，建议使用反向代理。
• 对于 Docker 用户：在运行容器时映射端口，例如：
  docker run -d --name homeassistant -p 9123:8123 ...
  此时可通过 :9123 访问。
• 对于 Python 虚拟环境 安装：启动时指定端口：
  hass --config /path/to/config --server-port 8080

安全建议

• 不要将 8123 端口直接暴露在公网，除非配合 HTTPS 和强认证（如 Cloudflare Tunnel、Nginx 反向代理 + SSL）。
• 启用 Home Assistant 内置的双因素认证和强密码策略。
• 考虑使用 ingress（通过 Home Assistant Supervisor）实现更安全的远程访问。

常见问题

Q：无法访问 http://IP:8123？
A：请检查：

• Home Assistant 是否正在运行；
• 设备防火墙是否放行 8123 端口；
• 是否在同一局域网内；
• 浏览器是否阻止了非 HTTPS 内容（某些企业网络策略）。

Q：能否同时运行多个 Home Assistant 实例？
A：可以，但每个实例必须使用不同的端口（如 8123、8124、8125...），并通过 Docker 或虚拟环境隔离。