なぜ立てたか

最近、Xserver VPS借りて、misskey鯖を立てました！せっかくVPSを借りたので他にも活用してみたいと思い、元々興味のあったn8nをセルフホストしてみました。
今回の記事では、n8nをXserver VPSにセルフホストする手順を書いていきたいと思います。（同じサーバーでnginxがすでに稼働中であることが前提です）

1 n8nとは

n8n（エヌエイトエヌ）とは、「ノーコードでワークフローを構築でき、様々なWebサービスをつなぎ合わせて面倒な作業を自動化してくれるツール」です。
例えば

毎朝の天気やニュースを自動取得して、LINEやDiscordに通知する
受信した長文メールをAIに要約させたり、メールのカテゴリ分けをしたりする
銀行の入金通知メールから家計簿を自動更新する
など、複数のアプリやサービスを連携して自動化することができます。

さらに、n8nはノーコードで自動化フローを構築できるだけでなく、API連携やコードの埋め込みなどといった高度なカスタマイズが可能なため、柔軟な拡張をすることができます。

n8nの運用

n8nを運用していくには3つの選択肢があります。

n8n Cloud — 公式のホスティングサービス。月額課金で、プランごとに実行数の上限あり
ローカルPCでセルフホスト — Dockerやnpmで自分のPCに立てる。無料
VPSでセルフホスト — VPSを借りて立てる（今回採用した方法）

	n8n Cloud	ローカル	VPS
初期設定	ほぼ不要	簡単	ドメイン・DNS・リバプロ・証明書が必要
費用	月額課金	無料	VPS代のみ
24時間稼働	◯	✕（PCの電源次第）	◯
Webhook受信	◯	△（ngrok等が必要）	◯
実行数の上限	プランによる	なし	なし
運用の手間	なし	小	全部自分持ち

VPSでセルフホストするメリット

費用がVPS代だけ
VPSを借りるときに発生する料金がかかります。既にVPSを借りているなら追加コストはありません。
24時間動く
「毎朝7時に天気を通知」のようなスケジュール実行が、PCを閉じても止まらずに動いてくれます。
Webhookを外から受けられる
Discord・GitHub・各種SaaSからのWebhookをそのまま受信できます。ローカル環境だとngrokなどが必要になる部分です。
実行数を気にしなくていい
サーバーのリソースが許す限り回し放題です。
認証情報が自分の手元にある
APIキーも処理するデータも外部サービスを経由しません。
カスタマイズが自由
環境変数の設定、Codeノードでのnpmパッケージ利用、他のDockerコンテナとの連携など、好きに触れます。

デメリット

構築のハードルが高い
サブドメイン、DNS、リバースプロキシ、SSL証明書まで全部自分で用意する必要があります。
セキュリティの責任を負う
n8nは各種サービスのAPIキーの塊です。管理画面をインターネットに晒す以上、HTTPS化と認証は必須になります。
リソースの奪い合いが起きる
既存サービスと同居する場合、重いワークフローがメモリを食って隣のサービスに影響することがあります。
アップデートとバックアップは自分で
放置でも動きはしますが、Dockerボリュームが飛ぶとワークフローも認証情報も全部消えます。

このように少しハードルが高いですが、その分自由度も上がるので、VPSを借りている、またはVPSで何かのサービスを運用したいと思っている場合はn8nもVPSでセルフホストすることをおすすめします。

2 手順

ここから本題の環境構築です。
まずは、前提として必要な環境から書いていきます。

2-1 環境

Xserver VPS（Ubuntu）
ドメイン取得済み（サブドメインでn8nを公開）
同じサーバーでnginxがすでに稼働中

2-2 事前準備

サブドメインのDNS設定

n8nはHTTPS前提で運用するのが基本なので、専用のサブドメインを用意します。
DNSに以下のAレコードを追加：

n8n.your-domain.com  →  VPSのIPアドレス

例) cloudflareの場合

Xserver VPSのパケットフィルター

Xserver VPSはVPSパネル側でポートが遮断されているので、「パネル→パケットフィルター設定」で80(HTTP)と443(HTTPS)を許可します。
既に開いている場合はそのままで大丈夫です。

Step１：Dockerのインストール

SSHでVPSに入り、Docker公式スクリプトでインストールします。

ssh ユーザー名@VPSのIP

# Docker公式のインストールスクリプト
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

上記のコマンドを利用すれば、一度ログアウト→再ログインでsudoなしでdockerが使えるようになります。

Step２：n8nの構成ファイルを置く

mkdir -p ~/n8n && cd ~/n8n

ファイルに移動出来たらdocker-compose.ymlを作成します。

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - N8N_HOST=n8n.your-domain.com
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://n8n.your-domain.com/
      - GENERIC_TIMEZONE=Asia/Tokyo
      - TZ=Asia/Tokyo
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

127.0.0.1:5678:5678ーn8nをlocalhostにのみ公開し、外部からは既存のnginx経由でしかアクセスできないようにする
GENERIC_TIMEZONE=Asia/Tokyoーこれを忘れるとスケジュール実行がUTC基準になる
起動は以下のコマンドで行います。

