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

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

Проект Orbitra оптимизирован для быстрого старта без сложной настройки окружения. В основе лежит лёгкий стек PHP + SQLite + Nginx — без отдельного сервера БД (нет ClickHouse, Redis или MySQL).

Системные требования

Orbitra хранит всё в одном файле SQLite, поэтому требует значительно меньше RAM, чем трекеры на ClickHouse, и работает на самых дешёвых VPS.

Базовые (обязательные):

Подбор по объёму трафика (ориентир):

Кликов в суткиRAMCPUДиск
до ~100 0001–2 GB1–2 vCPU20 GB SSD
~100 000 – 500 0002–4 GB2 vCPU40 GB SSD
~500 000 – 1 000 0004–8 GB4 vCPU80 GB SSD

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

💡 Почему меньше, чем у Keitaro? Keitaro хранит клики в ClickHouse + Redis + MySQL, поэтому его требования по RAM растут до 64 GB на миллионах кликов в сутки. У Orbitra всё в одном файле SQLite — узкое место не RAM, а дисковый I/O и однопоточная запись SQLite. Для низких и средних объёмов (в режиме WAL) этого достаточно; для устойчивых миллионов кликов в сутки с тяжёлой аналитикой архитектурно лучше подходит трекер на колоночной БД (как Keitaro).

💡 При установке на сервер с 1 GB RAM добавьте 1–2 GB swap: сборка фронтенда (Vite) — самый требовательный к памяти шаг. Сам трекер работает и на 1 GB.

Быстрая Автоматическая Установка (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, при недоступности — 8.4, из репозитория Ondřej Surý; недоступен и он — дистрибутивный), SQLite, скачает код фронтенда и настроит сертификаты HTTPS.

Первый вход: учётной записи «по умолчанию» нет. После установки откройте http://<ваш-домен>/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

Команда заодно чинит renewal-конфиги Certbot, оставшиеся от прежнего способа выписки, и генерирует самоподписанный сертификат. После обновления с версии ниже 0.9.6.4 выполните её один раз.

Что ставит установщик

Не ставится автоматически: очистка по срокам хранения (cli/cleanup_cron.php, см. Администрирование), монитор постбеков и проверка URL источников.

Перезапуск установщика на работающем сервере безопасен: он обновляет PHP, конфиги и кроны, не трогая данные.

Настройки безопасности панели после установки — свой путь к панели, доступ по IP, двухфакторный вход — описаны в Администрировании.

Обновление PHP

Security-адвайзори: CVE-2026-109618 / CVE-2026-109619 (октябрь 2026)

Две критические уязвимости в самом PHP («php2shell», неаутентифицированный RCE, CVSS v4.0 9.2, эксплойт публичный) закрыты upstream 2026-10-21. Исправленные релизы: 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 — только security-фиксы до конца 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 (при недоступности — 8.4) рядом со старым, переключит CLI-альтернативу php (её используют кроны и 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   # переведёт nginx/FPM/кроны на новую версию

Вручную (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, панель открывается, в Логах → Системный лог нет записей postback.php database error, а в настройках очереди постбеков пинг воркера свежий. Панель сама предупредит при обновлении через кнопку, если сервер остаётся на PHP < 8.4.

Разовый шаг на сервере после обновления (1.6.0+)

Кнопка «Обновить» в панели работает от веб-пользователя и не может менять 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) на помощники с проверкой аргументов, ставит крон очереди кликов и записывает версию в /etc/orbitra/server-setup-version. Запускать повторно безопасно. install.sh вызывает тот же скрипт, так что новые установки получают то же самое.

После обновления до 1.8.4: харднинг nginx (октябрьские advisories 2026)

На сервере ничего делать не нужно: само обновление перегенерирует nginx-vhost без директивы alias и перезагружает nginx (тем же проверенным путём, что и сохранение домена). Остаётся «системная» половина октябрьских advisories — сам пакет nginx (до CVSS 9.2), ядро и хранилище CA-сертификатов, — её может обновить только оператор:

apt update && NEEDRESTART_MODE=a apt upgrade -y   # Debian/Ubuntu; на RHEL-семействе dnf upgrade
systemctl reload nginx
reboot                                             # грузит пропатченное ядро
nginx -v                                           # исправлено: 1.31.7+ mainline / 1.30.6+ stable

Дистрибутивные сборки могут вшить фикс бэкпортом, не поднимая версию — проверяется через apt changelog nginx. На дашборде до появления пропатченной версии nginx висит закрываемый баннер (если shell доступен, чтобы её прочитать). Сам трекер не затронут пунктами про PostgreSQL / Redis / Node.js из того же дайджеста: он работает на PHP + SQLite, Node.js на сервере нет.

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

На сервере ничего делать не нужно. Обновление добавляет записи на уровне кампании со склейкой «один клик на визит» и режимом согласия — всё выключено по умолчанию: статистика кликов и записи меняются только там, где вы включите их сами. Cron добавлять не нужно: очистка по-прежнему ездит на входящих записях.

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

На сервере ничего делать не нужно. Обновление добавляет проверку браузера, но на существующей установке оставляет её выключенной, чтобы маршрутизация не изменилась сама. Админ один раз увидит на дашборде плашку: «Включить мягкий режим» включает её, «Подробнее» открывает Настройки → Боты, «Не сейчас» скрывает плашку (режим можно сменить в Настройки → Боты в любой момент). Новая установка сразу начинает в мягком режиме.

Целостность обновлений

Локальная Разработка (React & PHP Server)

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

Часть 1: Запуск Backend API

Откройте первый терминал и запустите встроенный PHP сервер с роутером:

cd Orbitra
php -S localhost:8080 router.php

Этот сервер будет принимать API запросы и редиректы.

Часть 2: Запуск Frontend (Vite)

Откройте второй терминал, установите npm пакеты и запустите dev-сервер:

cd Orbitra/frontend
npm install
npm run dev

После этого откройте в браузере http://localhost:5173. Все API запросы с фронтенда будут автоматически проксироваться (через vite.config.js proxy) на 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: что переносится автоматически, а что настроить вручную.

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

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

Читать гайд →