跳到主要内容

ArtinTech Solution

Routeros online sessions in Linkhive

大多数与 MikroTik 通信的 PHP 项目都会引入一个包。在 ISP 计费平台 Linkhive 中,我们自己编写了一个小巧的 RouterOS API PHP 客户端,因为协议很简单,而每次路由器调用都会影响客户的服务。

词和句

API 通过 TCP 的 8728 端口运行,或使用 TLS 的 8729 端口。一条命令是由词组成的句子,每个词前面都带有长度。路由器的回复以 !re(一行数据)、!trap(错误)、!fatal(断开连接)和 !done(完成)开头。

两种登录方式

从 RouterOS 6.43 起,登录直接发送用户名和密码。旧版本会返回质询,因此客户端同时支持两者:

$done = $this->talk(['/login', '=name='.$username, '=password='.$password])['done'];

if (isset($done['ret'])) {
    $response = '00'.md5(chr(0).$password.hex2bin($done['ret']));
    $this->talk(['/login', '=name='.$username, '=response='.$response]);
}
Linkhive“当前在线”页面列出会话、客户、套餐、IP、MAC 地址、在线时长、路由器和流量
会话读取自每台路由器的 /ppp/active 和 /ip/hotspot/active。

让驱动保持幂等

客户端之上是一个驱动,只有一个 upsert 辅助方法:按名称查找记录,存在就更新,不存在就添加。因此同一变更执行两次也无妨,这一点很重要,因为失败的变更会重试。!trap 会变成异常,由配置层捕获并记录,再标记订阅待重试。

关键要点

  • RouterOS API 大约两百行代码就能实现。
  • 如果客户使用旧路由器,请同时支持两种登录方式。
  • 让每次路由器写入都成为 upsert,这样重试才安全。

请注意,我们的客户端不验证路由器的 TLS 证书,因为路由器通常使用自签名证书。请把 TLS 视为在你可控网络中的加密手段。

你可以在 Linkhive 在线演示中查看,或在 Vibe96 购买 Linkhive。需要定制 MikroTik 集成?与我们聊聊,或了解我们的 Laravel 开发服务。

Share this article