文档目录
Velotrak 故障排查
更新于 2026年11月17日
活动或 Flow 不是进行中,或路径上没有可用的落地页和 Offer 时,点击返回 404。联盟密钥不属于这次点击的 Offer 时,回传返回 403。LP Protect 对其他人返回空白的 403。
点击的响应
进程起来后,GET /healthz 返回 {"status":"ok"}。安装器会等待这个地址。
| 你看到的 | 点击处理里的原因 |
|---|---|
503 not ready |
内存快照还没加载。 |
404 campaign not found |
id 未知,或活动不是 active。暂停和草稿活动不在快照里。 |
404 flow not found |
Flow 缺失或不是 active。 |
404 no available offer |
路径上的落地页或 Offer 全部暂停,或每个 Offer 都超过每日上限。没有备用路径。 |
404 no target |
判定没有产生可跳转的目标。 |
/go 上 404 unknown click |
点击 ID 不在查找表里。 |
复制链接之前,如果活动未启用、Flow 为空或已暂停,或 Offer、落地页已暂停,后台会先警告。
回传和像素
未知的联盟密钥:401。密钥正确,但不是这次点击的联盟:403 network_mismatch,不入账,也不发 CAPI。入站日志显示 rejected。未登记主机名上的托管落地页会被放进沙箱,像素读不到追踪 cookie。在域名页登记主机,并让反代原样转发 Host。被代理的主机名如果拦截了回传,或者记下的是边缘地址而不是访客,见 Cloudflare。
如果安装后国家、地区和城市为空,可能是 GeoIP 下载失败。安装器查找 /var/lib/velotrak/geoip/dbip-city.mmdb,取不到时会警告。
LP Protect 和登录
没有有效 vt_lp 令牌时,LP Protect 返回空白 403。入口令牌持续 5 分钟,并绑定 IP 和 User-Agent。之后的会话持续 2 小时。该功能属于 Pro。纯 HTTP 上,受保护页面的预览可能加载不出 CSS 和 JS。
如果升级后所有后台会话都失效,可能是第一次生成了主密钥(更早的构建使用空密钥,那些会话会被作废)。用脚本新装的实例已经设置了主密钥。丢失 master.key 不会停止点击。它会让集成凭据无法解密,直到你重新填写。把它和备份放在一起。