常见问题 — ProbeDeck 文档

按现象查。

面板打不开

docker ps                                   # 容器在跑吗
docker logs probedeck --tail 50             # 有报错吗
curl -sI http://127.0.0.1:17986/            # 本机通不通

bash

现象	原因
502 / 504	容器没起来，或反代上游端口写错
白屏	前端资源 404，检查反代有没有正确转发静态资源
能开但数据不动	WebSocket 没通，检查反代四项设置，见反向代理
端口连不上	`HOST_PORT` 改了但没重建容器

探针不上线

现象	原因
后台看不到这台机器	面板没收到上报。看面板日志有没有请求进来
收到了但不在线	`online_threshold_seconds` 调太小，或者探针真的断了
`SECRET` 报错	复制时带了空格或换行
老探针远程配置全失效	面板需要做 legacy clamp，见接入探针

# 探针自己的日志
journalctl -u cf-probe -f        # systemd
logread -f | grep cf-probe       # OpenRC / OpenWrt

bash

主题不生效

见主题开发的排查顺序。最常见的是用了短 sha 或分支链接。

数据库一直涨

检查 history_retention_days。默认 14 天，到达窗口后应该稳定。如果一直涨说明轮换没跑，看面板日志里 0 * * * * 那条有没有报错。见性能与占用。

忘记密码

docker logs probedeck 2>&1 | grep -i secret

bash

删 data/api_secret.txt 重置会让所有已配好的探针失效，因为它们用的是同一个 API_SECRET。

拉不到镜像

国内：自行配置 Docker 镜像加速器
架构：预构建镜像提供 linux/amd64 与 linux/arm64，Docker 会自动匹配；如果报 no matching manifest，检查你的 CPU 架构是否在这两者之外

通知发不出去

检查项	说明
至少配了一个渠道	报告类通知需要有效渠道
点「发送测试」	验证通道本身通不通
写了 JS 脚本	脚本非空会接管全部通知，上面的渠道都不生效
通知时区	日/周/月报按这个时区的提醒时间发，不是服务器本地时间

探针重启后流量归零

按网卡累计计数统计，重启可能归零，影响当期数据准确性。协议层面的固有限制。可以用流量校正手工对齐。