别让插件变成后门！手把手教你审计 HA Add-on 的 Docker 隔离安全性。

很多玩家在 Home Assistant (HA) 里安装插件（Add-ons）时，习惯了“一键安装”的快感。看到喜欢的各种功能，点一下 Install，甚至都不看一眼那个红色的“受保护模式”开关。作为一名处理过多次私有化环境渗透测试的架构师，我不得不提醒你：每一个 Add-on 本质上都是一个运行在你内网核心的 Docker 容器。如果这个插件的开发者安全意识淡薄，或者它申请了过高的内核权限，你的整个家庭网段对黑客来说就是不设防的。

在 Home Assistant Add-on Security 的范畴内，权限越界是目前最大的隐患。今天我们不谈怎么使用，我们直接进入生产环境，教你如何像安全专家一样审计那些号称“功能强大”的插件，看看它们是否在背后悄悄打开了通往你内核的后门。

💡 报错现象总结：用户在安装某些第三方插件后，发现系统日志中频繁出现 AppArmor denied 或 Permission denied。本质原因是插件尝试请求超出其安全配置文件的敏感权限（如直接访问 /dev/mem 或修改主机网卡），被 HA 底层的安全审计机制强制拦截。

---

剖析 Add-on 权限声明：谁在觊觎你的 root 权限？

在 HA 的架构中，插件的安全性由 config.yaml（或者 config.json）定义的 Options 决定。作为架构师，你必须警惕以下三个关键字段：

1. privileged：开启毁灭之门的钥匙

如果一个插件要求 privileged: true，意味着它几乎拥有和主机内核一样的权限。它能挂载文件系统、配置网络接口，甚至绕过所有的 Docker 隔离。

// 模拟一个极度危险的插件配置
{
  "name": "Super Tool",
  "privileged": ["SYS_ADMIN", "NET_ADMIN"], // 允许修改网络和系统管理
  "host_network": true, // 直接共享主机的网络栈
  "map": ["config:rw", "addons:rw"] // 读写所有的配置和插件目录
}

2. host_network 与端口陷阱

当插件启用 host_network: true 时，它不再受虚拟网桥限制。这意味着如果插件内运行的服务有漏洞，黑客可以直接扫描你局域网内的 NAS 或摄像头，而不需要经过任何跳转。

3. apparmor 策略：最后的防线

HA 默认会为每个插件分配一个 AppArmor 配置文件。如果日志里出现权限拒绝，那是底层的隔离机制在保护你。很多小白为了“能跑通”，会搜索如何禁用 AppArmor。架构师警告：这是自杀行为。

权限级别	标识符	风险等级	架构师审计建议
标准隔离	apparmor: true	安全	绝大多数纯软件服务（如 MQTT 界面）应停留在此
硬件直通	device: [...]	中等	仅允许访问指定的 USB 设备（如 Zigbee 网关）
网络共享	host_network: true	高	必须确保该插件不监听任何高危端口
特权模式	privileged: true	极高	除非是底层监控工具，否则一律拒绝安装

---

手动审计 Add-on 安全性的“笨办法”

当你从第三方仓库（非官方社区）看到一个诱人的插件时，不要直接点 Install，先做三件事：

第一步：检查 repository 的 Dockerfile

去该插件的 GitHub 仓库，看它的 Dockerfile。

• 它是否使用了 USER root？
• 它的基础镜像是否来自可信源（如 alpine 或 debian）？
• 它是否在启动脚本（run.sh）里执行了类似 chmod 777 的骚操作？

第二步：利用 docker inspect 现场取证

如果插件已经在运行，进入 HA 的宿主机 Shell，执行：

docker inspect addon_<slug_name> | grep -i "Capabilities"

看看它到底拿到了哪些内核能力（Capabilities）。如果看到 CAP_SYS_RAWIO，这意味着它能直接操作物理内存。

痛苦的临时方案：为何“手动修改隔离级别”不可取？

有些进阶玩家会尝试手动去改 /data/addons/core/xxx/config.v2.json。 这非常痛苦：

1. 自动回滚：HA 的 Supervisor 只要检测到配置不符，就会在重启时强制覆盖你的修改。
2. 签名失效：修改后的容器可能无法正常升级，导致你永远停留在有漏洞的旧版本。

---

获取插件安全审计脚本

与其冒着内网被渗透的风险去“盲测”第三方插件，不如建立一套标准化的审计流程。

我已经根据工业级容器安全标准，在 GitCode 上同步了一套**《HA 插件安全审计脚本》**。这套工具能一键扫描你当前已安装的所有插件，并根据 AppArmor 策略、Capabilities 申请以及 Host Network 占用情况，自动生成一份安全评估报告。

在 GitCode 仓库中，我还提供了一套**《插件加固模板》**，教你如何通过修改 Add-on 的声明文件，将那些“权限要得太多”的插件关进安全的笼子里。

家庭网络的安全不容试错。 作为一个老兵，我建议你立即前往 GitCode 仓库下载这套审计脚本。与其事后重装全家系统，不如事前把风险掐死在容器之外。

[前往 GitCode 下载插件安全审计脚本]