零配置方案:Zabbix + HTTP 代理实现内网穿透工具的自动化管理

简介: 本文作者蔡斯,Zabbix社区签约专家,Zabbix 6.0/7.0官方译者。文章探讨如何利用Zabbix的HTTP代理与低级别发现(LLD)功能,实现对免费内网穿透工具的自动化监控,解决多账号、多设备管理难、服务状态盲区等痛点,打造零侵入、零配置、无限扩展的智能监控体系。

作者简介
感谢本文作者蔡斯,Zabbix社区签约专家,Zabbix6.0、7.0官方译者。

一、背景:免费穿透工具的管理之痛

近年来,家庭 4K 影院、远程剪辑、NAS 灾备……需求井喷;随着IPv4 枯竭、IPv6 普及受限,让「移动观影 + 异地组网」成为刚需。FRP、ZeroTier、N2N 等零成本穿透方案迅速流行,却也带来三大痛点:

  • 商软免费节点限制多,多账号、多中转设备难管理
  • 异地组网服务端口随机分配,无法设定固定值
  • 既无 snmp,也固定探针,内网服务运行状态全靠“盲猜”

本文以「穿透工具A」为例,演示如何借助 Zabbix 低级别发现(LLD)+ HTTP 代理打造一次配置、"终身"自治的监控体系,支持无限横向扩展。

二、HTTP 代理:Zabbix 的"万能数据采集器"

HTTP agent 是 Zabbix 内置的一种无 Agent 采集方式:

  • 由 Server/Proxy 主动发起 HTTP/HTTPS 请求
  • 支持 Header、POST、Cookie、Auth、SSL 等完整 HTTP 语义
  • 返回体可以是 JSON、XML、Text,再配合 预处理 做二次解析

通过「穿透工具A」 REST 接口我们把它“拉”进Zabbix监控,实现多账号多设备零侵入纳管。

三、「穿透工具A」接口长什么样?

下文仅保留关键字段与含义,敏感 ID、域名、MAC 等已全部替换为占位符。

注:本文中不涉及任何用户隐私数据或敏感信息,所有数据均为示例数据,使用这些浏览器暴露接口的行为是基于技术研究和学习目的,并且不用于任何商业或非法用途。

3.1 账号级流量统计
POST/user/flow_stat

{
   
  "rtn": 0,
  "data": {
   
    "ddnsBytes": 1782357604,
    "relayBytes": 259885
  }
}

字段说明

ddnsBytes:累计直流流量(单位字节),需 ÷ 1024³ 转 GB

relayBytes:累计中转流量(单位字节),需 ÷ 1024³ 转 GB

3.2 内网穿透条目配置
POST/ddns/cfg/list
作用:列出当前账号下所有已创建的 DDNS 映射条目,供 LLD 用。

{
   
  "rtn": 0,
"datas": [
    {
   
      "id": xxxx,
      "peerid": "xxxx",
      "domain": "xxx.iepose.cn",
      "protocolLan": "https",
      "lanAddr": "192.168.0.xx:5001",
      "status": true,
      "uid": "xxxxx",
      "comment": "群晖NAS",
      ....
    }
  ]
}

字段说明

rtn:0 = 成功
datas[].id:映射记录内部 ID(示例:xxxxx→ MAP_ID)
datas[].peerid:节点唯一标识(示例:AD1*OW→ NOD_ID)
datas[].domain:暴露给外网的域名(示例:xxx.iepose.cn→ EXAMPLE_DOMAIN)
datas[].lanAddr:内网地址端口(示例:192.168.0.19:1234→ 192.168.x.x:PORT)
datas[].status:true = 映射在线
datas[].checkin:true = 心跳正常

3.3 中转设备绑定管理
GET/jdis/bindget?
作用:拉取账号下所有已绑定设备,含网卡、版本等信息,供 LLD 用。

