文档目录
Cloudflare 代理下的 Velotrak
更新于 2026年11月17日
Cloudflare 直接连到 Velotrak 时,点击记下的是 CF-Connecting-IP 里的访客,不是边缘节点的地址。SSL 模式用 Full (strict),并安装证书文件。橙色云终结 TLS 时,内置 ACME 无法签发,也无法续期。
访客 IP
点击、GeoIP、机器人判断、ip 字段上的分流规则、LP Protect 的入口令牌、后台登录限流和审计日志,用的是同一个客户端 IP 函数。
对端不是可信代理时,这个对端地址就是客户端。直连的公网请求里,转发头一律不采用,访客不能靠自己带的头挑选 IP。
可信代理包括:编进二进制的 Cloudflare 边缘地址段、回环地址、内网地址,以及 VELOTRAK_TRUSTED_PROXIES 里的 CIDR。来自可信对端时,X-Forwarded-For 的每一行合并后从右往左读,跳过可信的一跳。第一个不是可信代理的地址就是访客。最左边是客户端自己写的,不会单独拿来用。
对端或其中某一跳是 Cloudflare 地址时,采用 CF-Connecting-IP。对端是回环地址、而且请求里完全没有 X-Forwarded-For 时,也采用它。这是本机上的 cloudflared 隧道,公开演示站就是这样发布的。True-Client-IP 和 X-Real-IP 不读取。标准橙色云会发送 CF-Connecting-IP,起作用的是这个头。
橙色云直接连到 Velotrak 进程,就是「Cloudflare 对端」这种情况。为 Cloudflare 不用填写 VELOTRAK_TRUSTED_PROXIES。这个变量是给前面另一家 CDN 用的。
Cloudflare 地址段固定在二进制里,启动时不会下载。2026 年 11 月 17 日,它与公布的列表一致:cloudflare.com/ips-v4 和 cloudflare.com/ips-v6。以后 Cloudflare 新增、而这份二进制里没有的边缘地址,会当成普通公网客户端:转发头被忽略,记下的是该边缘节点的 IP。
你自己放在 Cloudflare 和 Velotrak 之间的代理必须追加 X-Forwarded-For。nginx 的写法是 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;。这样向左查找时会遇到 Cloudflare 的一跳,并采用 CF-Connecting-IP。只发送 CF-Connecting-IP、对端是 127.0.0.1 的代理会被接受。Docker 网桥或局域网地址如果转发了头、却没有追加 X-Forwarded-For,记下的是代理自己的地址,访客自己带的 CF-Connecting-IP 不被相信。安装器把 Velotrak 跑在宿主机上,前面没有另一层代理,所以橙色云直连这台机器就是直接的情况。
后面这些功能用的是同一个地址:
- GeoIP 查询国家、地区、城市和 ISP。安装后国家为空,是
/var/lib/velotrak/geoip/dbip-city.mmdb这份库没有就位。代理地址会查出该代理所在的位置,国家是有值的,不是空的。 - 机器人判断匹配 User-Agent,以及一份内置的数据中心地址段(例如 AWS、GCP、Azure)。Cloudflare 的地址段不在这份名单里,所以边缘地址本身不会被标成
dc_ip。你保存的自定义 IP 规则,匹配的是实际记下的那个地址。 ip字段上的分流规则比较的是这个地址。- LP Protect 用这个 IP 和 User-Agent 签名
vt_lp入口令牌,有效 5 分钟。入口通过之后的会话 cookie 持续 2 小时,不再绑定 IP。点击和落地页请求解出的地址不同时,落地页是空白 403。 - Meta CAPI 把点击行里的 IP 作为
client_ip_address发送。TikTok 作为ip发送。两者都是投递时从 ClickHouse 抄出来的。Google Measurement Protocol 的请求体里没有 IP 字段。
源站连接是 TLS,或者 X-Forwarded-Proto 正好是 https 时,vt_vid 和 vt_cid 带 Secure。保留这个头。这两个 cookie 要给像素读,所以不是 HttpOnly。
编进去的地址段不会拒绝其他客户端。直接打到端口上的请求,记下的是对端地址。若只允许 Cloudflare 连到源站 IP,那是服务器上的防火墙规则。
证书和 SSL 模式
设置 VELOTRAK_TLS_DOMAIN 会打开内置 ACME,并在 VELOTRAK_TLS_PORT(默认 443)上监听。VELOTRAK_TLS_CERT_FILE 和 VELOTRAK_TLS_KEY_FILE 加载你已经有的证书。安装器 env 文件的注释写的是 Cloudflare Origin CA 证书,或 DNS-01 签发得到的文件。这个程序不连接 DNS 服务商,自己做不了 DNS-01。只要设置了 VELOTRAK_TLS_DOMAIN,证书文件就不会被加载。
ACME 先尝试 tls-alpn-01:证书颁发机构必须和本进程在 443 上完成 TLS 握手。然后再尝试 http-01:向 80 端口请求 GET /.well-known/acme-challenge/…。普通 HTTP 监听的是 VELOTRAK_HTTP_PORT。安装器把它设成 8080。这个 HTTP 处理先应答校验路径,其余请求交给正常的应用。它不会把其他 HTTP 请求重定向到 HTTPS。
橙色云在 Cloudflare 终结 TLS,所以 tls-alpn-01 的握手到不了 Velotrak。http-01 打的是公网名字的 80 端口。默认进程在 8080 上,而 Cloudflare 的 “Always Use HTTPS” 在边缘就应答了 80 端口,校验路径到不了本进程。签发失败。名字一直开着代理时,续期同样失败。先把记录设成仅 DNS、签出证书后再打开代理,下一次续期仍然会失败。
橙色云上的主机名不要设置 VELOTRAK_TLS_DOMAIN,改为安装证书文件。Cloudflare Origin CA 证书能通过 Cloudflare 的 Full (strict) 校验。浏览器直接打开源站时不信任这张证书,所以访客应经由 Cloudflare 访问这个主机名。你在本程序之外用 DNS-01 续期的证书也可以。改完 env 后重启服务。
区域的 SSL 模式设为 Full (strict)。Cloudflare 会向 443 发起 TLS,并核对证书上的名字。Flexible 向源站发起普通 HTTP。本服务就地应答这个 HTTP 请求,所以 Flexible 本身不会和 Velotrak 形成跳转循环。Flexible 不会使用 443 上的证书,Cloudflare 到服务器的这一跳也不加密。请用 Full (strict)。如果你在 80 端口上把同一主机重定向到 https://,Flexible 会循环,因为 Cloudflare 会一直用 HTTP 回源。
域名页的「检查」请求 https://<主机>/healthz,不跟随重定向,并期望响应头 X-Probe-Ack。active 表示就是这个实例应答的。issuing 表示普通 HTTP 到达了这个实例,HTTPS 还没有。pending_dns 且说明里有 “a proxy is in between”,表示主机有应答,但没有这个头。挑战页或拦截页就是这种情况。Host 要原样转发,并放行 X-Probe 和 X-Probe-Ack。没有在域名页登记的主机不是追踪主机:落地页会被放进沙箱,像素读不到追踪 cookie。见安装。
代理不能改写的路径
这些响应是按访客区分的。源站对它们发送 Cache-Control: no-store:
| 路径 | 它是什么 |
|---|---|
GET /click/{活动-id} |
活动跳转。默认类型是 HTTP 302。meta、double_meta 和 js 是 HTTP 200 的 HTML,同样是 no-store。 |
GET /dm |
双重 meta 跳转的第二跳。 |
GET /go |
落地页前往这次点击选定的 Offer。 |
GET 或 POST /postback/{联盟密钥} |
联盟服务器对服务器的回传。 |
GET 或 POST /track |
浏览器像素。 |
开启 LP Protect 时的 GET /lp/…,或 HTML 地址里带 click_id 时 |
受保护的落地页,或替换了宏的落地页。 |
让这些响应保持源站发出的样子。把它们存进缓存、或忽略查询字符串的缓存规则,会把一个访客的跳转、cookie 或落地页 HTML 交给下一个访客。没有 click_id 的托管 HTML,以及其他落地页文件,是 public, max-age=60。/velotrak.js 是 public, max-age=300。按这个时间缓存,和源站一致。
js 跳转是一段内联脚本,注入的像素是 <script src="/velotrak.js" async></script>。两者都没有 Cloudflare 的跳过属性。追踪主机名上请关闭 Rocket Loader,并关闭 HTML 和 JavaScript 的 Auto Minify。这些功能会改写本服务生成的响应正文。
Bot Fight Mode、Super Bot Fight Mode、Browser Integrity Check 和 “I’m Under Attack” 会返回 JavaScript 挑战或拦截页。本服务没有绕过它们的办法。联盟回传是联盟服务器发出的普通 GET 或 POST。挑战完不成,转化就不会入账。同样的挑战会丢掉 /click、/go、/dm、/track 和 /velotrak.js。POST /mcp 也不是浏览器客户端;整个区域打开挑战后,任何能到达本进程的主机名上的 MCP 都会被挡住。请在追踪主机名上关闭这些功能,或对 /click、/go、/dm、/postback、/track、/lp、/velotrak.js 和 /mcp 跳过它们。
活动跳转是 HTTP 302;meta 和脚本类型则是 HTTP 200 的 HTML。状态码保持源站发出的值。追踪服务和后台都没有 WebSocket 端点,区域不必打开 WebSockets。
Cloudflare 大约在 100 秒时结束被代理的请求,并返回 524。本服务没有这个限制。备份和恢复是在后台的 HTTP 请求里做完的,大的备份会超过这个时间。后台页面壳是 Cache-Control: no-cache。
哪个主机名要开代理
托管落地页、点击链接、回传和像素,都是你登记的主机名上的路径。没有单独的落地页部署模式。
| 主机名 | 橙色云 |
|---|---|
追踪域名(活动链接、/postback、/lp、/go、/track) |
Cloudflare 直连 Velotrak 时,访客 IP 是对的。用 Full (strict) 和证书文件,上面的路径不要缓存,关闭机器人拦截,并关闭 Rocket Loader 和 HTML/JS 压缩。 |
后台域名(VELOTRAK_ADMIN_HOST) |
可选。同样的 TLS 模式,并且不要缓存。恢复超过代理时限时,浏览器里会失败,服务器上可能还在继续。仅 DNS 可以避开这一点。操作员能上传落地页时,后台要用单独的主机名。 |
| 联盟回传地址 | 不是单独的 DNS 名字。它是追踪域名上的 https://<追踪主机>/postback/<联盟密钥>。联盟的服务器必须能完成这个请求,中间不能有挑战页。 |
| 你自己网站上的外部落地页 | 不经过本进程。Velotrak 只是跳转到那个 URL。 |