n8n のローカルデプロイ

Linux/macOS 上で n8n をローカルにデプロイし、CometAPI コミュニティノードをインストールして、API 認証情報を設定し、マシン上で自動化ワークフローを実行します。

お使いのマシンに n8n をデプロイし、コミュニティノード経由で CometAPI に接続して、ローカルで自動化された AI ワークフローを実行します。

​

前提条件

• Linux（Ubuntu/Debian/CentOS など）または macOS
• RAM 2 GB 以上、空きディスク容量 10 GB 以上
• 公開 npm レジストリにアクセスできるシェル環境
• Node.js 18.x または 20.x LTS（ステップ 1 を参照）
• 有効な API キーを持つ CometAPI アカウント — こちらから取得

1. CometAPI API キーを取得する

   CometAPI コンソールにログインします。Add API Key をクリックし、sk-xxxxx キーをコピーします。

   

   
2. nvm 経由で Node.js をインストールする

   n8n 1.x には Node.js 18.x または 20.x が必要です。推奨される方法は nvm です:

   # Install nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   
   # Reload your shell profile
   source ~/.bashrc   # or ~/.zshrc on macOS
   
   # Install and activate the LTS version
   nvm install --lts
   nvm use --lts
   
   # Verify
   node -v
   npm -v
   

   後で n8n: command not found と表示される場合は、ターミナルを再起動するか、nvm で管理されている npm のグローバル bin ディレクトリが PATH に含まれていることを確認してください。

3. n8n をインストールして起動する

   npm install -g n8n
   n8n -v       # verify the installed version
   n8n start    # runs on http://localhost:5678/
   

   すでにポート 5678 が使用中の場合:

   export N8N_PORT=5679
   n8n start
   

   ターミナルを閉じた後も n8n を実行し続けるには:

   npm install -g pm2
   pm2 start "n8n" --name n8n
   pm2 save
   pm2 status
   

   

   
4. Owner アカウントを作成する

   ブラウザで http://localhost:5678/ を開きます。初回起動時にはセットアップウィザードが表示され、Owner アカウント（メールアドレス + パスワード）の作成を求められます。設定を完了してサインインしてください。

   
5. CometAPI コミュニティノードをインストールする

   1. Settings（左下）→ Community nodes に移動します
   2. Install a community node をクリックします
   3. パッケージ名 @cometapi-dev/n8n-nodes-cometapi を入力します
   4. リスク確認のチェックボックスをオンにして Install をクリックします

   インストール後、ノードパネルで CometAPI を検索できるようになります。

   

   

   Community Nodes セクションが表示されない場合: Owner アカウントでサインインしていることを確認し、Settings → Security でコミュニティノードのインストールが有効になっていることを確認してください。

6. ワークフローを作成して認証情報を設定する

   1. 上部の + New をクリックしてワークフローを作成します。
   2. キャンバス上の + をクリックし、CometAPI を検索してノードを追加します。

   

   

   3. Manual Trigger ノードを追加し、CometAPI ノードに接続します。
   4. CometAPI ノードで Credential to connect with の下にある Create new を選択します。sk-xxxxx キーを CometAPI Key に貼り付け、Save をクリックします。Base URL のデフォルトは https://api.cometapi.com で、通常は変更不要です。

   

   5. ノードを設定します:

   • Model: 使用したい現在のモデル ID を入力します
   • Messages: Role を user、Content をテスト用プロンプト（例: Hello）に設定します
   • 任意: system メッセージを追加し、Max Tokens、Temperature などを設定します

   6. Execute step をクリックしてノードを実行します。Output パネルに JSON レスポンスが表示されます。

   

トラブルシューティング

• node-gyp またはネイティブビルドエラー — ビルドツールをインストールしてください: sudo apt install build-essential python3（Debian/Ubuntu）または Xcode Command Line Tools（macOS）。
• npm 権限エラー（EACCES） — ユーザーレベルの Node.js インストールとして nvm を使用してください。sudo は不要です。
• ポート競合（localhost:5678 が利用不可） — n8n start を実行する前に N8N_PORT=5679（または別の空きポート）を設定してください。
• Community Nodes セクションが表示されない — Owner アカウントでサインインし、Settings → Security を確認してください。
• 社内ネットワークで npm install が失敗する — プロキシを設定してください: npm config set proxy http://user:pass@host:port
• CometAPI ノードが 401/403 を返す — API キーが正しいこと、およびモデルが CometAPI プランで利用可能であることを確認してください。
• 空のレスポンスまたはトークン制限エラー — Max Tokens を増やし、必要に応じて Temperature と Top P を調整してください。
• ターミナルを閉じると n8n が停止する — pm2 を使用してください: pm2 start "n8n" --name n8n && pm2 save.