リバースプロキシと HTTPS
ポート 3000 の前段に nginx か Caddy を置き、セルフホスティングの Nodaro を自分のドメインで HTTPS 配信します。そのあと PUBLIC_URL と CORS_ORIGIN を設定して、アプリを再起動します。
リバースプロキシを使うと、セルフホスティングの Nodaro を、実際のドメインで HTTPS で公開できます。Nodaro のコンテナはポート 3000 ですでに Web サーバー(Caddy)を動かしているため、そのポートの前段に TLS を終端するプロキシを 1 つ追加し、Nodaro に公開アドレスを伝えるだけです。nginx と Caddy のどちらも使えます。
ポート 3000 で提供されるもの
コンテナ内の Web サーバーは、すべてを 1 つのオリジンで提供します。
| パス | 応答するもの |
|---|---|
/ | エディターとアプリ(静的ファイル) |
/v1/* | API(コンテナ内のポート 9000 で待ち受けます) |
/health | コンテナのヘルスチェック用のアドレスで、API が応答します |
/storage/* | 同梱の MinIO にあるメディア |
/supabase/* | 同梱のログイン機能とデータ API |
/config.js | アプリの起動前にブラウザーが読み込む、実行時の設定 |
プロキシは、すべてのリクエストをポート 3000 に転送するだけでかまいません。
ヘルスチェック用のアドレス
ポート 3000 の GET /health は、コンテナのヘルスチェック用のアドレスです。応答するのは API で、アプリのページが返ることはありません。
| API の状態 | /health の応答 |
|---|---|
| 稼働中 | 200 で {"status":"healthy","timestamp":…,"version":…} |
| 停止中または再起動中 | 502。API は、終了してから 10 秒後にコンテナ内で再起動します。 |
| 応答なし:接続は受け付けるが応答しない | 5 秒後に 504 |
末尾のスラッシュ、大文字と小文字の違い、そのほかのアドレスの表記でも、同じ状態が返ります。/health/x のような下位のパスはこのアドレスではなく、healthy にはなりません。すべての応答に Cache-Control: no-store が付くので、環境の前にあるキャッシュが「healthy」を保持することはありません。API の準備ができるまで、ポート 3000 は何も応答しません。マイグレーションの実行中と、その後 Web サーバーが API を待つ最大 30 秒間です。
同梱の compose ファイルのヘルスチェックは、このアドレスを読み取ります。nodaro コンテナは、API が最初に応答した時点で healthy になり、5 回続けて読み取りに失敗すると unhealthy になります。Docker は、unhealthy であることを理由にコンテナを再起動しません。ほかのヘルスチェックや稼働監視も、それぞれ独自のタイムアウトを付けて、このアドレスに向けてください。
デプロイのヘルスチェックは、ポート 3000 を読み取る必要があります。ホスティングプラットフォームの中には、Railway のように、PORT でコンテナに渡したポートを調べるものがあります。イメージは PORT の値にかかわらず 3000 で待ち受けるため、そのままではデプロイのたびにチェックに失敗し、以前のデプロイが提供を続けます。そうしたプラットフォームでは、サービスの変数 PORT=3000 を設定してください。イメージのほかの部分は変わりません。API は引き続き Web サーバーの後ろの 9000 で待ち受けます。
方法 A:nginx
nginx やほかのプロキシをすでに運用している場合は、この方法を使います。
server {
listen 443 ssl http2;
server_name nodaro.example.com;
ssl_certificate /etc/letsencrypt/live/nodaro.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/nodaro.example.com/privkey.pem;
client_max_body_size 100M;
proxy_buffering off; # important for SSE
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}client_max_body_size 100Mで、アップロードを通せるようにします。proxy_buffering offで、Server-Sent Events が途切れずに流れるようにします。Nodaro は、テキストの出力と実行の進行状況を Server-Sent Events でストリーミングします。
方法 B:ホスト上の Caddy
Caddy は、Let's Encrypt の証明書を自動で取得します。
nodaro.example.com {
reverse_proxy 127.0.0.1:3000 {
flush_interval -1
}
}ポート 80 と 443 を開放し、ドメインの A レコードまたは AAAA レコードをホストに向けます。flush_interval -1 で、Server-Sent Events が途切れずに流れるようにします。
Nodaro に公開アドレスを伝える
どちらの方法でも、そのあと .env に次の値を設定します。
PUBLIC_URL=https://nodaro.example.com
CORS_ORIGIN=https://nodaro.example.com
# On the bundled MinIO, serve the media from the same domain:
R2_PUBLIC_URL=https://nodaro.example.com/storage/nodaro-assets次に、設定を反映します。
docker compose -f docker-compose.community.yml up -d再ビルドは必要ありません。コンテナは起動時に、公開 URL、ブラウザー用のログインアドレス、anon キーを /config.js に書き込みます。ブラウザーは、アプリの起動前にこのファイルを読み込みます。
PUBLIC_URL は、あらゆる場所で使われる環境のアドレスです。ログインと OAuth のコールバック、メディアの URL、CORS のチェックで使われます。http://localhost:3000 と PUBLIC_URL は、ブラウザーのオリジンとして常に許可されます。
複数のホスト名で配信する
- 追加のオリジン:
CORS_ORIGINに、カンマ区切りで列挙します。たとえばCORS_ORIGIN=https://nodaro.example.com,http://192.168.1.20:3000のように設定します。 - 訪問者のホスト名でのストリーム:デフォルトのコンテナのように API がアプリと同じオリジンにある場合は、
PUBLIC_URL_SAME_ORIGIN=trueを設定します。すると/config.jsは、API のアドレスとしてPUBLIC_URLではなく/をブラウザーに渡すため、ストリームは訪問者が開いたホスト名にとどまります。有効になるのは、値がちょうどtrueの場合だけです。API が実際に別のホストにある場合は、設定しないでください。
Compose ファイルは、.env の PUBLIC_URL_SAME_ORIGIN をコンテナに渡しません。nodaro サービスの environment: に追加してください。設定を参照してください。
アプリのページを専用のホスト名に移す
環境が 2 つ目のホスト名でも、アプリのページに応答するようにできます。元のホスト名には、API、ログインと OAuth、公開したアプリ、埋め込み、共有したプレゼンが残ります。どちらのホスト名も、同じサービスを指します。FLOW_UI_ORIGIN が新しいホスト名を示し、PUBLIC_URL は残すホスト名の https オリジンです。これは 2 段階で動きます。
# Step 1, the pages' own hostname: every hostname keeps serving every page.
FLOW_UI_ORIGIN=https://flow.example.com
# Step 2, the move: the hostnames listed here send the app's pages to it.
LEGACY_UI_HOSTS=app.example.comFLOW_UI_ORIGIN だけの場合、ページには専用のホスト名ができますが、何も移りません。
- リダイレクトはありません:どのホスト名も、すべてのページを引き続き提供します。Nodaro が書き出すリンク、人に渡すアドレス、ページが呼び出す API は、変わりません。
- ブラウザーに保存された設定は、新しいホスト名に初めてアクセスしたときに 1 回だけコピーされます。
- 公開ページごとに正規の置き場所が 1 つ:検索エンジンがインデックスしてよい各ページは、それを提供するどのホスト名でも、正規リンクで置き場所を示します。ホーム画面、
/gallery、/tutorials/...はFLOW_UI_ORIGINを示します。/login、/signup、公開したアプリ(/app/...)はPUBLIC_URLを示します。 - 起動ログには、新しいホスト名と、そこへリダイレクトするホスト名がないことが示されます。
LEGACY_UI_HOSTSのつづりの誤りも、ここでわかります。
LEGACY_UI_HOSTS も設定すると、移動が有効になります。
- 移るもの:
LEGACY_UI_HOSTSにあるホスト名でアプリのページを開くと、FLOW_UI_ORIGIN上の同じパスとクエリにリダイレクトされます。移るページには、ホーム画面、エディター、プロジェクト、設定、ギャラリー、ライブラリー、アプリ、テンプレートなどがあります。複数のホスト名は、カンマかスペースで区切って列挙します。大文字と小文字は区別されません。 - 残るもの:API、OAuth とログイン、公開したアプリ(
/app/...)、埋め込み、共有したプレゼン、すべてのファイル、不明なパスは、リダイレクトされません。フレーム内で読み込まれたページも、リダイレクトされません。 - 公開ページの置き場所は 1 つ:新しいホスト名で
/app/...、/embed/...、/present/...を開くと、PUBLIC_URLに送り返されます。 - リンク:Nodaro が書き出すアプリのページへのリンクは、新しいホスト名を指します。API、OAuth の発行者、人に渡すアドレスは
PUBLIC_URLのままです。対象は、公開したアプリ、埋め込み、共有したプレゼン、Webhook の URL、設定ページにある API の例です。 - リダイレクトのステータス:デフォルトは
302で、キャッシュされません。LEGACY_UI_REDIRECT_STATUS=301にすると301を返し、ブラウザーはそれを 1 時間保持します。 - 正規リンクは、手順 1 と同じままです。
両方の手順に共通:
- SNS アカウント:どちらのホスト名から接続した SNS アカウントも、接続を始めたページに結果を伝えます。接続のポップアップは
PUBLIC_URLで終わり、そのページが両方のホスト名に結果を送ります。各ホスト名は、自分のページでだけ結果を受け取ります。 - ブラウザーに保存された設定:新しいホスト名に初めてアクセスしたときに、ブラウザーに保存された設定が、元のホスト名から 1 回だけコピーされます。書き込まれるのは、新しいホスト名にまだない設定だけで、ログインのセッションは書き込まれません。あとで元のホスト名で変えた設定は、元のホスト名に残ります。2 つのホスト名は、
app.example.comとflow.example.comのように同じサイトにある必要があります。サイトが異なると、コピーするものが見つかりません。 - 厳密なチェック:
FLOW_UI_ORIGINとPUBLIC_URLは、パスもポートもない、互いに異なる 2 つの https オリジンです。設定が無効な場合、API は起動を拒否し、その設定の名前を示します。FLOW_UI_ORIGINなしでLEGACY_UI_HOSTSを設定した場合や、値が https オリジンでない場合です。LEGACY_UI_HOSTSに新しいホスト名しかない場合や、ホスト名だけではないエントリーがある場合も同じです。 - ほかのホスト名:どちらの設定にもないホスト名は、影響を受けません。
FLOW_PUBLIC_URL は FLOW_UI_ORIGIN の別名です。Compose ファイルはこれらの変数を .env からコンテナに渡さないため、nodaro サービスの environment: に追加して再起動してください。再ビルドは必要ありません。
ポートを変更する
アプリを別のホストポートで配信するには、docker-compose.community.yml で、ポートマッピングのホスト側を変更します(たとえば "3001:3000")。そのあと、PUBLIC_URL もそれに合わせて、http://localhost:3001 のように設定します。
クライアントのアドレスの記録方法
コンテナ内の Web サーバーは、プライベートアドレスにあるプロキシからの X-Forwarded-* ヘッダーだけを受け入れます。対象のアドレスは、127.0.0.1/8、10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、fd00::/8、::1 です。
- 信頼できるプロキシからのリクエストでは、
X-Forwarded-Forを 1 つのクライアントアドレスに絞り込みます。使われるのは、それ自体は信頼できるプロキシではない、最も右のエントリーです。クライアントがヘッダーに書き込んだアドレスはスキップされます。 - パブリックアドレスにあるプロキシからのリクエストでは、これらのヘッダーを、Web サーバー自身が観測した値に置き換えます。
イントラネットでは、ユーザー自身のアドレスもプライベートアドレスの場合、同じルールによって、そのアドレスもスキップされます。その場合、LAN 上のクライアントは、レート制限などのために API が記録するアドレスを、自分で選べてしまいます。
自分のドメインでの埋め込みエディター
NodarCut で編集、またはアプリの動画の結果の編集は、freecut.nodaro.ai にあるホスティング版の動画エディターを開きます。このエディターは、http://localhost:3000 からの埋め込みしか許可していません。ドメインや LAN のアドレスなど、それ以外のオリジンではブラウザーが埋め込みを拒否し、パネルにその理由が表示されます。配信している URL を添えて GitHub でイシューを作成するか、自分でエディターを運用して FREECUT_URL を設定してください。設定を参照してください。
MCP には専用のホスト名が必要
MCP クライアントは、ポート 9000 の API に直接アクセスする必要があります。ポート 3000 の Web サーバーは、MCP のリクエストを拒否します。MCP を参照してください。
同じホストでほかのアプリを提供する
コンテナー内の Web サーバーは、/etc/caddy/sites.d/ にあるすべての *.caddy ファイルも、1 つのサイトの一部として読み込みます。同じホストでエディターと並べて別の Web アプリを提供するには、Nodaro のイメージをもとにイメージをビルドし、そのアプリのルートをこのディレクトリーに追加します。組み込みの設定は編集しません。
FROM ghcr.io/nodaroai/nodaro-community:latest
COPY --from=<other app's build> /dist /srv/other-app
COPY other-app.caddy /etc/caddy/sites.d/other-app.caddy# /etc/caddy/sites.d/other-app.caddy
@other_app path /other /other/*
handle @other_app {
root * /srv/other-app
encode zstd gzip
try_files {path} /index.html
file_server
}- サイトではなくディレクティブ:ファイルに書くのは、
handleやredirなど、既存のサイトのディレクティブです。独自のサイトブロックは書きません。Caddy はhandleブロックをパスの順に並べるので、このディレクトリーのルートは、エディター自身のキャッチオールのルートより先に応答します。 - 重ならないパス:エディターのパスは避けてください。
/v1/*、/supabase/*、/storage/*、/.well-known/*、/config.js、/assets/*と、エディター自身のページです。各アプリのファイルも、それぞれのパスの下に置きます。 - 完全一致:パスは、
/other /other/*のように、完全一致と/*の両方で指定します。/other*のような接頭辞だけの指定では、/other-thingまで対象になります。 - ファイルがない状態が既定です:このディレクトリーは、なくてもかまいません。ない場合、サイトは変わらず、Caddy は起動時に、想定どおりの警告
No files matching import glob patternを 1 回記録します。 - デプロイの前にファイルを確認する:Caddy が解析できないファイルがあると Caddy が起動せず、ポート
3000では何も応答しなくなります。レイヤーを重ねたイメージは、caddy validate --config /etc/caddy/Caddyfile --adapter caddyfileで確認してください。
ログイン後、このようなアプリのパスはページ全体を読み込むので、エディターではなくそのアプリが応答します。シングルサインオンを参照してください。
よくある質問
Nodaro のコンテナには、Web サーバーがすでに含まれていますか?
はい。コンテナは、ポート 3000 で Caddy を動かしています。Caddy はエディターを配信し、/v1 をポート 9000 の API に転送し、メディアと同梱のログイン機能を同じオリジンで提供します。HTTPS にするには、TLS を終端するプロキシをポート 3000 の前段に置いてください。
Nodaro を自分のドメインで公開したあと、何を変更する必要がありますか?
PUBLIC_URL と CORS_ORIGIN を https のアドレスに設定します。同梱の MinIO を使う場合は、R2_PUBLIC_URL を https://your-domain/storage/nodaro-assets に設定します。そのあと docker compose up -d を実行します。再ビルドは必要ありません。
nginx のプロキシで、ストリーミング出力が機能しないのはなぜですか?
nginx はデフォルトでレスポンスをバッファリングするため、Server-Sent Events が滞ります。proxy_buffering off を設定してください。ホスト上の Caddy を使う場合は、reverse_proxy ブロックに flush_interval -1 を設定します。
Nodaro は、複数のホスト名で応答できますか?
はい。追加のオリジンを、カンマ区切りで CORS_ORIGIN に列挙します。デフォルトのコンテナのように API がアプリと同じオリジンにある場合は、PUBLIC_URL_SAME_ORIGIN=true も設定してください。これで、ストリームは訪問者が使っているホスト名にとどまります。
関連ページ
インストール
設定
セルフホスティング環境での MCP
トラブルシューティング
最終更新