Installation et mises à jour
Orbitra est optimisé pour un démarrage rapide sans configuration complexe de l'environnement. Il repose sur une stack légère PHP + SQLite + Nginx — pas de serveur de base de données séparé (ni ClickHouse, ni Redis, ni MySQL).
Configuration requise
Orbitra stocke tout dans un unique fichier SQLite, il a donc besoin de nettement moins de RAM que les trackers basés sur ClickHouse et tourne sur les plans VPS les moins chers.
Base (requis) :
- CPU : 1 vCPU (x86_64)
- RAM : 1 Go (2 Go recommandés)
- Disque : 20 Go SSD
- OS : Ubuntu 22.04 à 26.04, ou Debian 12 / 13
- Un serveur propre sans panneau de contrôle ; accès root/sudo
Dimensionnement selon le volume de trafic (à titre indicatif) :
| Clics par jour | RAM | CPU | Disque |
|---|---|---|---|
| jusqu'à ~100 000 | 1–2 Go | 1–2 vCPU | 20 Go SSD |
| ~100 000 – 500 000 | 2–4 Go | 2 vCPU | 40 Go SSD |
| ~500 000 – 1 000 000 | 4–8 Go | 4 vCPU | 80 Go SSD |
✅ Vérifié en pratique : Orbitra tourne de manière stable sur un VPS 2 vCPU / 2 Go de RAM / 20 Go SSD (Ubuntu 24.04) avec un trafic léger — un point de départ pratique et peu coûteux. Les lignes hautes du tableau sont de la marge pour un trafic plus élevé, pas une exigence stricte.
💡 Pourquoi moins que Keitaro ? Keitaro stocke les clics dans ClickHouse + Redis + MySQL, ses besoins en RAM montent donc jusqu'à 64 Go à des millions de clics par jour. Dans Orbitra, tout vit dans un unique fichier SQLite — le goulot d'étranglement n'est pas la RAM mais l'I/O disque et les écritures mono-thread de SQLite. Pour les volumes faibles et moyens (en mode WAL), cela suffit ; pour des millions de clics par jour soutenus avec de l'analytique lourde, un tracker à base de base columnaire (comme Keitaro) est architecturalement mieux adapté.
💡 Lors d'une installation sur un serveur de 1 Go de RAM, ajoutez 1–2 Go de swap : la construction du frontend (Vite) est l'étape la plus gourmande en mémoire. Le tracker lui-même tourne très bien avec 1 Go.
Installation automatique rapide (production)
Le moyen le plus rapide et le plus propre de lancer le projet sur un serveur est l'installateur intégré.
- Assurez-vous d'avoir un serveur Linux « propre » (Ubuntu 22.04+ ou Debian 12+).
- Lancez la commande en root/sudo :
wget -O orbitra-install.sh https://raw.githubusercontent.com/fenjo26/Orbitra.link/main/install.sh && bash orbitra-install.sh
Le téléchargement est une étape séparée à dessein : avec wget -qO- … | bash, un téléchargement raté envoie silencieusement du vide dans bash, et l'installation « se termine » sans une seule ligne de sortie. Ainsi, elle s'arrête au &&, et wget signale la raison.
- Le script installe Nginx, un PHP à jour (8.5, avec repli sur 8.4 depuis le dépôt Ondřej Surý ; si celui-ci est indisponible aussi — celui de la distribution), SQLite, télécharge le code du frontend et met en place les certificats HTTPS.
Première connexion : il n'y a pas de compte « par défaut ». Après l'installation, ouvrez
http://<your-domain>/admin.php— au premier lancement, Orbitra démarre l'assistant de configuration initiale, où vous créez votre propre administrateur (login ≥ 3 caractères, mot de passe ≥ 8 caractères, fuseau horaire et langue).
Accès au panneau par IP
Le panneau est toujours accessible à l'adresse du serveur — http://<ip>/admin.php — quel que soit le nombre de domaines liés et lequel vous supprimez ensuite. C'est le rôle d'un bloc catch-all qu'Orbitra place en premier dans la config Nginx ; les certificats sont émis via certbot certonly --webroot, donc Certbot ne réécrit pas la config.
https://<ip>/admin.php fonctionne aussi, mais avec un avertissement navigateur : Let's Encrypt n'émet pas de certificats pour des IP nues, donc un auto-signé est utilisé.
Si le panneau cessait quand même de répondre — par exemple, la config Nginx a été éditée à la main — reconstruisez-la depuis la base de données :
sudo php /var/www/orbitra/cli/nginx_sync.php
La commande répare aussi les configs de renouvellement Certbot héritées de l'ancienne méthode d'émission et génère un certificat auto-signé. Après une mise à jour depuis une version inférieure à 0.9.6.4, exécutez-la une fois.
Ce que l'installateur met en place
- Nginx, PHP-FPM (le pool est dimensionné selon la quantité de RAM,
fastcgi_read_timeout 180s), SQLite, Composer avec vérification SHA-256. - Le code dans
/var/www/orbitra, propriété dewww-data. - Sa propre clé de postback.
- La base Sypex Geo City (gratuite, sans clé). Si le serveur n'a pas pu joindre sypexgeo.net, l'installation se termine quand même, et la base peut être ajoutée plus tard dans ⚙ → Geo Databases.
- Les helpers SSL et nginx avec validation des arguments (
cli/server_setup.sh). - Les crons : spool des clics, file des postbacks, Web Push, auto-optimisation de la rotation, polling Telegram, émission SSL, import des coûts, plages d'IP, bases geo. Tableau complet dans Architecture.
- Les dépendances du serveur MCP, si npm est présent sur le serveur.
- Ouvre 80/443 dans ufw s'il est activé.
Non installé automatiquement : le nettoyage par rétention (cli/cleanup_cron.php, voir Administration), le moniteur de postbacks et les vérifications d'URL de source.
Relancer l'installateur sur un serveur en production est sans risque : il met à jour PHP, les configs et les crons sans toucher aux données.
Les réglages de sécurité du panneau après installation — chemin de panneau personnalisé, accès par IP, connexion à deux facteurs — sont couverts dans Administration.
Mise à jour de PHP
Alerte sécurité : CVE-2026-109618 / CVE-2026-109619 (octobre 2026)
Deux vulnérabilités RCE critiques non authentifiées dans PHP lui-même (« php2shell », CVSS v4.0 9.2, exploit public) ont été corrigées en amont le 2026-10-21. Versions corrigées : 8.5.12, 8.4.27, 8.3.36, 8.2.35. Un tracker est une application PHP exposée sur Internet, donc chaque interpréteur exposé au web doit être patché. Le panneau affiche un bandeau rouge sur le dashboard tant que le PHP en cours ne rapporte pas l'une de ces versions (ou plus récente).
- PHP 8.2–8.5, non patché :
NEEDRESTART_MODE=a apt install -y --only-upgrade 'php8.X-'(remplacez X par votre branche), puis redémarrez PHP-FPM et le serveur web (systemctl restart php8.X-fpm nginx). Sécurisé au copier-coller par conception : le flag-ysupprime la confirmationContinue? [Y/n](collez un bloc multi-lignes et la ligne SUIVANTE est lue comme la réponse — apt annule), etNEEDRESTART_MODE=arépond automatiquement au dialogue Ubuntu 22.04+ « which services to restart ». N'utilisez pas un simpleapt upgrade 'php': apt étend le glob à tous les paquets nommés php de l'archive et annule sur des conflits avant de mettre quoi que ce soit à jour. Les builds de distribution peuvent embarquer le correctif rétroporté sans atteindre le numéro de version — vérifiezapt changelog php8.X-fpm | grep 109618avant de conclure que vous êtes exposé. - PHP 8.1 ou plus ancien : la branche est EOL et ne recevra jamais le correctif. Mettez à niveau via le chemin de l'installateur ci-dessous (
sudo bash install.shinstalle PHP 8.5 à côté et bascule tout dessus). - Si PHP a été installé par un panneau d'hébergement (ispmanager etc.), mettez-le à jour depuis ce panneau.
Mise à niveau de routine
Ubuntu 22.04 / Debian 12 / Ubuntu 24.04 livrent PHP 8.1 / 8.2 / 8.3 en standard — ces versions ne reçoivent plus de mises à jour de sécurité (8.1 et 8.2 sont EOL ; 8.3 ne reçoit que des correctifs de sécurité jusqu'à fin 2027). Orbitra v1.5.10 tourne sur toutes, mais une installation neuve ou une mise à niveau de serveur devrait partir de PHP 8.4+.
Le chemin le plus simple est de relancer l'installateur (il est idempotent et supporte la mise à niveau par-dessus une installation existante) :
sudo bash /var/www/orbitra/install.sh
L'installateur ajoute le dépôt des builds PHP à jour (ondrej/php sur Ubuntu, packages.sury.org sur Debian), installe PHP 8.5 (avec repli sur 8.4) à côté de l'ancien, bascule l'alternative php du CLI (utilisée par les crons et Composer), réécrit la config Nginx vers le nouveau socket FPM, applique les réglages du pool et redémarre les services. L'ancienne version de PHP reste installée mais cesse de servir le trafic ; vous pouvez la retirer après vérification, si vous voulez.
Manuel (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
Manuel (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
Après la mise à jour, vérifiez : php -v affiche 8.4/8.5, le panneau s'ouvre, Logs → System log ne contient aucune entrée postback.php database error, et le ping du worker dans les réglages de la file des postbacks est récent. Lors d'une mise à jour via le bouton, le panneau vous avertira de lui-même si le serveur reste sur PHP < 8.4.
Étape serveur unique après mise à jour (1.6.0+)
Le bouton « Update » du panneau s'exécute comme l'utilisateur web et ne peut pas modifier sudoers. Les serveurs installés avant 1.6.0 ont besoin d'une seule exécution de cli/server_setup.sh en root après la mise à jour — le panneau affichera un bandeau avec la commande :
curl -fsSL https://raw.githubusercontent.com/fenjo26/Orbitra.link/v1.6.0/cli/server_setup.sh | sudo ORBITRA_REF=v1.6.0 bash
Le script est téléchargé depuis le tag de release, pas depuis /var/www/orbitra (ce répertoire appartient à l'utilisateur web, et root ne doit pas exécuter des fichiers que l'utilisateur web peut réécrire). Il remplace les anciennes règles sudo (certbot avec tous arguments, et cp vers sites-available — chacune pouvait permettre à l'utilisateur web d'obtenir root) par des helpers qui valident les arguments, installe le cron de la file des clics et écrit la version dans /etc/orbitra/server-setup-version. Le relancer est sans risque. install.sh appelle le même script, donc les nouvelles installations obtiennent la même chose.
Après la mise à jour vers 1.8.4 : durcissement nginx (avis d'octobre 2026)
Rien à exécuter sur le serveur : la mise à jour elle-même régénère le vhost nginx sans la directive alias et recharge nginx (par le même chemin vérifié qu'utilise l'enregistrement d'un domaine). Il reste la moitié système d'exploitation des avis d'octobre 2026 — le paquet nginx lui-même (noté jusqu'à CVSS 9.2), le kernel et le magasin de confiance des CA — que seul l'opérateur peut mettre à jour :
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
Les builds de distribution peuvent rétroporter le correctif sans changer la version — vérifiez avec apt changelog nginx. Le dashboard affiche un bandeau ignorable tant que le nginx en cours ne rapporte pas une version corrigée (quand un shell est disponible pour le lire). Le tracker n'est pas concerné par les items PostgreSQL / Redis / Node.js du même digest : il tourne en PHP + SQLite et n'embarque aucun Node.js sur le serveur.
Après la mise à jour vers 1.8.3 : session recordings pour des sites entiers
Rien à exécuter sur le serveur. La mise à jour ajoute les session recordings au niveau campagne avec le collage de visites One click per visit et le mode consentement, le tout désactivé par défaut — statistiques de clics et recordings ne changent que là où vous les activez vous-même. Aucun cron à ajouter : le nettoyage continue de profiter des recordings entrants.
Après la mise à jour vers 1.8.2 : browser check
Rien à exécuter sur le serveur. La mise à jour ajoute le browser check mais le laisse désactivé sur une installation existante, pour que le routage ne change pas tout seul. Les admins voient un bandeau unique sur le dashboard : Turn on soft mode l'active, Learn more ouvre Settings → Bots, Not now masque le bandeau (le mode se change à tout moment dans Settings → Bots). Une installation neuve démarre en mode soft.
Intégrité des mises à jour
composer.pharn'est pas conservé dans le dépôt : l'installateur télécharge la version épinglée dansinstall.sh(COMPOSER_VER) et vérifieCOMPOSER_SHA256; une divergence arrête l'installation. Un/var/www/orbitra/composer.phardéjà existant est utilisé tel quel.- Le panneau (
frontend/dist) est construit sur la machine de release et committé : le serveur ne lance jamaisnpm install/npm run build, et la copie de travail reste propre après l'installation. - Les tags de release devraient être signés (
git tag -s) pour que la mise à jour depuis le panneau tire du code vérifiable.
Développement local (React & serveur PHP)
Si vous comptez modifier le code source du frontend (React) et la partie visuelle du tracker, il vous faut un environnement local PHP + Vite.
Partie 1 : démarrer l'API backend
Ouvrez un premier terminal et démarrez le serveur PHP intégré avec le routeur :
cd Orbitra
php -S localhost:8080 router.php
Ce serveur gérera les requêtes API et les redirections.
Partie 2 : démarrer le frontend (Vite)
Ouvrez un second terminal, installez les paquets npm et démarrez le serveur de dev :
cd Orbitra/frontend
npm install
npm run dev
Ouvrez ensuite http://localhost:5173 dans votre navigateur. Toutes les requêtes API du frontend sont automatiquement proxifiées (via le proxy vite.config.js) vers http://localhost:8080/api.php, ce qui évite les problèmes de CORS et de session en mode développement.
Construire le panneau
Nécessaire seulement si vous modifiez le code du panneau :
cd Orbitra/frontend
npm run build
Le build atterrit dans frontend/dist/, qui est commité dans le dépôt — le serveur récupère le panneau tout fait via git pull ou une mise à jour depuis le panneau et ne construit rien lui-même.
Bot Telegram
Connexion et modes de fonctionnement — Bot Telegram.
Démarrage rapide : votre première campagne
Le chemin court : installez le tracker, créez une campagne et obtenez vos premiers clics et conversions en moins d'une heure.
Lire le guide →DocsInstallation et mises à jour
Installez Orbitra sur un serveur Ubuntu ou Debian tout neuf en une commande, et passez aux nouvelles versions sans risque.
Lire le guide →DocsMigrer depuis Keitaro
Déplacez campagnes, offres, sources et domaines de Keitaro vers Orbitra : ce qui est transféré et quoi vérifier après l'import.
Lire le guide →DocsMigrer depuis Binom
Déplacez campagnes et streams de Binom vers Orbitra via l'API publique v2 : ce qui est transféré automatiquement et quoi régler à la main.
Lire le guide →DocsAperçu des fonctionnalités
Tout ce qu'Orbitra sait faire : campaigns et streams, cloaking, landings, PWA, postbacks, coûts, rapports et intégrations.
Lire le guide →DocsCampaigns et streams
La référence complète : réglages de campagne, types de streams, schémas, rotation, filtres, test links et chaque option expliquée.
Lire le guide →DocsCloaking
La référence complète du cloaking : couches de détection, réglages globaux, filtres par stream, verdicts et rapports.
Lire le guide →DocsBrowser check
Comment la vérification JS attrape bots, VM et émulateurs à travers les contradictions de l'environnement du navigateur.
Lire le guide →DocsLanding pages
Types de landings, la macro {offer}, l'adaptateur JS, LeadForge et les landings multi-offres — la référence complète.
Lire le guide →DocsPWA et Web Push
Construisez des apps PWA installables et collectez des abonnés push : réglages, icônes, événements et notifications.
Lire le guide →DocsFunnel de visite PWA
Le funnel configurable des landings PWA : étapes ordonnées, store, instructions et carte push, tracking par écran, statistiques de transitions et éditeur.
Lire le guide →DocsPopups de conversion
Un popup avec bouton d'offre sur vos landings : templates par vertical, déclencheurs, designs, une vraie étape du funnel et les métriques Popup CTR.
Lire le guide →DocsEnregistrements de session
Replay des visites façon vidéo, heatmap de clics et carte de scroll : activation, sites entiers, consentement cookies, stockage et dépannage.
Lire le guide →DocsContent Gallery : référence complète
La médiathèque partagée du tracker : dossiers, uploads, limites de formats, MediaPicker et contrat de taille dans les éditeurs PWA, landing et offre.
Lire le guide →DocsBibliothèque de créas
L'onglet Creatives de la galerie : sync Facebook/TikTok, dépense et ROI par créa, rattachement des brouillons, alertes burnout et rapports.
Lire le guide →DocsPWA externes et chaînes Telegram
Builders PWA tiers comme cibles de stream avec installs et postbacks attribués, et offres chaîne Telegram via funnel bots avec conversions tg_join.
Lire le guide →DocsPostbacks et conversions
Postbacks entrants, types de conversion et devises, postbacks S2S sortants, macros, file de livraison, testeur, import et Conversions API.
Lire le guide →DocsCoûts : import de la dépense
Import de la dépense Facebook, TikTok, Google Ads et réseaux push/pop : matching par IDs, diagnostics, agences, métriques plateforme et agrégateur de revenus.
Lire le guide →DocsRéseaux push et pop
Import de dépense AdMaven, PropellerAds, Kadam et autres, et le Zone Killer : règles dry-run/auto pour bloquer les zones qui brûlent de l'argent.
Lire le guide →DocsFacebook / Meta
Les deux intégrations Facebook : import de coûts avec mapping des paramètres, et Conversions API avec matching navigateur, consentement et dépannage.
Lire le guide →DocsDolphin / Fbtool
Recevoir les coûts Facebook de Dolphin et Fbtool.pro sur l'endpoint compatible Keitaro : clé API, matching par adset/ad et répartition de la dépense sur les clics.
Lire le guide →DocsNettoyage des commentaires FB
Modération planifiée des commentaires spam sous vos pubs Facebook : dry-run, stop words, regexes admin, whitelist, journal et restauration en un clic.
Lire le guide →DocsSources de trafic et réseaux d'affiliation
Les deux annuaires du funnel : templates de sources avec paramètres et macros, postback vers la source, réseaux d'affiliation et paramètres d'offre.
Lire le guide →DocsRapports, logs et métriques
Dashboard, liste des campagnes, rapport à dimensions, tendances et cohortes, journal du trafic, carte du clic et le détail du calcul de chaque métrique.
Lire le guide →DocsDomaines et SSL
Ajouter des domaines, réglages par domaine, certificats Let's Encrypt et Cloudflare, registrars connectés et surveillance Backorder.
Lire le guide →DocsCloudflare
Connecter Cloudflare via l'API : parking DNS automatique, proxy orange, modes SSL de zone, import des zones et réécriture des enregistrements A.
Lire le guide →DocsAdministration
Utilisateurs, rôles et permissions, clés API, réglages du tracker, bases geo, mises à jour et menu ⚙ : archive, statuts, logs et extension Ads Manager.
Lire le guide →DocsBot Telegram
Statistiques, conversions et digest quotidien dans Telegram : connexion par token, webhook ou polling, commandes, notifications et alertes vers les chaînes.
Lire le guide →DocsMCP : un assistant IA dans le tracker
Connecter Claude Desktop ou tout client MCP à Orbitra via le serveur MCP : clés API, options de connexion et les 41 tools disponibles.
Lire le guide →