文档目录

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。

这些路径对应的对象见分流、落地页、转化和 CAPI。

问题

Q1Flexible 模式会和 Velotrak 互相跳转吗?
不会。普通 HTTP 会按 HTTP 直接响应。Flexible 仍然让 Cloudflare 到你服务器的这一跳不加密,也不会用 443 上的证书。请用 Full (strict)。
Q2橙色云后面,内置证书能续期吗?
不能。签发先在 443 上做 TLS 握手,这一步由 Cloudflare 自己应答,然后再到 80 端口做 HTTP 校验。安装器监听的是 8080。请改用证书文件。