Installation und Updates
Orbitra ist fĂŒr einen schnellen Start ohne komplexes Environment-Setup optimiert. Es baut auf einem schlanken PHP + SQLite + Nginx-Stack auf â ohne separaten DB-Server (kein ClickHouse, Redis oder MySQL).
Systemvoraussetzungen
Orbitra speichert alles in einer einzigen SQLite-Datei und braucht deshalb deutlich weniger RAM als ClickHouse-basierte Tracker â ein gĂŒnstigster VPS-Tarif reicht.
Basis (erforderlich):
- CPU: 1 vCPU (x86_64)
- RAM: 1 GB (2 GB empfohlen)
- Festplatte: 20 GB SSD
- OS: Ubuntu 22.04 bis 26.04 oder Debian 12 / 13
- Ein sauberer Server ohne Control Panel; root/sudo-Zugriff
GröĂenordnung nach Traffic-Volumen (Richtwert):
| Klicks pro Tag | RAM | CPU | Festplatte |
|---|---|---|---|
| bis ~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 |
â In der Praxis verifiziert: Orbitra lĂ€uft stabil auf einem 2 vCPU / 2 GB RAM / 20 GB SSD-VPS (Ubuntu 24.04) mit wenig Traffic â ein bequemer und gĂŒnstiger Startpunkt. Die oberen Tabellenzeilen sind Reserve fĂŒr höheres Traffic-Volumen, keine harte Anforderung.
đĄ Warum weniger als Keitaro? Keitaro speichert Klicks in ClickHouse + Redis + MySQL, wachsen seine RAM-Anforderungen doch bis 64 GB bei Millionen Klicks pro Tag. In Orbitra lebt alles in einer einzigen SQLite-Datei â der Flaschenhals ist nicht der RAM, sondern Disk-I/O und SQLites single-threaded Writes. FĂŒr kleine und mittlere Volumen (im WAL-Modus) reicht das; fĂŒr dauerhaft Millionen Klicks pro Tag mit schwergewichtiger Analytik ist ein Tracker mit Columnar-DB (wie Keitaro) architektonisch die bessere Wahl.
đĄ Bei der Installation auf einem 1-GB-RAM-Server: fĂŒge 1â2 GB Swap hinzu â das Bauen des Frontends (Vite) ist der speicherhungrigste Schritt. Der Tracker selbst lĂ€uft problemlos mit 1 GB.
Schnelle automatische Installation (Production)
Der schnellste und richtige Weg, das Projekt auf einem Server zu starten, ist der eingebaute Installer.
- Stelle sicher, dass du einen âsauberenâ Linux-Server hast (Ubuntu 22.04+ oder Debian 12+).
- FĂŒhre den Befehl als root/sudo aus:
wget -O orbitra-install.sh https://raw.githubusercontent.com/fenjo26/Orbitra.link/main/install.sh && bash orbitra-install.sh
Der Download ist mit Absicht ein eigener Schritt: Bei wget -qO- ⊠| bash pumpt ein fehlgeschlagener Download stumm Leere in bash, und die Installation âist fertigâ, ohne eine einzige Ausgabezeile. So stoppt sie an &&, und wget meldet den Grund.
- Das Script installiert Nginx, ein aktuelles PHP (8.5, mit Fallback auf 8.4 aus dem OndĆej-SurĂœ-Repository; ist auch das nicht verfĂŒgbar â das der Distribution), SQLite, lĂ€dt den Frontend-Code herunter und richtet HTTPS-Zertifikate ein.
Erste Anmeldung: Es gibt keinen âDefaultâ-Account. Ăffne nach der Installation
http://<your-domain>/admin.phpâ beim ersten Start startet Orbitra den Einrichtungs-Wizard, in dem du deinen eigenen Administrator anlegst (Login â„ 3 Zeichen, Passwort â„ 8 Zeichen, Zeitzone und Sprache).
Panel-Zugriff per IP
Das Panel ist immer unter der Server-Adresse erreichbar â http://<ip>/admin.php â egal wie viele Domains du bindest und welche du spĂ€ter löschst. DafĂŒr sorgt ein Catch-all-Block, den Orbitra an den Anfang der Nginx-Konfiguration setzt; Zertifikate werden via certbot certonly --webroot ausgestellt, sodass Certbot die Konfiguration nicht umschreibt.
https://<ip>/admin.php funktioniert ebenfalls, aber mit Browser-Warnung: Let's Encrypt stellt keine Zertifikate fĂŒr nackte IPs aus, daher wird ein selbstsigniertes verwendet.
Wenn das Panel trotzdem nicht mehr antwortet â etwa weil die Nginx-Konfiguration von Hand bearbeitet wurde â baue sie aus der Datenbank neu auf:
sudo php /var/www/orbitra/cli/nginx_sync.php
Der Befehl repariert auch Certbot-Renewal-Konfigurationen aus der alten Ausstellungsmethode und erzeugt ein selbstsigniertes Zertifikat. Nach einem Update von einer Version unter 0.9.6.4 einmal ausfĂŒhren.
Was das Installations-Script einrichtet
- Nginx, PHP-FPM (der Pool wird nach RAM-Menge dimensioniert,
fastcgi_read_timeout 180s), SQLite, Composer mit SHA-256-Verifizierung. - Den Code in
/var/www/orbitra, im Besitz vonwww-data. - Einen eigenen Postback-Key.
- Die Sypex-Geo-City-Datenbank (kostenlos, ohne Key). Konnte der Server sypexgeo.net nicht erreichen, lĂ€uft die Installation trotzdem durch, und die Datenbank lĂ€sst sich spĂ€ter unter â â Geo Databases hinzufĂŒgen.
- SSL- und Nginx-Helfer mit Argument-Validierung (
cli/server_setup.sh). - Crons: Klick-Spool, Postback-Warteschlange, Web Push, Rotations-Auto-Optimierung, Telegram-Polling, SSL-Ausstellung, Kosten-Import, IP-Bereiche, Geo-Datenbanken. Die volle Tabelle in Architecture.
- MCP-Server-AbhÀngigkeiten, falls npm auf dem Server vorhanden ist.
- Ăffnet 80/443 in ufw, falls es aktiv ist.
Nicht automatisch installiert: Retention-basiertes AufrÀumen (cli/cleanup_cron.php, siehe Administration), der Postback-Monitor und Quellen-URL-Checks.
Den Installer auf einem laufenden Server erneut auszufĂŒhren ist gefahrlos: Er aktualisiert PHP, Konfigurationen und Crons, ohne Daten anzufassen.
Die Panel-Sicherheitseinstellungen nach der Installation â eigener Panel-Pfad, Zugriff per IP, Zwei-Faktor-Login â sind in Administration beschrieben.
PHP aktualisieren
Sicherheitshinweis: CVE-2026-109618 / CVE-2026-109619 (Oktober 2026)
Zwei kritische, nicht authentifizierbare RCE-Schwachstellen in PHP selbst (âphp2shellâ, CVSS v4.0 9.2, öffentlicher Exploit) wurden upstream am 21.10.2026 gepatcht. Behobene Versionen: 8.5.12, 8.4.27, 8.3.36, 8.2.35. Ein Tracker ist eine PHP-App im offenen Internet, also muss jeder web-seitige Interpreter gepatcht sein. Das Panel zeigt ein rotes Banner auf dem Dashboard, bis das laufende PHP eine dieser Versionen (oder neuer) meldet.
- PHP 8.2â8.5, ungepatcht:
NEEDRESTART_MODE=a apt install -y --only-upgrade 'php8.X-'(ersetze X durch deinen Zweig), dann PHP-FPM und den Webserver neu starten (systemctl restart php8.X-fpm nginx). Paste-sicher konstruiert: Das Flag-yentfernt die BestĂ€tigungContinue? [Y/n](fĂŒgst du einen mehrzeiligen Block ein, wird die NĂCHSTE Zeile als Antwort gelesen â apt bricht ab), undNEEDRESTART_MODE=abeantwortet den Ubuntu-22.04+-Dialog âwelche Dienste neu startenâ automatisch. Benutze nicht ein nacktesapt upgrade 'php': apt expandiert den Glob auf jedes php-namige Paket im Archiv und bricht wegen Konflikten ab, bevor irgendetwas aktualisiert wird. Distro-Builds können den Fix backported tragen, ohne die Versionsnummer zu erreichen â prĂŒfeapt changelog php8.X-fpm | grep 109618, bevor du von einem betroffenen System ausgehst. - PHP 8.1 oder Ă€lter: Der Zweig ist EOL und bekommt den Fix nie. Upgrade ĂŒber den Installer-Weg unten (
sudo bash install.shinstalliert PHP 8.5 parallel und schaltet alles um). - Wurde PHP von einem Hosting-Panel installiert (ispmanager etc.), aktualisiere es ĂŒber dieses Panel.
Routine-Upgrade
Ubuntu 22.04 / Debian 12 / Ubuntu 24.04 liefern PHP 8.1 / 8.2 / 8.3 mit â diese Versionen erhalten keine Sicherheitsupdates mehr (8.1 und 8.2 sind EOL; 8.3 bekommt nur Security-Fixes bis Ende 2027). Orbitra v1.5.10 lĂ€uft auf allen, aber eine frische Installation oder ein Server-Upgrade sollte bei PHP 8.4+ beginnen.
Der einfachste Weg ist, den Installer erneut auszufĂŒhren (er ist idempotent und unterstĂŒtzt das Upgrade ĂŒber eine bestehende Installation):
sudo bash /var/www/orbitra/install.sh
Der Installer fĂŒgt das Repository der aktuellen PHP-Builds hinzu (ondrej/php auf Ubuntu, packages.sury.org auf Debian), installiert PHP 8.5 (mit Fallback auf 8.4) parallel zum alten, stellt die php-CLI-Alternative um (von Crons und Composer genutzt), schreibt die Nginx-Konfiguration auf den neuen FPM-Socket um, setzt die Pool-Einstellungen und startet die Dienste neu. Die alte PHP-Version bleibt installiert, serviert aber keinen Traffic mehr; nach einer PrĂŒfung kannst du sie entfernen, wenn du magst.
Manuell (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
Manuell (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
PrĂŒfe nach dem Update: php -v zeigt 8.4/8.5, das Panel öffnet sich, unter Logs â System log stehen keine postback.php database error-EintrĂ€ge, und der Worker-Ping in den Einstellungen der Postback-Warteschlange ist frisch. Beim Update ĂŒber den Button warnt das Panel von selbst, wenn der Server bei PHP < 8.4 bleibt.
Einmaliger Server-Schritt nach dem Update (1.6.0+)
Der âUpdateâ-Button im Panel lĂ€uft als Web-User und kann sudoers nicht Ă€ndern. Server, die vor 1.6.0 installiert wurden, brauchen nach dem Update einen einzelnen Lauf von cli/server_setup.sh als root â das Panel zeigt ein Banner mit dem Befehl:
curl -fsSL https://raw.githubusercontent.com/fenjo26/Orbitra.link/v1.6.0/cli/server_setup.sh | sudo ORBITRA_REF=v1.6.0 bash
Das Script wird vom Release-Tag geladen, nicht aus /var/www/orbitra (das Verzeichnis gehört dem Web-User, und root darf keine Dateien ausfĂŒhren, die der Web-User umschreiben kann). Es ersetzt die alten sudo-Regeln (certbot mit beliebigen Argumenten und cp nach sites-available â jede hĂ€tte dem Web-User Root verschaffen können) durch Helfer mit Argument-Validierung, installiert den Klick-Warteschlangen-Cron und schreibt die Version nach /etc/orbitra/server-setup-version. Ein erneuter Lauf ist gefahrlos. install.sh ruft dasselbe Script auf, bekommen also auch neue Installationen.
Nach dem Update auf 1.8.4: Nginx-Hardening (Oktober-2026-Hinweise)
Auf dem Server ist nichts auszufĂŒhren: Das Update selbst generiert den Nginx-vhost ohne die alias-Direktive neu und lĂ€dt nginx neu (ĂŒber denselben verifizierten Weg, den auch das Speichern einer Domain nutzt). Ăbrig bleibt die Betriebssystem-HĂ€lfte der Oktober-2026-Hinweise â das nginx-Paket selbst (bis CVSS 9.2 eingestuft), der Kernel und der CA-Trust-Store â die nur der Betreiber aktualisieren kann:
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
Distro-Builds können den Fix backporten, ohne die Version anzuheben â prĂŒfe das mit apt changelog nginx. Das Dashboard zeigt ein wegklickbares Banner, bis das laufende nginx eine behobene Version meldet (sofern eine Shell zum Nachlesen verfĂŒgbar ist). Die PostgreSQL-/Redis-/Node.js-Punkte desselben Digests betreffen den Tracker nicht: Er lĂ€uft auf PHP + SQLite und bringt kein Node.js auf den Server.
Nach dem Update auf 1.8.3: Session-Aufzeichnungen fĂŒr ganze Websites
Auf dem Server ist nichts auszufĂŒhren. Das Update bringt die Session-Aufzeichnungen auf Kampagnenebene mit One click per visit (Besuch-ZusammenfĂŒhrung) und dem Consent-Modus, alles standardmĂ€Ăig aus â Klick-Statistik und Aufzeichnungen Ă€ndern sich nur, wo du sie selbst einschaltest. Kein Cron nachzuinstallieren: Das AufrĂ€umen fĂ€hrt weiterhin mit den eingehenden Aufzeichnungen mit.
Nach dem Update auf 1.8.2: Browser check
Auf dem Server ist nichts auszufĂŒhren. Das Update bringt den Browser check mit, lĂ€sst ihn auf einer bestehenden Installation aber aus, damit sich das Routing nicht von selbst Ă€ndert. Admins sehen ein einmaliges Banner auf dem Dashboard: Turn on soft mode schaltet ein, Learn more öffnet Settings â Bots, Not now blendet das Banner aus (der Modus lĂ€sst sich jederzeit in Settings â Bots Ă€ndern). Eine frische Installation startet im Soft-Modus.
Update-IntegritÀt
composer.pharliegt nicht im Repository: Der Installer lÀdt die ininstall.shgepinnte Version (COMPOSER_VER) und verifiziertCOMPOSER_SHA256; eine Abweichung stoppt die Installation. Eine bereits vorhandene/var/www/orbitra/composer.pharwird so verwendet, wie sie ist.- Das Panel (
frontend/dist) wird auf der Release-Maschine gebaut und committed: Der Server fĂŒhrt nienpm install/npm run buildaus, und die Working Copy bleibt nach der Installation sauber. - Release-Tags sollten signiert sein (
git tag -s), damit ein Update aus dem Panel verifizierbaren Code zieht.
Lokale Entwicklung (React & PHP-Server)
Wenn du den Frontend-Quellcode (React) und die visuelle Seite des Trackers Àndern willst, brauchst du ein lokales PHP + Vite Setup.
Teil 1: Backend-API starten
Ăffne ein erstes Terminal und starte den eingebauten PHP-Server mit dem Router:
cd Orbitra
php -S localhost:8080 router.php
Dieser Server verarbeitet API-Anfragen und Redirects.
Teil 2: Frontend starten (Vite)
Ăffne ein zweites Terminal, installiere die npm-Pakete und starte den Dev-Server:
cd Orbitra/frontend
npm install
npm run dev
Ăffne dann http://localhost:5173 im Browser. Alle API-Anfragen aus dem Frontend werden automatisch (ĂŒber den Proxy in vite.config.js) an http://localhost:8080/api.php weitergeleitet â so vermeidest du CORS- und Session-Probleme im Entwicklungsmodus.
Das Panel bauen
Nur nötig, wenn du den Panel-Code Ànderst:
cd Orbitra/frontend
npm run build
Das Build landet in frontend/dist/, das im Repository committed ist â der Server nimmt das fertige Panel per git pull oder ĂŒber ein Update aus dem Panel und baut selbst nichts.
Telegram-Bot
Anbindung und Betriebsmodi â Telegram-Bot.
Schnellstart
Von einem nackten Server zur ersten Conversion in neun Schritten: Installation, erster Login, Domain, Netzwerk und Offer, Traffic-Quelle, Kampagne, PrĂŒfung, Kosten.
Guide lesen âDocsInstallation und Updates
Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.
Guide lesen âDocsMigration von Keitaro
Einstellungen per SQL-Dump von Keitaro zu Orbitra ĂŒbertragen: was mitkommt, das Dump-Script, der Import und was du danach prĂŒfen solltest.
Guide lesen âDocsMigration von Binom
Kampagnen, Offers, Streams und mehr direkt ĂŒber die Binom-v2-Public-API importieren â ohne Dump-Datei, inklusive Mapping-Hinweisen.
Guide lesen âDocsFunktionen im Ăberblick
Alle Orbitra-Funktionen auf einen Blick: Traffic und Schemas, Postbacks und Kosten, Analytics, Infrastruktur und Verwaltung â mit Links auf die Detailseiten.
Guide lesen âDocsKampagnen und Streams
Der Kampagnen-Editor im Detail: Reiter, Kostenmodelle, Stream-Typen, alle Filter, Schemas, Rotation mit Auto-Optimierung, Test-Link und Duplikat-Schutz.
Guide lesen âDocsCloaking (Referenz)
Die vollstĂ€ndige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, GrĂŒnde und Diagnostik.
Guide lesen âDocsBrowser check
Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an WidersprĂŒchen im Browser selbst erkennen â Modi, Anzeichen und der sichere Einstieg.
Guide lesen âDocsLandingpages (Referenz)
Die vollstÀndige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.
Guide lesen âDocsPWA und Web Push
PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.
Guide lesen âDocsPWA Funnel
Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.
Guide lesen âDocsConversion-Popups
Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.
Guide lesen âDocsSession-Aufzeichnungen und Heatmaps
Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.
Guide lesen âDocsContent Gallery
Die zentrale Mediathek des Trackers fĂŒr Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.
Guide lesen âDocsCreatives-Bibliothek
Creatives mit SubID-Tracking speichern und ĂŒber Kampagnen hinweg testen.
Guide lesen âDocsExterne PWA und Telegram-KanĂ€le
PWAs auf externen Domains veröffentlichen und Telegram-KanÀle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.
Guide lesen âDocsPostbacks und Conversions
Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.
Guide lesen âDocsKosten
Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen â und wie der Revenue Aggregator arbeitet.
Guide lesen âDocsPush- und Pop-Netzwerke
Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.
Guide lesen âDocsFacebook / Meta
Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.
Guide lesen âDocsDolphin / Fbtool
Facebook-Kosten ĂŒber den Keitaro-kompatiblen Admin-API-Endpunkt empfangen: API-Key, Dolphin- und Fbtool-Setup und wie der Spend auf die Klicks verteilt wird.
Guide lesen âDocsFB-Kommentar-Cleaner
Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.
Guide lesen âDocsTraffic-Quellen und Affiliate-Netzwerke
Die beiden Verzeichnisse am Funnel-Rand: Templates fĂŒr rund 200 Quellen und 440 Netzwerke, Parameter, Makros und Postback-URLs.
Guide lesen âDocsReports, Logs und Metriken
Der Report-Builder, Traffic-Log, Klick-Karte und jede Metrik erklĂ€rt â von Clicks und Visits ĂŒber ROI bis zur Scroll-Tiefe.
Guide lesen âDocsDomains und SSL
Domains hinzufĂŒgen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.
Guide lesen âDocsCloudflare
Kampagnen-Domains ĂŒber Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.
Guide lesen âDocsAdministration
Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus â die Verwaltung des Trackers ĂŒber das â-MenĂŒ.
Guide lesen âDocsTelegram-Bot
Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tÀgliches Digest.
Guide lesen âDocsMCP: ein KI-Assistent im Tracker
Claude oder einen anderen MCP-Client an Orbitra anbinden und Kampagnen, Offers und Domains in natĂŒrlicher Sprache verwalten.
Guide lesen â