2025.3.4
首页 ▸ Integrations ▸

Freebox

freebox 集成允许您观察和控制 Freebox 路由器。

目前 Home Assistant 支持以下设备类型：

配置

要将 Freebox integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

Freebox 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

您可以通过在浏览器中打开此地址 http://mafreebox.freebox.fr/api_version 来找到您的 Freebox 主机和端口。 返回的 JSON 应包含 api_domain（host）和 https_port（port）。 更多信息请参阅 API 文档。

Tip

由 http://mafreebox.freebox.fr/api_version 提供的 host（例如：xxxxxxxx.fbxos.fr）和 port 指的是您的 Freebox 公共 IP 地址，如果您的 Home Assistant 服务器位于本地局域网内，可能无法使用。对于本地 API 访问，您可以使用 host = mafreebox.freebox.fr 和 port = 443。

初始设置

Important

您必须为 Freebox 路由器的网络管理页面设置密码。在“Gestion des ports” > “Connexions entrantes”中启用“Permettre les nouvelles demandes d’associations”选项，并确保“Accès à distance sécurisé à Freebox OS”选项处于激活状态。

Home Assistant 第一次连接到您的 Freebox 时，您需要通过在提示时按下 Freebox 面板上的右箭头进行授权。

要使 Wi-Fi 开关和重启操作生效，您需要在“Paramètres de la Freebox” > “Gestion des accès” > “Applications”中为 Home Assistant 应用程序添加“Modification des réglages de la Freebox”权限。

要使用 Freebox Delta 的摄像头，您需要在“Paramètres de la Freebox” > “Gestion des accès” > “Applications”中为 Home Assistant 应用程序添加“Gestion de l’alarme et maison connectée”权限。

支持的路由器

仅支持具有 Freebox OS 的路由器：

  • Freebox V8，也称为 Freebox Pop
  • Freebox V7，也称为 Freebox Delta
  • Freebox V6，也称为 Freebox Revolution
  • Freebox mini 4k

存在检测

此平台通过跟踪连接到 Freebox 路由器的设备来提供存在检测。

注意事项

请注意，Freebox 在将设备标记为不活动之前会等待一段时间，这意味着在您断开设备和它在 Home Assistant 中显示为“离线”之间会有短暂延迟（1 或 2 分钟）。在指定 consider_home 参数时应考虑到这一点。 相反，Freebox 会立即报告新连接的设备，因此它们应该几乎能够即时显示为“在线”，只要 Home Assistant 刷新设备状态。

传感器

此平台为您提供监控 Freebox 路由器的传感器。 监控的指标包括：

  • 内部温度
  • 上传和下载速率（以 KB/s 为单位）
  • 已用磁碟的可用分区空间
  • 未接来电数量

二元传感器

可以使用诊断二元传感器监控每个 RAID 阵列的健康状态，反映其 degraded 状态（OK 表示未退化，PROBLEM 表示已退化）。

摄像头

摄像头仅在 Freebox V7（也称为 Freebox Delta）中可用。

二元

此平台为您提供监控：

  • 动作传感器
  • 门开关
  • 塑料盖

报警控制面板

此集成允许您查看和控制 Freebox 报警控制面板。

操作

操作 freebox.reboot

此操作将重新启动您的 Freebox 路由器。它不接受任何参数。请注意，不会有确认提示。

开关

此平台为您提供一个开关来切换 Wi-Fi 的开启或关闭。这将切换路由器的所有 Wi-Fi 接口（所有 SSID 和所有频段）。