docker compose up -d

失敗談

実は最初は、この構成ではなくHTTPS化を自動でやってくれるCaddyをリバースプロキシとして同じcomposeに入れる構成で組んでいました。

リバースプロキシ
・インターネットとWebサーバーの間にある中継サーバー
・セキュリティ、パフォーマンス、および信頼性を向上させるために実装される

caddy:
    image: caddy:latest
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data

この構成でファイルを作成し、docker compose up -dして、https://n8n.ドメイン.comにアクセスすると、初回セットアップ画面が出るはずでしたが、結果はこのようになりました。

$ docker compose ps
NAME          IMAGE           STATUS
n8n-caddy-1   caddy:latest    Restarting (1) 5 seconds ago   ← 再起動ループ
n8n-n8n-1     docker.n8n.io/n8nio/n8n   Up 2 minutes

Caddyのログを見ると以下のようになっていました。

Error: adapting config using caddyfile: EOF

さらにポートの使用状況を確認すると

$ sudo ss -tlnp | grep -E ':80|:443'
LISTEN 0  511  0.0.0.0:80   users:(("nginx",...))
LISTEN 0  511  0.0.0.0:443  users:(("nginx",...))

ログのEOFはCaddyfileの内容が正しく読み込めていないエラーです。ただ、そこを直しても、既存のnginxがポート80/443をつかんでおり、そもそもCaddyがポートをとれる余地がありませんでした。
nginxは既に他のサイトを配信中なので、既存nginxに相乗りさせる方針に切り替えました。

Step３：既存nginxにn8nのリバースプロキシ設定を追加

n8n用のファイルを作成

sudo nano /etc/nginx/sites-available/n8n

server {
    listen 80;
    server_name n8n.your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 300s;
        client_max_body_size 50m;
    }
}

下記のコマンドで有効化して反映します。

sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Step４：certbotでHTTPS化

既にnginxでHTTPSサイトを運用しているならcertbotは入っている可能性が高いので、確認してから実行します。

certbot --version || sudo apt install -y certbot python3-certbot-nginx

||によって、「左のコマンドが失敗した時だけ右を実行する」という挙動になっています
　もし、certbot --versionが失敗した場合は、右側のインストールが走ります。
-yは確認プロンプトへ自動でyesと答えるオプション

パッケージ	役割
`certbot`	Let's Encryptから証明書を取得・更新する本体
`python3-certbot-nginx`	nginx用プラグイン。設定ファイルの自動編集と、認証時のnginx制御を担当

sudo certbot --nginx -d n8n.your-domain.com

--nginxがプラグインの指定、-dが対象ドメインの指定です。
これ1本で、証明書の取得からnginx設定への反映まで全部やってくれます

server_name n8n.your-domain.comのserverブロックを探す
Let's Encryptがhttp://n8n.your-domain.com/に実際にアクセスしてドメイン所有を確認
証明書を/etc/letsencrypt/live/に保存
nginx設定に443のserverブロックとリダイレクトを自動追記してreload
自動更新のタイマーに登録

自動更新のタイマーに登録してくれるため、既存のサイトの更新スケジュールに相乗りする形になり、以後メンテ不要となります。

これが成功するとこんな出力になります。

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/n8n.your-domain.com/fullchain.pem
Deploying certificate
Successfully deployed certificate for n8n.your-domain.com to /etc/nginx/sites-enabled/n8n
Congratulations! You have successfully enabled HTTPS on https://n8n.your-domain.com

Step５：動作確認

https://n8n.your-domain.comにアクセスして、n8nのオーナーアカウント作成画面（Set up owner account）が表示されれば完了です。管理画面はこのアカウント認証で保護されます。

3 まとめ

まっさらなVPSなら「n8n+Caddy」のcompose一発が最短
既にnginxが動いているVPSでは、Caddyはポートを取れず再起動ループする
・その場合はn8nを127.0.0.1:5678にのみ公開し、既存nginxにリバースプロキシ設定を1ファイルに追加＋certbotでHTTPS化するのがきれい

以上となります。
今回は既存のnginxに同居させる形で、n8nをXserverに同居させる手順を紹介しました。
n8nは幅広い使い方ができ、日常のタスクを自動化することができるため、ぜひ使ってみてください！

参考

「リバースプロキシとは？|プロキシサーバーの説明」https://www.cloudflare.com/ja-jp/learning/cdn/glossary/reverse-proxy/
「n8nで自動化！便利な活用事例」https://note.com/kakazuastro/n/n17282f4d7856
「【入門】n8nとは？クラウド版とセルフホストの違い・始め方を分かりやすく解説」https://qiita.com/kaz_saito803/items/f3a4acd1e3960ad7d5ae
「n8nのセルフホスト完全ガイド|VPSのインストールから運用まで」https://humanoid-inc.net/owned-media/n8n-self-host-guide