管理
全部从面板右上角的 ⚙ 菜单打开。
用户与访问
⚙ → Users。两个标签页:Users(账号表格,仅管理员可见)和 Profile(你自己的账号 — 每个用户都有)。
角色
有两种角色:admin(完全访问)和 user(按资源授权)。安装时创建的账号不能删除,最后一个 admin 也不能。用户有权限模板:media buyer(投放优化师)、video editor / designer(视频剪辑 / 设计)、developer(开发),或自定义权限。
权限按资源授予:广告系列、offer、落地页、来源、联盟、域名、日志、素材库(gallery)、push。级别为 full、read-only、no access。广告系列还有 own + assigned 和 assigned only — 此时该用户在各处(列表、报表、日志、转化、仪表盘)只能看到和编辑这些广告系列。财务数据可以单独隐藏:消耗、收入、payout。
权限在服务器端强制执行。未分配给任何资源的操作仅管理员可用(完整清单见 REST API)。全局性危险操作(清空统计、Keitaro 导入、转化导入、回溯重映射)对"own + assigned"权限的用户不可用。
Profile
登录名、邮箱、界面语言、时区(约 250 个时区,带当前 UTC 偏移)、每周第一天、修改密码(需要当前密码;至少 8 个字符)。
两步验证 — 通过验证器应用的 TOTP。验证码一次性有效。
API 密钥
由管理员为用户创建:read — 只读;write — 再加管理。密钥通过 Authorization: Bearer <key> 请求头或 X-Api-Key 传递。用于 MCP、REST API、接收 Dolphin / Fbtool 的消耗,以及 Ads Manager 扩展。
登录
失败尝试限制:同一 IP 每 5 分钟 5 次,每个账号每 15 分钟 20 次(成功登录后重置)。会话时长为 session_lifetime(默认一天,可从 5 分钟到 30 天;环境变量 ORBITRA_SESSION_LIFETIME 优先于该设置)。
Settings
⚙ → Settings,标签页:
| 标签页 | 里面有什么 |
|---|---|
| General | Postback 密钥、默认币种、手动服务器 IP、PHP 落地页许可(默认关闭)及其 1–9 秒超时 |
| Bots | 浏览器检查 模式(Off / Observe only / Soft / Strict)、机器人 IP 和特征签名、全局 Bot ISP 名单、数据中心网段、作为机器人信号的 VPN ASN — 见 斗篷 |
| Conversion types | 自定义状态及其含义、未映射状态 — 见 Postback |
| Custom metrics | 报表的自定义公式 |
| Automation | Crons:postback 队列、backorder |
| System | 统计收集开关、忽略预取(prefetch)、新版本检查、日志和归档保留期限、按 IP/网段限制面板访问、后台路径 |
| Privacy | 扫描防护:不带活动参数直接命中可用链接时如何应答 — 302 到你的 URL、404 或空白页 |
后台路径
/admin.php 是任何扫描器第一个检查的路径。在 System → Admin panel path 里可以换成自己的(/my-panel),之后 /admin.php 开始返回 404。这隐藏了登录表单,但不能替代密码。如果忘了路径:
php /var/www/orbitra/cli/admin_path.php # print the current path
php /var/www/orbitra/cli/admin_path.php reset # вернуть /admin.php
按 IP 限制面板访问
IP 和网段列表(IPv4 和 IPv6,每行一个)。留空 — 面板可从任何地方访问。填写后 — 登录面板和已授权的 api.php 调用只接受来自这些地址的请求。追踪器只信任来自 Cloudflare 和私有代理的 X-Forwarded-For 请求头。小心:可能把自己锁在外面。从服务器上解除限制:
sudo -u www-data php -r '$db = new PDO("sqlite:/var/www/orbitra/orbitra_db.sqlite"); $db->exec("UPDATE settings SET value = \x27\x27 WHERE key = \x27admin_ip_access\x27");'
保留期限
"Log retention period" 和 "Archive resource retention period" 字段只在清理 cron 运行时生效。安装器不会配置它 — 请手动添加:
0 3 * * * php /var/www/orbitra/cli/cleanup_cron.php >> /var/www/orbitra/var/logs/cleanup.log 2>&1
删除分批进行,数据库不会被锁住。
个性化
⚙ → Personalization — logo、名称、浅色或深色主题和配色:Cobalt、Canary、Parchment、Indigo(各有浅色和深色变体)、Terminal、Aurora。主题在首次绘制之前应用,所以深色主题从第一帧就是深色的。
界面语言在个人资料里:English、Русский、Українська、Español、Deutsch、Français、中文。
Geo 数据库
⚙ → Geo Databases。没有 geo 数据库,国家过滤和国家斗篷不工作(所有访客都是 Unknown);没有 ASN 数据库 — 数据中心网段和 ISP 名单层不工作。
| 数据库 | 密钥 | 提供 |
|---|---|---|
| Sypex Geo City | 不需要 | 国家、地区、城市。安装器自动安装 |
| MaxMind GeoLite2 City / ASN | MaxMind license key | 城市、ASN 和服务商 |
| IP2Location DB11 | IP2Location token | Geo、时区 |
| IP2Proxy PX12 | IP2Location token | VPN、代理、TOR、住宅、欺诈评分 |
数据库由 cli/geo_update.php cron 每月更新(带 # orbitra-geo 标记;MaxMind 和 IP2 — 仅在保存了密钥时)。一个数据库都没有时,面板更新会自动装上 Sypex。没有数据库或只有 Sypex 时,所有标签页都会显示横幅警告。
⚙ → Geo profiles — 过滤器用的现成国家集合(EU、CIS 等)和自定义集合。
更新
⚙ → Update — 在 GitHub 上检查新版本,点按钮更新(以 web 用户执行 git pull)。检查结果缓存一小时,出错时缓存 10 分钟;可在 System → Notify about new versions 里关闭。
更新后面板会自己:
- 恢复缺失的 postback 队列 cron;
- 在没有任何 geo 数据库时下载 Sypex Geo;
- 在服务器 PHP 低于 8.4 时发出警告(如何升级 PHP — 部署)。
需要 root 的变更(sudo 规则、SSL 助手)无法通过按钮完成 — 面板会显示带 cli/server_setup.sh 命令的横幅(部署)。
如果虚拟主机禁用了 exec,页面会显示通过 Git 手动更新的命令。
其他
| 菜单项 | 作用 |
|---|---|
| Archive | 已删除的广告系列、offer、落地页、来源、联盟:恢复或永久抹除 |
| Clear statistics | 删除某个周期或全部点击和转化 |
| Migrations | 数据库 schema 版本、Keitaro 导入(从 Keitaro 迁移) |
| Status | 磁盘、CPU、内存、数据库大小 |
| Logs | 流量、postback、S2S、系统、审计(报表与日志) |
| Gallery | PWA、落地页和 offer 的媒体库(素材库) |
| AI / MCP | 连接 AI 助手(MCP) |
| Support and feedback | 联系方式和合作伙伴区块 |
Ads Manager 扩展
一款适用于 Chrome 和 Chromium 系反检测浏览器的扩展,在 Facebook Ads Manager 的 campaign、ad group 和 ad 行旁边显示 Orbitra 指标(每 30 秒刷新);点击后展示三天细分:每日历史、落地页与 offer、Pixel / CAPI 送达准确度。
- ⚙ → Integrations → Chrome & Antidetect Extension — 下载压缩包并解压。
- 以未打包扩展的方式加载该文件夹(或在支持的地方加载 ZIP)。
- 在扩展弹窗里粘贴追踪器 URL 和 Orbitra 显示的高亮 read key。
扩展只需要 read key。安全页命中的排除方式与报表一致。
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。
阅读教程 →