メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

このガイドでは、以下のWebサーバーレベルの設定について説明します:

レスポンスヘッダーを追加する

カスタムレスポンスヘッダーを使用すると、特定のパスに一致するリクエストにHTTPヘッダーの指示を追加できます。 レスポンスヘッダーは、要求されたコンテンツとどのようにやり取りするかをブラウザに指示する名前と値のペアです。 例えば、Access-Control-Allow-Origin ヘッダーを指定して、そのページでブラウザがアクセスできるドメインを指定できます。 このエントリを作成するには、Replit Appのルートディレクトリにある .replit ファイルに以下を追加します:
[[deployment.responseHeaders]]
path = "/*"
name = "Access-Control-Allow-Origin"
value = "origin"
このレスポンスヘッダーには以下のパラメーターが含まれます:
  • path: 要求されたリソースに一致するURLパスパターン
  • name: HTTPヘッダー名
  • value: HTTPヘッダーの値
.replit ファイルには複数の deployment.responseHeaders エントリを追加できます。 設定の更新を適用するには、Replit Appを再パブリッシュしてください。

予約済みヘッダー

Replitは以下のHTTPヘッダーを予約しており、設定することはできません。
Accept-Ranges
Age
Allow
Alt-Svc
Connection
Content-Encoding
Content-Length
Content-Range
Date
Location
Server
Set-Cookie
Trailer
Transfer-Encoding
Upgrade
HTTPヘッダーの詳細については、MDN WebドキュメントのHTTPヘッダーをご覧ください。

カスタム404ページを作成する

カスタム404ページは、ユーザーがパブリッシュ済みアプリ内のファイルやルールに一致しないURLパスを要求したときに表示されます。 カスタム404ページを追加するには、Replit Appのルートディレクトリに 404.html という名前のファイルにページコンテンツを作成します。 ユーザーが存在しないURLパスにアクセスしようとすると、カスタム404ページのレンダリングされたHTMLが表示されます。

URLパスのリライトを定義する

URLリライトを定義すると、Replit Appが処理する前にリクエストのURLパスを変更できます。 元のURLはブラウザに表示されたままですが、サーバーはリライトルールで定義されたリソースを読み込みます。 例えば、/app で始まるすべてのリクエストが /app/index.html ファイルの内容を読み込むように指定できます。 このエントリを作成するには、Replit Appのルートディレクトリにある .replit ファイルに以下を追加します:
[[deployment.rewrites]]
from = "/app/*"
to = "/app/index.html"
  • from: 要求されたリソースに一致するURLパスパターン
  • to: リライト後のパス。Static Deployment内のファイルに対応します。
.replit ファイルには複数の deployment.rewrites エントリを追加できます。 サーバーはエントリをリストの順序で解釈し、重複は無視します。 設定の更新を適用するには、Replit Appを再パブリッシュする必要があります。 以下のセクションでは、URLリライトルールの制約について説明します。

パスマッチング

リライトルールの from および to パラメーターには以下の制約が適用されます:
  • * がない場合、マッチングは完全一致である必要があります
  • * はパスの残り部分にマッチします
  • * はパスの末尾でのみ有効です
  • from パラメーターに * を含める場合、to パラメーターにも含めることでマッチしたパスの部分を表すことができます
例えば、.replit ファイルに以下のリライトが含まれている場合:
[[deployment.rewrites]]
from = "/v1/*"
to = "/v2/*"
ユーザーが /v1/about-us.html にアクセスすると、リライトにより /v2/about-us.html にあるファイルが配信されます。

シャドウイング

シャドウイングは、リライトがStatic Deployment内のファイルにも一致するURLパスとマッチした場合に発生します。 この場合、クラウドサーバーはリライトを無視してファイルを直接配信します。 例えば、パブリッシュ済みアプリに以下のファイルが含まれているとします:
  • index.html
  • about.html
.replit ファイルに以下のリライトが含まれている場合:
[[deployment.rewrites]]
from = "/*"
to = "/index.html"
ユーザーが /register.html にアクセスすると、サーバーはリクエストを /index.html にリライトしてそのファイルを配信します。 ただし、ユーザーが /about.html にアクセスした場合、サーバーはリライトを無視し、Static Deploymentに存在するため about.html ファイルを配信します。

ドメインの制限

リライトはStatic Deploymentのプライマリドメインへのリクエストにのみ機能し、 Static Deployment内のファイルにのみリダイレクトできます。