8123 这个"魔法数字",官方真的在拆:小红书吵翻的"升级变端口",口径其实是第三个

源自33位全网作者

10-16 20:28

10月14日,一条小红书帖子在 HA 玩家群里转开了:博主 Pangpy 按"每月第一个周三"的老例升级 Home Assistant OS 18.3,更完 HA 页面死活打不开,局域网、外网全军覆没。他翻了 App 配置、Cloudflare 证书、切 WiFi 和 5G、回退 18.2、重启虚拟机,带着 AI 排查两个多小时才恢复,最后给出的结论是:“HTTP 端口从 8123 变成 80 了。”

评论区当场劈成两半。顶评说得很冲:升级根本不会变端口,升级前是 8123,升完还是 8123,只有新装的才会默认用 80。 Docker 党和威联通虚拟机党跟了一句"我升级了,没这个问题";但也有人回帖"今天刚升级,也遇到这个问题"。帖子 13 赞 18 评,数字不大,问题不小——双十一快到了,装新系统的、每月手痒点更新的,都会被这 3 个数字绊一下。小红书

我翻完官方 2026.8 发布博客、HAOS 18.2/18.3 的发布说明和 GitHub 上几个相关 issue,发现这场架其实双方都只说对了一半,官方的完整口径是第三个:端口确实在被"退役",但只针对新装;老装机升级,端口一个字节都不会动。

官方到底改了什么:只动新装,不动老实例

2026.8 博客里这一节的标题就叫"The same Home Assistant, minus the magic number"(同一个 HA,去掉魔法数字)。官方原话是:这些年访问 HA 得在地址后面记得加 :8123,“这是每个人都被迫学会的一点技术冷知识”,从 2026.8 起,新安装的 Home Assistant OS 默认用普通网址访问,像打开任何网站一样,后面什么都不用加。配套的 HAOS 18.3(9 月 17 日发布)则把初始引导页也挪到了 80 端口,访问 8123 会自动跳过去。Home Assistant 官网GitHub

紧接着官方又专门写了一段"Your current setup keeps working":已在运行的实例什么都不变,保持原端口,照常工作;如果一切正常,最简单的做法就是别动它。所以评论区那句"升级不会变端口",是符合官方口径的;把断连直接归因于"8123 变 80",方向就错了。Home Assistant 官网

真正的新东西藏在后面:换端口这件事,官方把按钮交到了你自己手里。系统设置里新增了一个 Web 服务器面板,端口、监听网卡、可信代理都在里面。官方还做了个很贴心的保险——改完配置它会等你确认,5 分钟不点确认,自动回滚到原设置并重启。也就是说,锁死自己的最坏结果,是等五分钟。

8123 这个

8123 这个

如果你用 YAML 配过 http 组件,升级后第一次启动会自动把这些设置搬进界面,顶多弹个修复提示,不用动手。

"升级后失联"不是假问题,但锅多半不在端口

Pangpy 的帖子有个细节容易被吵架的人忽略:他是在虚拟机上折腾了很久才恢复的。如果你也是升级后打不开,先把顺序摆对——

第一步,花 10 秒排除端口错觉。 直接输 IP(不带端口)试一次,不行再手动加 :8123 试一次。两次都不行,就不是端口问题,别在 App、证书、DNS 上绕两个小时。

第二步,分清你是"升级"还是"重装/重引导"。 官方改默认端口的只有新装路径。重装、重置后重新引导的系统,落地页就在 80 上;而且早期有个坑:新装的终端 banner 仍会显示 `homeassistant.local:8123`,跟着它敲会撞上 connection refused——这个"官方横幅骗人"的 issue(HAOS #4993)8 月底就报过,横幅显示的和实际监听的对不上,别全信控制台。GitHub

第三步,才是查系统层。 18.3 本身是个修复版:它专门处理了"更新后断电导致容器镜像损坏"的问题(镜像层现在解包后立即同步落盘),并新增了 `ha docker reset-storage` 命令——配置和数据都保留,把 Docker 存储整个清掉重拉镜像。对用 SD 卡 + 家用电的国内玩家,这大概是今年最实用的一条新命令:断电后 HA 起不来、容器反复报错,先想到它,而不是先想到刷机。另外 GitHub 上 10 月 15 日还有一个孤例值得同配置的人留意:Pi 5 在 18.3 上断电后 WiFi 配不上、UI 失联,回滚到旧的 17.3 系统槽就恢复了——单例报告,尚未确认是普遍回归,但 HAOS 的 A/B 槽就是后悔药,遇到同样情况先回滚验证,别急着重装。GitHubGitHub

双十一之前,四本账对完再动手

第一本:老装机要不要主动换 80? 官方立场很明确——能用就别动。换的隐性成本全跟着旧地址走:收藏夹、手机 App 里的服务器地址、Node-RED 节点、webhook 回调、摄像头推送、路由器上那条 8123 端口映射,一处没改就是一处失联。有 5 分钟自动回滚兜底,想换可以试,但别在升级日当天换。Home Assistant 官网

第二本:公网暴露党,80 在国内反而是坑。 "没有数字的网址"只在局域网里成立:国内家宽入站的 80/443 大概率被运营商封着,备案又是另一道门。真要外网访问,保留 8123 或高位端口、反代挂非标端口,或者干脆走 Tailscale / Home Assistant Cloud(Link)这类不依赖入站的方案,比追"干净地址"实惠得多。

第三本:双十一装新机的,认知要先换。 刷 Green、装虚拟机从零开始的用户,从第一分钟起地址后面就没有 8123,打不开页面先试试裸 IP,别再走"重启-重装"的老舞步。用 Docker/Container Manager 装的不受影响,该映射 8123 还是 8123。

8123 这个

第四本:月度升级党的固定动作。 每月第一个周三,OS、Core、App 分三层,分开升;升之前手动备份一次;出问题按上面"10 秒端口排查→区分升级/重装→查系统层"的顺序走,别拿 AI 当随机森林跑。

8123 这三个数字,是老玩家的区号,是新用户的第一道墙。官方 2026.8 定的方向是让这道墙在普通人手里消失,存量装机则永远保留旧地址——方向没问题,执行期最贵的就是这类"新旧口径打架"的半小时。下次群里有人双十一装完机喊"8123 打不开",把这条排查顺序甩过去就行。至于 8123 会不会哪天真的全面退场,官方目前没说,可以留个观察。

内容由AI生成
1
扫一下,分享更方便,购买更轻松
0评论

当前文章无评论,是时候发表评论了
提示信息

取消
确认
评论举报

最新文章 热门文章