Skip to content

リダイレクト ​

distribution のリダイレクトは設定の一部で、redirects の下に並ぶ順序付きのルールの一覧です。訪問者が受け取るのは 公開中の deployment のリダイレクト表です。変更は、それによって作られた deployment を promote したときに公開され、切り戻すと以前の表が戻ります。

ルールが多い場合は 他のホスティングからリダイレクトを移行する を参照してください。

ルールの形式 ​

json
{
  "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 が指してよい他のホストを列挙します(外部の転送先 を参照)。

リクエストの照合 ​

  1. まず完全一致のルール:リクエストのパスを、* を含まないすべての from と比べます。末尾のスラッシュ 1 つは無視するので、/about/ は from: "/about" に一致します。
  2. 次にパターンを、書いた順に:末尾が * の from のうち、プレフィックスが最初に一致したものが使われます。/blog/* は /blog/2026/launch(:splat は 2026/launch)にも、/blog そのもの(:splat は空)にも一致します。
  3. 一致しない場合:リクエストは通常どおり配信されます。

パスはパーセントエンコードした形で、エスケープを大文字にして比較します。/café、/caf%c3%a9、/caf%C3%A9 は同じルールで、Edge は /caf%C3%A9 として保存します。それ以外は大文字と小文字を区別します。

すべてのリクエストで、確認の順序は次のとおりです。

  1. 停止(suspend)された distribution は 403 を返します。
  2. 公開停止 した distribution は 410 またはそのリダイレクトを返します。
  3. リダイレクトルール。
  4. パスワード保護、次にサイトのファイル。

そのため、パスワード保護された distribution でもリダイレクトは動き、訪問者はリダイレクト先のページでサインインします。

ステータスコード ​

ステータス意味ブラウザのキャッシュ
301恒久的な移動期限なしでキャッシュ
308恒久的な移動。メソッドとボディを保つ期限なしでキャッシュ
302Found(一時的)キャッシュしない(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 の列は任意です。空行と # で始まる行は読み飛ばします。

csv
from,to,status,query
/pricing-2025,/pricing,,
/blog/*,/news/:splat,301,
/docs/*,https://docs.acme.example/:splat,302,drop

Netlify _redirects:1 行に 1 ルールで from to [status] です。ステータス末尾の ! は受け付けて無視します。Edge のルールは常にサイトのファイルより先に適用されるからです。

text
/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 回現れた場合は、あとの行が使われます。

あわせて読む ​