宝塔拨测探针怎么装？SH脚本、Docker、宝塔插件三种部署方...
一句话答案：探针（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脚本会自动下载二进制文件、写入系统服务、生成绑定地址并启动 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 脚本装的完全一致。
部署后要做的两件事：绑定 + 保持在线
[*]绑定是探针生效的前提，三种方式殊途同归，最终都要登录宝塔账号完成设备绑定；
[*]保持在线决定收益——探针评分越高，被调度执行拨测任务的概率越大，收益也更稳定。评分与收益的关系详见 探针积分收益与评分。
提高评分的建议：让探针全天稳定在线；选低延迟低丢包的线路；家庭宽带节点挑出口带宽稳定的；设备负载过高或网络波动要及时处理。
常见问题
宝塔拨测探针是什么？
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；宝塔插件则在插件页面点「重新绑定」，然后打开新地址登录账号完成绑定。
探针评分低，该怎么提升？
几个要点：全天保持在线不掉线；选低延迟、低丢包的线路；家庭宽带节点要挑出口带宽稳定的；遇到设备负载过高或网络波动及时处理。评分上去了，被调度执行拨测任务的次数自然更多。
有问题欢迎回帖。
页:
[1]