【保存版】Node.js、Express、Proxyで実現するプロキシサーバーの応用例

2024-05-17

Node.js、Express、Proxy を用いたプロキシサーバーの構築

本記事では、Node.js フレームワークである Express を用いて、シンプルなプロキシサーバーを構築する方法について解説します。

プロキシサーバーは、クライアントとターゲットサーバー間の仲介役として機能するサーバーです。クライアントがプロキシサーバーにリクエストを送信すると、プロキシサーバーはターゲットサーバーから本来のリソースを取得し、クライアントに返します。

Express でプロキシサーバーを構築する利点

シンプルで軽量な実装が可能
リクエストとレスポンスを柔軟に制御できる
認証やキャッシュなどの機能を追加しやすい

必要なもの

Node.js
Express

手順

プロジェクトの初期化

npm init -y
npm install express express-http-proxy

サーバーの作成

const express = require('express');
const proxy = require('express-http-proxy');

const app = express();
const PORT = 3000;

// ターゲットサーバーの設定
const target = 'https://www.example.com';

// プロキシミドルウェアの設定
app.use('/api', proxy({ target }));

// サーバーの起動
app.listen(PORT, () => {
  console.log(`Server listening on port ${PORT}`);
});

実行

node index.js

上記コードを実行すると、ポート3000でプロキシサーバーが起動します。ブラウザで http://localhost:3000/api/path/to/resource にアクセスすると、プロキシサーバーが https://www.example.com/path/to/resource からリソースを取得し、ブラウザに返します。

応用例

API アクセスの制限: 特定のAPIへのアクセスを制限したり、認証を必要とするように設定できます。
コンテンツのキャッシュ: 静的コンテンツをキャッシュすることで、パフォーマンスを向上させることができます。
レスポンスの改変: レスポンスヘッダーを書き換えたり、本文を加工したりすることができます。

補足

上記はあくまで基本的な例です。実際の運用には、エラーハンドリングやセキュリティ対策などの考慮が必要となります。
より高度なプロキシ機能を実現するには、他のライブラリやモジュールを組み合わせて利用することもできます。

const express = require('express');
const proxy = require('express-http-proxy');

const app = express();
const PORT = 3000;

// ターゲットサーバーの設定
const target = 'https://jsonplaceholder.typicode.com';

// プロキシミドルウェアの設定
app.use('/api', proxy({ target }));

// サーバーの起動
app.listen(PORT, () => {
  console.log(`Server listening on port ${PORT}`);
});

解説

モジュールのインポート: 最初に必要なモジュールである express と express-http-proxy をインポートします。
Express アプリの作成: express() 関数を使用して、Express アプリケーションインスタンスを作成します。
ポートの設定: PORT 変数に、サーバーを起動するポート番号を設定します。
ターゲットサーバーの設定: target 変数に、プロキシサーバーがリクエストを転送するターゲットサーバーのURLを設定します。
プロキシミドルウェアの設定: app.use('/api', proxy({ target })) 行で、 /api パス以下にアクセスされたリクエストに対して、express-http-proxy ミドルウェアを適用します。このミドルウェアは、リクエストを target で指定されたターゲットサーバーに転送します。
サーバーの起動: app.listen(PORT, () => { ... }) 行で、Express アプリケーションを指定したポートで起動します。

実行方法

上記コードを index.js ファイルなどに保存し、以下のコマンドを実行することでサーバーを起動できます。

node index.js

ブラウザで http://localhost:3000/api/posts/1 にアクセスすると、JSON Placeholder API から取得したデータが返却されます。

このサンプルコードをベースに、以下の機能を追加することができます。

認証: 特定のAPIへのアクセスに認証を必要とする
エラーハンドリング: エラーが発生した場合の処理を記述する

これらの機能を追加することで、より高度なプロキシサーバーを構築することができます。

Node.js、Express、Proxyを用いたプロキシサーバー構築のその他の方法

特定のパスのみをプロキシする

express-http-proxy は、特定のパスのみをプロキシするように設定することができます。例えば、以下のコードは /api 以下のパスのみを https://jsonplaceholder.typicode.com にプロキシします。

app.use('/api', proxy({ target: 'https://jsonplaceholder.typicode.com' }));

express-http-proxy は、リクエストとレスポンスをカスタマイズするためのオプションを提供しています。例えば、以下のコードは、リクエストヘッダーに Authorization ヘッダーを追加します。

app.use('/api', proxy({
  target: 'https://jsonplaceholder.typicode.com',
  changeOrigin: true,
  proxyHeaders: {
    Authorization: 'Bearer YOUR_TOKEN',
  },
}));

エラーハンドリング

express-http-proxy は、エラーが発生した場合の処理を記述するためのオプションを提供しています。例えば、以下のコードは、エラーが発生した場合にログを出力します。

app.use('/api', proxy({
  target: 'https://jsonplaceholder.typicode.com',
  onError: (err, req, res) => {
    console.error(err);
    res.status(500).send('An error occurred');
  },
}));

認証

express-http-proxy を他の認証ミドルウェアと組み合わせて、特定のAPIへのアクセスに認証を必要とするようにすることができます。例えば、以下のコードは、Basic 認証を使用する認証ミドルウェアを追加します。

const basicAuth = require('express-basic-auth');

app.use('/api', basicAuth({
  users: {
    'user': 'password',
  },
}));

app.use('/api', proxy({ target: 'https://jsonplaceholder.typicode.com' }));

キャッシュ

const expressMemoryCache = require('express-memory-cache');

app.use('/api', expressMemoryCache({
  maxAge: 60 * 60, // 1時間
}));

app.use('/api', proxy({ target: 'https://jsonplaceholder.typicode.com' }));

上記以外にも、様々な方法でNode.js、Express、Proxyを用いたプロキシサーバーを構築することができます。詳細は、各ライブラリのドキュメントを参照してください。

これらの方法を参考に、ニーズに合ったプロキシサーバーを構築してください。

node.js proxy express