リダイレクト
distribution のリダイレクトは設定の一部で、redirects の下に並ぶ順序付きのルールの一覧です。訪問者が受け取るのは 公開中の deployment のリダイレクト表です。変更は、それによって作られた deployment を promote したときに公開され、切り戻すと以前の表が戻ります。
ルールが多い場合は 他のホスティングからリダイレクトを移行する を参照してください。
ルールの形式
{
"redirects": [
{ "from": "/pricing-2025", "to": "/pricing" },
{ "from": "/blog/*", "to": "/news/:splat", "status": 301 },
{ "from": "/docs/*", "to": "https://docs.acme.example/:splat", "status": 302, "query": "drop" }
],
"redirect_hosts": ["docs.acme.example"]
}| フィールド | 必須 | 値 |
|---|---|---|
from | はい | / で始まるパス。クエリ文字列や #fragment は含めない。末尾を * にすると、そのプレフィックス以下すべてに一致する。 |
to | はい | / で始まるパス、または https:// の URL。:splat は * が一致した部分に置き換わる。 |
status | いいえ | 301(既定)、302、307、308 |
query | いいえ | preserve(既定)または drop |
redirect_hosts には、to が指してよい他のホストを列挙します(外部の転送先 を参照)。
リクエストの照合
- まず完全一致のルール:リクエストのパスを、
*を含まないすべてのfromと比べます。末尾のスラッシュ 1 つは無視するので、/about/はfrom: "/about"に一致します。 - 次にパターンを、書いた順に:末尾が
*のfromのうち、プレフィックスが最初に一致したものが使われます。/blog/*は/blog/2026/launch(:splatは2026/launch)にも、/blogそのもの(:splatは空)にも一致します。 - 一致しない場合:リクエストは通常どおり配信されます。
パスはパーセントエンコードした形で、エスケープを大文字にして比較します。/café、/caf%c3%a9、/caf%C3%A9 は同じルールで、Edge は /caf%C3%A9 として保存します。それ以外は大文字と小文字を区別します。
すべてのリクエストで、確認の順序は次のとおりです。
- 停止(suspend)された distribution は
403を返します。 - 公開停止 した distribution は
410またはそのリダイレクトを返します。 - リダイレクトルール。
- パスワード保護、次にサイトのファイル。
そのため、パスワード保護された distribution でもリダイレクトは動き、訪問者はリダイレクト先のページでサインインします。
ステータスコード
| ステータス | 意味 | ブラウザのキャッシュ |
|---|---|---|
301 | 恒久的な移動 | 期限なしでキャッシュ |
308 | 恒久的な移動。メソッドとボディを保つ | 期限なしでキャッシュ |
302 | Found(一時的) | キャッシュしない(Cache-Control: no-store) |
307 | 一時的。メソッドとボディを保つ | キャッシュしない(Cache-Control: no-store) |
301 や 308 を受け取った訪問者は、ルールを変更または削除したあとも、以前の転送先に直接向かい続けます。移行を確認しているあいだは 302 を使い、正しいとわかったら 301 に切り替えてください。
クエリ文字列
query: "preserve"(既定)では、訪問者のクエリ文字列が to に付きます。to にすでにクエリ文字列がある場合は & でつなぎます。
| ルール | リクエスト | Location |
|---|---|---|
/old → /new | /old?utm_source=mail | /new?utm_source=mail |
/campaign → /landing?ref=edge | /campaign?gclid=x1 | /landing?ref=edge&gclid=x1 |
/clean → /fresh、query: "drop" | /clean?a=1 | /fresh |
from がクエリ文字列で照合することはありません。
外部の転送先
https:// の URL である to は、次のいずれかを指す必要があります。
- distribution 自身のアドレス
{slug}.edge.deca-dev.com - distribution に割り当てられた独自ドメイン、またはワークスペースで検証済みの独自ドメイン
- distribution の
redirect_hostsにあるホスト(最大 20)
それ以外は拒否します。これにより、検証済みのドメイン上のリダイレクトが、自分の管理していないサイトに訪問者を送ることを防ぎます。http:// の転送先は拒否します。:splat はパス、クエリ、フラグメントに置けます。ホストには置けません。ユーザー名も含みます。
保存前に Edge が行うチェック
リダイレクト表は、distribution の更新、インポート、deployment のチェックのときに検査します。検査に通らない表は保存されず、すべての問題が一覧されます。
| チェック | 結果 |
|---|---|
| 直接または他のルールを経由して自分に戻るルール | 拒否: redirect loop: /a -> /b -> /a |
| 10 回のリダイレクト以内に終わらないチェーン | 拒否 |
(正規化後に)同じ from を持つふたつのルール | 拒否 |
| 許可されていない外部ホスト | 拒否 |
| 落ち着くまでに 2 回以上のリダイレクトが必要なルール | 警告のみ: /a takes 2 redirects to settle |
ルールの数と長さの上限は 制限 にあります。
インポート形式
edge_redirect_import(POST /v1/distributions/{id}/redirects/import、edge redirects import)は 3 つの形式を読みます。エラーは行ごとに報告します。
CSV:1 行目は from と to を含むヘッダーで、status と query の列は任意です。空行と # で始まる行は読み飛ばします。
from,to,status,query
/pricing-2025,/pricing,,
/blog/*,/news/:splat,301,
/docs/*,https://docs.acme.example/:splat,302,dropNetlify _redirects:1 行に 1 ルールで from to [status] です。ステータス末尾の ! は受け付けて無視します。Edge のルールは常にサイトのファイルより先に適用されるからです。
/pricing-2025 /pricing
/blog/* /news/:splat 301次の Netlify の機能には対応しておらず、その行のエラーとして報告します。ステータス 200 のリライト、404 のカスタムページ、* と :splat 以外のプレースホルダー(/news/:year など)、クエリ、国、言語、ロールの条件です。
JSON:ルールの配列、または {"redirects": [...]} です。format: "json" を指定したときに edge_redirect_export が書き出す形式です。
mode: "merge"(既定)は、from がすでにあるルールをその位置で更新し、新しいルールを末尾に追加します。mode: "replace" はインポートしたルールだけを残します。1 回のインポートで同じ from が 2 回現れた場合は、あとの行が使われます。