斗篷(参考文档)
Cloaking(斗篷)流方案把流量分成两支:可疑访客(机器人、审核员、数据中心、VPN)看到安全页,真人看到盈利页。所有入口 — 广告系列 URL(index.php)、click.php 和 Click API v3 — 的判定都由同一个模块(core/CloakDetector.php)完成。
英文版详细技术解析:How the Orbitra Cloaker Works。
流的设置
安全页
内置 HTML、外部 URL、本地落地页或本地 offer。列表中的落地页和 offer 按分组归类,并支持搜索。
盈利页
工作方式与"Landing + Offer"方案相同,同样支持"Before the click / After the click"的 offer 选定时机。
把干净访客送往下一条流
勾选 "Send clean visitors to the next stream" 后,斗篷就变成了一个入口过滤器。可疑访客拿到安全页,干净访客则继续沿流列表往下走 — 国家、设备和语言由常规流来细分。此模式下本流的盈利页不会被使用。请把这样的流放在最前,或设为拦截流,确保每个访客都经过这道检查。
检测层
| 检测层 | 数据来源 | 缺少什么就不工作 |
|---|---|---|
| Data centers / hosting(数据中心/主机托管) | ASN 黑名单(core/data/asn_blocklist.json)、公开发布的云与爬虫 IP 段、ISP 名称中的托管关键词 | ASN 数据库(GeoLite2-ASN) |
| VPN / proxy | IP2Proxy PX12(VPN、TOR、住宅 IP、威胁、欺诈分数 ≥ 80)、VPN-ASN 名单 | IP2Proxy PX12 / ASN 数据库 |
| Bot blacklists(机器人黑名单) | Settings → Bots 中的 IP 和 User-Agent 签名 | — |
| User-Agent heuristics(UA 启发式) | 爬虫和工具(facebookexternalhit、meta-externalagent、curl、python、无头浏览器…)、空的 User-Agent、缺失的 Accept-Language | — |
如果缺少必需的数据库,广告系列编辑器会直接在斗篷卡片上显示警告。
灵敏度
信号分为硬信号(明确命中黑名单或信誉数据库)和软信号(单独看噪音较大的启发式特征)。
| 级别 | 何时进安全页 |
|---|---|
| Low | 只有硬信号 |
| Medium(默认) | 一个硬信号,或两个软信号 |
| High | 任意一个信号 |
定向过滤器
在被动检测层之后应用;不匹配即进安全页(TARGETING_SAFE):
- Countries(国家) — 允许或封禁名单。无法判定国家时,原因记为
geo_unknown而不是geo_country。没有 geo 数据库时每个访客都是Unknown,国家过滤器会把 100% 的流量送进安全页;编辑器会对此发出警告。 - Device types(设备类型) — 只放行所选类型,或放行除所选之外的全部。
- Block bots and data-center providers — 访客的 ISP 和 ASN 与名单比对:用流自己的名单,如果为空则用 Settings → Bots 里的全局名单。
JavaScript 验证
默认关闭。访客先拿到安全页,只有执行了 JS,才会通过一次性的签名链接(TTL 5 分钟)前往盈利页。navigator.webdriver = true 留在安全页,不执行 JS 的东西同样如此。代价是每个真人访客多一跳。
如果开启了浏览器检查(Settings → Bots),同一步骤还会采集浏览器信号:在 Soft 或 Strict 模式下,虚拟机、模拟器或伪装的手机会在此处拿到安全页,原因为 bc_。流的 Browser check* 字段可以只对这一条流关闭它。
Preloader(加载页)。 JS 步骤运行期间(不到一秒)访客会看到一个加载页,按流在 JS Challenge Preloader 下配置:使用内置页面,或用自己的 HTML(带实时预览)。历史上这一步复用安全页的 HTML — 未配置 preloader 时仍显示那段标记,已有广告系列保持原样;选择 Custom HTML 即可覆盖它。验证探针会自动注入你的 HTML — 不要自己添加跳转脚本,它们会和签名链接抢跑。
记录与报表
| 设置 | 默认值 | 作用 |
|---|---|---|
| Record Safe Page clicks | 开 | 安全页命中以 is_safe_page = 1 写入。关掉后它们不会进入数据库 |
| Exclude Safe Page clicks from reports | 开 | 命中保留在点击日志里,但从所有报表指标中剔除 — 点击、访问、唯一访客、机器人、空 referer、消耗、CPV。安全页命中毕竟也是对广告系列链接的一次访问,所以关闭该选项时它也会计入"Clicks"(自 1.8.5 起,点击统计包含每次访问) |
即使命中没有写入,被抑制命中的计数器(cloak_suppressed_stats)也会按广告系列、流、日期和判定结果计数 — "零点击"不会掩盖真实流量。
全局设置:Settings → Bots
- Bot IP addresses — IP 和 CIDR,IPv4 和 IPv6。每条都有来源(手动添加或来自 feed);清理时可以只删除某一来源的条目。
- Signatures (User-Agent) — 子串。
- Global Bot ISP blacklist — 每行一个运营商。过短、过于宽泛的字符串(
Inc、LLC)会被忽略:它们几乎能匹配所有运营商。 - Data-center and crawler IP ranges — 来自 lord-alfred/ipranges 的公开发布 IP 段:AWS、Google Cloud 和 Googlebot、Bing、Azure、Oracle、DigitalOcean、Facebook、Telegram、OpenAI、Cloudflare、Apple Private Relay 等。由
ipranges_cron.phpcron 每天更新(也可手动点"Update now"按钮或运行php ipranges_cron.php --force),存储在var/ipranges/。名单下载完成之前,该层不生效。 - Browser check — Off / Observe only / Soft / Strict:通过浏览器内的矛盾特征抓住机器人、虚拟机和模拟器。→ 浏览器检查
- Treat VPN ASN as a bot signal — 默认开启。如果你的受众大量使用商业 VPN,请把它关掉。
诊断
- 编辑器里的斗篷卡片 — 所选周期内有多少命中去了盈利页、多少去了安全页,最主要的原因,以及指向同一时间窗点击日志的链接。如果几乎所有流量都进了安全页,卡片会发出警告。
- 点击日志 — 当页面上出现斗篷点击时,"Route"和"Reason"两列会自动出现,并可按路由和原因过滤。点击卡片显示判定结果和原因,但仅限斗篷真正判定过的点击。
- 加
_dbg=1的测试链接 — 不记录点击的路由轨迹;_geo=XX覆盖国家(广告系列与流)。 - PHP 日志 — 形如
Orbitra cloak [campaign=12 stream=34]: stage=PASSIVE_SAFE ... reasons=[crawler_or_tool_ua]的行。
判定结果与原因
判定结果:money、passive_safe、targeting_safe、js_safe。原因写入 clicks.cloak_reasons,主要的有:
| 代码 | 含义 |
|---|---|
geo_country / geo_unknown | 国家不在名单中 / 无法判定国家 |
device_type | 设备类型不被允许 |
bot_isp、isp_blocklist | ISP 命中机器人与数据中心名单 |
datacenter_asn、asn_datacenter | 数据中心或主机托管的 ASN |
vpn_proxy_asn | VPN 或代理服务商的 ASN |
iprange_datacenter | IP 命中公开发布的云或爬虫 IP 段 |
hosting_isp | ISP 名称中含托管关键词 |
ip2proxy_* | IP2Proxy 信号:vpn_proxy、datacenter、residential、tor、bot、threat、high_fraud |
bot_blocklist | IP 命中机器人名单 |
crawler_or_tool_ua、suspicious_ua、no_user_agent、missing_accept_language | User-Agent 与请求头启发式 |
webdriver、js_missing、js_fingerprint | JavaScript 验证 |
常见问题
| 现象 | 检查什么 |
|---|---|
| 广告后台有点击,追踪器显示为零 | 安全页点击记录是否被关闭;被抑制命中计数器 |
| 100% 的流量都进了安全页 | 是否安装了 geo 数据库(⚙ → Geo databases);点击日志中的 geo_unknown 原因 |
| 真实移动用户进了安全页 | 原因 ip2proxy_vpn_proxy — 移除 VPN/proxy 检测层(它是硬信号,低灵敏度也取消不了) |
| Meta 或 Telegram 审核员看到了 offer | 他们的网络没有被 ASN 标记为数据中心;中等灵敏度下单一 IP 段命中只是软信号。提高灵敏度,或在拦截流上加"Bot"过滤器 |
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 offer、流量来源、广告系列、验证、消耗与统计。
阅读教程 →文档安装与更新
系统要求、一条命令的安装器、PHP 更新与安全公告、按 IP 访问后台、更新完整性校验,以及本地开发环境。
阅读教程 →文档从 Keitaro 迁移
通过 SQL dump 把设置从 Keitaro 迁到 Orbitra:迁移内容清单、导出脚本、导入步骤,以及导入后要检查的事项。
阅读教程 →文档从 Binom 迁移
通过 Binom v2 Public API 直接导入广告系列、offer、流等设置 — 无需 dump 文件,附字段映射说明。
阅读教程 →文档功能总览
所有功能一览:流量与方案、postback 与消耗、数据分析、基础设施与管理 — 每项都链接到详细页面,并附各版本的新增内容。
阅读教程 →文档广告系列与流
广告系列编辑器详解:设置标签页、计费模式、流类型与全部过滤器、方案、自动优化轮询、测试链接与重复点击防护。
阅读教程 →文档斗篷(参考文档)
斗篷完整参考:流设置、检测层、灵敏度、定向过滤器、JavaScript 验证、全局设置、判定结果与原因代码及诊断方法。
阅读教程 →文档浏览器检查
通过浏览器自报矛盾识别机器人、审核员虚拟机、模拟器和反检测浏览器:四种模式、特征清单、结果查看与安全启用步骤。
阅读教程 →文档落地页(参考文档)
落地页完整参考:本地、跳转、Preload 与 Action 四种类型,{offer} 宏、subid 传递、停留时长、JS adapter、PHP 落地页与故障排查。
阅读教程 →文档PWA 与 Web Push
PWA 落地页与自建 Web Push:构建器、域名绑定、VAPID 密钥、订阅者、消息与发送 cron、转化归因和故障排查。
阅读教程 →文档PWA 漏斗
PWA 落地页内的可配置漏斗:store/screen/instructions/push 步骤类型、逐屏追踪、统计维度与编辑器用法。
阅读教程 →文档转化弹窗(Conversion Popups)
在落地页上展示带 offer 按钮的弹窗:适用场景、Popup 标签页设置、触发条件与统计指标。
阅读教程 →文档会话录制与热力图
像视频一样回放真实访问,配合点击热力图与滚动图;含整站录制、Cookie 同意、存储上限与隐私说明。
阅读教程 →文档素材库完整参考
Gallery 页面、上传与软删除、MediaPicker 的尺寸契约(sizeContract)、格式与大小限制,以及视频支持。
阅读教程 →文档创意库
平台同步的创意与手动上传的草稿统一存放,自动绑定花费/收入/ROI,找出真正赚钱的创意。
阅读教程 →文档外部 PWA 与 Telegram 频道
把第三方 PWA 构建器接入流做 A/B,并把 Telegram 频道当作可归因的 offer 目的地。
阅读教程 →文档Postback 与转化
入站 postback 参数与状态映射、转化类型、出站 S2S postback、投递队列与测试器、转化导入和 Conversions API。
阅读教程 →文档花费(Costs)
从 Facebook、TikTok、Google Ads 和 push/pop 联盟导入花费并分摊到点击;含收入聚合器、代理佣金与排错。
阅读教程 →文档Push 与 Pop 联盟
接入 push/pop 联盟的花费导入与 zone 级优化:支持联盟列表、匹配规则与 Zone Killer 屏蔽烧钱 zone。
阅读教程 →文档Facebook / Meta
两套独立集成:从 Meta 导入广告花费,以及用 Conversions API 服务端发送转化事件,含浏览器匹配与排错。
阅读教程 →文档Dolphin / Fbtool
通过 Dolphin(Fbtool)API 实时接收 Facebook 消耗:兼容 Keitaro 的入站端点、API 密钥与活动参数配置、消耗分摊与验证。
阅读教程 →文档FB 评论清理器
按计划批量审核 Facebook 广告贴下的评论:停用词、正则、链接与联系方式规则,默认 dry-run、默认隐藏、操作可恢复。
阅读教程 →文档流量来源与联盟
配置漏斗两端的两个目录:约 200 个流量来源模板与约 440 个联盟模板,参数三元组、postback URL 与 offer 参数宏。
阅读教程 →文档报表、日志与指标
仪表盘、报表生成器、趋势与群组、流量日志与点击卡片,以及每个指标的计算方式。
阅读教程 →文档域名与 SSL
添加域名、把 DNS 指向服务器、自动签发 Let's Encrypt 证书,以及 Domains 页面上每个开关的作用。
阅读教程 →文档Cloudflare
通过 API 接入 Cloudflare:域名自动停放 A 记录、多账号、代理(橙色云朵)与 Flexible / Full / Strict SSL 模式。
阅读教程 →文档管理
用户、角色与按资源授权、两步验证、API 密钥、安全设置、geo 数据库、面板更新与系统状态。
阅读教程 →文档Telegram 机器人
在 Telegram 里管理追踪器:转化通知、每日摘要、统计命令,以及发到频道/群组的转化提醒。
阅读教程 →文档MCP:追踪器里的 AI 助手
把 Claude 或任何 MCP 客户端连上 Orbitra,用大白话管理广告系列:41 个工具、远程与本地两种连接方式、API 密钥安全。
阅读教程 →