Go 기반 CLI 도구로, 프로덕션 배포 전에 코드베이스의 출시 준비 상태를 스캔하여 누락된 구성, 보안 위생 문제, 비밀 유출 및 통합 격차를 감지합니다.
Preflight.sh는 코드베이스의 출시 준비 상태를 스캔하는 명령줄 도구입니다. 프로덕션에 배포하기 전에 누락된 구성, 통합 문제, 보안 우려 사항, SEO 메타데이터 격차 및 기타 흔한 실수를 식별합니다.
프로덕션에서 창피를 당하지 마세요. 그냥 명령을 실행하세요.
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부터 각 아카이브에는 서명된 빌드 출처 정보가 포함됩니다. 다운로드한 파일이 이 저장소의 릴리스 워크플로에서 빌드되었는지 확인하려면:
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/preflight/SKILL.md에 skills.sh 호환 에이전트 스킬이 포함되어 있습니다. 이 스킬은 코딩 에이전트에게 반복 가능한 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의 선택적 대시보드는 스캔 기록을 호스팅하여 제공하고 각 발견 사항에 대한 AI 생성 수정 제안을 추가합니다. 코드는 절대 사용자의 컴퓨터를 떠나지 않습니다. 스캔은 로컬에서 실행되며, 게시하지 않는 한 아무것도 전송되지 않습니다. 대시보드 베어러 토큰은 이를 발급한 오리진으로 제한되며, 인증된 리다이렉트는 오리진을 넘거나 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 키, Stripe 웹훅 URL, 시크릿 허용 목록, 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은 스캔 JSON과 동일한 schema_version 및 cli_version 필드를 포함합니다.
브라우저가 없는 CI나 다른 머신에서는 대신 토큰으로 로그인하세요: preflight auth login --token -은 stdin에서 토큰을 읽으며, 또는 PREFLIGHT_TOKEN을 설정하고 preflight auth login을 실행하세요. 어느 방식이든 토큰은 브라우저 로그인과 동일하게 검증되고 저장되며, 이후 명령은 변수가 아닌 저장된 자격 증명을 읽습니다.
게시된 실행에서 실패했거나 경고가 발생한 검사를 열면, 감지된 스택에 맞춰 단계별 수정 방법을 생성하며, 복사해서 바로 쓸 수 있는 명령과 코드를 제공합니다.
| 검사 | 설명 |
|---|---|
| ENV 패리티 | .env와 .env.example을 비교하여 누락된 변수를 확인합니다(옵트인; preflight init이 활성화) |
| 헬스 엔드포인트 | 사이트에 접근 가능한지 확인합니다. /health, /healthz, /api/health, /_health, /status를 시도한 뒤 루트로 대체합니다 |
| 취약점 스캔 | 패키지 관리자의 감사 도구(bundle-audit, npm audit 등)로 의존성 취약점을 확인합니다 |
| SEO 메타데이터 | title, description, Open Graph 태그를 확인합니다 |
| OG & Twitter 카드 | og:image, twitter:card 및 소셜 공유 메타데이터를 검증합니다 |
| Canonical URL | canonical 링크 태그가 있는지 확인합니다 |
| 뷰포트 | 모바일용 뷰포트 메타 태그가 올바른지 확인합니다 |
| Lang 속성 | 접근성을 위한 html lang 속성을 검증합니다 |
| 구조화 데이터 | JSON-LD Schema.org 마크업을 확인합니다 |
| 보안 헤더 | 프로덕션과 스테이징 모두에서 HSTS, CSP, X-Content-Type-Options, Referrer-Policy를 검증합니다. 취약한 CSP(예: 'unsafe-inline' 스크립트)는 실패가 아닌 제안 사항입니다(옵트인; 프로덕션 URL을 제공하면 preflight init이 활성화) |
| SSL 인증서 | SSL 유효성을 확인하고 만료 전에 경고합니다. 로컬 URL은 건너뜁니다 |
| WWW 리디렉션 | www/비-www가 canonical URL로 리디렉션되는지 확인합니다 |
| 이메일 인증 | 이메일 발신 도메인의 SPF/DMARC 레코드를 확인하며, 설정되지 않은 경우 프로덕션 URL의 도메인을 사용합니다(옵트인) |
| 시크릿 스캔 | 코드에서 유출된 API 키와 자격 증명을 찾습니다(옵트인; preflight init이 활성화) |
| 디버그 문 | 코드에 남아 있는 console.log, var_dump, debugger를 감지합니다. 개발 가드 뒤에 있는 문(코드 내, 또는 Twig, ERB, Blade, Django, Go 템플릿 내, 같은 줄의 && 및 삼항 연산자 포함)은 보고되지 않습니다 |
| 오류 페이지 | 사용자 정의 404/500 오류 페이지를 확인합니다 |
| 이미지 최적화 | 로드 시간을 저하시키는 큰 이미지(>500KB)를 찾습니다 |
| 법적 페이지 | 배포된 사이트에서 개인정보 처리방침 및 서비스 약관 페이지를 확인하며, 호스트가 차단되었거나 다운된 경우 소스로 대체합니다 |
| 파비콘 & 아이콘 | favicon, apple-touch-icon(.png, .webp, .svg), 웹 매니페스트를 확인하며, 레이아웃 <link> 태그에 선언된 아이콘과 Next.js icons 메타데이터도 포함합니다. favicon 누락은 경고입니다 |
| robots.txt | robots.txt가 존재하고 내용이 있는지 확인합니다 |
| sitemap.xml | 사이트맵 파일 또는 생성기를 확인하며, Next.js Pages Router, Astro, SvelteKit 엔드포인트도 포함합니다 |
| llms.txt | LLM 크롤러 안내 파일을 확인합니다 |
| ads.txt | 광고 지원 사이트의 ads.txt를 검증합니다(옵트인) |
| humans.txt | 팀을 명시하는 humans.txt를 확인합니다(옵트인) |
| IndexNow | IndexNow 키 파일을 검증합니다. 사이트에 접근 가능한 경우 배포된 /{key}.txt가 판단 기준이 됩니다(옵트인) |
| LICENSE | 라이선스 파일을 확인합니다(오픈 소스 프로젝트용 옵트인) |
쿠키 동의 도구(CookieConsent, Cookiebot, OneTrust 등)는 자체 검사가 아니라 서비스로 검사됩니다.
Preflight는 다음 서비스에 대한 구성을 자동 감지하고 검증합니다:
결제
오류 추적 및 모니터링
이메일 및 뉴스레터