从 Keitaro 迁移
Orbitra 可以从 Keitaro 迁移设置 — 联盟、offer、域名、带 Click API token 的广告系列、带过滤器的流、广告系列 postback、落地页和流量来源。点击统计不会迁移:这是一次全新的开始。
哪些内容会被迁移
| Keitaro | Orbitra | 保留的内容 |
|---|---|---|
| Affiliate networks(联盟) | Affiliate networks | Postback URL、offer 参数 |
| Offers | Offers | URL、佣金、geo |
| Domains(域名) | Domains | 停放(parking)、仅 HTTPS |
| Groups(分组) | Campaign groups(广告系列分组) | 名称 |
| Campaigns(广告系列) | Campaigns | 别名(alias)、Click API token、状态、流量来源 |
| Streams(流) | Streams | 类型、位置、权重、方案、动作、过滤器(包括 sub_id_N 和参数过滤器)、"allow / deny" 模式、与 offer 和落地页的关联 |
| Campaign postbacks(广告系列 postback) | S2S Postbacks | URL、方法、状态 |
| Landing pages(落地页) | Landing pages | 名称和 URL |
| Sources(流量来源) | Sources | 参数 |
不迁移:点击和转化、用户、本地落地页文件(只迁移关于它们的记录)。无法迁移的过滤器会列在导入报告里。
Keitaro 的流量来源和联盟模板已经内置于 Orbitra — 无需迁移(流量来源与联盟)。
1. 在 Keitaro 服务器上导出 dump
以 root 身份通过 SSH 连上 Keitaro 服务器,完整运行下面的命令。它从 /etc/keitaro/env/inventory.env 读取数据库凭据,宿主机上的 MariaDB 客户端和 Keitaro Docker 容器内的 MariaDB 都能用,只导出设置表(不含点击日志),找不到表时会拒绝运行 — 因而你绝不会误把整个数据库 dump 下来。
bash <<'ORBITRA_DUMP'
set -eo pipefail
# Sourced before set -u: the env file is Keitaro's, not ours.
source /etc/keitaro/env/inventory.env
set -u
# Password goes through the environment, never through argv or a file left on disk.
export MYSQL_PWD="$MARIADB_KEITARO_PASSWORD"
DB="$MARIADB_KEITARO_DATABASE"
# MariaDB client on the host, or inside the Keitaro MariaDB container.
if CLI=$(command -v mariadb || command -v mysql) && DUMP=$(command -v mariadb-dump || command -v mysqldump); then
sql() { "$CLI" -u"$MARIADB_KEITARO_USER" -h127.0.0.1 -P3306 --protocol=tcp "$@" </dev/null; }
dump() { "$DUMP" -u"$MARIADB_KEITARO_USER" -h127.0.0.1 -P3306 --protocol=tcp "$@" </dev/null; }
else
CT=$(docker ps --format '{{.Names}}' 2>/dev/null | grep -i -m1 -E 'mariadb|mysql' || true)
if [ -z "$CT" ]; then
echo "ERROR: no MariaDB client on this server and no MariaDB container found" >&2
exit 1
fi
echo "Using MariaDB inside container: $CT"
sql() { docker exec -e MYSQL_PWD "$CT" sh -c 'exec $(command -v mariadb || command -v mysql) "$@"' sh -u"$MARIADB_KEITARO_USER" "$@" </dev/null; }
dump() { docker exec -e MYSQL_PWD "$CT" sh -c 'exec $(command -v mariadb-dump || command -v mysqldump) "$@"' sh -u"$MARIADB_KEITARO_USER" "$@" </dev/null; }
fi
# Settings tables only: campaigns, offers, domains, streams... - no click logs.
TABLES=$(sql -N "$DB" -e "
SELECT table_name FROM information_schema.tables
WHERE table_schema = DATABASE()
AND table_name IN (
'keitaro_affiliate_networks', 'keitaro_groups', 'keitaro_offers',
'keitaro_domains', 'keitaro_campaigns', 'keitaro_campaign_postbacks',
'keitaro_landings', 'keitaro_streams', 'keitaro_stream_filters',
'keitaro_stream_offer_associations', 'keitaro_stream_landing_associations',
'keitaro_traffic_sources', 'keitaro_ref_sources')
ORDER BY table_name" | tr '\n' ' ')
# Without a table list mysqldump would dump the WHOLE database, click logs included.
if [ -z "$(echo $TABLES)" ]; then
echo "ERROR: no Keitaro tables found in database $DB" >&2
exit 1
fi
OUT=/root/keitaro_orbitra_full.sql.gz
echo "Dumping tables: $TABLES"
dump --single-transaction --quick --skip-lock-tables "$DB" $TABLES | gzip -1 > "$OUT"
ls -lah "$OUT"
echo "DONE: $OUT"
ORBITRA_DUMP
最后你会看到 DONE: /root/keitaro_orbitra_full.sql.gz。文件通常为 1–5 MB。
2. 下载文件
在 ⚙ → Migrations(迁移)页面输入 Keitaro 服务器的 IP — 面板会把它填进现成的命令。命令在你的电脑上运行,而不是在服务器上:
# macOS / Linux
scp root@IP_KEITARO:/root/keitaro_orbitra_full.sql.gz ~/Downloads/
# Windows (PowerShell)
scp root@IP_KEITARO:/root/keitaro_orbitra_full.sql.gz $env:USERPROFILE\Downloads\
3. 导入到 Orbitra
⚙ → Migrations → Import from Keitaro (SQL dump)(迁移 → 从 Keitaro 导入):
- 选择一个
.sql.gz或.sql文件。dump 不会作为 SQL 执行 — 只做解析。 - 勾选要导入的内容。Keep campaign IDs(保留广告系列 ID,即 Orbitra ID = Keitaro ID)只在干净的安装上可用,且要求广告系列表为空(包括归档)。
- Show preview — 不写入的演练:会导入每种类型的多少对象、哪些过滤器无法迁移。
- Import into Orbitra(导入到 Orbitra)。
在测试服务器上反复导入时有一个 Cleanup(清理)区块:它会删除追踪器的全部配置(域名、offer、联盟、广告系列、流、postback、像素、流量来源、落地页、分组),但不碰统计和用户。必须输入 DELETE 才能确认。
4. 导入之后
- Token。 打开几个广告系列 — Click API token 应与 Keitaro 的一致。这样你网站上的集成脚本(
click.php、KClient)继续有效,只需修改其中的追踪器地址。 - 域名。 把域名的 A 记录指向新服务器(或接入 Cloudflare / Namecheap / Dynadot — 记录会自动设置),然后等待证书签发(域名与 SSL)。
- 联盟 postback。 Orbitra 的 Postback URL 格式不同:
https://your-domain/<postback_key>/postback?…。请在联盟后台里更新(Postback(回传))。 - Geo 数据库。 没有它,国家过滤器无法工作 — 检查 ⚙ → Geo databases。
- 路由检查。 广告系列测试链接加
&_dbg=1,可以在不记录点击的情况下显示选中了哪条流、为什么(广告系列与流)。
常见问题
| 现象 | 原因与解决方法 |
|---|---|
dump 命令提示 no Keitaro tables found | inventory.env 里的数据库不对,或 Keitaro 安装方式非标准。检查 MARIADB_KEITARO_DATABASE |
no MariaDB client … and no MariaDB container found | 既没有 MariaDB 客户端也没有运行中的 MariaDB 容器 — 启动 Keitaro 或安装客户端 |
| 导入没有发现任何内容 | dump 是空的,或来自错误的数据库 — 检查文件大小和命令输出中的 Dumping tables: 一行 |
| 流没有被迁移 | 没有勾选"Import streams"选项,或 dump 里缺少 keitaro_streams 和关联表 |
| 域名返回 404 | DNS 尚未指向新服务器,或该域名没有分配 Index 广告系列 |
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。
阅读教程 →