为什么 Olink 会在 HA 停止时接管 8123 端口?
同一台机器上若曾跑 Home Assistant(HA),HA 默认占用 8123。HA 服务停掉后,有时会发现 Olink 开始监听 8123——这是预期行为,不是「偷偷抢 HA」,而是为了兼容 米家授权回调地址格式。
原因
米家授权走的是 米家 Home Assistant 集成那套回调约定:浏览器授权成功后,会跳回类似:
http://olink.homeassistant.local:8123/……也就是说,回调 URL 必须是「某主机名 + 端口 8123」(常见主机名形如 xxx.homeassistant.local)。Olink 因此会额外(或同时)在 8123 上提供 HTTP,才能接住自动回调。
流程简要:
米家授权页
→ 跳转回调 http://*.homeassistant.local:8123/…
→ 须有进程在本机 8123 监听
→ Olink 监听 8123 以接收回调HA 在跑时,8123 往往已被 HA 占用,Olink 可能绑不上该端口(日志里会有 bind 失败一类提示)。HA 一停,8123 空出来,Olink 就能绑上——看起来就像「HA 停了之后被 Olink 接管了 8123」。
和 HA 冲突时怎么办
若你本机还要继续用 HA,或希望 8123 只给 HA:
- 关闭 Olink 对 8123 的监听(见下一节)。
- 米家授权改用手粘贴回调:把浏览器地址栏完整 URL 粘到「手动粘贴回调地址」再确认,见 米家授权后网络错误。不监听 8123 时,自动回调页可能打不开,手动粘贴即可完成授权。
- 同机长期并存:HA 占 8123 + Olink 关监听;或仅在授权时临时停 HA——二选一即可。
如何不监听 8123
配置项是 server.listen_8123,默认 true。关掉后 Olink 不再额外绑定 8123(主管理端口如 5512 不受影响)。
环境变量前缀为 APP,嵌套字段用 __ 分隔,对应写法:
APP__server__listen_8123=false写法一:写入 data/.env(板子 / 本机安装常用)
旗舰等安装一般会通过 systemd 加载 /opt/olink/data/.env。编辑该文件,增加或改成:
APP__server__listen_8123=false保存后重启 Olink,例如:
sudo systemctl restart olink写法二:Docker / docker-compose
在 environment 里增加:
environment:
- APP__server__listen_8123=false或 docker run:
-e APP__server__listen_8123=false写法三:application.toml
也可在数据目录的 application.toml(常见 /opt/olink/data/application.toml)里写:
[server]
listen_8123 = false改完同样需要重启(或按你环境使配置重新加载)后再确认 8123 已释放:
ss -lntp | grep 8123
# 或
lsof -iTCP:8123 -sTCP:LISTEN不应再看到 olink 进程占着 8123(HA 若在跑,则仍可能是 HA)。
注意
- 回调地址里的端口写死为 8123 是米家 / HA 协议约定;关监听后请用 手动粘贴回调,不要指望自动跳回 Olink。
- 主控制台端口(如
APP__server__listen=0.0.0.0:5512)与 8123 独立;关的是额外的 HA 兼容端口。 - 若
config.toml/application.toml里已显式写了listen_8123,以文件里的最终合并结果为准;不确定时直接在 toml 里设false最省事。 .local解析失败见 米家授权后网络错误。