跳到主要内容
版本：latest

部署宝塔拨测探针

宝塔拨测探针（bt-probe-agent）是一款分布式网络拨测工具。您可以在服务器或家庭宽带设备上部署探针，参与宝塔拨测网络，为 HTTP、PING、TCP、DNS 等监控任务提供多地域、多线路的探测能力。

宝塔拨测官网：https://t.bt.cn/

部署方式​

探针支持以下三种部署方式，请根据使用环境任选一种：

方式适用场景特点
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

使用 Docker 部署​

Docker 方式适合希望隔离运行环境的用户。完整的部署、绑定、更新与卸载步骤，请参阅使用 Docker 部署宝塔拨测探针。

部署完成后，执行以下命令查看绑定信息：

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

打开输出结果中 verification_uri_complete 对应的 URL，完成设备绑定。

使用宝塔插件部署​

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

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

信息

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

常见问题​

绑定 URL 过期怎么办？​

重新生成绑定 URL，然后打开新地址完成绑定。

SH 脚本安装：

bt-probe-agent public-activate

Docker 部署：

docker exec -it bt-probe-agent bt-probe-agent public-activate

使用宝塔插件时，可在插件页面点击 重新绑定。

部署后多久可以看到评分？​

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

如何提高探针评分？​

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

探针申请被驳回怎么办？​

每个区域可接入的节点数量有限，平台会优先选择质量较高的节点。您可以更换其他区域后再次尝试；被驳回的申请会转为普通探针节点。