Cómo instalar AirTrail - Rastreador de vuelos autohospedado en Docker

AirTrail | Flight Tracking | Docker

AirTrail: Rastreador de vuelos personal autohospedado en Docker

Mapa interactivo de tus vuelos. Estadísticas detalladas. Importa de FlightRadar24, JetLog, TripIt, Flighty. Multi-usuario. OAuth. Tema claro/oscuro. Control de datos 100%. Open source.

¿Qué es AirTrail?


AirTrail es un rastreador de vuelos personal moderno y open source que te permite visualizar todos tus vuelos en un mapa interactivo con estadísticas detalladas, completamente autohospedado. A diferencia de FlightRadar24 (tracking público), MyFlightRadar24 (estadísticas limitadas), o aplicaciones SaaS, AirTrail es tuyo: datos privados, almacenados en tu servidor, sin vendor lock-in.

Características principales: Mapa interactivo global con todos tus vuelos. Estadísticas: km volados, horas en aire, aeropuertos visitados, desglose por aerolínea. Importa vuelos desde MyFlightRadar24, App in the Air, JetLog, TripIt, Flighty, byAir. Multi-usuario con autenticación incorporada y soporte OAuth. Tema claro/oscuro adaptable. PostgreSQL backend. SvelteKit frontend moderno. Responsive design (desktop, tablet, móvil). API REST. Control total de datos en tu servidor.

Para viajeros y enthusiasts de aviación: Rastreo privado de tus vuelos. Sin publicidad. Sin tracking de terceros. Tu historia de vuelo es tuya.

Características principales

Mapa interactivo global

Visualiza todos tus vuelos en mapa. Rutas, patrones, puntos calientes.

Estadísticas detalladas

Km totales, horas aire, aeropuertos visitados, desglose aerolínea.

Importar vuelos

MyFlightRadar24, JetLog, TripIt, Flighty, App in the Air, byAir.

Multi-usuario

Múltiples usuarios, vuelos compartidos, permisos granulares.

Autenticación OAuth

Social login: GitHub, Google, etc. O usuario/password local.

Tema claro/oscuro

Interfaz moderna. Auto-adapt o selecciona tu preferencia.

Responsive design

Funciona perfecto en desktop, tablet, móvil.

API REST

Integra con aplicaciones externas. Automación.

Control total

Self-hosted. Datos privados. Open source. Tu servidor.

Búsqueda filtrable

Busca vuelos por fecha, aerolínea, ruta, aeropuerto.

Requisitos del sistema

  • Docker & Docker Compose 2.x+
  • 1-2 GB RAM (SvelteKit + PostgreSQL)
  • 5+ GB espacio disco (BD + datos vuelos)
  • Puerto 3000 (configurable)
  • PostgreSQL (incluido en docker-compose)
  • Navegador moderno para UI
Ligero: AirTrail consume recursos moderados. Perfecto para VPS, Raspberry Pi potente, cualquier servidor moderno.

Instalación con Docker Compose

Opción 1: One-liner (Linux con Docker)

