作者简介
感谢本文作者蔡斯，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 用。
{
"terms": [
{
"peerid": "xxxx",
"term": {
"nic": [
{
"mac": "xxxxxxxxxx",
.....
],
"name": "LAPTOP-MICLE",
"ip": xxxxxxx,
"isp": "联通",
"location": "深圳",
..........
},
"role": 1
},
{
"peerid": "XXXXXXXXXXXXXXXXX",
.....
}字段说明
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'
调试监控项
4.1.2 分离直流和中转数据
结合HTTP 代理采集回来的数据，我们可以自带相关项目方法关联它，单位是字节B。
然后通过预处理JSONPath
将这些JSON格式的数据轻松分离作为一个单独的监控项，好处就是减少采集次数，充分利用已有数据。
接着我们来验证一下，配置的参数是否正确，毕竟这是Zabbix UI给我们提供极简的scriptsless，无需通过手写scirpts即可完成debug。
观察最新采集的数据，中转和直流流量已正确识别出来。
对比「穿透工具A」控制台的流量数据。
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'
调试监控项
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"}]}，如下图。
4.2.3 内网穿透条目:条目发现-监控项原型
在LLD 自动发现规则中创建监控项原型，才能继用它暴露的宏变量，这里演示如何获取穿透的内网地址。
类型：相关项目
Key：lanAddr[{#NATID}]
主要项：内网穿透条目
如下图所示：
结合预处理JSONPath和正则匹配$.datas[?(@.id=="{#NATID}")].lanAddr，成功匹配到内网代理IP和端口
查看最新采集的数据，内网协议，内网地址，映射开启状态均已显示。
对比「穿透工具A」控制台的内网穿透配置，完全一样！
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
请求头部：同理
调试监控项
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"}]}，如下图。
4.2.3 内网设备挂历:设备发现-监控项原型
在LLD 自动发现规则中创建监控项原型，才能继用它暴露的宏变量，这里演示如何获取穿透的公网IP。
类型：相关项目
Key：ip["{#NAME}"]
主要项：中转设备管理
如下图所示：
结合预处理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地址。
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。
5.4 动态 HTTP 监控
通过HTTP 代理我们还可以将内网穿透条目中的公网域名纳入监控，判断其标题如果出现：XX无法打开页面即表示网络或者客户端出现问题。
类型：HTTP 代理
Key：web.title.check[{#NATID}]
URL：{#PROTOCAL}😕/{#NATDOMAIN}
预处理：(?i)]>([^<])
5.5 自动发现及常规监控项总览
六、「穿透工具A」监控实战
6.1 添加「穿透工具A」监控
首次需登录「穿透工具」控制台，打开F12找到list链接，点击负载获取你的UID和OWCODE。
回到Zabbix添加主机，关联我们制作好的「穿透工具A」监控专用模板。
配置宏变量，其中·{零配置方案：Zabbix + HTTP 代理实现内网穿透工具的自动化管理_数据_21OWCODE}是前面获取的，{$PHONE}是你登录手机号。
6.2 配置监控看板和查看数据
在仪表盘中，我们添加TOP主机类型组件，即可得到多个账号多个设备在线状态、账号级的流量数据。后续结合Grafana，可扩展出更多的列表数据，如设备的出口IP，映射公网域名等。
6.3 查看及触发告警
中转设备代理的服务，即内网服务掉线则会发出告警：
中转设备掉线，通过HTTP 代理及JavaScrip匹配映射出来的DDNS条目(访问域名)进行实时访问的页面标题，判断是否在线。
七、总结
本文详尽介绍如何通过HTTP 代理结合预处理中的JSONPath和JavaScript，模拟浏览器将「穿透工具A」的REST接口返回的Json数据进行过滤和匹配，结合Zabbix LLD规则将多中转设备的数据纳管到监控原型中，实现一个都不能少的目标。
作为抛砖引玉，笔者选「穿透工具A」作为功能演示，提供一种零侵入、零配置的监控思路和实现方案。
笔者注：文中所提及的工具名称仅为示例，不代表任何特定品牌或产品；使用本文中的方法和技术时，请确保遵守相关法律法规和服务条款。