Встановлення та оновлення
Orbitra оптимізована для швидкого старту без складного налаштування оточення. Вона побудована на легкому стеку PHP + SQLite + Nginx — без окремого сервера баз даних (ні ClickHouse, ні Redis, ні MySQL).
Системні вимоги
Orbitra зберігає все в одному SQLite-файлі, тому їй потрібно суттєво менше RAM, ніж трекерам на ClickHouse, і вона працює на найдешевших VPS-тарифах.
Базові (обов'язкові):
- CPU: 1 vCPU (x86_64)
- RAM: 1 ГБ (рекомендовано 2 ГБ)
- Диск: 20 ГБ SSD
- ОС: Ubuntu від 22.04 до 26.04, або Debian 12 / 13
- Чистий сервер без панелі керування; доступ root/sudo
Розмір сервера під обсяг трафіку (орієнтир):
| Кліків на день | RAM | CPU | Диск |
|---|---|---|---|
| до ~100 000 | 1–2 ГБ | 1–2 vCPU | 20 ГБ SSD |
| ~100 000 – 500 000 | 2–4 ГБ | 2 vCPU | 40 ГБ SSD |
| ~500 000 – 1 000 000 | 4–8 ГБ | 4 vCPU | 80 ГБ 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)
Найшвидший і правильний спосіб запустити проєкт на сервері — вбудований інсталятор.
- Переконайтеся, що у вас «чистий» Linux-сервер (Ubuntu 22.04+ або Debian 12+).
- Виконайте команду від 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 повідомляє причину.
- Скрипт встановлює 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 виконайте її один раз.
Що встановлює інсталятор
- Nginx, PHP-FPM (розмір пулу рахується з обсягу RAM,
fastcgi_read_timeout 180s), SQLite, Composer з перевіркою SHA-256. - Код у
/var/www/orbitra, власник —www-data. - Власний ключ постбека.
- База Sypex Geo City (безкоштовна, без ключа). Якщо сервер не зміг дістати sypexgeo.net, встановлення все одно завершиться, а базу можна додати пізніше у ⚙ → Geo Databases.
- Helper-скрипти для SSL і nginx з валідацією аргументів (
cli/server_setup.sh). - Cron-задачі: spool кліків, черга постбеків, Web Push, автооптимізація ротації, Telegram polling, випуск SSL, імпорт витрат, IP-діапазони, гео-бази. Повна таблиця — у Architecture.
- Залежності MCP-сервера, якщо на сервері є npm.
- Відкриває 80/443 в ufw, якщо він увімкнений.
Не встановлюється автоматично: чистка за 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 не повідомляє одну з цих версій (або новішу).
- PHP 8.2–8.5 без патча:
NEEDRESTART_MODE=a apt install -y --only-upgrade 'php8.X-'(замініть X на вашу гілку), потім перезапустіть PHP-FPM і веб-сервер (systemctl restart php8.X-fpm nginx). Блок безпечний для вставки за задумом: прапорець-yприбирає підтвердженняContinue? [Y/n](вставите багаторядковий блок — Наступний рядок прочитається як відповідь, і apt перерветься), аNEEDRESTART_MODE=aавтоматично відповідає на діалог Ubuntu 22.04+ «які сервіси перезапустити». Не використовуйте голийapt upgrade 'php': apt розгортає glob на всі пакети з ім'ям php в архіві і переривається на конфліктах, нічого не оновивши. Дистрибутивні збірки можуть нести виправлення бекпортом, не дійшовши до номера версії — перевіртеapt changelog php8.X-fpm | grep 109618, перш ніж вважати, що ви вразливі. - PHP 8.1 або старіше: гілка EOL і ніколи не отримає виправлення. Оновлюйтеся шляхом через інсталятор нижче (
sudo bash install.shставить PHP 8.5 поруч і перемикає все на нього). - Якщо PHP встановлено панеллю хостингу (ispmanager тощо), оновіть його з тієї панелі.
Планове оновлення
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-режимі.
Цілісність оновлень
composer.pharне зберігається в репозиторії: інсталятор завантажує версію, зафіксовану вinstall.sh(COMPOSER_VER), і перевіряєCOMPOSER_SHA256; розбіжність зупиняє встановлення. Вже наявний/var/www/orbitra/composer.pharвикористовується як є.- Панель (
frontend/dist) збирається на машині релізу і комітиться: сервер ніколи не виконуєnpm install/npm run build, а робоча копія після встановлення лишається чистою. - Теги релізів мають бути підписані (
git tag -s), щоб оновлення з панелі підтягувало код, який можна перевірити.
Локальна розробка (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-бот.
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть 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 й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →