n8n Webhookがlocalhostになる：公開URLとproxyの版を合わせる
外部サービスへ登録するWebhookがlocalhostなら、公開URLの設定が実行プロセスへ届いているかを見ます。n8n 2.35.0以降の公式名はN8N_WEBHOOK_URLです。旧名WEBHOOK_URLは別名として残りますが、版を混ぜてコピーしません。
公式資料確認日：。
表示URLを直す設定と、外から到達する経路は別
公開URL設定はエディター表示や外部サービスへの登録先を合わせるためです。DNS、TLS、proxyの転送、認証が実際に通ることまで作る設定ではありません。管理画面全体を公開する必要があるとも判断しません。
使っている版と、起動方法を先に記録する
2.35.0以降はN8N_WEBHOOK_URL、WEBHOOK_URLは非推奨の別名という現行公式仕様です。旧版で新名が読まれることは推定しません。端末で設定した値と、Dockerやサービス管理経由のプロセスが読んだ値は別に確かめます。
| 観測するもの | 分かること | 次の行動 |
|---|---|---|
| n8nの実行版 | 有効な変数名 | 対象版の公式設定を選ぶ |
| 表示・登録する公開URL | 外部へ渡す入口 | host・scheme・pathを照合 |
| proxyの段数と転送 | 実際の要求経路 | 転送ヘッダーと信頼範囲を照合 |
| 受付と保存結果 | 業務処理が終わったか | HTTP応答だけで完了にしない |
proxy一段の公式例を、多段へそのまま使わない
公式例はN8N_PROXY_HOPS=1と、最後のproxyでX-Forwarded-For・Host・Protoを渡す構成です。CDN等が入るなら実際の段数とヘッダーの信頼範囲を別に照合します。数字だけを増やして接続できれば合格にはしません。
localhostを直しても、試験用URLの問題は残る
URLのhostが正しくなった後は、test／productionの違いとワークフローの公開状態を見ます。少数の許可された非機密入力で到達・受付・成果を追います。認証やTLS検証を無効にして到達させる手順は選びません。
ホスティング購入は、公開受付の要件が決まってから
自分だけの管理用通信なら、公開Webhookが必要ない場合もあります。第三者から継続受付する必要と、今の経路の障害を分けます。VPSへ移してもURL・proxy・認証の照合は残ります。
公式資料と、判断例の境界
仕様の根拠は以下の公式資料です。本文の記入例は実測値ではありません。購入・設定変更時は、対象の型番・版・契約条件を照合します。
- n8n：reverse proxy経由のWebhook URL
外向けURLと転送ヘッダーを設定。公式例のN8N_PROXY_HOPS=1を多段構成へ無条件でコピーしません。
- n8n：Endpoints設定と版の違い
2.35.0からN8N_WEBHOOK_URLが推奨。WEBHOOK_URLは動作する別名ですが非推奨の警告が出ます。旧版へ新名の対応を推定しません。