MikroTik

mikrotik 平台通过查看连接到 MikroTik RouterOS 基于路由器的设备来提供存在检测。

目前在 Home Assistant 中支持以下设备类型:

  • 存在检测

前提条件

您必须在路由器上启用访问 RouterOS API 才能使用该平台。

RouterOS 使用 ping 测试来确定客户端的存在,请确保您没有在客户端上阻止此操作(Windows 防火墙的默认行为),因为这将导致提供的 device_tracker 的状态为 not_home

终端:

/ip service
set api disabled=no port=8728

网页前端:

转到 IP -> 服务 -> API 并启用它。

确保端口 8728 或您选择的端口可以从您的网络访问。

配置

要将 MikroTik integration 添加到您的 Home Assistant 实例中,请使用此 My 按钮:

手动配置步骤

如果上述 My 按钮不起作用,您也可以手动执行以下步骤:

使用证书

要使用 SSL 连接到 API(通过 api-ssl 而非 api 服务),在 RouterOS 方面需要进一步的配置。您必须上传或生成证书并配置 api-ssl 服务以使用它。以下是自签名证书的示例:

/certificate add common-name="API 的自签名演示证书" days-valid=3650 name="API 的自签名演示证书" key-usage=digital-signature,key-encipherment,tls-server,key-cert-sign,crl-sign
/certificate sign "API 的自签名演示证书"
/ip service set api-ssl certificate="API 的自签名演示证书"
/ip service enable api-ssl

如果一切正常,您可以在 RouterOS 中禁用纯 api 服务:

/ip service disable api

RouterOS 中的用户权限

要使用此设备跟踪器,您只需有限的权限。为了增强您的 MikroTik 设备的安全性,请创建一个仅具有 API 和 ping 测试权限的 “只读” 组,并将用户添加到该组:

/user
group add name=homeassistant policy=read,api,test
add group=homeassistant name=homeassistant

您将被提示为新创建的用户设置密码。根据您的 RouterOS 版本和配置,您可能需要自己设置密码:

/user set [find username=homeassistant] password=PASSWORD