
CLI-инструмент на базе Go, который сканирует кодовые базы на готовность к запуску, обнаруживая отсутствующую конфигурацию, проблемы гигиены безопасности, утечки секретов и пробелы интеграции перед развёртыванием в production.
Preflight.sh — это инструмент командной строки, который сканирует вашу кодовую базу на готовность к запуску. Выявляет отсутствующую конфигурацию, проблемы интеграции, проблемы безопасности, пробелы в SEO-метаданных и другие распространённые ошибки до развёртывания в production.
Не позорьтесь в production. Просто запустите команду.
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
Скачайте последний релиз со страницы GitHub Releases.
Начиная с v0.23.0 каждый архив содержит подписанные сведения о происхождении сборки. Чтобы проверить, что загруженный файл был собран в рамках workflow релиза этого репозитория:
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
Этот репозиторий включает совместимый со skills.sh навык агента по пути skills/preflight/SKILL.md. Он даёт агентам для программирования воспроизводимый рабочий процесс Preflight: проверить preflight.yml, запустить безопасные для CI сканирования, отсортировать находки, избегать небезопасных игнорирований, повторно запустить валидацию и сообщить об остаточном риске запуска.
Вывести список навыка из этого репозитория:
# With Bun
bunx --yes skills add preflightsh/preflight --list
# Or with npm
npx --yes skills add preflightsh/preflight --list
Установите только навык Preflight:
# With Bun
bunx --yes skills add preflightsh/preflight --skill preflight
# Or with npm
npx --yes skills add preflightsh/preflight --skill preflight
Preflight полностью доступен из командной строки без учётной записи. Необязательная панель управления на app.preflight.sh добавляет размещённую историю ваших сканирований и сгенерированные ИИ рекомендации по исправлению для каждой находки. Ваш код никогда не покидает вашу машину: сканирование выполняется локально, и ничего не отправляется, пока вы не опубликуете. Токены доступа панели управления ограничены источником, который их выдал, а аутентифицированные перенаправления не могут пересекать источники или понижать HTTPS.
security_headers, ssl, www_redirect, email_auth, debug_statements, error_pages, image_optimization, legal_pages и проверки файлов веб-стандартов. debug_statements и image_optimization включают до пяти находок (файл и строка или файл и размер).seoMeta и имена env-файлов удаляются, как и учётные данные в URL, строки запросов и фрагменты.secrets, vulnerability, env_parity, health_endpoint, stripe, index_now, все проверки сервисов и любая ошибка "Check failed:".preflight.yml: имя проекта, стек, источники URL, объявления сервисов и какие проверки включены. Ключ IndexNow, URL вебхука Stripe, список разрешённых секретов, имена env-файлов, путь проверки работоспособности, путь к макету и список игнорирования удаляются.Предложения, содержимое файлов, вывод инструментов аудита и секретные значения никогда не отправляются.
Создайте бесплатную учётную запись, затем подключите 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
Опубликуйте сканирование на своей панели управления с помощью --publish. Будет выведена ссылка для просмотра запуска. Публикация выполняется по мере возможности: если вы не в сети или не вошли в систему, сканирование всё равно выполнится и завершится нормально.
preflight scan --publish
На панели управления вы получаете разбивку результатов каждого запуска по категориям «пройдено/предупреждение/ошибка», список результатов проверок и историю по каждому проекту, чтобы видеть, что изменилось между развёртываниями.
Эту историю также можно просмотреть из терминала с помощью 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
Требуется preflight auth login. --here сопоставляет запуски с текущим репозиторием по его git remote — тот же ключ, который используется при публикации. Приложение, просканированное из подкаталога своего репозитория (одно приложение в монорепозитории), также привязывается к этому подкаталогу, поэтому apps/web и apps/api публикуются в отдельные проекты дашборда. history --format json содержит те же поля schema_version и cli_version, что и JSON сканирования.
В CI или на другой машине без браузера войдите с помощью токена: preflight auth login --token - читает его из stdin, либо задайте PREFLIGHT_TOKEN и выполните preflight auth login. В любом случае токен проверяется и сохраняется так же, как при входе через браузер; последующие команды читают сохранённые учётные данные, а не переменную.
Откройте любую неудачную проверку или проверку с предупреждением в опубликованном запуске, чтобы сгенерировать пошаговое исправление, адаптированное к обнаруженному стеку, с готовыми к копированию командами и кодом.