{
   
    "terms": [
        {
   
            "peerid": "xxxx",
            "term": {
   
                "nic": [
                    {
   
                        "mac": "xxxxxxxxxx",
                        .....
                ],
                "name": "LAPTOP-MICLE",
                "ip": xxxxxxx,
                "isp": "联通",
                "location": "深圳",
                ..........
            },
            "role": 1
        },
        {
   
            "peerid": "XXXXXXXXXXXXXXXXX",
            .....
}

字段说明

terms[].peerid:设备唯一 ID

terms[].term.name:设备别名

terms[].term.status:设备在线状态,出现status则表示掉线

terms[].term.ip:大端序格式 → 需结合预处理转为十进制 IP

terms[].term.nic[].ipv4n:网卡 IP(大端序整数格式)

terms[].term.nic[].mac:原始 MAC → 需格式化为 XX:XX:XX:XX:XX

terms[].term.nbhttp/ nbhttps:「穿透工具A」对外 HTTP/HTTPS 端口

3.4 中转设备代理服务清单
GET/jdis/servicelist?
作用:列出每台设备代理的内网的服务及端口,供 LLD 用。

{
   
    "jd": [
        {
   
            "ip": 151038144,
            "dtype": 999,
            "status": 1,
            "name": "grafana",
            "ports": [
                3000
            ],
            "svs": [
                {
   
                    "port": 3000
                }
            ],
            "peerid": "XXXXXXXXXXXXXXXXXXX",
        },
        ......
    ]
}

字段说明

jd[].ip:大端序格式 → 需结合预处理转为十进制 IP

jd[].name:服务名称(如 grafana、DSM、路由器)

jd[].ports:端口数组,可一对多

jd[].status:1 = 正常运行

将以上 JSON 汇总后喂给 Zabbix LLD,即可实现 账号-设备-流量-服务 四维自动发现。

四、LLD 规则:让「穿透工具A」接口“自报家门”

通过几大核心 REST 接口数据得知,「穿透工具A」对内网穿透管理分为两个层级:一个是系统层级,即账号级流量;另一个是设备级别;因此结合 Zabbix LLD 规则,“系统级静态指标”用普通监控项,“设备级动态对象”用 LLD,即可支持多设备。

4.1 创建直流和中转流量监控项
4.1.1 账号当月使用流量
类型:HTTP agent
Key:flow.stat
URL:https://xxx.xxx.com/user/flow_stat
请求类型:POST
请求正文:{"uid":"{$UID}","owcode":"{$OWCODE}"}
请求头部:-H 'accept: application/json, text/plain, /' -H 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36 Edg/139.0.0.0'
调试监控项
image.png

4.1.2 分离直流和中转数据
结合HTTP 代理采集回来的数据,我们可以自带相关项目方法关联它,单位是字节B。

image.png

然后通过预处理JSONPath
将这些JSON格式的数据轻松分离作为一个单独的监控项,好处就是减少采集次数,充分利用已有数据。
image.png

接着我们来验证一下,配置的参数是否正确,毕竟这是Zabbix UI给我们提供极简的scriptsless,无需通过手写scirpts即可完成debug。

image.png

观察最新采集的数据,中转和直流流量已正确识别出来。

image.png

对比「穿透工具A」控制台的流量数据。

image.png

4.2 创建内网穿透条目获取 LLD 规则
创建 LLD 规则的目标是暴露采集同类型不同规格的参数,为了减少对HTTP 代理的依赖,我们在创建LLD规则前,需要先建立一个普通的监控项。

4.2.1 内网穿透条目
类型:HTTP agent
Key:cfg.list
URL:https://xxx.xxx.com/ddns/cfg/list
请求类型:POST
请求正文:{"uid":"{$UID}","owcode":"{$OWCODE}"}
请求头部:-H 'accept: application/json, text/plain, /' -H 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36 Edg/139.0.0.0'
调试监控项

image.png

4.2.2 内网穿透条目:条目发现
类型:相关项目
Key:cfg.discovery
主要项:内网穿透条目
暴露宏变量:{#NATID}
{#NATDOMAIN}
预处理(JavaScript 统一转换)暴露宏变量

var res = JSON.parse(value);
var lld = [];

res.datas.forEach(function(item){
   
    lld.push({
   
        "{#NATID}"    : item.id,
        "{#NATDOMAIN}"    : item.domain
    });
});

return JSON.stringify({
   data: lld});

老道理,同样通过测试步骤,输入RESP接口采集回来的JSON
数据进行加工测试,得到{"data":[{"{#NATID}":xxxx,"{#NATDOMAIN}":"xxxx.iepose.cn"}]},如下图。

image.png

4.2.3 内网穿透条目:条目发现-监控项原型
在LLD 自动发现规则中创建监控项原型,才能继用它暴露的宏变量,这里演示如何获取穿透的内网地址。

类型:相关项目
Key:lanAddr[{#NATID}]
主要项:内网穿透条目
如下图所示:

image.png

结合预处理JSONPath和正则匹配$.datas[?(@.id=="{#NATID}")].lanAddr,成功匹配到内网代理IP和端口

image.png

查看最新采集的数据,内网协议,内网地址,映射开启状态均已显示。

image.png

对比「穿透工具A」控制台的内网穿透配置,完全一样!

image.png

4.3 创建中转设备绑定查询 LLD 规则
创建 LLD 规则的目标是暴露采集同类型不同规格的参数,为了减少对HTTP 代理的依赖,我们在创建LLD规则前,需要先建立一个普通的监控项。

4.3.1 中转设备管理
类型:HTTP agent
Key:bind.get
URL:https://xxx.xxx.com/jdis/bindget
请求:GET
查询字段:uid=xxx&owcode=xxx&product=2581&cache_ver=0.29773539924079817
请求头部:同理
调试监控项

image.png

4.3.1 中转设备管理:设备发现
类型:相关项目
Key:dev.discovery
主要项:内网设备管理
暴露宏变量:{#PEERID}
{#NAME}
预处理(JavaScript 统一转换)暴露宏变量

// 只遍历顶级 terms,每台设备生成 1 条发现记录

var lld = [];
var root = JSON.parse(value);

root.terms.forEach(function(node){
   
    var t = node.term;
    lld.push({
   
        "{#PEERID}"   : node.peerid,
        "{#NAME}"     : t.name
    });
});
return JSON.stringify({
   data: lld});

同样通过测试步骤,输入RESP接口采集回来的JSON
数据进行加工测试,得到{"data":[{"{#PEERID}":"xxx","{#NAME}":"xxx"},{"{#PEERID}":"xxx","{#NAME}":"xxx"}]},如下图。

image.png

4.2.3 内网设备挂历:设备发现-监控项原型
在LLD 自动发现规则中创建监控项原型,才能继用它暴露的宏变量,这里演示如何获取穿透的公网IP。

类型:相关项目
Key:ip["{#NAME}"]
主要项:中转设备管理
如下图所示:

image.png

结合预处理JSONPath和正则匹配$.terms[?(@.peerid=="{#PEERID}")].term.ip,可获取到大端序的IP地址。

预处理(JavaScript 统一转换)

function intToIP(i){
   
    return [
    i & 0xFF,           // 最低字节 → 第 1 段
    (i >>> 8) & 0xFF,   // 次低字节 → 第 2 段
    (i >>> 16) & 0xFF,  // 次高字节 → 第 3 段
    (i >>> 24) & 0xFF   // 最高字节 → 第 4 段
     ].join('.');
}
return intToIP(parseInt(value));

再结合JavaScrips进行转换,可得出最终IP地址。

image.png

4.4 创建中转设备代理服务 LLD 规则
因篇幅原因,本节不做展开,和以上同理。

五、基于自动发现创建监控原型和触发器

5.1 一张图看懂监控纳管流程

「穿透工具A」 API
     │
     ├─ HTTP Agent → LLD 规则 → 生成宏 {
   #PEERID} {
   #NAME} {
   #NATDOMAIN} …
     │                    │
     │                    ├─ Item Prototype
     │                    ├─ Trigger Prototype
     │                    └─ Graph Prototype
     │
     └─ 新节点上线 → 自动纳入监控,无需人工干预

零侵入:无需在节点安装 Agent
零配置:节点增减自动发现
零费用:HTTP 代理 + 免费穿透工具即可落地
5.2 服务端口可用性原型
字段示例

Item Prototype Key : net.tcp.service[tcp,{#SERVICEIP},{#SERVICEPORT}]

Trigger Prototype : last(/OWJDXB by HTTP/net.tcp.service[tcp,{#SERVICEIP},{#SERVICEPORT}])=0

5.3 监控主机内存容量(GB)
实践得知,Linux和Docker系的「穿透工具A」客户可以获取宿主机的总内存和已用内存,指令类似free -m单位 MB ,需要通过预处理倍数 1024x1024进行转换,单位Units 填 B,因为Zabbix不支持MB。

image.png

5.4 动态 HTTP 监控
通过HTTP 代理我们还可以将内网穿透条目中的公网域名纳入监控,判断其标题如果出现:XX无法打开页面即表示网络或者客户端出现问题。

类型:HTTP 代理
Key:web.title.check[{#NATID}]
URL:{#PROTOCAL}://{#NATDOMAIN}
预处理:(?i)]>([^<])
5.5 自动发现及常规监控项总览
image.png

六、「穿透工具A」监控实战

6.1 添加「穿透工具A」监控
首次需登录「穿透工具」控制台,打开F12找到list链接,点击负载获取你的UID和OWCODE。

image.png

回到Zabbix添加主机,关联我们制作好的「穿透工具A」监控专用模板。

image.png

配置宏变量,其中·{零配置方案:Zabbix + HTTP 代理实现内网穿透工具的自动化管理_数据_21OWCODE}是前面获取的,{$PHONE}是你登录手机号。

image.png

6.2 配置监控看板和查看数据
在仪表盘中,我们添加TOP主机类型组件,即可得到多个账号多个设备在线状态、账号级的流量数据。后续结合Grafana,可扩展出更多的列表数据,如设备的出口IP,映射公网域名等。

image.png

image.png


6.3 查看及触发告警

中转设备代理的服务,即内网服务掉线则会发出告警:

image.png

中转设备掉线,通过HTTP 代理及JavaScrip匹配映射出来的DDNS条目(访问域名)进行实时访问的页面标题,判断是否在线。

image.png

七、总结

本文详尽介绍如何通过HTTP 代理结合预处理中的JSONPath和JavaScript,模拟浏览器将「穿透工具A」的REST接口返回的Json数据进行过滤和匹配,结合Zabbix LLD规则将多中转设备的数据纳管到监控原型中,实现一个都不能少的目标。

作为抛砖引玉,笔者选「穿透工具A」作为功能演示,提供一种零侵入、零配置的监控思路和实现方案。

笔者注:文中所提及的工具名称仅为示例,不代表任何特定品牌或产品;使用本文中的方法和技术时,请确保遵守相关法律法规和服务条款。

相关文章
|
4天前
|
搜索推荐 编译器 Linux
一个可用于企业开发及通用跨平台的Makefile文件
一款适用于企业级开发的通用跨平台Makefile,支持C/C++混合编译、多目标输出(可执行文件、静态/动态库)、Release/Debug版本管理。配置简洁,仅需修改带`MF_CONFIGURE_`前缀的变量,支持脚本化配置与子Makefile管理,具备完善日志、错误提示和跨平台兼容性,附详细文档与示例,便于学习与集成。
296 116
|
19天前
|
域名解析 人工智能
【实操攻略】手把手教学,免费领取.CN域名
即日起至2025年12月31日,购买万小智AI建站或云·企业官网,每单可免费领1个.CN域名首年!跟我了解领取攻略吧~
|
7天前
|
数据采集 人工智能 自然语言处理
Meta SAM3开源:让图像分割,听懂你的话
Meta发布并开源SAM 3,首个支持文本或视觉提示的统一图像视频分割模型,可精准分割“红色条纹伞”等开放词汇概念,覆盖400万独特概念,性能达人类水平75%–80%,推动视觉分割新突破。
467 44
Meta SAM3开源:让图像分割,听懂你的话
|
13天前
|
安全 Java Android开发
深度解析 Android 崩溃捕获原理及从崩溃到归因的闭环实践
崩溃堆栈全是 a.b.c?Native 错误查不到行号?本文详解 Android 崩溃采集全链路原理,教你如何把“天书”变“说明书”。RUM SDK 已支持一键接入。
686 222
|
2天前
|
Windows
dll错误修复 ,可指定下载dll,regsvr32等
dll错误修复 ,可指定下载dll,regsvr32等
134 95
|
11天前
|
人工智能 移动开发 自然语言处理
2025最新HTML静态网页制作工具推荐:10款免费在线生成器小白也能5分钟上手
晓猛团队精选2025年10款真正免费、无需编程的在线HTML建站工具,涵盖AI生成、拖拽编辑、设计稿转代码等多种类型,均支持浏览器直接使用、快速出图与文件导出,特别适合零基础用户快速搭建个人网站、落地页或企业官网。
1685 158
|
存储 人工智能 监控
从代码生成到自主决策:打造一个Coding驱动的“自我编程”Agent
本文介绍了一种基于LLM的“自我编程”Agent系统,通过代码驱动实现复杂逻辑。该Agent以Python为执行引擎,结合Py4j实现Java与Python交互,支持多工具调用、记忆分层与上下文工程,具备感知、认知、表达、自我评估等能力模块,目标是打造可进化的“1.5线”智能助手。
931 61