路由器

ASUS 华硕路由器

注意

Windows 所装 Home Assistant 无法使用此组件。

更新提示

本插件配置方法自 0.82 版本开始发生变化,请及时更新。

使用前请前往路由器管理界面 —— 系统管理 —— Enable SSH 或 启动 Telnet

asuswrt:
  host: 路由器IP
  username:  路由器账号
  password: 路由器密码
  protocol: 协议 ssh 或者 telnet
  port: 端口,默认 22,telnet 模式为 23
  mode: 模式,默认 router,可选 ap
  ssh_key: ssh 秘钥路径,可选

Netgear 网件路由器

device_tracker:
  - platform: netgear
    host: YOUR_ROUTER_IP
    username: YOUR_ADMIN_USERNAME
    password: YOUR_ADMIN_PASSWORD

变量说明:

  • host (必需): 路由器 IP 192.168.0.1.
  • username (可选: 管理员账户名称,默认为 admin.
  • password (可选): 管理员账户密码
  • port (可选): 端口,默认5000,部分型号使用80。

小米路由器

device_tracker:
  - platform: xiaomi
    host: YOUR_ROUTER_IP
    username: YOUR_USER_NAME
    password: YOUR_ADMIN_PASSWORD

变量说明:

  • host (必需): 路由器 IP 192.168.0.1.
  • username (可选: 管理员账户名称,默认为 admin.
  • password (可选): 管理员账户密码

华为路由器

device_tracker:
  - platform: huawei_router
    host: 192.168.1.1
    username: user
    password: pass

变量说明:

  • host (必需): 路由器 IP 192.168.0.1.
  • username (可选: 管理员账户名称,默认为 admin.
  • password (可选): 管理员账户密码

注意

此组件仅在部分设备测试通过,不保证所有华为路由器的可用性。


device_tracker:
  - platform: tplink
    host: YOUR_ROUTER_IP
    username: YOUR_ADMIN_USERNAME
    password: YOUR_ADMIN_PASSWORD

变量说明:

  • host (必需): 路由器 IP 192.168.0.1.
  • username (可选: 管理员账户名称,默认为 admin.
  • password (可选): 管理员账户密码

注意

此组件使用网络爬虫模拟用户登录的方式抓取数据,因此一旦配置此组件后,路由器的管理界面将有可能无法正常打开。

特殊设备密码加密

部分路由器的密码经过二次加密,要获取真正的秘钥,请执行以下步骤:

  • 前往路由器管理登录界面
  • 输入密码,但不要按回车,也不要选中密码
  • 打开浏览器『开发者工具』(按 F12 或者右键选检查)
  • 在浏览器终端输入 document.getElementById("login-password").value; 获取真实密钥

DD-WRT

device_tracker:
  - platform: ddwrt
    host: YOUR_ROUTER_IP
    username: YOUR_ADMIN_USERNAME
    password: YOUR_ADMIN_PASSWORD

变量说明:

  • host (必需): 路由器 IP 192.168.0.1.
  • username (可选: 管理员账户名称,默认为 admin.
  • password (可选): 管理员账户密码

Tomato

device_tracker:
  - platform: tomato
    host: IP
    username: 用户名
    password:  密码
    http_id: HTTP_ID,登录路由器界面获取

注意

此组件仅能获取无线联网设备状态,无法获取有线联网设备状态。


OpenWRT

OpenWRT 可选下列 2 种方法接入:

Luci

配置前请在路由器中安装 Luci: opkg install luci-mod-rpc

device_tracker:
  - platform: luci
    host: YOUR_ROUTER_IP
    username: YOUR_USER_NAME
    password: YOUR_ADMIN_PASSWORD

变量说明:

  • host (必需): 路由器 IP 192.168.0.1.
  • username (可选: 管理员账户名称,默认为 admin.
  • password (可选): 管理员账户密码

ubus

前置步骤:

  • 在路由器中安装 ubus: opkg install rpcd-mod-file

  • 路由器中创建 /usr/share/rpcd/acl.d/user.json 文件,复制粘贴以下内容:

{
  "user": {
    "description": "Read only user access role",
    "read": {
      "ubus": {
        "*": [ "*" ]
      },
      "uci": [ "*" ]
    },
    "write": {}
  }
}
  • 启动服务:/etc/init.d/rpcd restart && /etc/init.d/uhttpd restart
  • 确认服务已注册:ubus list | grep file
device_tracker:
  - platform: luci
    host: YOUR_ROUTER_IP
    username: YOUR_USER_NAME
    password: YOUR_ADMIN_PASSWORD

变量说明:

  • host (必需): 路由器 IP 192.168.0.1.
  • username (可选: 管理员账户名称,默认为 admin.
  • password (可选): 管理员账户密码 -dhcp_software(可选): DHCP软件默认 dnsmasq