今すぐ始める
すべての記事チュートリアル · 2 分で読めます

Node.jsアプリをRivervoのレンタルサーバーにデプロイする(Next.js・Nuxt)

RT
Rivervo Team · Rivervo
·
2026年4月29日
·
更新日 2026年11月13日
Node
ON SHARED HOSTING

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 app

package.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アプリなら、このガイドで十分です。

まとめ

  1. 手元でnpm run build
  2. .next/(Next)または.output/(Nuxt)とpackage.json、server.cjsをアップロード
  3. ウェブサイト → Node.jsとPython → Node.jsアプリケーション → フォルダー、起動ファイルserver.cjs、モードは本番
  4. **依存関係をインストール(npm install)**して、再起動

うまく動かない場合は、お問い合わせください。Passengerのエラーページを貼り付けていただければ、原因の箇所をお伝えします。

— Rivervoチーム