> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CometAPI で n8n をローカル実行する
> このガイドでは、ローカルデプロイ設定、認証情報、モデルへのアクセスを構成して、CometAPI とともに n8n をローカルで実行する方法を説明します。
自分のマシンに n8n をデプロイし、コミュニティノード経由で CometAPI に接続して、AI ワークフローの自動化をローカルで実行します。
## 前提条件
* Linux（Ubuntu/Debian/CentOS など）または macOS
* 2 GB 以上の RAM、10 GB 以上の空きディスク容量
* 公開 npm レジストリにアクセス可能なシェル環境
* Node.js 18.x または 20.x LTS（ステップ 1 を参照）
* 有効な API キーを持つ CometAPI アカウント — [こちらから取得](https://www.cometapi.com/console/token)
[CometAPI コンソール](https://www.cometapi.com/console/token)にログインします。**Add API Key** をクリックし、CometAPI API キーをコピーします。
n8n 1.x には Node.js 18.x または 20.x が必要です。推奨される方法は [nvm](https://github.com/nvm-sh/nvm) です。
```bash theme={null}
# 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` に含まれていることを確認してください。
```bash theme={null}
npm install -g n8n
n8n -v # verify the installed version
n8n start # runs on http://localhost:5678/
```
ポート 5678 がすでに使用中の場合:
```bash theme={null}
export N8N_PORT=5679
n8n start
```
ターミナルを閉じた後も n8n を実行し続けるには:
```bash theme={null}
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
```
ブラウザで [http://localhost:5678/](http://localhost:5678/) を開きます。初回実行時には、セットアップウィザードで **Owner** アカウント（メールアドレス + パスワード）の作成を求められます。作成を完了してサインインします。
1. **Settings**（左下）→ **Community nodes** に移動します
2. **Install a community node** をクリックします
3. パッケージ名 `@cometapi-dev/n8n-nodes-cometapi` を入力します
4. リスク確認のチェックボックスをオンにして **Install** をクリックします
インストール後、ノードパネルで **CometAPI** を検索できるようになります。
Community Nodes セクションが表示されない場合は、**Owner** アカウントでサインインしていることを確認し、**Settings → Security** でコミュニティノードのインストールが有効になっていることを確認してください。
1. 上部の **+ New** をクリックしてワークフローを作成します。
2. キャンバス上の **+** をクリックし、**CometAPI** を検索してノードを追加します。
3. **Manual Trigger** ノードを追加し、CometAPI ノードに接続します。
4. CometAPI ノードの **Credential to connect with** で **Create new** を選択します。**CometAPI Key** に CometAPI API キーを貼り付け、**Save** をクリックします。Base URL のデフォルトは `https://api.cometapi.com` で、通常は変更不要です。
5. ノードを設定します:
* **Model**: 使用したい現在の 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 キーと、その model が CometAPI プランで利用可能かを確認してください。
* **空のレスポンスまたはトークン制限エラー** — **Max Tokens** を増やし、必要に応じて **Temperature** と **Top P** を調整してください。
* **ターミナルを閉じると n8n が停止する** — pm2 を使用してください: `pm2 start "n8n" --name n8n && pm2 save`.