Docs

Instalación y actualizaciones

Orbitra está optimizado para un arranque rápido sin una configuración de entorno compleja. Se construye sobre un stack ligero de PHP + SQLite + Nginx — sin un servidor de base de datos aparte (sin ClickHouse, Redis ni MySQL).

Requisitos del sistema

Orbitra guarda todo en un solo archivo SQLite, así que necesita bastante menos RAM que los trackers basados en ClickHouse y funciona en los planes de VPS más baratos.

Básico (requerido):

Dimensionamiento por volumen de tráfico (una orientación):

Clics por díaRAMCPUDisco
hasta ~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

✅ Verificado en la práctica: Orbitra funciona de forma estable en un VPS de 2 vCPU / 2 GB RAM / 20 GB SSD (Ubuntu 24.04) con tráfico ligero — un punto de partida cómodo y barato. Las filas superiores de la tabla son margen para más tráfico, no un requisito estricto.

💡 ¿Por qué menos que Keitaro? Keitaro guarda los clics en ClickHouse + Redis + MySQL, así que sus requisitos de RAM crecen hasta 64 GB con millones de clics al día. En Orbitra todo vive en un único archivo SQLite — el cuello de botella no es la RAM sino la E/S de disco y las escrituras single-thread de SQLite. Para volúmenes bajos y medios (en modo WAL) esto basta; para millones de clics al día sostenidos con analítica pesada, un tracker con base de datos columnar (como Keitaro) es arquitectónicamente más adecuado.

💡 Al instalar en un servidor de 1 GB de RAM, añade 1–2 GB de swap: compilar el frontend (Vite) es el paso que más memoria consume. El tracker en sí funciona bien con 1 GB.

Instalación automática rápida (Producción)

La forma más rápida y correcta de lanzar el proyecto en un servidor es el instalador integrado.

  1. Asegúrate de tener un servidor Linux "limpio" (Ubuntu 22.04+ o Debian 12+).
  2. Ejecuta el comando como root/sudo:
   wget -O orbitra-install.sh https://raw.githubusercontent.com/fenjo26/Orbitra.link/main/install.sh && bash orbitra-install.sh

La descarga es un paso separado a propósito: con wget -qO- … | bash, una descarga fallida canaliza vacío a bash en silencio, y la instalación "se completa" sin una sola línea de salida. De esta forma se detiene en &&, y wget informa del motivo.

  1. El script instala Nginx, un PHP actual (8.5, con repliegue a 8.4 del repositorio de Ondřej Surý; si tampoco está disponible — el de la distro), SQLite, descarga el código del frontend y configura los certificados HTTPS.

Primer inicio de sesión: no hay una cuenta "por defecto". Tras la instalación, abre http://<your-domain>/admin.php — en el primer arranque Orbitra inicia el asistente de configuración inicial, donde creas tu propio administrador (usuario ≥ 3 caracteres, contraseña ≥ 8 caracteres, zona horaria e idioma).

Acceso al panel por IP

El panel siempre está disponible en la dirección del servidor — http://<ip>/admin.php — sin importar cuántos dominios vincules y cuáles borres después. Lo gestiona un bloque catch-all que Orbitra pone primero en la configuración de Nginx; los certificados se emiten vía certbot certonly --webroot, así que Certbot no reescribe la configuración.

https://<ip>/admin.php también funciona, pero con una advertencia del navegador: Let's Encrypt no emite certificados para IPs desnudas, así que se usa uno autofirmado.

Si el panel deja de responder — por ejemplo, si la configuración de Nginx se editó a mano — reconstrúyela desde la base de datos:

sudo php /var/www/orbitra/cli/nginx_sync.php

El comando también repara las configuraciones de renovación de Certbot que quedaron del método de emisión anterior y genera un certificado autofirmado. Tras actualizar desde una versión anterior a 0.9.6.4, ejecútalo una vez.

Qué configura el instalador

No se instala automáticamente: la limpieza por retención (cli/cleanup_cron.php, ver Administration), el monitor de postbacks y las comprobaciones de URLs de fuente.

