Strumento CLI basato su Go che scansiona i codebase per verificare la prontezza al lancio, rilevando configurazioni mancanti, problemi di igiene della sicurezza, fughe di segreti e lacune di integrazione prima del dispiegamento in produzione.
Preflight.sh è uno strumento da riga di comando che analizza la tua codebase per verificarne la prontezza al lancio. Identifica configurazioni mancanti, problemi di integrazione, criticità di sicurezza, lacune nei metadati SEO e altri errori comuni prima che tu esegua il deploy in produzione.
Non farti fare brutta figura in produzione. Esegui semplicemente il comando.
brew install preflightsh/preflight/preflight
npm install -g @preflightsh/preflight
go install github.com/preflightsh/preflight@latest
docker pull ghcr.io/preflightsh/preflight
curl -fsSL https://preflight.sh/install.sh | sh
Scarica l'ultima release da GitHub Releases.
A partire dalla v0.23.0 ogni archivio include una provenienza di build firmata. Per verificare che un download sia stato generato dal workflow di release di questo repository:
gh attestation verify preflight_<version>_<os>_<arch>.tar.gz --repo preflightsh/preflight
# Initialize in your project directory
cd your-project
preflight init
# (asks before replacing an existing preflight.yml; --force skips the question)
# In a script or CI job, where nobody can answer, pass --yes to accept the
# detected defaults. Without it, init stops and writes nothing when its input
# ends before the questions do.
# Run all checks
preflight scan
# Scan a specific directory
preflight scan /path/to/project
# Run with verbose output (shows which files matched each check)
preflight scan --verbose
preflight scan -v # short form
# Run in CI mode with JSON output
preflight scan --ci --format json
# Run only specific checks, or skip some, for fast iteration
# (one-off; unlike `preflight ignore` it doesn't change preflight.yml)
preflight scan --only seo_meta,og_twitter
preflight scan --skip vulnerability,secrets
# Silence a check
preflight ignore sitemap
# Unsilence a check
preflight unignore sitemap
# List all check IDs
preflight checks
Questo repository include una skill per agenti compatibile con skills.sh in skills/preflight/SKILL.md. Fornisce agli agenti di coding un flusso di lavoro Preflight ripetibile: ispezionare preflight.yml, eseguire scansioni sicure per la CI, analizzare i risultati, evitare esclusioni non sicure, rieseguire la validazione e segnalare il rischio residuo al lancio.
Elenca la skill da questo repository:
# With Bun
bunx --yes skills add preflightsh/preflight --list
# Or with npm
npx --yes skills add preflightsh/preflight --list
Installa solo la skill Preflight:
# With Bun
bunx --yes skills add preflightsh/preflight --skill preflight
# Or with npm
npx --yes skills add preflightsh/preflight --skill preflight
Preflight è completamente utilizzabile dalla riga di comando senza alcun account. La dashboard opzionale su app.preflight.sh aggiunge una cronologia ospitata delle tue scansioni e suggerimenti di correzione generati dall'AI per ogni problema rilevato. Il tuo codice non lascia mai la tua macchina: la scansione viene eseguita localmente e nulla viene inviato a meno che tu non pubblichi. I token bearer della dashboard sono limitati all'origine che li ha emessi e i reindirizzamenti autenticati non possono attraversare origini né effettuare il downgrade di HTTPS.
security_headers, ssl, www_redirect, email_auth, debug_statements, error_pages, image_optimization, legal_pages e i controlli sui file standard del web. debug_statements e image_optimization includono fino a cinque risultati (file e riga, oppure file e dimensione).seoMeta e i nomi dei file env vengono rimossi, così come le credenziali negli URL, le stringhe di query e i frammenti.secrets, vulnerability, env_parity, health_endpoint, stripe, index_now, ogni controllo dei servizi e qualsiasi errore "Check failed:".preflight.yml oscurato: nome del progetto, stack, origini degli URL, dichiarazioni dei servizi e quali controlli sono abilitati. La chiave IndexNow, l'URL del webhook Stripe, la allowlist dei segreti, i nomi dei file env, il percorso di health, il percorso del layout e la lista di esclusione vengono rimossi.I suggerimenti, il contenuto dei file, l'output degli strumenti di audit e i valori segreti non vengono mai inviati.
Crea un account gratuito, poi collega la CLI:
preflight auth login # opens your browser to authorize this CLI
preflight auth status # show who you're logged in as
preflight auth logout # remove stored credentials
Pubblica una scansione sulla tua dashboard con --publish. Stampa un link per visualizzare l'esecuzione. La pubblicazione è best-effort: se sei offline o non hai effettuato l'accesso, la scansione viene comunque eseguita e termina normalmente.
preflight scan --publish
Nella dashboard ottieni la suddivisione pass/warn/fail di ogni esecuzione, l'elenco degli esiti dei controlli e una cronologia per progetto che ti permette di vedere cosa è cambiato tra un deploy e l'altro.
Puoi anche consultare quella cronologia dal terminale con preflight history:
preflight history # recent runs across your projects
preflight history --here # only the current project's runs
preflight history <run-id> # one run's full check results
preflight history --here --format json # machine-readable, for agents
Richiede preflight auth login. --here associa le esecuzioni al repository corrente tramite il suo git remote, la stessa chiave usata durante la pubblicazione. Un'app scansionata da una sottodirectory del suo repository (un'app in un monorepo) è associata anch'essa a quella sottodirectory, quindi apps/web e apps/api pubblicano su progetti dashboard separati. history --format json contiene gli stessi campi schema_version e cli_version del JSON di scansione.
Su CI o su un'altra macchina senza browser, accedi con un token: preflight auth login --token - lo legge da stdin, oppure imposta PREFLIGHT_TOKEN ed esegui preflight auth login. In entrambi i casi il token viene verificato e memorizzato come un login da browser; i comandi successivi leggono le credenziali memorizzate, non la variabile.
Apri qualsiasi controllo fallito o con avviso su un'esecuzione pubblicata per generare una correzione passo-passo adattata allo stack rilevato, con comandi e codice pronti da copiare.
Scopri gli strumenti più utilizzati dalla nostra community.
Nessun dato di popolarità ancora.