文档目录

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 不会停止点击。它会让集成凭据无法解密,直到你重新填写。把它和备份放在一起。

正常路径见安装、分流和转化。

问题

Q1授权服务器中断时,追踪会停吗?
不会。点击、回传和 CAPI 投递不在授权检查里。已付费的授权如果 30 天没有心跳,仍然保持付费。订阅周期结束后,创建操作在 7 天内退回 Free 上限,然后套餐变成 Free。
Q2为什么我的回传被忽略?
错误的联盟密钥是 401。密钥属于另一个联盟、而不是这次点击所用 Offer 的联盟时,是 403 network_mismatch,不会入账。账本不允许的状态变更返回 200 ignored。