设备及服务 - 路由器

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 (可选): 管理员账户密码

注意

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

TP-LINK 路由器

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