一句话答案：探针（bt-probe-agent）一共三种装法——服务器熟手用 SH 脚本一条命令安装（推荐）、玩容器的用 Docker 部署、宝塔面板用户直接在软件商店装插件，三种效果等价，任选其一，装完登录宝塔账号完成设备绑定就能参与拨测网络并按天拿积分。
探针是干什么的
宝塔拨测探针（bt-probe-agent）是一款分布式网络拨测工具。把它部署到你的服务器或者家庭宽带设备上，它就会加入宝塔拨测网络，为 HTTP、PING、TCP、DNS 这类监控任务提供多地域、多线路的探测能力，同时按节点类型每日结算积分收益。节点覆盖越广，平台的全网检测能力越完整，这也是节点来源的一部分——节点构成可参考 拨测节点来源。
三种方式怎么选
|
|
| 方式
| 适用场景
| 特点
| SH 脚本一键安装
| 有服务器且熟悉命令行
| 一条命令快速安装，推荐使用
| Docker 部署
| 容器化环境
| 隔离运行，支持自动更新
| 宝塔插件部署
| 宝塔面板用户
| 在面板中可视化管理
|
三种方式部署的是同一个探针，功能完全一致，根据你手上的环境挑一个就行。Docker 部署的细节另见 探针Docker部署，本篇不重复展开。
方式一：SH 脚本一键安装（推荐）
在服务器终端执行一条命令：- <div class="blockcode"><blockquote>curl -kfsSL 'https://t.bt.cn/api/v1/agent/install.sh' | sudo bash
安装后的日常管理命令：
- # 查看运行状态
- 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
方式二：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
容器首次启动会自动初始化 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 脚本装的完全一致。
部署后要做的两件事：绑定 + 保持在线- 绑定是探针生效的前提，三种方式殊途同归，最终都要登录宝塔账号完成设备绑定；
- 保持在线决定收益——探针评分越高，被调度执行拨测任务的概率越大，收益也更稳定。评分与收益的关系详见 探针积分收益与评分。
提高评分的建议：让探针全天稳定在线；选低延迟低丢包的线路；家庭宽带节点挑出口带宽稳定的；设备负载过高或网络波动要及时处理。
常见问题
宝塔拨测探针是什么？
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；宝塔插件则在插件页面点「重新绑定」，然后打开新地址登录账号完成绑定。
探针评分低，该怎么提升？
几个要点：全天保持在线不掉线；选低延迟、低丢包的线路；家庭宽带节点要挑出口带宽稳定的；遇到设备负载过高或网络波动及时处理。评分上去了，被调度执行拨测任务的次数自然更多。
有问题欢迎回帖。
|
|
运维要高效，装宝塔
