Skip to content

deploy.md

Latest commit

 

History

History
107 lines (81 loc) · 4.56 KB

deploy.md

File metadata and controls

107 lines (81 loc) · 4.56 KB
Raw

🚀 Guía de Despliegue y Funcionalidades: Sentinel Observer

Sentinel Observer es un sistema de vigilancia continua (SaaS bot) diseñado para monitorizar cuentas y publicaciones de Instagram de manera 100% indetectable.

🌟 ¿Qué hace de forma excepcional?

  1. Monitorización 24/7 de Alta Precisión: Vigila de cerca tanto Perfiles como Publicaciones Individuales (Reels, Posts) de Instagram para detectar el momento exacto en que son baneados, eliminados o desactivados.

  2. Alertas Híbridas de Ban/Unban (Recuperación): Envía notificaciones de Telegram estilizadas y contundentes (al estilo "Hacker") cuando un objetivo cae ("Smoked") y cuando vuelve a estar activo ("Came back from graveyard").

  3. Cronometraje Inteligente: Calcula matemáticamente el tiempo exacto que tomó derribar un objetivo (desde que se empezó a vigilar) o el tiempo exacto que le tomó al objetivo ser desbaneado.

  4. Soporte Multilingüe Nativo: Habla fluidamente en 4 idiomas: Inglés, Español, Francés y Esperanto, adaptando no solo el texto sino el diseño de los mensajes automáticamente por usuario.

  5. Extracción de Métricas y Capturas Visuales: No solo avisa; recolecta inteligencia. Extrae Seguidores, Seguidos y Posts de los perfiles. Para las publicaciones, extrae Likes, Comentarios y el Texto. Y en todos los reportes, anexa una captura de pantalla prístina del estado de la página.

  6. Protección Multi-Usuario con Lista Blanca: Solo los usuarios autorizados por el Administrador pueden usar el bot, garantizando uso privado y control del servidor.

🕵️‍♂️ ¿Cómo lo hace? (El Motor en la Sombra)

  1. Navegación Sigilosa (Stealth Playwright): No utiliza APIs oficiales (que son limitadas). Levanta instancias asíncronas y headless (invisibles) de Chromium.
  2. Evasión de Algoritmos Anti-Bot: Simula comportamiento humano real:
    • Retardos aleatorios (human_delay).
    • Desplazamiento orgánico en la página.
    • Supresión de las banderas de automatización en Chromium.
    • Uso de Cookies de Sesión persistentes (cookies.json) para burlar los muros de inicio de sesión de Meta.
  3. Manejo Dinámico del Estado: No se confunde con los 404. Sabe distinguir si un 404 es una cuenta "Baneada/Eliminada/No Existente" e inmediatamente bloquea la cuenta en estado de "Vigilancia de Recuperación".
  4. Arquitectura Asíncrona (Aiogram + Asyncio): El motor principal (main.py) opera un bucle de recarga cada 10-15 minutos, mientras que los comandos de Telegram (telegram_bot.py) responden en tiempo real sin bloquear la cola de recolección de datos.

🛠️ Comandos de Despliegue y Mantenimiento

Para instalar, encender y gestionar el bot en un servidor (Ubuntu/Debian), sigue estos pasos:

1. Preparar el Entorno

Asegúrate de tener Python 3 instalado y crear un entorno virtual para no ensuciar el sistema.

# Navega al directorio del proyecto
cd /home/dicov/sentinel_observer/

# Crea el entorno virtual
python3 -m venv venv

# Actívalo
source venv/bin/activate

2. Instalar Dependencias

Instala los paquetes necesarios y el navegador de Playwright.

# Instalar los paquetes de Python
pip install -r requirements.txt
# (Alternativa si no hay requirements: pip install aiogram playwright structlog)

# Instalar los binarios del navegador de Playwright
playwright install chromium

3. Configuración Inicial

El bot requiere de dos archivos vitales en la raíz del proyecto:

  • config.py o variables de entorno que contengan:
    • TELEGRAM_BOT_TOKEN = "Tu_Token_Aquí"
    • TELEGRAM_ADMIN_ID = "El_Chat_ID_Del_Admin"
  • cookies.json: El archivo con las cookies de sesión exportadas desde una cuenta de Instagram limpia (para sortear los bloqueos).

4. Encender el Bot (Modo de Prueba)

Para correrlo en la terminal y ver los logs en vivo:

source venv/bin/activate
python main.py

5. Encender el Bot (Modo Producción - En Segundo Plano)

Para que el bot siga corriendo incluso cuando cierres la terminal, puedes usar nohup o preferiblemente un gestor como systemd o pm2.

Usando Nohup:

source venv/bin/activate
nohup python main.py > bot_logs.log 2>&1 &

(Para detenerlo después, busca el proceso con ps aux | grep main.py y usa kill <PID>)

Usando PM2 (Recomendado para auto-reinicio):

# Si tienes Node/NPM instalado:
npm install -g pm2
pm2 start main.py --name "EyeconBot" --interpreter ./venv/bin/python
pm2 save
pm2 logs EyeconBot

¡Con esto el motor estará vigilando en las sombras de forma permanente!