Node-HTTP-Proxy 开源项目教程

项目介绍

Node-HTTP-Proxy 是一个功能全面的 HTTP 代理库，适用于 Node.js。它支持正向代理和反向代理，适用于多种场景，如负载均衡、API 请求转发等。该项目由 http-party 维护，是一个活跃的开源项目，拥有广泛的社区支持和丰富的文档资源。

项目快速启动

安装

首先，确保你已经安装了 Node.js 和 npm。然后，通过 npm 安装 node-http-proxy：

npm install http-proxy

基本使用

以下是一个简单的示例，展示如何创建一个基本的 HTTP 代理服务器：

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

// 创建代理服务器
const proxy = httpProxy.createProxyServer({});

// 创建 HTTP 服务器
http.createServer(function(req, res) {
  // 将请求代理到目标服务器
  proxy.web(req, res, { target: 'http://localhost:8080' });
}).listen(3000, () => {
  console.log('代理服务器运行在 http://localhost:3000/');
});

应用案例和最佳实践

负载均衡

Node-HTTP-Proxy 可以用于实现简单的负载均衡。以下是一个示例，展示如何将请求分发到多个后端服务器：

const servers = [
  'http://localhost:8081',
  'http://localhost:8082',
  'http://localhost:8083'
];

let current = 0;

http.createServer((req, res) => {
  proxy.web(req, res, { target: servers[current] });
  current = (current + 1) % servers.length;
}).listen(3000);

API 网关

Node-HTTP-Proxy 也可以用作 API 网关，将不同的请求路由到不同的后端服务：

http.createServer((req, res) => {
  if (req.url.startsWith('/api/v1')) {
    proxy.web(req, res, { target: 'http://localhost:8081' });
  } else if (req.url.startsWith('/api/v2')) {
    proxy.web(req, res, { target: 'http://localhost:8082' });
  } else {
    res.writeHead(404);
    res.end();
  }
}).listen(3000);

典型生态项目

Express 集成

Node-HTTP-Proxy 可以与 Express 框架集成，提供更高级的路由和中间件功能：

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

const app = express();

app.use('/api', (req, res) => {
  proxy.web(req, res, { target: 'http://localhost:8080' });
});

app.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000/');
});

WebSocket 支持

Node-HTTP-Proxy 也支持 WebSocket 代理：

const WebSocket = require('ws');
const httpProxy = require('http-proxy');

const proxy = httpProxy.createProxyServer({});

const wss = new WebSocket.Server({ port: 3000 });

wss.on('connection', (ws) => {
  ws.on('message', (message) => {
    proxy.ws(ws, { target: 'ws://localhost:8080' });
  });
});

通过这些示例和最佳实践，你可以充分利用 Node-HTTP-Proxy 的功能，构建强大的代理服务器和 API 网关。