本文介绍使用 Express 搭配 http-proxy-middleware 实现高性能、稳定可靠的反向代理，将远程网站（如 GitHub Pages）完整镜像至本地服务，规避手动请求引发的网络错误与响应头丢失问题。
本文介绍使用 express 搭配 `http-proxy-middleware` 实现高性能、稳定可靠的反向代理，将远程网站（如 github pages）完整镜像至本地服务，规避手动请求引发的网络错误与响应头丢失问题。
在 Node.js 中“代理”一个外部网站（例如 https://parking-master.github.io/FPS/）到本地服务（如 http://localhost:8080），本质上不是“爬取+重发”，而是标准的反向代理（Reverse Proxy）。你当前代码中使用 axios.get() 手动发起请求并透传响应，存在多个根本性缺陷：
- ❌ 无法自动继承原始响应的全部 HTTP 头（如 Content-Security-Policy、ETag、Cache-Control、Set-Cookie 等）；
- ❌ 并发请求时触发底层 TCP 连接限制（尤其 IPv6 不可达导致 ENETUNREACH），因 axios 默认未复用连接池或合理设置超时/重试；
- ❌ 无法正确处理重定向（301/302）、分块传输（chunked encoding）、流式响应（如音频、3D 模型 .glb 文件）；
- ❌ 缺乏请求路径重写、Host 头修正、SSL 证书信任等生产级代理必需能力。
✅ 正确方案是采用成熟的反向代理中间件 —— http-proxy-middleware。它基于 node-http-proxy 构建，专为 Express/Koa 等框架设计，完全遵循 HTTP/1.1 协议语义，支持 WebSocket、流式转发、头部自动同步与跨域适配。
✅ 推荐实现（Express + http-proxy-middleware）
npm install express http-proxy-middleware
const express = require('express');
const { createProxyMiddleware } = require('http-proxy-middleware');
const app = express();
const TARGET_URL = 'https://parking-master.github.io/FPS';
// 启用反向代理：所有请求代理至目标站点
app.use(
'/',
createProxyMiddleware({
target: TARGET_URL,
changeOrigin: true, // 修改请求头 Origin 和 Host 为目标域名（必需！）
secure: true, // 验证 HTTPS 证书（GitHub Pages 使用有效证书，设为 true）
followRedirects: true, // 自动跟随 3xx 重定向
autoRewrite: true, // 重写 HTML 中的绝对 URL（可选，增强资源加载鲁棒性）
onProxyReq: (proxyReq, req, res) => {
// 可选：添加自定义请求头（如 User-Agent）
proxyReq.setHeader('X-Forwarded-For', req.ip);
},
onProxyRes: (proxyRes, req, res) => {
// 可选：调试日志
console.log(`[PROXY] ${req.method} ${req.url} → ${proxyRes.statusCode}`);
},
})
);
// 错误处理中间件（捕获代理异常）
app.use((err, req, res, next) => {
console.error('[Proxy Error]', err.message);
res.status(502).send('Bad Gateway: Failed to proxy request.');
});
const PORT = 8080;
app.listen(PORT, () => {
console.log(`✅ Reverse proxy server running at http://localhost:${PORT}`);
console.log(`➡️ Forwarding all requests to ${TARGET_URL}`);
});⚠️ 关键注意事项
- changeOrigin: true 是必须项：否则 GitHub Pages 等虚拟主机（Virtual Host）会因 Host 头不匹配而返回 404 或拒绝连接；
- 避免路径冲突：若需同时提供本地 API 或静态资源，请将代理挂载到特定前缀（如 /proxy/），而非 app.use('/')；
- CORS 与资源加载：代理后浏览器视为同源请求，天然规避 CORS 限制；但原站若含 Content-Security-Policy: origin example.com，仍可能阻断资源——此时需配合 autoRewrite: true 或后端重写响应头；
- IPv6 兼容性问题根源：你的 ENETUNREACH 错误源于系统尝试通过 IPv6 连接 GitHub 的 AAAA 记录失败，而 http-proxy-middleware 内部使用 node-http-proxy，默认启用 IPv6 fallback 并具备更健壮的连接池管理，可显著缓解该问题；
-
生产环境建议：
- 添加 timeout: 10000 和 proxyTimeout: 15000 防止长连接卡死；
- 使用 logLevel: 'warn' 减少日志噪音；
- 若需缓存，应搭配独立缓存层（如 Redis），而非在代理层硬编码。
✅ 验证效果
启动服务后访问 http://localhost:8080/，即可完整加载 https://parking-master.github.io/FPS/ 页面，包括 HTML、CSS、JS、.glb、.mp3 等所有资源，且开发者工具 Network 面板显示状态码、响应头、内容类型均与原站一致。
? 提示：此方案不仅适用于 GitHub Pages，也兼容任何公开 HTTPS 网站（如 https://example.com）。若目标站禁用代理（如检查 X-Forwarded-For），需进一步配置 onProxyReq 清除敏感头字段。
反向代理不是“搬运”，而是“桥梁”。选择成熟中间件，让协议细节交由专家处理，你只需专注业务逻辑与用户体验。
