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 按钮不起作用,您也可以手动执行以下步骤:
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在右下角,选择
Add Integration 按钮。 -
从列表中选择 MikroTik。
-
按照屏幕上的说明完成设置。
使用证书
要使用 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