Installation

Paquets natifs (.deb / .exe / .dmg)

Téléchargez le dernier .deb (Debian/Ubuntu), .exe (Windows) ou .dmg (macOS) depuis les Releases GitHub du projet — aucun Python requis, cyberlens s'exécute comme un binaire autonome directement dans votre terminal.

  • Debian/Ubuntu : sudo apt install ./cyberlens_<version>_amd64.deb — installe dans /usr/bin/cyberlens, déjà dans le PATH.
  • Windows : lancez cyberlens-<version>-setup.exe ; cochez « Add CyberLens to PATH » (recommandé, coché par défaut). Ouvrez un nouveau terminal, puis lancez cyberlens --help.
  • macOS : ouvrez le .dmg, lancez le .pkg à l'intérieur — installe dans /usr/local/bin/cyberlens, déjà dans le PATH.

Installation

Snap (Linux)

sudo snap install cyberlens
cyberlens install-browsers

Confinement strict — l'accès réseau et à votre dossier personnel est déclaré explicitement, aucune installation système requise en dehors du snap lui-même.

Installation

Depuis les sources (pip)

python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Optionnel : requis pour les modules basés navigateur (storage, clickjacking, xss)
playwright install chromium firefox webkit

Installation

Après l'installation

Quelle que soit la méthode choisie, téléchargez un moteur de navigateur — requis pour les modules storage/clickjacking/xss et le rendu JavaScript du crawler (tout le reste fonctionne sans) :

cyberlens install-browsers

Démarrage rapide

Premières commandes

cyberlens scan https://example.com --output report.pdf
cyberlens scan https://example.com --format html --output report.html
cyberlens scan https://example.com --format json --output report.json

# Rapport en français plutôt qu'en anglais (défaut)
cyberlens scan https://example.com --language fr --output rapport.pdf

# Un sous-ensemble de modules, sans confirmation interactive, timeout personnalisé
cyberlens scan https://example.com \
  --modules headers,tls,discovery \
  --confirm-authorized \
  --timeout 15

# Active les tests d'intrusion actifs sur les formulaires POST (SQLi/NoSQLi/SSTI/...)
# — une seconde confirmation distincte est requise, car cela envoie de vraies requêtes POST
cyberlens scan https://example.com --active-forms

# Tous les modules avec tests actifs en une seule commande
# (équivalent à omettre --modules et passer --active-forms)
cyberlens scan https://example.com --full --confirm-authorized --confirm-active-forms

# Se connecter d'abord, pour que le reste du scan voie une vue authentifiée
# — nécessite un vrai compte que vous contrôlez sur la cible
CYBERLENS_AUTH_PASSWORD=... cyberlens scan https://example.com --auth-username vous@example.com

Pour aller plus loin sur chaque fonctionnalité, direction les Guides.