Volver a ejecutar el instalador en un servidor en producción es seguro: actualiza PHP, configuraciones y crons sin tocar los datos.

Los ajustes de seguridad del panel tras la instalación — una ruta de panel personalizada, acceso por IP, login de dos factores — se cubren en Administration.

Actualizar PHP

Aviso de seguridad: CVE-2026-109618 / CVE-2026-109619 (octubre de 2026)

Dos vulnerabilidades críticas de RCE sin autenticación en el propio PHP ("php2shell", CVSS v4.0 9.2, exploit público) fueron parcheadas upstream el 2026-10-21. Versiones corregidas: 8.5.12, 8.4.27, 8.3.36, 8.2.35. Un tracker es una aplicación PHP expuesta a internet, así que todo intérprete con cara a la web debe estar parcheado. El panel muestra un banner rojo en el dashboard hasta que el PHP en ejecución reporte una de estas versiones (o más nueva).

Actualización rutinaria

Ubuntu 22.04 / Debian 12 / Ubuntu 24.04 traen PHP 8.1 / 8.2 / 8.3 de serie — estas versiones ya no reciben actualizaciones de seguridad (8.1 y 8.2 están EOL; 8.3 solo recibe correcciones de seguridad hasta finales de 2027). Orbitra v1.5.10 funciona con todas, pero una instalación nueva o una actualización de servidor debería partir de PHP 8.4+.

El camino más simple es volver a ejecutar el instalador (es idempotente y soporta actualizar sobre una instalación existente):

sudo bash /var/www/orbitra/install.sh

El instalador añade el repositorio de builds actuales de PHP (ondrej/php en Ubuntu, packages.sury.org en Debian), instala PHP 8.5 (con repliegue a 8.4) junto al viejo, cambia la alternativa php de la CLI (usada por los crons y Composer), reescribe la configuración de Nginx al nuevo socket FPM, aplica los ajustes del pool y reinicia los servicios. La versión vieja de PHP queda instalada pero deja de servir tráfico; puedes eliminarla después de comprobar, si quieres.

