NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較

リバースプロキシと 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.com

FLOW_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 も設定してください。これで、ストリームは訪問者が使っているホスト名にとどまります。

最終更新

目次