はじめに
Square Cloud で n8n インスタンス を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。前提条件
- Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
- 有効なプラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。
MEMORY=3072) で動作するため、Standard など最低 4 GB を備えたプランが必要です。それより小さいプランにはそれだけの RAM がありません。このガイドは Node.js ランタイムで動作します。
プロジェクトの入手
n8n は Node.js 上で動作するため、プロジェクトに必要なのは、dependencies に n8n を記載し、それを起動するスクリプトを持つpackage.json だけです。
package.json
latest を使うと、再インストールのたびに破壊的変更を含む新しいメジャーバージョンに上がる可能性があります。n8n 2.x には Node.js 24 以降が必要で、VERSION=recommended がそれを提供します。
後で更新するには、npm view n8n version で最新バージョンを確認し、n8n のリリースノートを読んでから package.json のバージョンを変更し、プロジェクトを再度アップロードしてください。
デプロイに必要なものはすべて当社の n8n-web のリリースに用意されています。
project.zip をダウンロードしてアップロードするだけです。Square Cloud の設定
プロジェクトのルートにsquarecloud.app ファイルを作成します。
squarecloud.app
START=npm run start は package.json の start スクリプトを実行します。ダッシュボードからアップロードする場合は、ランタイムを手動で Node.js に設定し、起動コマンドに npm run start を使用します。MEMORY の値は、プラットフォームのサイジングルールに従っています。調整したい場合はRAM の最小値が存在する理由を参照してください。
環境変数
以下の変数を設定します。プロジェクトのルートにある.env ファイル (n8n は起動時にこれを読み込みます) に記載するか、アップロードフォームの 詳細設定 またはダッシュボードで、アプリケーションの環境変数として設定できます。my-n8n-subdomain は自分の SUBDOMAIN に置き換えてください。
.env
N8N_PORTとN8N_LISTEN_ADDRESSにより、n8n はすべてのインターフェースのポート80で待ち受けます。Square Cloud はサブドメインへのトラフィックをこのポートに届けます。n8n は Square Cloud が設定する変数PORTを読み込まないため、N8N_PORTが必要です。N8N_HOST、N8N_PROTOCOL、N8N_WEBHOOK_URLは n8n に公開アドレスを伝えます。古いガイドでは最後の変数をWEBHOOK_URLと呼んでいますが、n8n 2.x では非推奨です。その他のオプションについては n8n のエンドポイント変数を参照してください。
.env ファイルより優先されます。
ZIP に含めるもの
package.jsonsquarecloud.app.env(上記の変数をそこに記載する場合)
node_modules/ は含めないでください。n8n はサーバー上で Square Cloud がインストールします。
デプロイと動作確認
ダッシュボード経由
1
アップロードページにアクセス
アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2
環境を設定
zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3
プロジェクトをデプロイ
最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。

4
アプリが稼働していることを確認
最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで
ウェブサイトや API をデプロイした場合は、ブラウザで
https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
CLI 経由
この方法を使用するには、プロジェクトのルートにsquarecloud.app という名前の設定ファイルが必要です。このファイルは、アプリケーションの実行方法を Square Cloud に伝えます。
設定ファイルガイド
アプリケーションの環境を定義する
squarecloud.app 設定ファイルの作成方法を学びます。1
CLI をインストール
Square Cloud CLI をインストールします。すでにお持ちの場合は、同じコマンドを実行すると更新されます:
2
ログイン
次のコマンドを実行します。ブラウザが開くので、そこでログインを承認すれば CLI の準備は完了です。API キーをコピーする必要はありません。スクリプトや CI については、CLI の認証を参照してください。
3
プロジェクトをアップロード
プロジェクトのフォルダで次のコマンドを実行します。CLI は 自分で作成した zip をアップロードするには、
squarecloud.ignore に記載されたものを除いて現在のフォルダを zip にし、アップロードします:--file で指定します:4
アプリが稼働していることを確認
最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。ウェブサイトや API をデプロイした場合は、ブラウザで
https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
初回アクセス
デプロイ直後にhttps://my-n8n-subdomain.squareweb.app を開き、オーナーアカウントを作成してください。最初にページを開いた人がインスタンスのオーナーになるため、URL を誰かと共有する前に済ませておきましょう。
よくあるエラー
カスタムドメイン
デフォルトの URL
mysite.squareweb.app の代わりにカスタムドメイン(例: mysite.com)を使用するには、Standard プラン以上が必要です。デフォルトの URL は設定ファイルの SUBDOMAIN フィールドから決まります。独自ドメインを接続するには、独自ドメインの設定方法に従ってください。最小 RAM 要件
ウェブサイトと API は最小 512MB RAMです。これは静的ランタイムで静的ビルドを配信するには十分な量です。サーバー上でページをレンダリングするアプリ(Next.js、Nuxt、Angular SSR など)には、最低 1GB RAMを推奨します。より大規模なアプリケーションでは、メモリ不足でアプリケーションがクラッシュするのを防ぐため、より多くの RAM を割り当ててください。
このサイトが見つかりませんでした。
サブドメイン/ドメインが SUBDOMAIN フィールドまたはカスタムドメイン設定で構成されている内容と一致しているか確認してください。サイトをアップロードしたばかりの場合は、Square が初回アクセスを有効化するまで最大 60 秒お待ちください。
サイトの応答に時間がかかりすぎました…
サーバーはポート 80 とホスト 0.0.0.0 でリッスンする必要があります。Square Cloud はアプリケーションに環境変数 PORT(
80)と HOST(0.0.0.0)を設定します。別の値をハードコーディングせず、コードでこれらを読み込んでください。localhost や 127.0.0.1 だけでリッスンしているサーバーには、リクエストが届きません。n8n がサブドメインで応答しない
n8n は変数PORT と HOST を無視します。N8N_PORT=80 と N8N_LISTEN_ADDRESS=0.0.0.0 が設定されていることを確認し、アプリケーションを再起動してください。
Webhook URL が内部ポートを指している
N8N_WEBHOOK_URL がないと、ワークフローに表示される Webhook URL が内部ポートを指してしまい、外部サービスから到達できません。N8N_WEBHOOK_URL を公開アドレス (例: https://my-n8n-subdomain.squareweb.app/) に設定し、アプリケーションを再起動してください。
次のステップ
環境変数
n8n の設定やシークレットをダッシュボードまたは CLI で管理します。
カスタムドメイン
独自ドメインから n8n を配信し、
N8N_HOST と N8N_WEBHOOK_URL を更新します。Uptime Kuma
n8n やその他のサービスを監視します。

