XserverにNode.jsを導入する方法

JavaScript

2022.01.022026.04.20

結論：そのままでは動かないので「構造を変えて無理やり動かす」
全体構成：擬似的にExpressを動かす仕組み
1. 仕組みのイメージ
Step1：Node.js環境は事前に構築済みである前提
Step2：Expressアプリを作る（ただし書き換える）
1. 通常のExpress（これは使えない）
2. CGI対応に書き換える
Step3：CGIとして動かす
1. CGIファイルを作る
2. 実行権限を付ける
Step4：.htaccessでCGIを有効化
Step5：ブラウザでアクセス
Step6：Expressっぽくする（ここが応用）
1. 実はExpressはそのまま使えない
2. 疑似Expressの作り方
深堀り：なぜこの方法はおすすめしないのか
現実的な代替案（重要）
1. VPSを使う
まとめ：この技術の本質

結論：そのままでは動かないので「構造を変えて無理やり動かす」

まず最初に現実をはっきりさせます。

Expressは本来「常駐サーバー」です。
つまりポートを開いて待ち受ける設計です。

一方でXserverは

常駐プロセス禁止
ポート開放不可

という制約があります。

この時点で「普通のExpress」は動きません。

ではどうするか。

「リクエストごとに起動 → 処理 → 終了」というCGI的な動かし方に変換します。

ここが最大のポイントです。

全体構成：擬似的にExpressを動かす仕組み

仕組みのイメージ

通常のExpress

ブラウザ → Nodeサーバー（常駐） → レスポンス

Xserverでの強引な構成

ブラウザ → Apache（Xserver） → CGI起動 → Node実行 → レスポンス

つまり「Nodeを毎回起動する」形にします。

この時点で分かる重要な事実があります。

パフォーマンスは悪い
リアルタイム処理は不向き

用途は限定されます。

Step1：Node.js環境は事前に構築済みである前提

これは前段階です。まだならここで止まります。

Nodeが動くこと

node -v

npmが動くこと

npm -v

ここが通らないなら先に環境構築が必要です。

Step2：Expressアプリを作る（ただし書き換える）

通常のExpress（これは使えない）

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello Express');
});

app.listen(3000);

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello Express');
});

app.listen(3000);

JavaScript

この listen() がアウトです。

CGI対応に書き換える

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello from Node CGI');
});

server.emit('request', {
  url: '/',
  method: 'GET'
}, {
  writeHead: (code, headers) => {
    console.log(`Status: ${code}`);
    for (let key in headers) {
      console.log(`${key}: ${headers[key]}`);
    }
    console.log('');
  },
  end: (body) => {
    console.log(body);
  }
});

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello from Node CGI');
});

server.emit('request', {
  url: '/',
  method: 'GET'
}, {
  writeHead: (code, headers) => {
    console.log(`Status: ${code}`);
    for (let key in headers) {
      console.log(`${key}: ${headers[key]}`);
    }
    console.log('');
  },
  end: (body) => {
    console.log(body);
  }
});

JavaScript

ここでやっていることは重要です。

HTTPレスポンスを「標準出力」に書き出しているだけです。

CGIは「標準出力＝レスポンス」だからです。

Step3：CGIとして動かす

CGIファイルを作る

nano index.cgi

#!/usr/bin/env node

その下にNodeコードを書きます。

重要なのは1行目です。これがないと動きません。

実行権限を付ける

chmod 755 index.cgi

ここは絶対に必要です。

Step4：.htaccessでCGIを有効化

Options +ExecCGI
AddHandler cgi-script .cgi

Options +ExecCGI
AddHandler cgi-script .cgi

Apache

これで .cgi が実行されます。

Step5：ブラウザでアクセス

https://あなたのドメイン/index.cgi

これで表示されれば成功です。

Step6：Expressっぽくする（ここが応用）

実はExpressはそのまま使えない

理由は単純です。

Expressは内部でサーバーを立てる前提だからです。

つまり

app.listen() に依存している

ここを回避しないといけません。

疑似Expressの作り方

軽量ルーターを自作します。

const url = require('url');

const routes = {
  '/': () => 'Home',
  '/about': () => 'About Page'
};

const path = url.parse(process.env.REQUEST_URI).pathname;

console.log('Content-Type: text/plain\n');

if (routes[path]) {
  console.log(routes[path]());
} else {
  console.log('404 Not Found');
}

const url = require('url');

const routes = {
  '/': () => 'Home',
  '/about': () => 'About Page'
};

const path = url.parse(process.env.REQUEST_URI).pathname;

console.log('Content-Type: text/plain\n');

if (routes[path]) {
  console.log(routes[path]());
} else {
  console.log('404 Not Found');
}