设备对接（设备开局）

对接要求

路由或交换设备需要接入公网（不需要公网IP），并配置好DNS服务器。

支持RouterOS v6.45-v7最新版，v6.45以下版本部分可以对接，但是功能不完整，建议使用v6.45以上版本。

支持CHR、X86、ARM等全部Mikrotik架构及所有硬件路由产品。

对接码生成和使用

在设备管理-设备对接页面，创建新的对接码，复制开局指令，到Winbox的Terminal命令行窗口即可，等待5-10秒，自动执行证书下载、增加同步计划任务操作，在RosZ设备管理页面可以看到新整的Mikrotik设备。

对接码生成和使用

设备网络检查及对接指令执行

复制对接指令前，请确保设备已正常接入网络，可以Ping通RosZ.cn，Ping指令为：

ping rosz.cn count=2

对接命令使用

对接完成及设备信息查看

对接后，可在设备管理页面查看设备状态，展开子表可浏览分类详尽数据。

设备信息查看

常见问题及故障

1. 在设备管理页面删除设备后，自动清理对接脚本、日志配置等设置信息，无需人工操作；

2. hap ac lite等单核低端设备，不建议对接使用，cpu性能太低，不足以运行监测任务，如必须使用，请不要绑定设备安全组、不要下发复杂的队列任务；

3. 对接码没有严格的数量限制，随着设备增多，上限弹性增长，可以多个设备共用相同对接码，提供多个对接码的意义是方便进行设备分组管理；

4. 在Interface/Ether的所有接口中，选定一个备注comment添加关键字"RosZ"，即可绑定到该接口MAC地址，避免X86架构重启MAC频繁切换反复创建新数据；

5. 出现错误提示“failure: unable to resolve hostname”，说明设备没有正常接入网络或未配置DNS服务器，无法正常解析域名，请检查外网配置以及DNS服务器配置。

6. X86和CHR设备自动标注0号网卡为绑定网口，备注为“RosZ”，以免X86和CHR设备绑定的MAC地址漂移变化；如需指定绑定特定网口，可自行备注即可。

7. RouterOS的默认账号admin或者唯一账号必须设置密码，否则无法导入SSL证书，不能正常对接

出现错误提示“failure: unable to resolve hostname”的解决办法

附：路由设备DNS服务器配置及连接状态检查指令

{
/ip dns set servers=114.114.114.114,119.29.29.29,223.5.5.5
/ip dns static remove [find name~"rosz"]
/ping rosz.cn count=1
/tool fetch https://rosz.cn/i
}

DNS服务器配置及相应信息

附：调低RosZ数据同步频率指令，已添加到云指令集，也可通过云指令批量下发

适用于Mikrotik单核早期设备如hap ac lite等，如果调低频率后，cpu占用仍然比较高，建议升级设备或检查策略配置

/system scheduler set [find name=RosZ.cn] interval=2m

使用云指令调低RosZ数据同步频率指令