Home Assistant 端口详解

什么是 Home Assistant？

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

默认端口：8123

Home Assistant 默认使用 8123 端口提供 Web 界面服务。这意味着当你在浏览器中访问：

http://[你的设备IP地址]:8123

即可打开 Home Assistant 的初始设置页面或登录界面。

如何修改默认端口？

如果你希望更改 Home Assistant 的监听端口（例如避免冲突或增强安全性），可以通过以下方式实现：

方法一：通过 configuration.yaml（传统安装）

在你的 configuration.yaml 文件中添加以下内容：

http:

  server_port: 8080

保存后重启 Home Assistant，新端口即生效。

方法二：Docker 启动时指定端口映射

运行容器时使用 -p 参数：

docker run -d \

  --name homeassistant \

  --privileged \

  -v /PATH_TO_CONFIG:/config \

  -p 8080:8123 \

  ghcr.io/home-assistant/home-assistant:stable

这样外部访问 :8080，容器内部仍使用 8123。

常见问题

• 无法访问 8123 端口？ 检查防火墙是否放行该端口，或 Home Assistant 是否正常运行。
• 端口被占用？ 使用 netstat -tuln | grep 8123（Linux/macOS）查看占用进程。
• 想用 HTTPS？ 可通过反向代理（如 Nginx）配合 Let's Encrypt 实现加密访问。

总结

掌握 Home Assistant 的端口配置是搭建稳定智能家居系统的第一步。默认端口为 8123，但可根据实际需求灵活调整。合理配置网络与安全策略，才能充分发挥 HA 的强大功能。