siteUrl・EMDASH_SITE_URL・SITE_URLの優先順

Node.jsで起動したEmDashが公開URLをどこから読むか、確認用の環境ファイルで試します。

目次

EmDashが外部ツールに知らせるサイトのURLは、astro.config.mjs の siteUrl が最優先です。公開先ごとに値を切り替えたい場合は、この項目を省き、Node.jsの起動時に環境変数 EMDASH_SITE_URL を渡せます。

どの値が使われる?

サイトの「オリジン」は、https://example.com のように、通信方式とドメイン、必要に応じてポート番号までを書いたものです。ここでは、EmDashがMCPという外部ツール用の接続口を案内する場面で確かめます。

優先順指定する場所入れる値の例
1astro.config.mjs の emdash({...}) にある siteUrlhttps://fixed.example.test
2環境変数 EMDASH_SITE_URLhttps://preview.example.test
3環境変数 SITE_URLhttps://fallback.example.test
4いずれも未指定の場合は、AstroからEmDashへ渡されたリクエストのオリジンhttp://localhost:4491(今回のNode.js環境)

今回の教材では、4番の状態でブラウザー側から 127.0.0.1 を指定しても、EmDashの応答には localhost が出ました。公開用のドメインを返したい場合は、上位のいずれかで明示します。サイトマップや robots.txt は管理画面で登録したサイトURLも参照するため、そちらの表示と違うことがあります。

環境ファイルの値を試す

「週末ノート」の練習サイトを準備します。以下は教材のNode.js版で試す方法です。教材の astro.config.mjs では siteUrl を省いています。

  1. weekend-note の package.json と同じ場所に .env.origin-demo というファイルを作り、次の3行を保存します。2つのURLは結果を見分けるための練習用の値です。
PORT=4491
EMDASH_SITE_URL=https://preview.example.test
SITE_URL=https://fallback.example.test
  1. Macならターミナル、WindowsならPowerShellで weekend-note を開き、次の2行を順に実行します。1行目でサイトをビルドし、2行目で環境ファイルを読み込み、手元だけでサイトを起動します。
npm run build
node --env-file=.env.origin-demo scripts/start.mjs
  1. ブラウザーで http://127.0.0.1:4491/.well-known/oauth-protected-resource を開きます。resource の値が https://preview.example.test/_emdash/api/mcp なら、2つの環境変数のうち EMDASH_SITE_URL が使われています。この確認でログインや外部ツールの接続は不要です。

値を変えたら何をやり直す?

同じコマンド入力画面で Ctrl+C を押して停止します。.env.origin-demo から EMDASH_SITE_URL の行だけを消し、先ほどの起動コマンド(2行目)を再実行してください。先ほどと同じローカルURLを開き、resource の先頭が https://fallback.example.test に変われば、SITE_URL が使われています。確認後は Ctrl+C で終了できます。

結果が変わらないときは、astro.config.mjs の siteUrl と、起動に使うシェルですでに設定済みの環境変数を確認してください。Node.jsの --env-file では同じ名前の変数が起動前に設定済みなら、そちらの値が優先されます。ブラウザーに古い応答が残っているときは、プライベートウインドウでも確認できます。

astro.config.mjs の siteUrl を変更したときは、もう一度ビルドしてから起動します。画像最適化の許可先にもこのURLを使う構成では、ビルドする環境にも公開URLを渡します。今回の実行確認はローカルの接続案内までです。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。