自サーバでNext.jsアプリを動かす#2
PM2を利用して、快適にNext.jsアプリを動かす

Next.jsで作成したWebサイト・アプリを自サーバで運用するために「PM2」というミドルウェアを利用して、快適に運用して方法のまとめ

初回公開日2025/6/20

最終更新日2025/6/20

前回「自サーバでNext.jsアプリを動かす#1 Node.jsインストール＋Nginx設定＋デプロイ」で行った作業では、npm startでnode.jsを使ってWebアプリを起動しました。

前回の確認はこちら...

自サーバでNext.jsアプリを動かす#1 Node.jsインストール＋Nginx設定＋デプロイへ

しかし、通常、Node.jsアプリはnpm startなどで起動すると、そのターミナルが閉じられたら終了してしまうという特性がある。これでは、サーバ再起動やSSH切断などに弱く、本番環境での運用はできません。そこで登場するのが、プロセスマネージャーと呼ばれる広義のミドルウェアです。

私の環境で採用しているプロセスマネージャーは「PM2」です。

1.「PM2」とは？

PM2（Process Manager 2）は、Node.jsアプリケーションを本番環境で安定して常駐・管理するためのプロセスマネージャです。

PM2の主な機能は下記のとおりです。

アプリをバックグラウンドで常駐実行
サーバ再起動後にも自動復元（systemd連携）
ログの一元管理
複数アプリのプロセスをまとめて管理

こうした運用に必要な機能をぜんぶカバーしてくれる便利ツールです。

○npm start と PM2 の違い

観点	npm start	PM2
実行方法	nodeで直接起動	バックグラウンドで常駐起動
ターミナル閉じたら？	❌ アプリも終了	✅ アプリは生きたまま維持
再起動後の自動復元	❌ できない	✅ pm2 startup + pm2 save で対応可
ログ管理	❌ 手動でリダイレクトする必要あり	✅ pm2 logs で即確認
複数プロセス管理	❌ 別ターミナルで個別に起動	✅ 一括管理・再起動・再保存が可能

○他に同様のプロセスマネージャは？

ミドルウェア名	特徴
forever	初期に使われてたプロセスマネージャ。シンプルだが、機能が少ない
nodemon	開発用。コード変更を検知して自動再起動するツール。本番には不向き
systemd	OSレベルのプロセス管理。柔軟だが設定が複雑。PM2と併用されることも多い

PM2は「開発でも本番でも使える」「機能が豊富」「導入が簡単」な三拍子そろったツールです

↓プロセスマネージャのイメージです：

text

[ クライアント ]
      │
      ▼
+-------------+　　　+--------------------+      +------------------------+
|    Nginx    |───▶|      PM2           |─────▶|     Next.js アプリ     |
| (リバースプロキシ) |　|  (プロセスマネージャ) |      |   (バックエンド処理)  |
+-------------+　　　+--------------------+      +------------------------+

この図のように、Nginxはインターネットからのリクエストを受け取り、PM2によって常駐管理されているNext.jsアプリにリクエストを中継します。

PM2は単なる起動ツールではなく、プロセスの監視・復旧・ログ管理・自動起動まで担う「アプリ運用の屋台骨」となる存在です。

2.【サーバ側作業】PM2のインストールと実行

PM2のインストール

bash

sudo apt update
sudo npm install -g pm2

PM2の実行

bash

cd /var/www/example.com/html/
pm2 start npm --name "new-app" -- start

--name "new-app"の自分が覚えやすい名前でOK

とりあえず、これでブラウザでNext.jsのデフォルトページは表示できます。ぜひ、確認してみてください。

pm2 start npm --name "new-app" -- startしただけですと、サーバを再起動した時に再度コマンドを実行する必要があります。サーバの再起動時も自動的にpm2で起動させる方法は下記のようになります。

PM2をサーバ起動時に自動起動させる手順

pm2 startup を実行:

bash

pm2 startup

上記のコマンドを実行すると、下記のようなメッセージが表示されます。

bash

