8 月 26 日开始,不少人的 Home Assistant 出了个很扎眼的怪事:前端里所有地图被一张巨大的 “API KEY REQUIRED” 水印糊了个正着——用后来官方修这个事的 PR 定性,是这一下把前端里每一张地图都打挂了。社区求助帖攒下三万四千多浏览,楼里的回复相当无奈:开发者也是刚被通知,总会有办法的。Home Assistant 社区论坛
肇事者是 CARTO——HA 多年白嫖的底图服务商,饭局结束,开始要钱了。但有意思的不是这次"断供",而是官方的应对:没有再找一家免费栅格瓦片商凑合,而是把早就排进计划里的矢量瓦片方案一步到位换上去了。8 月 27 日合并的 PR 直接把地图引擎切到 OpenStreetMap 矢量瓦片,两天后就进了 2026.9.0b1。换句话说,上个月升过 2026.9 的老玩家,脚下这张地图其实已经换过引擎了——只是官方自己在下一轮发布注记里承认,这事上一轮几乎没在注记里提过,直到 9 月 30 日 2026.10 beta 放出来,这张"新地图"才第一次把界面亮全。10 月 7 日正式版本发布+发布直播(北京时间 10 月 8 日凌晨 4 点),现在正卡在要不要升级的窗口上。GitHubHome Assistant 社区论坛Home Assistant 官方博客
这次新亮出来的,不只是画质
2026.10 beta 注记把地图放在了头版头条的位置,几件事值得单独说:
地图改在你的设备上实时绘制:街道、标注不再是拼图片,任意缩放不发糊、缩放过程顺滑;
人用头像显示,同一个区域内多人合并成一个气泡,继续缩小地图时相邻气泡还会再合并——家里谁在"家"、谁在"公司",一眼看清,不用逐个点开实体;
Map 仪表盘新增侧栏总览:People / Devices / Zones 三个页签,点一个人看他最近的停留轨迹(每个点按所在区域上色);手机端地图直接全屏铺满;
区域(Zone)编辑器也换成新地图:设置"家"的范围终于可以看着地图打点、拖半径了。Home Assistant 官方博客
如果你只把 HA 的地图当摆设,这页可以跳过——但如果你的离家/到家自动化(人走关灯、离家几百米开空调)是靠 Zone 在做,2026.10 是这套东西上线以来最大的一次翻新。
最关键的变动不是画质:以后不是你的浏览器在"取地图"了
新架构里,浏览器不再直接访问任何第三方瓦片服务器,瓦片由你的 HA 服务器代为抓回、放进内存缓存,再分发给各设备。官方代码注释写得很直白:OSMF(OpenStreetMap 基金会)要求请求带可识别的 UA,而浏览器被禁止发送这种头;而且浏览器直连会把你的页面地址——包括 Nabu Casa 的远程访问 URL——当 Referer 漏给瓦片商。代理这一层,顺手把这个隐私口子也堵了。GitHub
对国内玩家,这个架构变化有两个直接推论,很多人升级后没头没尾的"地图刷不出来",根源都在这:
地图能不能加载,取决于你 HA 服务器侧能不能连上 OSM,而不是你的手机或宽带。远程通过 Link 中继回家开 HA 也一样:瓦片流量是从你家里服务器走出去的。服务器连不上,你在手机端做什么都没用;服务器能连上,远程看地图反而比老版本稳。Home Assistant 官方文档
官方给上游抓取设了 10 秒超时、同时最多 16 个并发(注释说明是刻意保护志愿者服务器),缓存 32MB、只放内存不写 SD 卡,重启后热数据集清零;但过期条目永远不会被丢弃——抓取失败时用旧瓦片兜底。浏览器侧还有一周的缓存时长。所以首次加载"街区一块块慢慢刷出来"属于设计内行为,反复白屏才是要排查的问题。GitHub
一条自查命令,在 HA 主机(或 SSH 进容器)上跑一下就有答案:`curl -w ‘%{time_total}s %{http_code}n’ -o /dev/null https://vector.openstreetmap.org/shortbread_v1/tilejson.json`。几秒内返回 200,地图就能加载出来;卡到 10 秒超时的,先解决服务器出口,再谈新地图。GitHub
还有个容易被忽略的定心丸:地图只是底图,人员/区域判定逻辑和瓦片能不能加载无关。Zone 触发、到家自动化跑的是坐标计算,瓦片挂了自动化照常工作——这是它和"云端挂了全家变砖"性质完全不同的地方,也是本地党可以忍受这张图慢慢刷的理由。
国内用户的三个账:能不能加载、坐标对不对、老设备吃不吃得下
第一个账,瓦片。 上面那条 curl 就是分水岭。能通的,往下看;不通的(比如服务器出口管控严的),地图会长期只有底色和气泡、没有街道,此时把 Zone 自动化当"盲用"是可行的,但新地图带来的编辑体验对你不成立,别为此焦虑。
第二个账,坐标系。 这可能是比加载速度更深的坑:OSM 和手机 GPS 坐标走 WGS-84,高德、百度用的是各自加密的偏移坐标系(GCJ-02/BD-09),同一个地址在这两套体系之间能差出几百米。知乎上那篇"为什么你的坐标在中国会"漂移"500米"的回答(62 赞)说的就是这个普遍问题。对 HA 的具体后果是:如果你过去建 Zone 时是把高德搜到的"家"的经纬度抄进去的,这个圆心在真实 GPS 坐标系里就是偏了几百米的——新地图上你会第一次直观看见人点落在街区外侧。修正不靠玄学:趁 2026.10 区域编辑器可视化了,直接把圆拖到正确位置,或以"人在门口 automation 准不准"来实测校半径。地理围栏本来就建议半径给足冗余,靠肉眼对齐不如靠实测边界。知乎
第三个账,老设备。 官方这次是明确写了的:带不动矢量渲染的设备,比如你墙上那块老平板,会自动回退到经典栅格地图。所以墙面上那套中控屏升级后看到的是"旧地图",不是坏了;顺带一个冷知识——矢量源最高 z14,再放大靠拉伸,而栅格回退版能到 z19,老平板上反而"更能放得深"。家里吃灰平板上墙的,这点值得留意。Home Assistant 官方博客GitHub
要不要当小白鼠:beta 窗口期的两份名单
2026.10 beta 注记里那句话值得每个打算切 beta 的人记住:发布注记仍在完善中,某些功能最终可能不会进入正式版。前端 beta 里程碑上目前还剩 2 个未决 issue、21 个已关闭,地图相关的没有未决报告;但别忘了前车之鉴——2026.9 从正式版到 9.4 连打了四个补丁才稳。Home Assistant 官方博客Home Assistant 官网
建议继续观察的:没在用 Zone/到家自动化的人(地图翻新对你只是可看可不看)、墙上有老平板中控的人(回退逻辑先实测)、服务器出口连 OSM 都够呛的人(新引擎对你先是个加载问题)。正式版发布后一周内,国内外肯定有实测帖,看不吃亏。
可以先上的:自动化里重度依赖 zone、等着用新区域编辑器拖半径的人;已经在 beta 渠道、愿意去 Discord #beta 频道报 issue 的人。注意官方提醒:报 bug 要带具体 beta 版本号。
另外,不想追 beta 也别觉得错过了换引擎——瓦片底层 2026.9 就已经换完,2026.10 新的是界面(气泡、总览、区域编辑器)。换句话说正式版你迟早会遇到新地图,beta 只是提前一周。
高德党先别急着卸载:自建图这条路没被官方取代
国内 HA 社区这几年围绕地图干了大量活儿:B 站那条把高德地图接进 HA 做通勤时间、到家预判的教程视频拿了 686 赞、162 条跟帖,Node-RED 流至今在玩家群里流传。更早还有人做了整套调用高德 API 替换原生地图的方案,小红书上高德 + Node-RED 的组合教程也常年有人收藏。这些路线今天依旧成立:内置这张 OSM 矢量图解决的是"人在哪、zone 对不对、可视化编辑",导航级路网细节、POI、国内地址习惯,还是社区方案的强项。顺带一句维护现状:流传最广的几个国产地图仓库里,有的最后提交停在 2024 年 9 月——照常用,但别指望它跟着 2026.10 的新前端一起演进,出兼容问题得自己捡得动。哔哩哔哩小红书GitHub
这张图这次换代,本质上是一次"免费托管不可持续"的事故驱动升级:第三方白嫖的底图说翻脸就翻脸,官方索性把底图收进自己代理、数据交给志愿者社区维护的 OSM。对本地党,这是又一个云依赖被拔掉;但对国内可用性——瓦片通不通、坐标对不对、数据密不密——官方能给的只有代理缓存和 10 秒超时,剩下的三个账,只能自己家自己算。
升级完 2026.10 正式版的朋友,值得回来盯一件事:Map 仪表盘里你家人的气泡有没有整体朝某个方向"飘"出去两三百米。有的话,那不是新地图的锅,是你家 zone 的坐标系老账,这回终于看得见、也就拖得动了。