极简探针(monitor) 第三方FreeBSD Agent

[!danger] 免责申明: 本项目由 AI 辅助完成. 使用本项目产生的一切后果由使用者自行承担,项目作者不对任何直接或间接损失负责.

本 Agent 仓库地址: https://github.com/MaoShiSanKe/monitor-agent-freebsd

探针官方文档: https://monitor-document.pages.dev/

探针官方 Github: https://github.com/monitor-probe/

由于本人只有 serv00 的 FreeBSD 系统, 所以对 Serv00 做了适配

Agent 概览:

• 协议层复用官方 Linux agent 的代码（MIT），采集层针对 FreeBSD 重写：全部走 sysctl / getfsstat / getifaddrs 内核接口，不读 /proc、不调外部命令


• 产出约 1.5MB 单二进制，内存占用约 20MB（含 rustls TLS 栈）

前置条件

jail 用户的磁盘配额：源码 + 编译缓存约需 300MB~500MB。编译完可删 target/ 目录释放大半。

第一步：编译

git clone https://github.com/MaoShiSanKe/monitor-agent-freebsd.git

cd monitor-agent-freebsd

cargo build --release



    

  

首次编译拉取依赖约 1-3 分钟。产物在 target/release/monitor-agent-freebsd。

自检（可选但建议）：

cargo test --release

# 应输出：test result: ok. 20 passed



    

  

第二步：安装到固定位置

install -d ~/bin

cp target/release/monitor-agent-freebsd ~/bin/

~/bin/monitor-agent-freebsd --help



    

  

能打印用法即安装成功。

第三步：试运行

~/bin/monitor-agent-freebsd --server https://你的面板域名 --token 你的节点token --interval 2



    

  

成功标志：

counting traffic on: bge0 bge1 ue0     ← 列出参与流量统计的网卡（你的机器上名字会不同）

connected to x.x.x.x:443               ← 连上 hub（经 Cloudflare 时显示 CF 的 IP）



    

  

此时刷新面板，节点应已点亮。Ctrl+C 停掉，进入下一步。

第四步：常驻运行

（无 root 方案）

jail 没有 systemd/OpenRC。用 FreeBSD 自带的 daemon(8) + crontab 实现开机自启 + 崩溃自动拉起：

crontab -e



    

  

加入一行（注意 daemon 在 /usr/sbin）：

@reboot /usr/sbin/daemon -r /home/你的用户名/bin/monitor-agent-freebsd --server https://你的面板域名 --token 你的token --interval 2 >> /home/你的用户名/monitor-agent.log 2>&1



    

  

再手动启动一次（不用等重启）：

/usr/sbin/daemon -r /home/你的用户名/bin/monitor-agent-freebsd --server https://你的面板域名 --token 你的token --interval 2 >> ~/monitor-agent.log 2>&1 &



    

  

验证守护有效：kill 掉 agent 进程，1 秒内 ps aux | grep monitor-agent 应出现新 PID（daemon -r 的自动重启）。

有 root 的完整 FreeBSD 机器

可以写 rc.d 脚本，或者同样用上面的 daemon + cron 方案。

运行参数

也支持环境变量 MONITOR_SERVER / MONITOR_TOKEN / MONITOR_IFACE。

jail 环境的数据口径

serv00 等 FreeBSD jail 共享宿主内核，指标口径如下——装前须知，免得误会数据造假：

这些是 FreeBSD jail 的固有行为，不是 agent 的 bug。

更新

cd ~/monitor-agent-freebsd

git pull

cargo build --release

cp target/release/monitor-agent-freebsd ~/bin/

pkill -f monitor-agent-freebsd



    

  

daemon -r 会在 1 秒内用新二进制把进程拉起来，无感更新。agent 本身没有自动更新，需要手动执行。

卸载

pkill -f monitor-agent-freebsd

crontab -e          # 删掉 @reboot 那行

rm ~/bin/monitor-agent-freebsd

rm -rf ~/monitor-agent-freebsd ~/monitor-agent.log



    

  

hub 面板上删除或隐藏该节点即可，无需其他清理。

常见问题

Q：编译报 error: linker 'cc' not found

A：缺基础工具链。serv00 自带；自己的机器 pkg install rust llvm 即可。

Q：面板显示在线但 CPU/内存数字巨大

A：正常——jail 共享宿主，显示的是整台机器（见上文口径表）。

Q：流量数字从安装那一刻起就几百 GB？

A：正常——上报的是内核的生命周期累计计数器（宿主机开机至今），hub 从此刻开始累计增量。面板上"日流量/月流量"从安装起算才是你自己的用量。

Q：hub 返回 401

A：token 错了。回面板节点列表重新复制完整 token（64 位十六进制）。

Q：daemon: not found

A：用完整路径 /usr/sbin/daemon，FreeBSD base 系统自带，jail 一般不屏蔽。

Q：掉线后多久面板变灰？

A：hub 侧判定约 150 秒。agent 掉线后会自动指数退避重连（1s→60s），hub 恢复后自动上线，无需人工干预。

与官方 Linux agent 的差异

• 仅采集层（collect.rs）是 FreeBSD 实现；协议层与官方代码同源，行为一致（心跳、重连退避、ping 探测、并发上限保护全部相同）


• boot_id 用 kern.boottime + 网卡集合摘要生成（FreeBSD 没有 Linux 的 boot_id 文件），重启后 hub 自动重新基线流量


• 官方 install.sh 一键脚本不适用于 FreeBSD（它依赖 systemd/OpenRC），本文的手动流程即 jail 等价物

如果你部署在 Serv00 , 在部署全部完成后, 你的探针就会出现一台超级🐥 ^-^