如何实现 WebSocket 反向代理?（反向代理 session）

off999 2025-03-19 01:02 117 浏览 0 评论

前言

为什么要代理 WebSocket？

是这样的，因为我们有个基于 electron 的桌面应用，他在本地提供 http 和 websocket 两个服务，客户端（浏览器）可以使用这些服务来完成一些核心业务需要。

问题是，目前该应用只支持 windows 平台，虽然生产环境对环境有所要求，但部分开发却是 mac 电脑，无法安装该客户端，总不能要求开发者安装个虚拟机，或者尽快开发个 mac 版，无论硬件还是软件，搭建开发环境的成本都太高。

于是设想在一台 windows 电脑上共享桌面应用服务，在测试环境做请求代理，以便持有 mac 或者安装应用有问题的同学进行无障碍快速接入。

这篇就讲下如何配置 webpack 和 nginx 来完成这样的“小工程”。

架构设计

下图主要示意了如下几个方面：

桌面服务被安装在可用的 windows 机器上
开发环境通过配置 webpack 进行请求转发
对于 mac 平台及不适配的情况，统一通过 nginx 进行请求转发

跨平台 socket 代理策略

webpack-dev-server

项目基于 vue-cli，首先需要对 vue.config.js 中 webpack 的代理部分进行修改。

先设置 VUE_APP_PROXY_URL，定义目标转发环境的（IP）地址，再添加 VUE_APP_PROXY_PLATFORM 决定是否开启转发功能。

# env.local
VUE_APP_PROXY_PLATFORM = mac
VUE_APP_PROXY_URL = 192.168.1.x:81

// vue.config.js
var proxy = {
  // 后端服务
  ['/api']: {
    target: process.env.VUE_PROXY_API,
  },
};

if (VUE_APP_PROXY_PLATFORM == 'mac') {
  proxy = Object.assign(proxy, {
    // 桌面应用 http 服务
    ['/app-api']: {
      target: 'http://' + process.env.VUE_APP_PROXY_URL,
    },
    // 桌面应用 websocket 服务
    ['/app-ws']: {
      target: 'ws://' + process.env.VUE_APP_PROXY_URL,
      ws: true, //开启 websocket 支持
      pathRewrite: {
        '^/app-ws': '/',
      },
    },
  });
}
module.exports = {
  // ...
  devServer: {
    host: '0.0.0.0',
    port: port,
    open: true,
    proxy: proxy,
  },
};

接下来只要在业务代码中，添加对应 /app** 前缀来匹配代理规则即可。

nginx

nginx 端配置简单，只需要对协议进行升级即可：

server {
  listen  81;

  # http 代理
  location /app-api/ {
    proxy_pass http://192.168.1.y:18455/;
  }

  # websocket 代理
  location / {
    proxy_pass http://192.168.1.y:18455/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
  }
}