[PM2] Init system found: systemd
[PM2] To setup the startup script, copy/paste the following command:
sudo env PATH=$PATH:/home/***/.nvm/versions/node/v22.14.0/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u *** --hp /home/***

sudo env ・・・の部分をコピー＆ペーストしてコマンド実行します。

bash

sudo env PATH=$PATH:/home/***/.nvm/versions/node/v22.14.0/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u *** --hp /home/***

以上は、そのサーバ、そのユーザー、そのOSに1回だけ実行すればOKです。

現在のプロセスリストを保存（必須）:

bash

pm2 save

↑これをしないと「登録したけど何を起動するか」が空っぽで、再起動しても何も復元されないので、注意が必要です。

pm2 saveで現在稼働中のプロジェクトを保存するものです。

例えば、新たなプロジェクトを稼働させた時は

bash

cd /var/www/hogehoge.com/html/
pm2 start npm --name "new-app2" -- start
pm2 save

このように、pm2 startとpm2 saveを実行するだけでサーバ再起動時に自動でプロジェクトを稼働してくれます。

pm2で稼働中のプロジェクトの確認

bash

pm2 list

bash

┌────┬────────────────────┬──────────┬──────┬───────────┬──────────┬──────────┐
│ id │ name               │ mode     │ ↺    │ status    │ cpu      │ memory   │
├────┼────────────────────┼──────────┼──────┼───────────┼──────────┼──────────┤
│ 0  │ new-app            │ fork     │ 0    │ online    │ 0%       │ 67.9mb   │
└────┴────────────────────┴──────────┴──────┴───────────┴──────────┴──────────┘

name欄はpm2 startコマンドで指定したnameになります。

pm2で稼働中のプロジェクトを停止

bash

pm2 delete new-app
pm2 save

pm2 listで表示されるnameを指定して削除できます。idの数値でpm2 delete 0としてもOKです。
pm2 saveで自動実行の定義にも反映

全てのプロジェクトの停止する場合：

bash

pm2 delete all
pm2 save

稼働中のPM2プロジェクトを再起動

何か設定変更したり、再アップロードした場合はPM2もリスタートする必要があります。

bash

pm2 restart new-app
pm2 save

restartコマンドも名前指定だけでなくid指定でpm2 restart 0とすることもできます。

全てのプロジェクトの再起動する場合：

bash

pm2 restart all
pm2 save

2. PM2を利用したNext.js本番運用のまとめ：デプロイ後の定型手順

本番へファイルをアップロード後

bash

# 1. 対象のルートディレクトリへ移動
cd /var/www/example.com/html

# 2. 依存関係をロックファイルに基づいてインストール
npm ci

# 3. [Prismaを利用中の場合]Prisma Client の再生成（DBスキーマが変わってなくても基本実行）
npx prisma generate

# 4. PM2でNext.jsを起動
# [稼働中のプロジェクトの場合]-PM2を再起動
pm2 restart new-app

# [新規プロジェクトの場合]-PM2で新規スタート
pm2 start npm --name "new-app2" -- start

# 5. 現在のプロセス構成を保存（再起動後に自動復元させるため）
pm2 save

3. PM2をもっと便利に使う！ `ecosystem.config.js` の活用

ここまで紹介してきたPM2の操作はすべて、コマンドラインで1つずつ手動で実行していました。実際の運用では、複数のアプリや環境変数の管理、ログパスの指定なども行いたくなる場面が多くなってきます。

そこで活用したいのが、PM2の構成ファイル ecosystem.config.js です。

このファイルを使えば、

環境変数の設定（.envの代わり）
スクリプトの指定（npm run startのような）
アプリごとのログや再起動設定
複数アプリの管理

などが、すべて1つのファイルで自動化できます。

運用ポリシー

色々な利用の仕方がありますが、私の場合は下記のポリシーでPM2を運用することにしています。

項目	方針
ecosystem.config.jsの配置	各サイトルートには置かず、ホームディレクトリに配置
サイトごとに管理	サイトごとにファイルを分割（例：ecosystem-delogs.config.js）
.envファイル	使用しない（env オブジェクト内で環境変数を定義）
公開ディレクトリのセキュリティ	重要設定ファイルはすべて非公開領域に集約

ディレクトリ構成（例）

text

/home/user/
├── pm2/
│   ├── ecosystem-example.config.js（←ここにpm2設定ファイル）
│   └── ecosystem-hogehoge.config.js（←サイト毎に分けて管理）
/var/www/
├── example.com/
│   └── html/（←ここに公開ファイル）

設定ファイルは非公開領域のサーバの各ユーザのホームディレクトリに配置

ecosystem-example.config.js の設定

bash

cd ~
mkdir pm2
vi pm2/ecosystem-example.config.js

設定例：

bash : ecosystem-example.config.js

// /home/user/pm2/ecosystem-example.config.js

module.exports = {
  apps: [
    {
      name: 'example-app',
      cwd: '/var/www/example.com/html/',
      script: 'npm',
      args: 'start',
      instances: 1,
      autorestart: true,
      watch: false,
      max_memory_restart: '1G',
      env: {
        NODE_ENV: 'production',
        NEXT_PUBLIC_SITE_NAME: 'example',
        DATABASE_URL: 'postgresql://dbuser:yourpassword@xxx.xxxx.xxx.xxx:5432/dbname?schema=public'
      }
    }
  ]
}

○各設定項目の説明

項目名	説明
name	PM2で表示されるアプリ名（pm2 listに出る）
cwd	カレントワーキングディレクトリ（ルートディレクトリ）
script	起動するスクリプト（Next.jsならnpm）
args	npmに渡す引数（start → npm start）
instances	クラスタモード用（Next.jsでは基本1でOK）
autorestart	アプリが落ちたら自動で再起動する
watch	ファイルの変更時に再起動させるか。falseの場合、手動で`pm2 restart`したときだけ再起動（本番環境はこれ）
max_memory_restart	メモリが1GB超えたら再起動
env	環境変数（.envファイル代わりにここで指定）

ecosystem.config.js は Node.jsの module.exports 構文を使った JavaScriptファイルになります。コメントアウトする際は通常のJavaScriptと同じです。//や/* */を利用します。
env:{}にNext.jsの.envの内容を記述しますが、NODE_ENV: 'production',のような:で区切る記述の仕方になります。Next.js側ではNODE_ENV='production'と=で指定いると思うので注意してください。
max_memory_restartは難しいところです。あまり頻繁に再起動しても困るので、サーバスペックと相談して決めます。pm2 listやpm2 monitで利用メモリがチェックできます。 MBでしてする場合は512Mなどと指定します。

