接入探针 — ProbeDeck 文档

生成安装命令

管理面板 → 服务器 → 添加服务器 → 点「安装命令」。

命令里的 SERVER_ID 和 SECRET 由面板生成，不要自己编。地址取自你访问面板时的地址，所以必须先配好反向代理。

支持的平台

平台	安装方式
Linux	`install.sh`，自动识别 systemd 与 OpenRC
Alpine	同上
OpenWrt	同上（无 systemd，走 OpenRC）
macOS	`install.sh`
Windows	`install.ps1`（PowerShell）
群晖 / fnOS	Docker 镜像
Docker / Unraid	Docker 镜像（amd64 + arm64）

Docker / Unraid 部署

在「安装命令」弹窗里把目标系统下拉切到 Docker / Unraid，命令框会直接生成可用的 docker run：

docker run -d \
  --name cf-probe \
  --restart unless-stopped \
  -e SERVER_ID=<服务器ID> \
  -e SECRET=<服务器密钥> \
  -e WORKER_URL=https://<面板地址>/update \
  -v /opt/cf-probe:/etc/cf-probe \
  ghcr.io/gg949/cfsm-agent:latest

bash

/etc/cf-probe 必须挂卷——里面存配置与流量计数，不挂的话容器重建后数据全丢。

默认 bridge 网络下只统计容器自己的虚拟网卡。要监控宿主机真实流量请加 --network host。

Unraid 用户可以在容器设置里给个图标：

https://raw.githubusercontent.com/gg949/cfsm-agent/main/docker/icon.png

三个环境变量

变量	是什么
`SERVER_ID`	面板给这台机器分配的 ID
`SECRET`	上报密钥，等同于密码
`WORKER_URL`	面板地址 + `/update`

远程配置

面板会在上报响应里下发远程配置：采集间隔、上报间隔、连接模式（HTTP / WSS）、ping 模式、探测点列表。新版探针能接受 1 / 3 / 5 / 10 / 15 / 20 秒的扩展上报间隔。

老探针（≤ v1.0.17）只接受 30 / 60 / 120 / 180 秒。面板会自动对旧探针把间隔收敛（agentConfig.js 里的 legacy clamp），避免整包配置被拒——一旦被拒，连带节点数等其他配置也会一起失效。

连不上怎么查

# 1. 面板收到上报了吗
docker logs probedeck | tail -50
 
# 2. 探针在自己机器上的日志
journalctl -u cf-probe -f          # Linux systemd
logread -f | grep cf-probe         # OpenRC / OpenWrt
 
# 3. 手动打一次
curl -sI https://你的面板地址/api/config

bash

常见原因：地址填成了 http://（SECRET 会明文传输但仍能连）、反代没配 WebSocket、SECRET 复制时带了换行或空格。

换发 SECRET

删掉这台机器重新添加，或在编辑面板里重置密钥。重置后旧探针必须重新配置。