宝塔拨测探针是什么？

宝塔拨测探针（bt-probe-agent）是一款分布式网络拨测工具。部署到服务器或家庭宽带设备后，可参与宝塔拨测网络，为 HTTP、PING、TCP、DNS 等监控任务提供多地域、多线路的探测能力，同时按节点类型每日获取积分。

宝塔拨测探针支持哪几种部署方式？

三种：SH 脚本一键安装（推荐，一条命令快速安装）、Docker 部署（容器化隔离运行、支持自动更新）、宝塔插件部署（宝塔面板用户可视化操作）。根据使用环境任选一种即可。

探针部署后多久能看到评分？

探针完成绑定并保持运行后会开始上报自检数据，首次部署后最长约 1 小时生成评分。评分数据来自探针自检上报，需要先完成绑定并保持稳定运行。

绑定 URL 过期了怎么办？

重新生成绑定 URL 再打开新地址完成绑定。SH 脚本安装的用命令 bt-probe-agent public-activate；Docker 部署的用 docker exec -it bt-probe-agent bt-probe-agent public-activate；宝塔插件的在插件页面点「重新绑定」。

探针评分低怎么办？

保持探针全天稳定在线，使用低延迟、低丢包的网络线路，家庭宽带节点选出口带宽稳定的线路，并及时排查设备负载过高或网络波动问题。评分越高，被调度执行拨测任务的概率越大。

宝塔拨测探针怎么部署？SH 脚本、Docker、宝塔插件三种方式

宝塔拨测探针（bt-probe-agent）是一款分布式网络拨测工具，部署到你的服务器或家庭宽带设备后，就能参与宝塔拨测网络，为 HTTP、PING、TCP、DNS 等监控任务提供多地域、多线路的探测能力，同时按节点类型每日获取积分收益。

部署方式有三种：SH 脚本一键安装（推荐）、Docker 部署、宝塔插件部署。任选一种即可，下面分别说明。

三种部署方式怎么选

方式	适用场景	特点
SH 脚本一键安装	有服务器且熟悉命令行	一条命令快速安装，推荐使用
Docker 部署	容器化环境	隔离运行，支持自动更新
宝塔插件部署	宝塔面板用户	在面板中可视化管理

方式一：SH 脚本一键安装（推荐）

在服务器终端执行一条命令：

curl -kfsSL 'https://t.bt.cn/api/v1/agent/install.sh' | sudo bash

安装程序会自动下载二进制文件、写入系统服务、生成绑定地址并启动 Agent。安装完成后，终端会输出绑定 URL，在浏览器打开该地址，登录宝塔账号并完成设备绑定即可。

安装后的日常管理命令

# 查看运行状态
systemctl status bt-probe-agent

# 查看实时日志
journalctl -u bt-probe-agent -f

# 重启探针
systemctl restart bt-probe-agent

# 查看版本
bt-probe-agent version

# 卸载探针
bt-probe-agent uninstall

绑定 URL 过期或需要重新绑定

bt-probe-agent public-activate

执行后会重新生成绑定 URL，打开新地址完成绑定。

方式二：Docker 部署

适合希望隔离运行环境的用户。先创建 docker-compose.yml：

services:
  bt-probe-agent:
    image: docker.cnb.cool/btpanel/bt-probe-agent:latest
    container_name: bt-probe-agent
    restart: always
    cap_add:
      - NET_RAW
    volumes:
      - /run/bt-probe-agent:/run/bt-probe-agent
      - /etc/bt-probe-agent:/etc/bt-probe-agent
      - /var/lib/bt-probe-agent:/var/lib/bt-probe-agent
    environment:
      - TBT_CONTROL_PLANE_URL=https://t.bt.cn
      - TBT_AGENT_ENDPOINT=wss://t.bt.cn/ws/agent
      - BT_PROBE_LOG_MODE=file
    healthcheck:
      test: ["CMD", "bt-probe-agent", "status"]
      interval: 60s
      timeout: 5s
      retries: 3
      start_period: 10s

在 docker-compose.yml 所在目录执行：

docker-compose up -d

容器首次启动会自动初始化 Agent 身份并生成激活会话。然后查看绑定信息：

docker exec bt-probe-agent cat /var/lib/bt-probe-agent/activation.json

输出中的 verification_uri_complete 就是绑定 URL，打开它（或使用 user_code）完成设备绑定。

前置要求：Docker 20.10 或更高版本（含 Docker Compose）、amd64 或 arm64 架构、可访问 t.bt.cn 和镜像仓库。国内服务器拉取镜像超时时，需先配置可用的镜像加速器。

更完整的 Docker 部署（更新、备份恢复、卸载）步骤，见官方文档 docker-deployment.md，本文不展开。

方式三：宝塔插件部署

适合宝塔面板用户，全程可视化：

登录宝塔面板，打开左侧菜单中的 软件商店。
搜索 拨测探针 并安装插件。
打开插件页面，点击 绑定设备。
在浏览器中登录宝塔账号并完成授权。

插件会自动检测并接管探针，之后可以在插件页面查看设备状态、节点信息、运行时长和质量趋势等信息。

注意：插件仅用于托管探针，卸载插件不会同时卸载探针；通过插件安装的探针与 SH 脚本安装的探针一致。

部署后要做的两件事：绑定 + 保持在线

绑定是探针生效的前提，三种方式最终都要登录宝塔账号完成设备绑定。保持稳定在线决定收益——探针评分越高，被调度执行拨测任务的概率越大，收益也更稳定。

提高评分的方法：保持探针全天稳定在线、使用低延迟低丢包的线路、家庭宽带节点选出口带宽稳定的线路、及时排查设备负载过高或网络波动。

信息来源

本文事实以宝塔官方文档《部署宝塔拨测探针》与《使用 Docker 部署宝塔拨测探针》为准。