Міграція з Keitaro
Orbitra переносить налаштування з Keitaro — партнерські мережі, оффери, домени, кампанії з їхніми токенами Click API, потоки з фільтрами, постбеки кампаній, лендинги та джерела. Клікова статистика не переноситься: це старт з чистого аркуша.
Що переноситься
| Keitaro | Orbitra | Що зберігається |
|---|---|---|
| Affiliate networks | Affiliate networks | Postback URL, параметри офферів |
| Offers | Offers | URL, виплата, гео |
| Domains | Domains | Паркінг, HTTPS-only |
| Groups | Campaign groups | Назва |
| Campaigns | Campaigns | Аліас, токен Click API, стан, джерело |
| Streams | Streams | Тип, позиція, вага, схема, дія, фільтри (включно з sub_id_N і фільтрами за параметрами), режими «allow / deny», зв'язки з офферами та лендингами |
| Campaign postbacks | S2S Postbacks | URL, метод, статуси |
| Landing pages | Landing pages | Назви та URL |
| Sources | Sources | Параметри |
Не переноситься: кліки та конверсії, користувачі, файли локальних лендингів (лише записи про них). Фільтри, які перенести не вдалося, перелічені у звіті імпорту.
Шаблони джерел і партнерських мереж 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. Завантажте файл
На сторінці ⚙ → Migrations введіть 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
⚙ → Migrations → Import from Keitaro (SQL dump):
- Оберіть файл
.sql.gzабо.sql. Дамп не виконується як SQL — він лише розбирається. - Позначте, що імпортувати. Keep campaign IDs (Orbitra ID = Keitaro ID) працює лише на чистій установці, де таблиця кампаній порожня, включно з архівом.
- Show preview — пробний запуск без запису: скільки об'єктів кожного типу буде імпортовано і які фільтри не переносяться.
- Import into Orbitra.
Для повторних імпортів на тестовому сервері є блок Cleanup: він видаляє всю конфігурацію трекера (домени, оффери, партнерські мережі, кампанії, потоки, постбеки, пікселі, джерела, лендинги, групи), не чіпаючи статистику та користувачів. Для підтвердження треба ввести DELETE.
4. Після імпорту
- Токени. Відкрийте пару кампаній — токен Click API має збігатися з токеном Keitaro. Тоді інтеграційні скрипти на ваших сайтах (
click.php, KClient) продовжать працювати; треба лише змінити в них адресу трекера. - Домени. Наведіть A-записи доменів на новий сервер (або підключіть Cloudflare / Namecheap / Dynadot — записи прописаються автоматично) і дочекайтеся сертифікатів (Domains and SSL).
- Постбеки мереж. Postback URL в Orbitra інший:
https://your-domain/<postback_key>/postback?…. Оновіть його в кабінетах мереж (Постбеки та конверсії). - Гео-база. Без неї фільтри країн не працюють — перевірте ⚙ → Geo databases.
- Перевірка роутингу. Тестове посилання кампанії з
&_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: у виводі команди |
| Потоки не перенеслися | Опція «Import streams» не була позначена, або в дампі немає keitaro_streams і таблиць зв'язків |
| Домен віддає 404 | DNS ще не вказує на новий сервер, або домену не призначено Index-кампанію |
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть Orbitra на чистий сервер Ubuntu або Debian однією командою та безпечно оновлюйтеся до нових версій.
Читати гайд →ДокументаціяМіграція з Keitaro
Перенесіть кампанії, оффери, джерела та домени з Keitaro в Orbitra одним імпортом — що переноситься і що перевірити після нього.
Читати гайд →ДокументаціяМіграція з Binom
Перенесіть кампанії та потоки з Binom у Orbitra через Public API: що переноситься автоматично, а що налаштувати вручну.
Читати гайд →ДокументаціяОгляд можливостей
Усе, що вміє Orbitra: кампанії та потоки, клоакинг, лендинги, PWA, постбеки, витрати, звіти та інтеграції.
Читати гайд →ДокументаціяКампанії та потоки
Повна довідка: налаштування кампаній, типи потоків, схеми, ротація, фільтри, тестові посилання та кожна опція з поясненням.
Читати гайд →ДокументаціяКлоакинг
Повна довідка з клоакингу: шари детекції, глобальні налаштування, фільтри потоку, вердикти та звіти.
Читати гайд →ДокументаціяПеревірка браузера
Як JS-перевірка ловить ботів, віртуальні машини та емулятори за суперечностями в браузерному оточенні.
Читати гайд →ДокументаціяЛендинги
Типи лендингів, макрос {offer}, JS-адаптер, LeadForge та мультиофферні лендинги — повна довідка.
Читати гайд →ДокументаціяPWA та Web Push
Створюйте встановлювані PWA-застосунки та збирайте push-підписників: налаштування, іконки, події та сповіщення.
Читати гайд →ДокументаціяPWA-воронка
Воронка візиту на PWA-лендинг: екрани до встановлення, трекінг кожного екрана, статистика показів і матриця переходів.
Читати гайд →ДокументаціяКонверсійні попапи
Попап із кнопкою оффера на лендингах: вкладка Popup, вертикальні шаблони, тригери показу і метрики показів та CTR.
Читати гайд →ДокументаціяЗаписи сесій і теплові карти
Реплеї реальних візитів, теплові карти кліків і скролу, ліміти сховища, приватність і запис цілих сайтів.
Читати гайд →ДокументаціяГалерея контенту
Повна довідка Галереї: папки, завантаження, MediaPicker у редакторах, контракти розміру, обмеження форматів і відео.
Читати гайд →ДокументаціяБібліотека креативів
Креативи з витратами, доходом і ROI: синк файлів з Facebook і TikTok, дедуплікація, звіти і алерт вигорання креативів.
Читати гайд →ДокументаціяЗовнішні PWA та Telegram-канали
Сторонні PWA-сервіси як цілі потоків (/eflow) і Telegram-канали як оффери: funnel-бот, вступи-конверсії та атрибуція.
Читати гайд →ДокументаціяПостбеки та конверсії
Вхідні постбеки, статуси й типи конверсій, вихідні S2S-постбеки на джерело, черга доставки, тестер і імпорт конверсій.
Читати гайд →ДокументаціяВитрати
Імпорт витрат з Facebook, TikTok, Google Ads і push/pop-мереж, розподіл по кліках, агентські комісії та агрегатор доходу.
Читати гайд →ДокументаціяPush- і pop-мережі
Імпорт витрат із push/pop-мереж і Zone Killer: правила, що знаходять і блокують зони, які палять бюджет.
Читати гайд →ДокументаціяFacebook / Meta
Імпорт витрат з Meta Ads і Conversions API: токени, мапінг статусів, серверні події з дедуплікацією і діагностика.
Читати гайд →ДокументаціяDolphin / Fbtool
Отримуйте витрати Facebook у трекер через API Dolphin (Fbtool) у реальному часі: API-ключ, налаштування сервісів і розподіл витрат по кліках.
Читати гайд →ДокументаціяЧистильник коментарів FB
Масова модерація коментарів під рекламою Meta за розкладом: набори правил, винятки, сухий прогін, журнал дій і авто-пауза.
Читати гайд →ДокументаціяДжерела трафіку та партнерські мережі
Два довідники, що налаштовують «краї» воронки: шаблони джерел і мереж, параметри, постбек у джерело та офферні параметри.
Читати гайд →ДокументаціяЗвіти, логи та метрики
Дашборд, список кампаній, конструктор звітів, тренди й когорти, лог трафіку та картка кліка — і як рахується кожна метрика.
Читати гайд →ДокументаціяДомени та SSL
Додайте домени, наведіть DNS на сервер, отримайте безкоштовний сертифікат Let's Encrypt і розберіться з кожним перемикачем на сторінці Domains.
Читати гайд →ДокументаціяCloudflare
Інтеграція з Cloudflare через API: A-записи ставляться автоматично, а з проксі SSL роздає Cloudflare — без certbot і очікування валідації.
Читати гайд →ДокументаціяАдміністрування
Користувачі, ролі та права по ресурсах, налаштування безпеки, гео-бази, оновлення панелі й розширення Ads Manager.
Читати гайд →ДокументаціяTelegram-бот
Керуйте трекером із Telegram: статистика, конверсії та сповіщення в чаті, вебхук або поллінг і алерти в канали.
Читати гайд →ДокументаціяMCP: ШІ-асистент у трекері
Підключіть Claude або будь-який MCP-клієнт до Orbitra й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →