preflight — CLI-инструмент на базе Go, который сканирует кодовые базы на готовность к запуску, обнаруживая отсутствующую конфигурацию, проблемы гигиены безопасности, утечки секретов и пробелы интеграции перед развёртыванием в production. | Kitploit

Preflight.sh

Preflight.sh — это инструмент командной строки, который сканирует вашу кодовую базу на готовность к запуску. Выявляет отсутствующую конфигурацию, проблемы интеграции, угрозы безопасности, пробелы в SEO-метаданных и другие распространённые ошибки до того, как вы развернёте проект в продакшене.

Не позорьте себя в продакшене. Просто запустите команду.

Установка

Homebrew (macOS/Linux)

brew install preflightsh/preflight/preflight

npm

npm install -g @preflightsh/preflight

Go

go install github.com/preflightsh/preflight@latest

# Инициализация в каталоге вашего проекта
cd your-project
preflight init

# Запуск всех проверок
preflight scan

# Сканирование конкретного каталога
preflight scan /path/to/project

# Запуск с подробным выводом (показывает, какие файлы соответствуют каждой проверке)
preflight scan --verbose
preflight scan -v  # краткая форма

# Запуск в режиме CI с JSON-выводом
preflight scan --ci --format json

# Запуск только определённых проверок или пропуск некоторых для быстрой итерации
# (разово; в отличие от `preflight ignore` не изменяет preflight.yml)
preflight scan --only seo_meta,og_twitter
preflight scan --skip vulnerability,secrets

# Отключение проверки
preflight ignore sitemap

# Повторное включение проверки
preflight unignore sitemap

# Список всех ID проверок
preflight checks

preflight auth login    # открывает браузер для авторизации этого CLI
preflight auth status   # показывает, под каким пользователем вы вошли
preflight auth logout   # удаляет сохранённые учётные данные

preflight history                       # недавние запуски по всем вашим проектам
preflight history --here                # только запуски текущего проекта
preflight history <run-id>              # полные результаты проверок одного запуска
preflight history --here --format json  # машиночитаемый формат для агентов

Проверка	Описание
ENV Parity	Сравнивает `.env` и `.env.example` на предмет отсутствующих переменных
Health Endpoint	Проверяет доступность сайта; автоматически определяет `/health`, `/healthz`, `/api/health` или возвращается к корневому пути
Vulnerability Scan	Проверяет уязвимости зависимостей (bundle audit, npm audit и т. д.)
SEO Metadata	Проверяет наличие title, description и тегов Open Graph
OG & Twitter Cards	Проверяет og:image, twitter:card и метаданные для публикации в соцсетях
Canonical URL	Проверяет наличие тега canonical link
Viewport	Проверяет правильный метатег viewport для мобильных устройств
Lang Attribute	Проверяет атрибут html lang для доступности
Structured Data	Проверяет наличие разметки JSON-LD Schema.org
Security Headers	Проверяет HSTS, CSP, X-Content-Type-Options как на продакшене, так и на стейджинге
SSL Certificate	Проверяет действительность SSL и предупреждает до истечения срока
WWW Redirect	Проверяет редирект www/без-www на канонический URL
Email Auth	Проверяет DNS-записи SPF/DMARC для доставляемости почты (по желанию)
Secret Scanning	Находит утёкшие API-ключи и учётные данные в коде
Debug Statements	Обнаруживает console.log, var_dump, debugger, оставленные в коде
Error Pages	Проверяет наличие пользовательских страниц ошибок 404/500
Image Optimization	Находит большие изображения (>500KB), которые замедляют загрузку
Legal Pages	Проверяет наличие страниц политики конфиденциальности и условий обслуживания
Cookie Consent	Обнаруживает решение для согласия на cookie (соответствие GDPR/CCPA)

projectName: my-app
stack: rails  # rails, next, react, vite, laravel и т. д.

urls:
  staging: "https://staging.example.com"
  production: "https://example.com"

services:
  stripe:
    declared: true
  sentry:
    declared: true

checks:
  envParity:
    enabled: true
    envFile: ".env"
    exampleFile: ".env.example"

  healthEndpoint:
    enabled: true
    path: "/health"  # необязательно — автоматически определяет распространённые пути, если не задано

  stripeWebhook:
    enabled: true
    url: "https://api.example.com/webhooks/stripe"  # необязательно — проверяется GET-запросом; сообщается о 404 или отсутствии ответа

  seoMeta:
    enabled: true
    mainLayout: "app/views/layouts/application.html.erb"

  security:
    enabled: true

  secrets:
    enabled: true
    # Пофайловый список разрешений для сканирования секретов. Используйте его, чтобы
    # подавить отдельную находку (например, публичный ключ с ограничением по referrer),
    # не отключая всю проверку.
    allowlist:
      - path: web/js/golden-hour.js
        fingerprint: "sha256:<hex>"   # рекомендуется — привязывает к точному секрету
        reason: "Ключ Google Timezone с ограничением по HTTP-referrer"
      - path: "web/tools/**/*.php"    # поддерживаются glob-шаблоны doublestar

  indexNow:
    enabled: true
    key: "your32characterhexkeyhere00000"

  emailAuth:
    enabled: true  # по желанию, проверяет SPF/DMARC на продакшен-домене

  humansTxt:
    enabled: false  # по желанию, указывает команду

  license:
    enabled: false  # по желанию, для проектов с открытым исходным кодом

# Отключение конкретных проверок или сервисов по ID
ignore:
  - sitemap
  - llms_txt
  - google_analytics

preflight ignore sitemap        # Игнорировать проверку sitemap
preflight ignore sentry         # Игнорировать проверку сервиса Sentry
preflight unignore sitemap      # Повторно включить проверку sitemap
preflight checks                # Список всех игнорируемых ID

Старое	Новое
`seoMeta`	`seo_meta`
`ogTwitter`	`og_twitter`
`securityHeaders`	`security_headers`
`envParity`	`env_parity`
`healthEndpoint`	`health_endpoint`
`robotsTxt`	`robots_txt`
`llmsTxt`	`llms_txt`
`adsTxt`	`ads_txt`
`humansTxt`	`humans_txt`
`indexNow`	`index_now`

Код	Значение
0	Все проверки пройдены
1	Только предупреждения
2	Найдены ошибки
64	Preflight не смог выполниться (неверный путь, нечитаемая конфигурация, неизвестный ID проверки)
130	Сканирование отменено (Ctrl-C / SIGTERM)

# bash (добавьте в ~/.bashrc)
source <(preflight completion bash)

# zsh (добавьте в ~/.zshrc)
source <(preflight completion zsh)

# fish
preflight completion fish | source

preflight

Популярное

Docker

Shell-скрипт

Ручная загрузка

Быстрый старт

Навык агента (Agent Skill)

Панель управления и ИИ-подсказки

Что проверяется

Поддерживаемые сервисы (72)

Конфигурация

Игнорирование проверок и сервисов

Добавление в список разрешений отдельной находки секретов

Игнорируемые ID проверок

Переименованные ID проверок в 0.22

Примечание о сканировании кода, которому вы не доверяете

Игнорируемые ID сервисов

Коды выхода

Автодополнение в оболочке

Поддерживаемые стеки

Интеграция с CI

Лицензия