起動＆保存手順（サーバ再起動対応）

bash

pm2 start ~/pm2/ecosystem-example.config.js
pm2 save

bash

pm2 list

example-appが表示されればOK

リスタート時：

bash

pm2 restart ~/pm2/ecosystem-example.config.js
pm2 save

設定ファイルを更新した時だけなく、公開ファイルを更新した際も必ず、~/pm2/ecosystem-example.config.jsをつけて実行してください。
私は~/pm2/ecosystem-example.config.jsをつけずにリスタートした時に環境設定ファイルを読み込んでくれない現象を経験しました。

これで、効率的な運用もできるようになったと思います。改めて、ecosystem.config.jsを利用した場合のNext.js本番運用のまとめを記します。

4. PM2の`ecosystem.config.js`を利用したNext.js本番運用のまとめ：デプロイ後の定型手順

本番へファイルをアップロード後

bash

# 1. 対象のルートディレクトリへ移動
cd /var/www/example.com/html

# 2. 依存関係をロックファイルに基づいてインストール
npm ci

# 3. [Prismaを利用中の場合]Prisma Client の再生成（DBスキーマが変わってなくても基本実行）
npx prisma generate

# 4. PM2でNext.jsを起動
# [稼働中のプロジェクトの場合]-PM2を再起動
pm2 restart ~/pm2/ecosystem-example.config.js

# [新規プロジェクトの場合]-PM2で新規スタート
pm2 start ~/pm2/ecosystem-example.config.js

# 5. 現在のプロセス構成を保存（再起動後に自動復元させるため）
pm2 save