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 には最大 5 件の検出項目(ファイルと行、またはファイルとサイズ)が含まれます。seoMeta レイアウトパス、env ファイル名は削除され、URL の認証情報、クエリ文字列、フラグメントも同様に削除されます。secrets、vulnerability、env_parity、health_endpoint、stripe、index_now、すべてのサービスチェック、および任意の「Check failed:」エラー。preflight.yml:プロジェクト名、スタック、URL オリジン、サービス宣言、および有効になっているチェック。IndexNow キー、Stripe webhook 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
ダッシュボードでは、各実行のpass/warn/failの内訳、チェック結果の一覧、プロジェクトごとの履歴を確認できるため、デプロイ間で何が変わったかを把握できます。
この履歴はターミナルから 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 リモートに基づいて実行を現在のリポジトリに照合します。これは公開時と同じキーです。リポジトリのサブディレクトリからスキャンされたアプリ(モノレポ内の 1 つのアプリ)もそのサブディレクトリでキー付けされるため、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 リンクタグが存在するか検証します |
| ビューポート | モバイル向けの適切な viewport メタタグをチェックします |
| Lang 属性 | アクセシビリティのための html lang 属性を検証します |
| 構造化データ | JSON-LD Schema.org マークアップをチェックします |
| セキュリティヘッダー | prod と staging の両方で HSTS、CSP、X-Content-Type-Options、Referrer-Policy を検証します。弱い CSP('unsafe-inline' スクリプトなど)は失敗ではなく提案となります(オプトイン。本番 URL を指定すると preflight init で有効になります) |
| SSL 証明書 | SSL の有効性をチェックし、期限切れ前に警告します。ローカル URL ではスキップされます |
| WWW リダイレクト | www/非 www が canonical URL にリダイレクトされるか検証します |
| メール認証 | メール送信ドメイン、または未設定の場合は本番 URL のドメインについて SPF/DMARC レコードをチェックします(オプトイン) |
| シークレットスキャン | コード内に漏洩した API キーや認証情報を検出します(オプトイン。preflight init で有効になります) |
| デバッグステートメント | コードに残った console.log、var_dump、debugger を検出します。開発用ガードの背後にあるステートメント(コード内、または Twig、ERB、Blade、Django、Go テンプレート内で、同一行の && や三項演算子を含む)は報告されません |
| エラーページ | カスタムの 404/500 エラーページをチェックします |
| 画像最適化 | 読み込み時間を損なう大きな画像(>500KB)を検出します |
| 法的ページ | デプロイされたサイト上のプライバシーポリシーと利用規約ページをチェックし、ホストがブロックされているかダウンしている場合はソースにフォールバックします |
| Favicon & アイコン | favicon、apple-touch-icon(.png、.webp、.svg)、web マニフェストをチェックします。レイアウトの <link> タグで宣言されたアイコンや Next.js の icons メタデータも含みます。favicon の欠落は警告です |
| robots.txt | robots.txt が存在し、内容があるか検証します |
| sitemap.xml | sitemap ファイルまたはジェネレーターをチェックします。Next.js Pages Router、Astro、SvelteKit のエンドポイントも含みます |
| llms.txt | LLM クローラー向けガイダンスファイルをチェックします |
| ads.txt | 広告収益サイト向けに ads.txt を検証します(オプトイン) |
| humans.txt | チームをクレジットする humans.txt をチェックします(オプトイン) |
| IndexNow | IndexNow キーファイルを検証します。サイトに到達可能な場合は、デプロイされた /{key}.txt が判定します(オプトイン) |
| LICENSE | ライセンスファイルをチェックします(オープンソースプロジェクト向けのオプトイン) |
Cookie 同意ツール(CookieConsent、Cookiebot、OneTrust など)は、独自のチェックとしてではなく、サービスとしてチェックされます。
Preflight は、以下のサービスの設定を自動検出して検証します:
決済
エラートラッキングとモニタリング
メールとニュースレター