默认端口是多少?
Home Assistant 默认使用 8123 端口。安装完成后,您通常可以通过以下地址在浏览器中访问:
- 局域网内:http://[HA设备IP]:8123
- 本地回环:http://localhost:8123 或 http://127.0.0.1:8123
如何修改默认端口?
如果您希望更改 Home Assistant 的监听端口(例如避免冲突或安全考虑),可通过以下方式:
- Docker 用户:在运行容器时使用
-p 新端口:8123映射端口。 - Home Assistant OS / Supervised:不建议直接修改,应通过反向代理(如 Nginx)实现端口转发。
- 手动安装(Python 虚拟环境):启动时添加
--port 新端口号参数。
无法访问?常见原因
- 防火墙或路由器阻止了 8123 端口
- Home Assistant 服务未正常启动
- 设备 IP 地址发生变化
- 浏览器缓存或 HTTPS 强制跳转问题
安全建议
为保障系统安全,请勿直接将 8123 端口暴露在公网。推荐使用以下方式远程访问:
- 启用 Home Assistant Cloud(Nabu Casa)
- 配置反向代理 + HTTPS(如 Nginx + Let's Encrypt)
- 通过 Tailscale、ZeroTier 等内网穿透工具