Документация

Миграция из Keitaro

Orbitra переносит из Keitaro настройки — партнёрки, офферы, домены, кампании с токенами Click API, потоки с фильтрами, постбеки кампаний, лендинги и источники. Статистика кликов не переносится: это новый старт.

Что переносится

KeitaroOrbitraЧто сохраняется
Партнёрские сетиПартнеркиPostback URL, параметры оффера
ОфферыОфферыURL, выплата, гео
ДоменыДоменыПарковка, HTTPS-only
ГруппыГруппы кампанийНазвание
КампанииКампанииАлиас, токен Click API, состояние, источник
ПотокиПотокиТип, позиция, вес, схема, действие, фильтры (в том числе sub_id_N и фильтры по параметру), режимы «разрешить / запретить», связи с офферами и лендингами
Постбеки кампанийS2S PostbacksURL, метод, статусы
ЛендингиЛендингиНазвания и 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):

  1. Выберите файл .sql.gz или .sql. Дамп не выполняется как SQL — он только разбирается.
  2. Отметьте, что импортировать. Сохранять ID кампаний (Orbitra ID = Keitaro ID) работает только на чистой установке, где таблица кампаний пуста, включая архив.
  3. Показать предпросмотр — пробный прогон без записи: сколько объектов каждого типа будет импортировано и какие фильтры не переносятся.
  4. Импортировать в Orbitra.

Для повторного импорта на тестовом сервере есть блок Очистка: удаляет всю конфигурацию трекера (домены, офферы, партнёрки, кампании, потоки, постбеки, пиксели, источники, лендинги, группы), не трогая статистику и пользователей. Для подтверждения нужно ввести DELETE.

4. После импорта

Частые проблемы

СимптомПричина и решение
Команда дампа пишет 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 и таблиц связей
Домен отвечает 404DNS ещё не указывает на новый сервер или домену не задана Index-кампания
← Назад
Установка и обновление
Вперёд →
Миграция из Binom
Исходник на GitHub: github.com/fenjo26/Orbitra.link/wiki
Все гайды
Документация

Быстрый старт: первая кампания

Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.

Читать гайд →
Документация

Установка и обновление

Установите 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 и управляйте кампаниями обычными словами.

Читать гайд →