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

Встановлення та оновлення

Orbitra оптимізована для швидкого старту без складного налаштування оточення. Вона побудована на легкому стеку PHP + SQLite + Nginx — без окремого сервера баз даних (ні ClickHouse, ні Redis, ні MySQL).

Системні вимоги

Orbitra зберігає все в одному SQLite-файлі, тому їй потрібно суттєво менше RAM, ніж трекерам на ClickHouse, і вона працює на найдешевших VPS-тарифах.

Базові (обов'язкові):

Розмір сервера під обсяг трафіку (орієнтир):

Кліків на деньRAMCPUДиск
до ~100 0001–2 ГБ1–2 vCPU20 ГБ SSD
~100 000 – 500 0002–4 ГБ2 vCPU40 ГБ SSD
~500 000 – 1 000 0004–8 ГБ4 vCPU80 ГБ SSD

✅ Перевірено на практиці: Orbitra стабільно працює на VPS 2 vCPU / 2 ГБ RAM / 20 ГБ SSD (Ubuntu 24.04) з невеликим трафіком — зручна і недорога стартова точка. Верхні рядки таблиці — це запас на більший трафік, а не жорстка вимога.

💡 Чому менше, ніж у Keitaro? Keitaro зберігає кліки в ClickHouse + Redis + MySQL, тому її вимоги до RAM зростають до 64 ГБ при мільйонах кліків на день. В Orbitra все живе в одному SQLite-файлі — вузьке місце не RAM, а дисковий I/O і однопоточні записи SQLite. Для малих і середніх обсягів (у режимі WAL) цього достатньо; для стабільних мільйонів кліків на день з важкою аналітикою трекер на колоночній БД (як Keitaro) архітектурно підходить краще.

💡 При встановленні на сервер з 1 ГБ RAM додайте 1–2 ГБ swap: збірка фронтенду (Vite) — найбільш вимоглива до пам'яті стадія. Сам трекер прекрасно працює на 1 ГБ.

Швидке автоматичне встановлення (Production)

Найшвидший і правильний спосіб запустити проєкт на сервері — вбудований інсталятор.

  1. Переконайтеся, що у вас «чистий» Linux-сервер (Ubuntu 22.04+ або Debian 12+).
  2. Виконайте команду від root/sudo:
   wget -O orbitra-install.sh https://raw.githubusercontent.com/fenjo26/Orbitra.link/main/install.sh && bash orbitra-install.sh

Завантаження винесено в окремий крок невипадково: із wget -qO- … | bash невдале завантаження мовчки передає в bash порожнечу, і встановлення «завершується» без жодного рядка виводу. Так воно зупиняється на &&, а wget повідомляє причину.

  1. Скрипт встановлює Nginx, актуальний PHP (8.5, з fallback на 8.4 з репозиторію Ondřej Surý; якщо недоступний і він — дистрибутивний), SQLite, завантажує код фронтенду та налаштовує HTTPS-сертифікати.

Перший вхід: акаунта «за замовчуванням» немає. Після встановлення відкрийте http://<your-domain>/admin.php — при першому запуску Orbitra стартує майстер початкового налаштування, де ви створите власного адміністратора (логін ≥ 3 символів, пароль ≥ 8 символів, часовий пояс і мова).

Доступ до панелі за IP

Панель завжди доступна за адресою сервера — http://<ip>/admin.php — скільки б доменів ви не прив'язали і які з них потім не видалили. За це відповідає catch-all-блок, який Orbitra ставить першим у конфіг Nginx; сертифікати випускаються через certbot certonly --webroot, тож Certbot конфіг не переписує.

https://<ip>/admin.php теж працює, але з попередженням браузера: Let's Encrypt не випускає сертифікати для «голих» IP, тому використовується самопідписаний.

Якщо панель усе одно перестає відповідати — наприклад, конфіг Nginx редагували руками — перезберіть його з бази даних:

sudo php /var/www/orbitra/cli/nginx_sync.php

Команда також лагодить конфіги поновлення Certbot, що залишилися від попереднього способу випуску, і генерує самопідписаний сертифікат. Після оновлення з версії нижче 0.9.6.4 виконайте її один раз.

Що встановлює інсталятор

Не встановлюється автоматично: чистка за retention (cli/cleanup_cron.php, див. Administration), монітор постбеків і перевірка URL джерел.

Повторний запуск інсталятора на робочому сервері безпечний: він оновлює PHP, конфіги й cron-задачі, не чіпаючи дані.

Налаштування безпеки панелі після встановлення — власний шлях панелі, доступ за IP, двофакторний вхід — описані в Administration.

Оновлення PHP

Застереження безпеки: CVE-2026-109618 / CVE-2026-109619 (жовтень 2026)

Дві критичні вразливості RCE без автентифікації в самому PHP («php2shell», CVSS v4.0 9.2, публічний експлойт) закриті upstream 21.10.2026. Виправлені релізи: 8.5.12, 8.4.27, 8.3.36, 8.2.35. Трекер — це PHP-застосунок, доступний з інтернету, тож кожен веб-інтерпретатор мусить бути пропатчений. Панель показує червоний банер на дашборді, доки запущений PHP не повідомляє одну з цих версій (або новішу).

Планове оновлення

Ubuntu 22.04 / Debian 12 / Ubuntu 24.04 постачають PHP 8.1 / 8.2 / 8.3 «з коробки» — ці версії більше не отримують оновлень безпеки (8.1 і 8.2 — EOL; 8.3 отримує лише виправлення безпеки до кінця 2027). Orbitra v1.5.10 працює на всіх, але свіжу установку або оновлення сервера варто починати з PHP 8.4+.

Найпростіший шлях — повторно запустити інсталятор (він ідемпотентний і підтримує оновлення поверх наявної установки):

sudo bash /var/www/orbitra/install.sh

Інсталятор додає репозиторій актуальних збірок PHP (ondrej/php на Ubuntu, packages.sury.org на Debian), ставить PHP 8.5 (з fallback на 8.4) поруч зі старим, перемикає альтернативу php для CLI (нею користуються cron-задачі та Composer), переписує конфіг Nginx на новий FPM-сокет, застосовує налаштування пулу і перезапускає сервіси. Стара версія PHP залишається встановленою, але перестає обслуговувати трафік; після перевірки її можна видалити, якщо хочете.

Вручну (Ubuntu):

sudo add-apt-repository -y ppa:ondrej/php && sudo apt-get update
sudo apt-get install -y php8.5-fpm php8.5-cli php8.5-sqlite3 php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-bcmath
sudo update-alternatives --set php /usr/bin/php8.5
sudo bash /var/www/orbitra/install.sh   # switches nginx/FPM/crons to the new version

Вручну (Debian):

. /etc/os-release
curl -fsSL https://packages.sury.org/php/apt.gpg | sudo gpg --dearmor --yes -o /usr/share/keyrings/deb.sury.org-php.gpg
echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ ${VERSION_CODENAME} main" | sudo tee /etc/apt/sources.list.d/php-sury.list
sudo apt-get update
sudo apt-get install -y php8.5-fpm php8.5-cli php8.5-sqlite3 php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-bcmath
sudo update-alternatives --set php /usr/bin/php8.5
sudo bash /var/www/orbitra/install.sh

Після оновлення перевірте: php -v показує 8.4/8.5, панель відкривається, у Logs → System log немає записів postback.php database error, а ping воркера в налаштуваннях черги постбеків свіжий. При оновленні кнопкою панель сама попередить, якщо сервер залишився на PHP < 8.4.

Одноразовий крок на сервері після оновлення (1.6.0+)

Кнопка «Update» у панелі виконується від веб-користувача і не може змінювати sudoers. Серверам, встановленим до 1.6.0, після оновлення потрібен один запуск cli/server_setup.sh від root — панель покаже банер із командою:

curl -fsSL https://raw.githubusercontent.com/fenjo26/Orbitra.link/v1.6.0/cli/server_setup.sh | sudo ORBITRA_REF=v1.6.0 bash

Скрипт завантажується з тега релізу, а не з /var/www/orbitra (та директорія належить веб-користувачу, а root не повинен виконувати файли, які веб-користувач може перезаписати). Він замінює старі sudo-правила (certbot з будь-якими аргументами та cp у sites-available — кожне з них могло дозволити веб-користувачу отримати root) на helper-и з валідацією аргументів, встановлює cron черги кліків і записує версію у /etc/orbitra/server-setup-version. Повторний запуск безпечний. install.sh викликає той самий скрипт, тож нові установки отримують те саме.

Після оновлення до 1.8.4: зміцнення nginx (жовтневі застереження 2026)

На сервері робити нічого не треба: саме оновлення перегенеровує vhost nginx без директиви alias і перезавантажує nginx (тим самим перевіреним шляхом, яким зберігається домен). Залишається частина жовтневих застережень 2026 на боці операційної системи — сам пакет nginx (оцінка до CVSS 9.2), ядро і CA-сховище довіри — їх може оновити лише оператор:

apt update && NEEDRESTART_MODE=a apt upgrade -y   # Debian/Ubuntu; dnf upgrade on the RHEL family
systemctl reload nginx
reboot                                             # loads the fixed kernel
nginx -v                                           # fixed: 1.31.7+ mainline / 1.30.6+ stable

Дистрибутивні збірки можуть нести виправлення бекпортом без підняття версії — перевірте через apt changelog nginx. Дашборд показує банер, який можна сховати, доки запущений nginx не повідомляє виправлену версію (коли є shell, щоб прочитати її). Трекер не зачеплений пунктами PostgreSQL / Redis / Node.js того самого дайджесту: він працює на PHP + SQLite і не постачає Node.js на сервер.

Після оновлення до 1.8.3: запис сесій для цілих сайтів

На сервері робити нічого не треба. Оновлення додає запис сесій на рівні кампанії зі склеюванням візитів One click per visit і режимом згоди, все вимкнено за замовчуванням — статистика кліків і записи змінюються лише там, де ви самі їх увімкнете. Додавати cron не треба: чистка, як і раніше, їде на вхідних записах.

Після оновлення до 1.8.2: перевірка браузера

На сервері робити нічого не треба. Оновлення додає перевірку браузера, але залишає її вимкненою на наявній установці, щоб роутинг не змінювався сам собою. Адміни бачать одноразовий банер на дашборді: Turn on soft mode вмикає її, Learn more відкриває Settings → Bots, Not now ховає банер (режим можна змінити у Settings → Bots будь-коли). Свіжа установка стартує в soft-режимі.

Цілісність оновлень

Локальна розробка (React і PHP-сервер)

Якщо плануєте змінювати вихідний код фронтенду (React) і візуальну частину трекера, знадобиться локальне оточення PHP + Vite.

Частина 1: запуск бекенд-API

Відкрийте перший термінал і запустіть вбудований PHP-сервер з роутером:

cd Orbitra
php -S localhost:8080 router.php

Цей сервер оброблятиме API-запити та редиректи.

Частина 2: запуск фронтенду (Vite)

Відкрийте другий термінал, встановіть npm-пакети і запустіть dev-сервер:

cd Orbitra/frontend
npm install
npm run dev

Потім відкрийте http://localhost:5173 у браузері. Усі API-запити з фронтенду автоматично проксіюються (через проксі у vite.config.js) на http://localhost:8080/api.php, що уникає проблем із CORS і сесіями в режимі розробки.

Збірка панелі

Потрібна лише якщо ви змінюєте код панелі:

cd Orbitra/frontend
npm run build

Збірка потрапляє у frontend/dist/, який закомічений у репозиторій — сервер бере готову панель через git pull або оновлення з панелі і сам нічого не збирає.

Telegram-бот

Підключення та режими роботи — Telegram-бот.

← Попередній
Швидкий старт: ваша перша кампанія
Наступний →
Міграція з Keitaro
Переглянути джерело на GitHub: github.com/fenjo26/Orbitra.link/wiki
Усі гайди
Документація

Швидкий старт: ваша перша кампанія

Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.

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

Встановлення та оновлення

Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.

Читати гайд →