Миграция из Keitaro
Orbitra переносит из Keitaro настройки — партнёрки, офферы, домены, кампании с токенами Click API, потоки с фильтрами, постбеки кампаний, лендинги и источники. Статистика кликов не переносится: это новый старт.
Что переносится
| Keitaro | Orbitra | Что сохраняется |
|---|---|---|
| Партнёрские сети | Партнерки | Postback URL, параметры оффера |
| Офферы | Офферы | URL, выплата, гео |
| Домены | Домены | Парковка, HTTPS-only |
| Группы | Группы кампаний | Название |
| Кампании | Кампании | Алиас, токен Click API, состояние, источник |
| Потоки | Потоки | Тип, позиция, вес, схема, действие, фильтры (в том числе sub_id_N и фильтры по параметру), режимы «разрешить / запретить», связи с офферами и лендингами |
| Постбеки кампаний | S2S Postbacks | URL, метод, статусы |
| Лендинги | Лендинги | Названия и URL |
| Источники | Источники | Параметры |
Не переносятся: клики и конверсии, пользователи, файлы локальных лендингов (только записи о них). Фильтры, которые нельзя перенести, перечисляются в отчёте импорта.
Шаблоны источников и партнёрок Keitaro уже встроены в Orbitra — переносить их не нужно (Источники и партнёрки).
1. Дамп на сервере Keitaro
Подключитесь к серверу Keitaro по SSH под root и выполните команду целиком. Она берёт доступ к базе из /etc/keitaro/env/inventory.env, работает и с клиентом MariaDB на хосте, и с MariaDB внутри Docker-контейнера Keitaro, выгружает только таблицы настроек (без логов кликов) и откажется работать, если таблицы не найдены — чтобы случайно не выгрузить всю базу.
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 МБ.
2. Скачайте файл
На странице ⚙ → Миграции введите IP сервера Keitaro — панель подставит его в готовые команды. Выполните команду на своём компьютере, не на сервере:
# 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
⚙ → Миграции → Импорт из Keitaro (SQL dump):
- Выберите файл
.sql.gzили.sql. Дамп не выполняется как SQL — он только разбирается. - Отметьте, что импортировать. Сохранять ID кампаний (Orbitra ID = Keitaro ID) работает только на чистой установке, где таблица кампаний пуста, включая архив.
- Показать предпросмотр — пробный прогон без записи: сколько объектов каждого типа будет импортировано и какие фильтры не переносятся.
- Импортировать в Orbitra.
Для повторного импорта на тестовом сервере есть блок Очистка: удаляет всю конфигурацию трекера (домены, офферы, партнёрки, кампании, потоки, постбеки, пиксели, источники, лендинги, группы), не трогая статистику и пользователей. Для подтверждения нужно ввести DELETE.
4. После импорта
- Токены. Откройте пару кампаний — токен Click API должен совпадать с Keitaro. Тогда интеграционные скрипты на сайтах (
click.php, KClient) продолжат работать, нужно только поменять в них адрес трекера. - Домены. Направьте A-записи доменов на новый сервер (или подключите Cloudflare / Namecheap / Dynadot — записи пропишутся сами) и дождитесь сертификатов (Домены и SSL).
- Постбеки партнёрок. Postback URL в Orbitra другой:
https://ваш-домен/<postback_key>/postback?…. Обновите его в кабинетах сетей (Постбеки). - Гео-база. Без неё фильтры стран не работают — проверьте ⚙ → Гео базы.
- Проверка маршрутизации. Тестовая ссылка кампании с
&_dbg=1покажет, какой поток выбирается и почему, без записи клика (Кампании и потоки).
Частые проблемы
| Симптом | Причина и решение |
|---|---|
Команда дампа пишет no Keitaro tables found | Не та база в inventory.env или нестандартная установка Keitaro. Проверьте MARIADB_KEITARO_DATABASE |
no MariaDB client … and no MariaDB container found | Нет ни клиента MariaDB, ни запущенного контейнера с MariaDB — запустите Keitaro или поставьте клиент |
| Импорт ничего не нашёл | Дамп пустой или не из той базы — посмотрите размер файла и строку Dumping tables: в выводе команды |
| Потоки не перенеслись | Не отмечен пункт «Импортировать потоки» или в дампе нет keitaro_streams и таблиц связей |
| Домен отвечает 404 | DNS ещё не указывает на новый сервер или домену не задана Index-кампания |
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите Orbitra на чистый сервер Ubuntu или Debian одной командой и безопасно обновляйтесь до новых версий.
Читать гайд →ДокументацияМиграция из Keitaro
Перенесите кампании, офферы, источники и домены из Keitaro в Orbitra в один клик — что переносится и что проверить.
Читать гайд →ДокументацияМиграция из Binom
Перенесите кампании и потоки из Binom в Orbitra: что переносится автоматически, а что настроить вручную.
Читать гайд →ДокументацияВозможности Orbitra
Всё, что умеет Orbitra: кампании и потоки, клоакинг, лендинги, PWA, постбеки, расходы, отчёты и интеграции.
Читать гайд →ДокументацияКампании и потоки
Полный справочник: настройки кампаний, типы потоков, схемы, ротация, фильтры, тестовые ссылки и каждый параметр.
Читать гайд →ДокументацияКлоакинг
Полный справочник по клоакингу: уровни детекции, глобальные настройки, фильтры потоков, вердикты и отчёты.
Читать гайд →ДокументацияПроверка браузера
Как JS-проверка ловит ботов, виртуальные машины и эмуляторы через противоречия в окружении браузера.
Читать гайд →ДокументацияЛендинги
Типы лендингов, макрос {offer}, JS-адаптер, LeadForge и мульти-оффер лендинги — полный справочник.
Читать гайд →ДокументацияPWA-лендинги и Web Push
Собирайте устанавливаемые PWA-приложения и собирайте push-подписчиков: настройки, иконки, события и уведомления.
Читать гайд →ДокументацияPWA-воронка
Многошаговая PWA-воронка: приглашения к установке, отслеживание событий и возвратные уведомления.
Читать гайд →ДокументацияКонверсионные попапы
Показывайте реальные конверсии как попапы на странице: настройка, триггеры и размещение.
Читать гайд →ДокументацияЗаписи сессий и карта кликов
Воспроизводите реальные визиты, смотрите карты кликов и скроллов. Лимиты хранения и приватность.
Читать гайд →ДокументацияГалерея контента
Центральное хранилище иконок, скриншотов и креативов для PWA и лендингов.
Читать гайд →ДокументацияБиблиотека креативов
Храните креативы с отслеживанием по subid и тестируйте их в разных кампаниях.
Читать гайд →ДокументацияВнешние PWA и Telegram-каналы
Публикуйте PWA на внешних доменах и используйте Telegram-каналы как источник трафика.
Читать гайд →ДокументацияПостбеки и конверсии
Входящие постбеки, статусы и типы конверсий, исходящие S2S-постбеки в источник трафика.
Читать гайд →ДокументацияРасходы: импорт из рекламных кабинетов
Импорт расходов из Facebook, TikTok и Google Ads, обновление через API и крон — и как работает агрегатор доходов.
Читать гайд →ДокументацияPush и pop сети
Работа с пуш и поп источниками трафика: фиды, оптимизация зон и zone killer.
Читать гайд →ДокументацияFacebook / Meta integration
Импорт расходов из Meta Ads и Conversions API: серверные события с дедупликацией.
Читать гайд →ДокументацияDolphin / Fbtool — приём расходов (Keitaro Admin API)
Получайте расходы Facebook через API Dolphin (Fbtool) в реальном времени.
Читать гайд →ДокументацияЧистилка комментариев FB
Массовая модерация комментариев под рекламой Meta: скрывать, удалять и фильтровать по ключевым словам.
Читать гайд →ДокументацияИсточники трафика и партнёрские сети
Каталог 50+ источников трафика и 440+ сетей: шаблоны, параметры и адреса постбеков.
Читать гайд →ДокументацияОтчёты, логи и метрики
Конструктор отчётов, сохранённые отчёты, логи кликов и каждая метрика с пояснением.
Читать гайд →ДокументацияДомены и SSL
Добавление доменов, DNS, бесплатные сертификаты Let's Encrypt, редиректы, парковка и каждый переключатель на странице.
Читать гайд →ДокументацияCloudflare — DNS и SSL доменов
Как запускать домены кампаний через Cloudflare: DNS, режимы SSL и что отключить.
Читать гайд →ДокументацияАдминистрирование
Пользователи, роли и права, настройки безопасности, гео-базы, обновления и состояние системы.
Читать гайд →ДокументацияTelegram-бот
Управляйте трекером из Telegram: статистика, конверсии и алерты в чате.
Читать гайд →ДокументацияMCP-сервер: работа с трекером через нейросеть
Подключите Claude или любой MCP-клиент к Orbitra и управляйте кампаниями обычными словами.
Читать гайд →