Square Cloud で n8n をセルフホスト

​

はじめに

• この記事では、Square Cloud で n8n アプリケーションを作成してホスティングする手順を案内します。
• 始める前に、Square Cloud のアカウントを持っていることを確認してください。アカウントはメールアドレスを使ってサインアップページから作成できます。
• 最後に、アカウントに最低 4GB の RAM を備えた有効なプラン (Standard など) が必要です。n8n は 3GB (下記の MEMORY=3072) で動作し、それより小さいプランにはそれだけの RAM がありません。利用可能なプランを比較し、ニーズに合ったものを選んでください。

​

プロジェクトの作成

• n8n は Node.js 上で動作するため、プロジェクトに必要なのは package.json だけです。
• package.json の dependencies に n8n を記載し、それを起動するスクリプトを用意します。以下が例です。

{
  "name": "squarecloud-n8n",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "start": "n8n"
  },
  "author": "Square Cloud Education <squarecloud.app>",
  "license": "ISC",
  "dependencies": {
    "n8n": "2.41.3"
  }
}

• n8n のバージョンは意図的に固定しています。latest を使うと、再インストールのたびに破壊的変更を含む新しいメジャーバージョンに上がる可能性があります。n8n 2.x には Node.js 24 以降が必要で、VERSION=recommended がそれを提供します。
• 後で更新するには、npm view n8n version で最新バージョンを確認し、n8n のリリースノートを読んでから package.json のバージョンを変更し、プロジェクトを再度アップロードしてください。

​

ZIP に含めるファイル

• package.json
• squarecloud.app (下記の設定ファイル)
• .env (任意、下記の変数を記載)

​

設定ファイル

• ダッシュボードからアップロードする場合は、ランタイムを手動で Node.js に設定し、起動コマンドに npm run start を使用します。squarecloud.app 設定ファイルでは次のようになります。

DISPLAY_NAME=App name
RUNTIME=nodejs
START=npm run start
MEMORY=3072
VERSION=recommended
SUBDOMAIN=my-n8n-subdomain

• 上記の MEMORY の値は、プラットフォームのサイジングルールに従っています。調整したい場合はRAM の最小値が存在する理由を参照してください。
• 次に、以下の環境変数を設定します。プロジェクトのルートにある .env ファイル (n8n は起動時にこれを読み込みます) に記載するか、アップロードフォームの Advanced configuration で設定できます。my-n8n-subdomain は自分の SUBDOMAIN に置き換えてください。

N8N_PORT=80
N8N_LISTEN_ADDRESS=0.0.0.0
N8N_HOST=my-n8n-subdomain.squareweb.app
N8N_PROTOCOL=https
N8N_WEBHOOK_URL=https://my-n8n-subdomain.squareweb.app/

• N8N_PORT と N8N_LISTEN_ADDRESS により、n8n はすべてのインターフェースのポート 80 で待ち受けます。Square Cloud はサブドメインへのトラフィックをこのポートに届けます。n8n は Square Cloud が設定する変数 PORT を読み込まないため、N8N_PORT が必要です。
• N8N_HOST、N8N_PROTOCOL、N8N_WEBHOOK_URL は n8n に公開アドレスを伝えます。N8N_WEBHOOK_URL がないと、ワークフローに表示される Webhook URL が内部ポートを指してしまい、外部サービスから到達できません。古いガイドではこの変数を WEBHOOK_URL と呼んでいますが、n8n 2.x では非推奨です。その他のオプションについては n8n のエンドポイント変数を参照してください。
• ダッシュボードで設定した変数は .env ファイルより優先されます。管理方法については環境変数を参照してください。

​

プロジェクトを Square Cloud にアップロード

​

ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。

2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。

3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。

4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。

アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

​

CLI 経由

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

オーナーアカウントの作成

​

最後に

​

次のステップ

​

お問い合わせ