Administración
Todo lo que se abre desde el menú ⚙ en la esquina superior derecha del panel.
Usuarios y acceso
⚙ → Users. Dos pestañas: Users (la tabla de cuentas, visible para admins) y Profile (tu propia cuenta — para cada usuario).
Roles
Hay dos roles: admin (acceso total) y user (permisos por recurso). La cuenta creada en la instalación no se puede borrar, ni el último admin que queda. Los usuarios tienen plantillas de permisos: media buyer, editor de video / diseñador, desarrollador, o permisos personalizados.
Los permisos se otorgan por recurso: campaigns, offers, landings, sources, affiliate networks, domains, logs, gallery, push. Los niveles son full, read-only, no access. Para campañas también hay own + assigned y assigned only — entonces el usuario ve y edita solo esas campañas en todas partes: en listas, informes, logs, conversiones, en el dashboard. Los datos financieros se pueden ocultar aparte: costos, ingresos, payouts.
Los permisos se aplican en el servidor. Las acciones no asignadas a ningún recurso son solo de admin (la lista completa en REST API). Las operaciones globalmente peligrosas (borrar estadísticas, importación de Keitaro, importación de conversiones, reasignación retroactiva) no están disponibles para los usuarios con acceso "own + assigned".
Profile
Login, email, idioma de la interfaz, zona horaria (unas 250 zonas con el offset UTC actual), primer día de la semana, cambio de contraseña (requiere la contraseña actual; mínimo 8 caracteres).
Autenticación de dos factores — TOTP vía una app de autenticación. Los códigos son de un solo uso.
API keys
Las crea un admin para un usuario: read — solo lectura, write — también gestión. La clave se pasa en la cabecera Authorization: Bearer <key> o X-Api-Key. Se usa en MCP, REST API, para recibir costos de Dolphin / Fbtool y en la extensión de Ads Manager.
Inicio de sesión
Límites de intentos fallidos: 5 por 5 minutos desde una IP, y 20 por 15 minutos por cuenta (se reinician tras un inicio de sesión exitoso). La vida de la sesión es session_lifetime (un día por defecto, de 5 minutos a 30 días; la variable de entorno ORBITRA_SESSION_LIFETIME tiene prioridad sobre el ajuste).
Settings
⚙ → Settings, pestañas:
| Pestaña | Qué hay |
|---|---|
| General | Postback key, moneda por defecto, IP manual del servidor, permiso de landings PHP (desactivado por defecto) y su timeout de 1–9 s |
| Bots | Modo de Browser check (Off / Observe only / Soft / Strict), IPs y firmas de bots, la lista global de Bot ISP, rangos de datacenter, ASN de VPN como señal de bot — ver Cloaking |
| Conversion types | Estados personalizados y qué significan, estados sin mapear — ver Postbacks |
| Custom metrics | Fórmulas personalizadas para los informes |
| Automation | Crons: cola de postbacks, backorder |
| System | Recolección de estadísticas on/off, ignorar prefetch, comprobaciones de versión nueva, períodos de retención de logs y archivo, acceso al panel por IP/subredes, ruta del panel de admin |
| Privacy | Protección contra escaneos: qué responder cuando un enlace en funcionamiento recibe una visita directa sin parámetros de campaña — un 302 a tu URL, 404 o una página vacía |
Ruta del panel
/admin.php es lo primero que comprueba cualquier escáner. En System → Admin panel path puedes reemplazarlo por el tuyo (/my-panel), tras lo cual /admin.php empieza a responder 404. Esto esconde el formulario de login pero no reemplaza la contraseña. Si olvidas la ruta:
php /var/www/orbitra/cli/admin_path.php # print the current path
php /var/www/orbitra/cli/admin_path.php reset # вернуть /admin.php
Acceso al panel por IP
Una lista de IPs y subredes (IPv4 e IPv6, una por línea). Vacía — el panel está disponible desde cualquier lugar. Llena — iniciar sesión en el panel y las llamadas autorizadas a api.php funcionan solo desde esas direcciones. Las cabeceras X-Forwarded-For el tracker solo las confía si vienen de Cloudflare y de proxies privados. Cuidado: te puedes dejar fuera tú mismo. Para quitar la restricción desde el servidor:
sudo -u www-data php -r '$db = new PDO("sqlite:/var/www/orbitra/orbitra_db.sqlite"); $db->exec("UPDATE settings SET value = \x27\x27 WHERE key = \x27admin_ip_access\x27");'
Períodos de retención
Los campos "Log retention period" y "Archive resource retention period" solo funcionan cuando el cron de limpieza corre. El instalador no lo configura — añádelo a mano:
0 3 * * * php /var/www/orbitra/cli/cleanup_cron.php >> /var/www/orbitra/var/logs/cleanup.log 2>&1
El borrado corre en lotes para que la base de datos no se bloquee.
Personalization
⚙ → Personalization — logo, nombre, tema claro u oscuro y paletas: Cobalt, Canary, Parchment, Indigo (en variantes clara y oscura), Terminal, Aurora. El tema se aplica antes del primer pintado, así que el tema oscuro es oscuro desde el primer cuadro.
El idioma de la interfaz está en el profile: English, Русский, Українська, Español, Deutsch, Français, 中文.
Bases de datos geo
⚙ → Geo Databases. Sin una base de datos geo, los filtros de país y el cloaking por país no funcionan (todos los visitantes son Unknown); sin una base de datos ASN — las capas de datacenter y de listas de ISP.
| Base de datos | Clave | Qué da |
|---|---|---|
| Sypex Geo City | no hace falta | País, región, ciudad. La instala el instalador |
| MaxMind GeoLite2 City / ASN | clave de licencia de MaxMind | Ciudad, ASN y proveedor |
| IP2Location DB11 | token de IP2Location | Geo, zona horaria |
| IP2Proxy PX12 | token de IP2Location | VPN, proxy, TOR, residencial, fraud score |
Las bases se actualizan cada mes por el cron cli/geo_update.php (marcado con # orbitra-geo; MaxMind e IP2 — solo si las claves están guardadas). Una actualización del panel instala Sypex por sí misma cuando no hay ninguna base. Un banner en todas las pestañas avisa cuando no hay bases o solo está Sypex.
⚙ → Geo profiles — conjuntos de países listos para los filtros (EU, CIS, etc.) y personalizados.
Update
⚙ → Update — comprueba si hay una versión nueva en GitHub y actualiza con un botón (git pull como el usuario web). La comprobación se cachea una hora, 10 minutos en caso de error; se desactiva en System → Notify about new versions.
Tras una actualización el panel, por sí solo:
- restaura el cron de la cola de postbacks si falta;
- descarga Sypex Geo cuando no hay bases de datos geo;
- avisa si el servidor corre PHP por debajo de 8.4 (cómo actualizar PHP — Instalación y actualizaciones).
Los cambios que requieren root (reglas de sudo, helpers de SSL) no se pueden hacer con el botón — el panel muestra un banner con el comando cli/server_setup.sh (Instalación y actualizaciones).
Si exec está deshabilitado en el hosting, la página muestra los comandos para actualizar a mano vía Git.
Varios
| Ítem del menú | Qué hace |
|---|---|
| Archive | Campañas, ofertas, landings, fuentes y redes de afiliados borradas: restaurar o borrar para siempre |
| Clear statistics | Borrar los clics y las conversiones de un período o todos |
| Migrations | Versión del esquema de la base de datos, importación de Keitaro (Migrar desde Keitaro) |
| Status | Disco, CPU, RAM, tamaño de la base de datos |
| Logs | Traffic, postbacks, S2S, system, audit (Informes, logs y métricas) |
| Gallery | Biblioteca de medios para PWA, landings y ofertas (Content Gallery) |
| AI / MCP | Conectar un asistente de IA (MCP) |
| Support and feedback | Contactos y el bloque de partners |
Extensión de Ads Manager
Una extensión para Chrome y navegadores antidetect basados en Chromium muestra las métricas de Orbitra junto a las filas de campaña, grupo de anuncios y anuncio en el Facebook Ads Manager (refrescando cada 30 segundos), y al pulsar — un desglose de tres días: historia diaria, landings y ofertas, precisión de entrega de Pixel / CAPI.
- ⚙ → Integrations → Chrome & Antidetect Extension — descarga el archivo y descomprímelo.
- Carga la carpeta como una extensión desempaquetada (o un ZIP, donde esté soportado).
- En el popup de la extensión, pega la URL del tracker y la clave read resaltada que muestra Orbitra.
La extensión solo necesita una clave read. Las visitas a la página segura se excluyen igual que en los informes.
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 →DocsInstalació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 →DocsMigrar 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 →DocsMigrar 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 →DocsResumen de funciones
Todo lo que Orbitra puede hacer: campañas y flujos, cloaking, landings, PWA, postbacks, costos, informes e integraciones.
Leer la guía →DocsCampañ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 →DocsCloaking: referencia completa
Referencia completa del cloaking: capas de detección, sensibilidad, ajustes globales, veredictos, motivos e informes.
Leer la guía →DocsBrowser 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 →DocsLanding pages (referencia)
Tipos de landing, la macro {offer}, el adaptador JS, LeadForge y landings multi-oferta — la referencia completa.
Leer la guía →DocsPWA 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 →DocsEmbudo 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 →DocsPopups 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 →DocsGrabaciones 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 →DocsContent 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 →DocsBiblioteca 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 →DocsPWA 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 →DocsPostbacks y conversiones
Postbacks entrantes, estados y tipos de conversión, y postbacks S2S salientes hacia tu fuente de tráfico.
Leer la guía →DocsCostos
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 →DocsRedes 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 →DocsFacebook / Meta
Importación de costos desde Meta Ads y Conversions API: eventos del lado del servidor con deduplicación.
Leer la guía →DocsDolphin / 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 →DocsFB 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 →DocsFuentes 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 →DocsInformes, 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 →DocsDominios 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 →DocsCloudflare
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 →DocsAdministración
Usuarios, roles y permisos, ajustes de seguridad y privacidad, bases de datos geo, actualizaciones y estado del sistema.
Leer la guía →DocsBot de Telegram
Gestiona el tracker desde Telegram: estadísticas, conversiones y alertas en el chat, con webhook o polling.
Leer la guía →DocsMCP: 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 →