Manual (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

Manual (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

Tras la actualización, comprueba: php -v muestra 8.4/8.5, el panel abre, Logs → System log no tiene entradas postback.php database error, y el ping del worker en los ajustes de la cola de postbacks es reciente. Al actualizar desde el botón, el panel avisará por sí solo si el servidor se queda en PHP < 8.4.

Paso de servidor único tras actualizar (1.6.0+)

El botón "Update" del panel se ejecuta como el usuario web y no puede modificar sudoers. Los servidores instalados antes de 1.6.0 necesitan una única ejecución de cli/server_setup.sh como root tras actualizar — el panel mostrará un banner con el comando:

curl -fsSL https://raw.githubusercontent.com/fenjo26/Orbitra.link/v1.6.0/cli/server_setup.sh | sudo ORBITRA_REF=v1.6.0 bash

El script se descarga del tag de la release, no de /var/www/orbitra (ese directorio pertenece al usuario web, y root no debe ejecutar archivos que el usuario web puede reescribir). Reemplaza las viejas reglas sudo (certbot con cualquier argumento, y cp hacia sites-available — cualquiera de las dos podría dar root al usuario web) por scripts auxiliares que validan argumentos, instala el cron de la cola de clics y escribe la versión en /etc/orbitra/server-setup-version. Ejecutarlo otra vez es seguro. install.sh llama al mismo script, así que las instalaciones nuevas reciben lo mismo.

Tras actualizar a 1.8.4: hardening de nginx (avisos de octubre de 2026)

Nada que ejecutar en el servidor: la propia actualización regenera el vhost de nginx sin la directiva alias y recarga nginx (por la misma ruta verificada que usa el guardado de un dominio). Lo que queda es la mitad del sistema operativo de los avisos de octubre de 2026 — el paquete nginx en sí (puntuado hasta CVSS 9.2), el kernel y el almacén de confianza de CAs — que solo el operador puede actualizar:

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

Las builds de la distro pueden traer la corrección backporteada sin subir la versión — compruébalo con apt changelog nginx. El dashboard muestra un banner descartable hasta que el nginx en ejecución reporte una versión corregida (cuando hay una shell disponible para leerla). El tracker no se ve afectado por los puntos de PostgreSQL / Redis / Node.js del mismo digest: corre PHP + SQLite y no incluye Node.js en el servidor.

Tras actualizar a 1.8.3: grabaciones de sesión para sitios enteros

Nada que ejecutar en el servidor. La actualización añade las grabaciones de sesión a nivel de campaña con el pegado de visitas One click per visit y el modo de consentimiento, todo desactivado por defecto — las estadísticas de clics y las grabaciones solo cambian donde tú mismo las actives. No hay cron que añadir: la limpieza sigue montada en las grabaciones entrantes.

Tras actualizar a 1.8.2: browser check

Nada que ejecutar en el servidor. La actualización añade el browser check pero lo deja desactivado en una instalación existente, para que el enrutamiento no cambie por sí solo. Los admins ven un banner de una sola vez en el dashboard: Turn on soft mode lo activa, Learn more abre Settings → Bots, Not now oculta el banner (el modo se puede cambiar en Settings → Bots en cualquier momento). Una instalación nueva empieza en modo soft.

Integridad de las actualizaciones

Desarrollo local (React y servidor PHP)

Si planeas modificar el código fuente del frontend (React) y la parte visual del tracker, necesitarás un entorno local de PHP + Vite.

Parte 1: Arrancar la API del backend

Abre una primera terminal y arranca el servidor PHP integrado con el router:

cd Orbitra
php -S localhost:8080 router.php

Este servidor atenderá las peticiones de la API y las redirecciones.

Parte 2: Arrancar el frontend (Vite)

Abre una segunda terminal, instala los paquetes npm y arranca el servidor de desarrollo:

cd Orbitra/frontend
npm install
npm run dev

Luego abre http://localhost:5173 en tu navegador. Todas las peticiones de la API del frontend se redirigen automáticamente por proxy (vía el proxy de vite.config.js) a http://localhost:8080/api.php, lo que evita problemas de CORS y de sesión en modo desarrollo.

Compilar el panel

Solo hace falta si cambias el código del panel:

cd Orbitra/frontend
npm run build

El build queda en frontend/dist/, que está comprometido al repositorio — el servidor toma el panel ya hecho vía git pull o una actualización desde el panel y no compila nada por sí mismo.

Bot de Telegram

Conexión y modos de operación — Bot de Telegram.

← Anterior
Inicio rápido: tu primera campaña
Siguiente →
Migrar desde Keitaro
Ver el código en GitHub: github.com/fenjo26/Orbitra.link/wiki
Todas las guías
Docs

Inicio rápido: tu primera campaña

El camino corto: instala el tracker, crea la red, la oferta y la campaña, y consigue tus primeros clics y conversiones en menos de una hora.

Leer la guía →
Docs

Instalación y actualizaciones

Instala Orbitra en un servidor Ubuntu o Debian recién creado con un solo comando, actualiza PHP y las versiones nuevas de forma segura.

Leer la guía →
Docs

Migrar desde Keitaro

Mueve campañas, ofertas, fuentes y dominios de Keitaro a Orbitra con un dump SQL — qué se transfiere y qué revisar después.

Leer la guía →
Docs

Migrar desde Binom

Mueve campañas y flujos de Binom v2 a Orbitra vía su Public API — qué se transfiere automáticamente y qué se ajusta a mano.

Leer la guía →
Docs

Resumen de funciones

Todo lo que Orbitra puede hacer: campañas y flujos, cloaking, landings, PWA, postbacks, costos, informes e integraciones.

Leer la guía →
Docs

Campañas y flujos

La referencia completa: ajustes de campaña, tipos de flujo, esquemas, rotación, filtros, test links y cada opción explicada.

Leer la guía →
Docs

Cloaking: referencia completa

Referencia completa del cloaking: capas de detección, sensibilidad, ajustes globales, veredictos, motivos e informes.

Leer la guía →
Docs

Browser check

Cómo el check JS atrapa bots, VMs y emuladores por contradicciones del navegador: modos Off / Observe / Soft / Strict y sus signos.

Leer la guía →
Docs

Landing pages (referencia)

Tipos de landing, la macro {offer}, el adaptador JS, LeadForge y landings multi-oferta — la referencia completa.

Leer la guía →
Docs

PWA y Web Push

Crea apps PWA instalables y tu propia base de suscriptores push: constructor, claves VAPID, mensajes, atribución y solución de problemas.

Leer la guía →
Docs

Embudo de PWA

Cómo funciona el embudo configurable de una PWA: pasos y tipos de pantalla, tracking por pantalla, estadísticas del embudo y vista previa en el editor.

Leer la guía →
Docs

Popups de conversión

Muestra conversiones reales como popups en tus landings: activación por campaña, plantillas por vertical, disparadores y ubicación.

Leer la guía →
Docs

Grabaciones de sesión y mapas de calor

Reproduce visitas reales y consulta el mapa de calor de clics y de scroll. Límites de almacenamiento y notas de privacidad.

Leer la guía →
Docs

Content Gallery (referencia)

Almacenamiento central de iconos, capturas y creativos usados en PWAs y landings: carpetas, límites y el MediaPicker en los editores.

Leer la guía →
Docs

Biblioteca de creativos

Almacena creativos con tracking de subid y pruébalos en distintas campañas: métricas por creativo sincronizadas con Facebook y TikTok.

Leer la guía →
Docs

PWA externas y canales de Telegram

Publica PWAs en dominios externos y usa canales de Telegram como fuente de tráfico con suscriptores atribuidos.

Leer la guía →
Docs

Postbacks y conversiones

Postbacks entrantes, estados y tipos de conversión, y postbacks S2S salientes hacia tu fuente de tráfico.

Leer la guía →
Docs

Costos

Importa el gasto de Facebook, TikTok y Google Ads, o actualízalo por API y cron — y cómo funciona el agregador de ingresos.

Leer la guía →
Docs

Redes push y pop

Trabajo con fuentes de tráfico push y pop: importación de gasto por campaña y zona, optimización de zonas y el Zone Killer.

Leer la guía →
Docs

Facebook / Meta

Importación de costos desde Meta Ads y Conversions API: eventos del lado del servidor con deduplicación.

Leer la guía →
Docs

Dolphin / Fbtool

Recibe los costos de Facebook vía la API de Dolphin (Fbtool) en tiempo real: clave de API, configuración de cada servicio y cómo se reparte el gasto entre los clics.

Leer la guía →
Docs

FB Comment Cleaner

Modera en bloque los comentarios bajo tus anuncios de Meta: ocultar, borrar y filtrar por palabras clave, con dry run, journal y auto-pausa.

Leer la guía →
Docs

Fuentes de tráfico y redes de afiliados

Los dos directorios que configuran los bordes del embudo: plantillas y parámetros de fuentes y redes, postback global, macros de oferta y LeadForge.

Leer la guía →
Docs

Informes, logs y métricas

El constructor de informes, tendencias y cohortes, el log de tráfico y la tarjeta del clic, más la definición de cada métrica.

Leer la guía →
Docs

Dominios y SSL

Añade dominios, apunta el DNS y emite certificados Let's Encrypt gratis: ajustes del dominio, modos SSL, registrars conectados y Backorder.

Leer la guía →
Docs

Cloudflare

Cómo pasar los dominios de campaña por Cloudflare vía API: token, parking automático del registro A, modos SSL de zona y proxy.

Leer la guía →
Docs

Administración

Usuarios, roles y permisos, ajustes de seguridad y privacidad, bases de datos geo, actualizaciones y estado del sistema.

Leer la guía →
Docs

Bot de Telegram

Gestiona el tracker desde Telegram: estadísticas, conversiones y alertas en el chat, con webhook o polling.

Leer la guía →
Docs

MCP: un asistente de IA en el tracker

Conecta Claude o cualquier cliente MCP a Orbitra y maneja campañas con comandos en lenguaje natural: claves de API, conexión y seguridad.

Leer la guía →