.png)
🏗️ 第一阶段：Ubuntu 独立容器端（Frigate 配置）
由于 Frigate 独立跑在 Ubuntu 容器中，我们要确保它的核心配置文件没有任何语法垃圾。
1. 修改 config.yml 配置文件
打开你的 Frigate 配置文件，将 mqtt 这一段严格对齐修改为以下纯净代码。
⚠️ 避坑警示：千万不要在代码行后面直接加中文括号或说明，否则会被系统误认为是用户名/密码的一部分！
YAML
mqtt:
enabled: true
host: 192.168.0.9 # 💥 填入你运行 Home Assistant (Mosquitto) 的实际局域网 IP
port: 1883
user: mqtt # 💥 必须全小写，后面有一个空格
password: mqtt # 💥 必须全小写，后面有一个空格
2. 彻底“物理清理缓存”并冷启动
修改完 config.yml 后，不要只点 restart，必须在 Ubuntu 终端的 docker-compose.yml 目录下执行以下“强刷组合拳”，彻底销毁旧容器的错误连接缓存：
Bash
# 1. 彻底停掉并销毁当前 Frigate 容器
docker compose down
# 2. 重新加载全新配置并在后台启动
docker compose up -d
🔐 第二阶段：Home Assistant 端（MQTT 桥梁配置）
有了 Frigate 发出的正确钥匙，HA 的 MQTT 服务器也必须对齐。
1. 检查 Mosquitto Broker 账户
进入 HA 的 设置 ➔ 加载项 (Add-ons) ➔ Mosquitto broker。
点击顶部的 配置 (Configuration) 标签页。
点击右上角三个点
⋮➔ 选择 以 YAML 格式编辑 (Edit in YAML)。确保里面有如下账号密码定义：
YAML
logins: - username: mqtt password: mqtt点击保存并重启 Mosquitto Broker 插件。
2. 验证“任督二脉”是否打通
查看 Mosquitto 的 日志 (Log)，只要刷出以下日志，说明 Frigate 已成功刷卡进门：
Plaintext
New client connected from 192.168.0.1 as frigate (p4, c1, k60, u'mqtt').
🔌 第三阶段：重点补齐！在 HA 中安装并配置 Frigate 核心集成
MQTT 管道通了之后，我们需要让 HA 系统能够真正“读懂”并接管 Frigate 发过来的视频和传感器数据。
1. 在 HACS 中下载 Frigate 集成
点击 HA 左侧大边栏的
HACS。在 HACS 页面顶部搜索框输入
Frigate。找到 Frigate 官方集成（图标是一只飞鸟），点击进去并点击右下角的 Download 下载。
下载完成后，必须重启一次 Home Assistant 系统（设置 ➔ 系统 ➔ 右上角关机图标 ➔ 重启 Home Assistant）。
2. 在“设备与服务”中正式添加集成
HA 重启完成后，点击 设置 ➔ 设备与服务。
点击右下角的 添加集成 (ADD INTEGRATION) 按钮。
在搜索框里输入
Frigate并点击它。此时会弹出一个配置框，要求你填入 Frigate 的访问地址：
URL：输入你 Ubuntu 独立运行 Frigate 的后台地址（包含端口，例如
http://192.168.0.1:5678/或带有你设置的实际端口）。
点击提交。
此时，HA 就会瞬间通过网络握手 Frigate 容器，在集成列表里为你生成一个醒目的 Frigate 大卡片。点进去就会看到生成了诸如 Scam Front 等摄像头设备以及多达 41 个实体。原本因为 MQTT 没通而显示“不可用”的所有传感器（Car、Person、Motion），此刻会瞬间刷亮复活，变成“清除”或“关闭”状态！
🎨 第四阶段：HACS 前端大屏卡片安装（以下暂未实现）
1. 避坑冷知识：新版 HACS 2.0 命名变更
旧版本中用来放前端卡片的分类叫
Plugin或Lovelace。在最新的 HACS 2.0+ 界面里，官方将所有前端卡片统一更名合并改叫——
Dashboard！官方项目的最新真身组织名是
dermotduffy，且更名为advanced-camera-card。
2. 正确添加自定义存储库步骤
回到
HACS独立页面。点击右上角那三个点
⋮➔ 选择 自定义存储库 (Custom repositories)。在弹出的窗口里，精确填入以下信息：
Repository (存储库)：
Plaintext
https://github.com/dermotduffy/advanced-camera-cardType (类型)：下拉菜单里，直接选择新版的
Dashboard。
点击
ADD(添加) ➔ 绿灯秒过！在列表里点击新出现的卡片，点击右下角的 Download 下载它。
【极其重要】 下载完成后，在当前浏览器页面上按下
Ctrl + F5（Mac 按Cmd + Shift + R）强行刷新网页清除缓存，否则 HA 无法在内存里加载新卡片。
🚀 第五阶段：仪表盘大屏搭建（对齐 2026 最新 YAML 语法）
新版卡片升级为通用高级相机卡片后，旧的 live_provider 和 timeline 语法已经被废弃。
1. 添加卡片
回到 HA 首页 概览 ➔ 点击右上角三个点
⋮➔ 编辑仪表盘。点击右下角 添加卡片 ➔ 搜索并选择
Advanced Camera。
2. 塞入 2026 最新标准 YAML 代码
点击卡片左下角的 代码编辑器 (Code Editor)，将里面的默认代码全部清空，替换为下面这份完全对齐新版语法的完美配置：
YAML
type: custom:advanced-camera-card
cameras:
- camera: camera.scam_front # 💥 确保这是你在 HA 开发者工具里查到的真实摄像头实体名
engine: frigate # 💥 新版顶级引擎声明，取代了旧版的 live_provider
frigate:
camera: scam_front # 对应你 Frigate config.yml 里的摄像头名字
client_id: frigate
title: 门口监控
menu:
buttons:
frigate: true
events: true
media_players: true # 💥 新版将 timeline 和 media_player 合并为此单个开关
🏆 完美呈现
点击保存并退出编辑模式。
现在，整套系统从底层容器、MQTT 通信总线、HA 系统集成、到 HACS 前端大屏全部闭环打通！你可以在 HA 首页享受到纯本地、带 AI 过滤和完美时间轴回放的顶级监控体验了。
评论区