Установка и обновление
Проект Orbitra оптимизирован для быстрого старта без сложной настройки окружения. В основе лежит лёгкий стек PHP + SQLite + Nginx — без отдельного сервера БД (нет ClickHouse, Redis или MySQL).
Системные требования
Orbitra хранит всё в одном файле SQLite, поэтому требует значительно меньше RAM, чем трекеры на ClickHouse, и работает на самых дешёвых VPS.
Базовые (обязательные):
- CPU: 1 vCPU (x86_64)
- RAM: 1 GB (рекомендуется 2 GB)
- Диск: 20 GB SSD
- ОС: Ubuntu от 22.04 до 26.04 или Debian 12 / 13
- Чистый сервер без панели управления; доступ root/sudo
Подбор по объёму трафика (ориентир):
| Кликов в сутки | RAM | CPU | Диск |
|---|---|---|---|
| до ~100 000 | 1–2 GB | 1–2 vCPU | 20 GB SSD |
| ~100 000 – 500 000 | 2–4 GB | 2 vCPU | 40 GB SSD |
| ~500 000 – 1 000 000 | 4–8 GB | 4 vCPU | 80 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)
Самый быстрый и правильный способ запуска проекта на сервере — использование встроенного инсталлятора.
- Убедитесь, что у вас "чистый" 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, при недоступности — 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 выполните её один раз.
Что ставит установщик
- Nginx, PHP-FPM (пул рассчитывается от объёма RAM,
fastcgi_read_timeout 180s), SQLite, Composer с проверкой SHA-256. - Код в
/var/www/orbitra, владелец —www-data. - Собственный ключ постбеков.
- Гео-базу Sypex Geo City (бесплатно, без ключа). Если сервер не достучался до sypexgeo.net, установка всё равно завершится, а базу можно поставить позже в ⚙ → Гео базы.
- Помощники SSL и nginx с проверкой аргументов (
cli/server_setup.sh). - Кроны: спул кликов, очередь постбеков, Web Push, автооптимизация ротации, опрос Telegram, выпуск SSL, импорт расходов, IP-диапазоны, гео-базы. Полная таблица — Архитектура.
- Зависимости MCP-сервера, если на сервере есть npm.
- Открывает 80/443 в ufw, если он включён.
Не ставится автоматически: очистка по срокам хранения (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 на сервере не сообщает одну из этих версий (или новее).
- 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 и старше: ветка снята с поддержки, фикса для неё не будет. Обновляйтесь инсталлятором (см. ниже:
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 — только 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: проверка браузера
На сервере ничего делать не нужно. Обновление добавляет проверку браузера, но на существующей установке оставляет её выключенной, чтобы маршрутизация не изменилась сама. Админ один раз увидит на дашборде плашку: «Включить мягкий режим» включает её, «Подробнее» открывает Настройки → Боты, «Не сейчас» скрывает плашку (режим можно сменить в Настройки → Боты в любой момент). Новая установка сразу начинает в мягком режиме.
Целостность обновлений
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 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-бот.
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите 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 и управляйте кампаниями обычными словами.
Читать гайд →