Node.jsアプリはVPSでなければ動かせない、と思われがちですが、そんなことはありません。Rivervoのすべての共用レンタルサーバープランには、ウェブサイトのメニューにNode.jsとPythonがあり、ほかのサイトを配信しているのと同じApacheの背後で、アプリ用のPhusion Passengerプロセスを起動します。
このガイドでは、最もよく使われる2つのフレームワーク、Next.jsとNuxt 3について、一連の流れを説明します。最終的には、アプリがhttps://your-domain.jp(または任意のサブドメイン)で、本物のNode.jsプロセスとして動き、再起動後も復帰し、ワンクリックで再起動できる状態になります。
共用レンタルサーバーにNodeアプリをデプロイするのが初めての場合、誰もがつまずくのが起動ファイルです。Passengerには、フレームワークを起動するエントリースクリプトが1つ必要です。以下にフレームワークごとのファイルを用意したので、そのままコピーして使えます。編集は不要です。
始める前に必要なもの
- Rivervoのレンタルサーバープラン(どのプランでもNode.jsアプリが動きます)
- アプリをビルドするための、手元のv20以降のNode.js
- アップロードできる状態のビルド済みファイル(フレームワークごとに説明します)
- アカウントへのファイルマネージャーまたはSFTPでのアクセス(どちらでも可)
root、sudo、systemd、リバースプロキシの設定は不要です。すべてPassengerが処理します。
ステップ1:手元でアプリをビルドする
アップロードするのはソースではなくビルド済みのアプリです。パネルは依存関係をインストールしますが、Reactのコンパイルや Viteのビルドは行いません。先にご自身のPCで済ませてください。
Next.js:
npm ci
npm run buildこれで.next/(ビルド結果)ができます。ここではnext startを実行しないでください。このあと起動ファイルから起動します。
Nuxt 3:
npm ci
npm run buildこれで.output/(Nuxtのユニバーサルビルドディレクトリ)ができます。同じく、まだ何も実行しません。
ステップ2:必要なファイルをアップロードする
node_modules/をアップロードする必要はありません。依存関係はパネルがインストールします。gitやビルドキャッシュも不要です。
アカウント内の、できればpublic_htmlの外のパス(例:/home/<account>/myapp/)にアップロードします。なぜ外なのかというと、Passengerはpublic_htmlを自動的にURLのルートとして公開するため、そこにアプリのコードを置くと外から見えてしまうからです。
| フレームワーク | アップロードするもの | 不要なもの |
|---|---|---|
| Next.js | .next/、public/、package.json、package-lock.json、next.config.js、server.cjs(下記) | node_modules/、.git/、.env.local |
| Nuxt 3 | .output/、package.json、package-lock.json、server.cjs(下記) | node_modules/、.nuxt/、.git/、ソースのpages/、components/ |
ファイルを置く方法は2つあります。
- ウェブサイト → ファイル → zipをアップロード → 展開:回線が不安定な場合はこれが一番簡単です。
- SFTP(FileZilla、Cyberduck、
rsync):繰り返しデプロイするなら、こちらが速いです。サーバー、ポート、ユーザー名、パスワードはウェブサイト → SSHとSFTPにあります。
ステップ3:起動ファイルを追加する
リクエストが来たときにPassengerが実行するファイルです。アプリのフォルダーのpackage.jsonと同じ場所に置きます。
Next.jsの場合:server.cjs
const next = require('next')
const http = require('http')
const port = process.env.PORT || 3000
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev, dir: __dirname })
const handle = app.getRequestHandler()
app.prepare().then(() => {
http.createServer((req, res) => handle(req, res)).listen(port, () => {
console.log(`Next.js server listening on port ${port}`)
})
})このファイルの役割:
- Nextを読み込み、現在のディレクトリ(
.next/とpackage.jsonがある場所)を指定します。 - Nextの内部ルーターからリクエストハンドラーを作ります。
- Passengerが割り当てたポート(
process.env.PORT)でHTTPサーバーを起動します。 - ローカルでのテスト用に、
3000をフォールバックにします。
devはNODE_ENVから自動で決まります。パネルで本番モードを設定すれば(ステップ4で行います)、Nextは本番モードで動きます。
Nuxt 3の場合:server.cjs
import('./.output/server/index.mjs').then(({ createApp }) => {
createApp().then(({ app }) => {
const port = process.env.PORT || 3000
app.listen(port, () => {
console.log(`Nuxt server listening on port ${port}`)
})
})
})このファイルの役割:
- Nuxtの
.output/server/index.mjs(npm run buildで作られるエントリー)を動的にインポートします。 createApp()でH3サーバーのインスタンスを作ります。- Passengerが割り当てたポートで待ち受けます。
動的なimport()は意図したものです。.mjsモジュールはrequire()できませんが、.cjsファイルからは動的にインポートできます。Passengerのランチャー内で動く、最もすっきりした書き方です。
ステップ4:パネルでアプリケーションを作成する
プロジェクトを開き、ウェブサイト → Node.jsとPython → Node.jsアプリケーションに進みます。
| 項目 | 値 |
|---|---|
| バージョン | 20以降 |
| モード | 本番 |
| フォルダー | ホームフォルダー内のmyapp(ファイルをアップロードした場所) |
| アドレス | your-domain.jp(またはapp.your-domain.jpなどのサブドメイン) |
| 起動ファイル | server.cjs |
作成をクリックします。~/nodevenv/myapp/20/にNode.jsの環境が作られます。
依存関係をインストールする
アプリが作成されたら、そのアプリの**依存関係をインストール(npm install)**をクリックし、出力を確認します。失敗した場合は次を確認してください。
package.jsonがアプリケーションのルートにあること(入れ子になっていないこと)。- Next.jsの場合:
nextがdevDependenciesではなくdependenciesに入っていること(本番インストールでは開発用の依存関係は入りません)。 - Nuxtの場合:
nuxt自体も通常の依存関係に入っていること。
環境変数を追加する
アプリの設定 → 環境変数 → 変数を追加で設定します。本番モードではNODE_ENV=productionがすでに設定されています。
実行時に読み込む値(データベースのURL、APIキーなど)があるNext.jsアプリでは、ここに追加します。秘密情報を含む.envファイルはアップロードしないでください。 アプリの環境変数に設定するのが正しい方法です。
設定を保存するとアプリが再起動するので、新しい変数はすぐに反映されます。
ステップ5:動作を確認する
アプリケーションのURLを開きます。アプリが表示されれば成功です。
Passengerのエラーページが表示された場合は、展開して一番下を見てください。ほとんどの場合、わかりやすいスタックトレースがあります。よくあるのは次の2つです。
Error: Cannot find module 'next':npm installが実行されていないか、別のフォルダーで実行されています。もう一度**依存関係をインストール(npm install)**をクリックしてください。
Error: ENOENT: no such file or directory, open '.next/...':ソースだけをアップロードし、ビルド済みの.next/ディレクトリをアップロードしていません。手元でビルドして、アップロードし直してください。
更新をデプロイする方法
ステップ1と2を繰り返し、アプリの再起動をクリックします。具体的には次のとおりです。
1. Build locally npm run build
2. Upload .next/ or .output/, plus any changed source/config
3. Panel Restart the apppackage.jsonを変更した場合は、再起動の前に**依存関係をインストール(npm install)**をクリックします。コマンドラインを使いたい場合は、ウェブサイト → ターミナルへ。アプリのカードに、その環境に入るためのコマンドが表示されています。
よくある注意点
WebSocket: PassengerはHTTP/1.1とHTTP/2に対応しています。Next.jsやNuxtの組み込みルートでは、WebSocketへのアップグレードが使えます。別のWebSocketサーバー(ws、socket.io)を使う場合も、同じポートを共有し、同じserver.cjsから起動します。追加の設定は不要です。
ファイルのアップロード/next.config.jsのbody-parserの上限: Passengerのリクエストボディの上限は標準で10MBです。大きなファイルをアップロードする場合は、public_htmlの.htaccessでpassenger_max_request_sizeを引き上げます。
PassengerMaxRequestSize 52428800(バイト単位で50MBです。)
Cronジョブ: アプリにバックグラウンド処理(メルマガ配信、定期エクスポートなど)が必要な場合、ウェブのプロセス内で実行しないでください。ウェブサイト → Cronジョブから、Nodeスクリプトを直接呼び出します。
/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.jsプロセスのメモリ: アカウントごとのRAM上限(プランによって異なります)を超えると、Passengerがアプリを再起動します。一般的なNext.js/Nuxtアプリなら、待機時は100MB未満です。上限に達する場合は、より大きなプランが必要だと考える前に、process.memoryUsage()でプロファイルを取り、メモリリークを探してください。
独自ドメインとHTTPS: アプリに設定したアドレスが、Passengerが割り当てるアドレスです。SSLは自動で、追加の設定は不要です。別のドメインやサブドメインを使う場合は、先にウェブサイト → ドメインで追加し、アプリのアドレスとして選びます。
Nodeのバージョン: バージョンの一覧に、インストール済みのすべてのバージョンが表示されます。切り替えはアプリの設定で行います。
Nodeに共用レンタルサーバーを使うべきでない場合
率直に言うと、共用レンタルサーバーのNode.jsは、ポートフォリオサイト、ブログ、マーケティングページ、小規模なSaaSのフロントエンド、社内ツールには最適です。一方、次のような用途には向きません。
- 高負荷のAPI(継続して毎秒50リクエスト超):アカウントごとのCPU上限が効いてきます
- 数千の同時接続があるWebSocket中心のアプリ
- ワーカープロセスをforkするアプリ(キューワーカー、スクレイパー):Passengerのアカウントごとのプロセス数の枠では扱いにくくなります
- systemd、Docker、root権限が必要なもの
こうした用途には、当社のVPSが適しています。root権限があり、カーネルも専用で、何でも動かせます。ただ、膨大なアクセスを受けないほとんどのNext.js・Nuxtアプリなら、このガイドで十分です。
まとめ
- 手元で
npm run build .next/(Next)または.output/(Nuxt)とpackage.json、server.cjsをアップロード- ウェブサイト → Node.jsとPython → Node.jsアプリケーション → フォルダー、起動ファイル
server.cjs、モードは本番 - **依存関係をインストール(npm install)**して、再起動
うまく動かない場合は、お問い合わせください。Passengerのエラーページを貼り付けていただければ、原因の箇所をお伝えします。
— Rivervoチーム