bash <(curl -o- https://raw.githubusercontent.com/JohanOhly/AirTrail/main/scripts/install.sh)

Opción 2: Setup manual

# Crear directorio mkdir airtrail && cd airtrail # Descargar archivos de configuración wget -O docker-compose.yml https://raw.githubusercontent.com/JohanOhly/AirTrail/main/docker/production/compose.yml wget -O .env https://raw.githubusercontent.com/JohanOhly/AirTrail/main/.env.example

Paso 3: Configurar .env

# Edita .env y configura: # URL donde accederás (localhost, IP, dominio) ORIGIN=http://localhost:3000 # Para múltiples URLs (separadas por coma): ORIGINS=http://localhost:3000,https://airtrail.tudominio.com # Contraseña PostgreSQL (solo caracteres A-Za-z0-9) DB_PASSWORD=tu_contrasena_segura # Base de datos DATABASE_URL=postgres://airtrail:tu_contrasena_segura@db:5432/airtrail

Paso 4: Iniciar con Docker Compose

docker compose up -d # Verificar que está corriendo docker compose ps

Acceder

http://localhost:3000 - Dashboard de AirTrail

Primeros pasos

1. Crear cuenta admin

  1. Abre http://localhost:3000
  2. Haz signup (crear cuenta)
  3. Username/email y contraseña
  4. Serás el admin de la instancia

2. Añadir vuelos manualmente

  1. Click en "Add Flight" o botón similar
  2. Completa formulario:
  3. Departure airport (ej: MAD, BCN, SVQ)
  4. Arrival airport
  5. Fecha y hora
  6. Número de vuelo (opcional)
  7. Aerolínea
  8. Guardar

3. Importar vuelos desde MyFlightRadar24

  1. Settings → Import
  2. Selecciona "MyFlightRadar24"
  3. Autentica con tu cuenta MyFlightRadar24
  4. AirTrail descarga todos tus vuelos automáticamente

4. Importar desde otros servicios

  1. Settings → Import
  2. Opciones: JetLog, App in the Air, TripIt, Flighty, byAir
  3. Sigue el proceso de autenticación
  4. Importa todos tus vuelos históricos

5. Explorar el mapa

  1. Dashboard muestra mapa interactivo global
  2. Todos tus vuelos aparecen como líneas en el mapa
  3. Zoom, pan, explora tus patrones de viaje
  4. Click en ruta para detalles del vuelo

6. Ver estadísticas

  1. Sección "Statistics" o "Stats"
  2. Km totales volados, horas en aire
  3. Aeropuertos visitados, desglose por aerolínea
  4. Gráficos por año, mes, tipo de aeronave

7. Invitar otros usuarios

  1. Settings → Users/Members
  2. Invite user o Add member
  3. Email de invitación
  4. Pueden crear cuenta o usar OAuth

Casos de uso

  • Viajeros frecuentes: Rastreo privado de todo tu historial de vuelos.
  • Aviation enthusiasts: Documentación personal de vuelos tomados.
  • Familias: Compartir vuelos entre familia. Multi-usuario incorporado.
  • Pilotos: Registro de horas de vuelo, rutas, experiencias.
  • Bloggers de viajes: Mapa interactivo para demostrar dónde has viajado.
  • Data privacy advocates: Control total. Sin publicidad. Sin tracking.

HTTPS con Caddy (producción)

Caddyfile

airtrail.tudominio.com { reverse_proxy localhost:3000 }

Actualizar ORIGINS en .env

ORIGINS=https://airtrail.tudominio.com,http://localhost:3000

Reiniciar

docker compose restart

Acceso remoto seguro

https://airtrail.tudominio.com con HTTPS automático de Caddy

Gestión y mantenimiento

Ver logs

docker compose logs -f docker logs -f airtrail-app

Backup de base de datos

docker exec airtrail-db pg_dump -U airtrail -d airtrail > airtrail-backup-$(date +%Y%m%d).sql

Restore de backup

docker exec -i airtrail-db psql -U airtrail -d airtrail < airtrail-backup-20260522.sql

Reiniciar servicios

docker compose restart

Actualizar AirTrail

docker compose pull docker compose down && docker compose up -d

Ver tamaño de base de datos

docker exec airtrail-db du -sh /var/lib/postgresql/data

Verificar salud de la aplicación

docker compose ps

Comparativa con alternativas

vs MyFlightRadar24

AirTrail gana: Self-hosted, privado, SvelteKit moderno, multi-usuario. MyFlightRadar24 gana: Más pulido, integración social.

vs Flighty (App)

AirTrail gana: Web-based, auto-hospedable, gratuito. Flighty gana: App nativa, real-time tracking en vuelo.

vs JetLog

AirTrail gana: Self-hosted, mapa interactivo, open source. JetLog gana: Más features de logbook, integración crew.

vs Spreadsheet (Excel/Sheets)

AirTrail gana: Visualización de mapa, estadísticas automáticas, búsqueda. Spreadsheet gana: Total control de estructura.

Mejor para: Viajeros frecuentes que quieren rastreo privado, visual, multi-usuario, self-hosted. Sin suscripción. Control total de datos.

Comentarios

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.