Express代理服务器HTTPS访问失败问题排查求助

核心问题分析 #

• 当前Express使用app.listen()启动的是HTTP服务器，无法处理HTTPS请求，这是访问https://时出现ERR_SSL_PROTOCOL_ERROR的直接原因。
• 代理配置中的ssl字段是用于代理向目标服务器发起请求时的客户端证书，而非当前代理服务器对外提供HTTPS服务的证书。

解决步骤 #

1. 将Express服务器切换为HTTPS服务 #

替换原app.listen代码，使用Node.js内置https模块创建HTTPS服务器：

const fs = require('fs');
const express = require('express');
const morgan = require('morgan');
const https = require('https'); // 新增HTTPS模块引入
const { createProxyMiddleware } = require('http-proxy-middleware');

const Host = '0.0.0.0';
const Port = 3000;
const TargetBaseURL = 'https://myaddressgoeshere.com/';

// 读取证书时不要加utf8编码，证书为二进制格式
const sslKey = fs.readFileSync('ssl/key.pem');
const sslCert = fs.readFileSync('ssl/cert.pem');

const app = express();

app.use(morgan('dev'));

app.use('/proxy', createProxyMiddleware({
    target: TargetBaseURL,
    changeOrigin: true,
    pathRewrite: {
        [`^/proxy`]: '',
    },
    secure: true, // 验证目标服务器SSL证书，若目标为自签名可设为false
    // 移除此处ssl配置，仅当目标服务器要求客户端证书时才需配置
}));

// 用HTTPS服务器替代原HTTP启动方式
https.createServer({ key: sslKey, cert: sslCert }, app).listen(Port, Host, () => {
    console.log(`Starting HTTPS Proxy at https://${Host}:${Port}`);
});

2. 修正自签名证书生成流程 #

原命令生成的key.pem带文本格式注释，易导致解析错误，改用以下命令生成纯净PEM格式密钥：

C:
cd "C:\Program Files\Git\usr\bin"
# 生成2048位私钥
openssl genrsa -out key.pem 2048
# 生成证书签名请求
openssl req -new -key key.pem -out cert.csr
# 生成有效期10年的自签名证书
openssl x509 -req -days 3650 -in cert.csr -signkey key.pem -out cert.pem

生成后直接将key.pem和cert.pem放入项目/ssl文件夹即可，无需额外转换。

3. 处理目标服务器CSP限制 #

原HTTP代理访问时的CSP错误，是因为目标服务器要求页面通过HTTPS加载。切换为HTTPS代理后，访问https://proxyaddress:3000/proxy/login即可满足CSP的HTTPS要求。

4. 排查SSL协议版本问题 #

若仍出现tlsv1 alert protocol version错误，需确认目标服务器支持的TLS版本（建议TLS 1.2+），并在代理配置中指定允许的版本：

const https = require('https');

// 在代理配置中添加agent字段指定TLS版本
app.use('/proxy', createProxyMiddleware({
    // 其他配置...
    agent: new https.Agent({
        minVersion: 'TLSv1.2',
        maxVersion: 'TLSv1.3'
    })
}));

验证步骤 #

1. 重启代理服务器
2. 访问https://proxyaddress:3000/proxy/login，开发环境下手动信任自签名证书
3. 检查请求是否正常转发至目标服务器

内容的提问来源于stack exchange，提问作者eat-sleep-code