Socket.io搭配HTTPS（Let's Encrypt）无法连接问题求助

看起来你遇到的核心问题是Socket.io服务器的HTTPS配置不完整，再加上Nginx反向代理下的WebSocket转发规则缺失，以及防火墙的端口限制，导致切换HTTPS后无法建立连接。下面是一步步的修复方案：

1. 完善Socket.io服务器的HTTPS证书配置 #

你当前的服务器代码只是创建了HTTPS服务器实例，但没有传入Let's Encrypt的证书和密钥，这会导致服务器无法正常提供合法的HTTPS服务。修改你的Node.js代码如下：

const express = require('express');
const https = require('https');
const fs = require('fs');
const socketIo = require('socket.io');

const app = express();

// 加载Let's Encrypt颁发的证书和私钥（替换成你的域名对应路径）
const sslOptions = {
  key: fs.readFileSync('/etc/letsencrypt/live/www.example.com.br/privkey.pem'),
  cert: fs.readFileSync('/etc/letsencrypt/live/www.example.com.br/fullchain.pem')
};

// 用SSL配置创建HTTPS服务器
const httpsServer = https.createServer(sslOptions, app);
const io = socketIo(httpsServer);

// 测试连接事件（可选，用于验证连接状态）
io.on('connection', (socket) => {
  console.log(`用户已连接: ${socket.id}`);
  socket.on('disconnect', () => {
    console.log(`用户已断开: ${socket.id}`);
  });
});

httpsServer.listen(3009, () => {
  console.log('Socket.io HTTPS服务器监听端口3009');
});

注意：确保Node.js进程有权限读取证书文件，可以用sudo chmod -R 755 /etc/letsencrypt/live/临时授权，或者调整文件所属组避免权限问题。

2. 配置Nginx支持WebSocket转发 #

Nginx默认不会处理WebSocket的Upgrade请求，需要在你的站点配置中添加相关规则，确保Socket.io的连接能正确转发到后端的Node.js服务器。修改Nginx的server块配置：

server {
    listen 443 ssl;
    server_name www.example.com.br;

    # Let's Encrypt证书配置
    ssl_certificate /etc/letsencrypt/live/www.example.com.br/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/www.example.com.br/privkey.pem;

    # 转发ASP.NET Core应用的请求（假设Kestrel监听5000端口）
    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection keep-alive;
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # 专门转发Socket.io的请求
    location /socket.io/ {
        proxy_pass https://localhost:3009;
        proxy_http_version 1.1;
        # 关键：处理WebSocket升级请求
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

配置完成后，重启Nginx生效：

sudo systemctl restart nginx

3. 检查UFW防火墙规则 #

• 如果你的客户端是通过Nginx转发访问Socket.io（即客户端用https://www.example.com.br而非带端口的地址），只需要确保443端口开放：

  sudo ufw allow 443/tcp
  sudo ufw reload
  

• 如果需要直接访问3009端口（不推荐，暴露后端端口不安全），则需要开放该端口：

  sudo ufw allow 3009/tcp
  sudo ufw reload
  

4. 优化客户端Socket.io配置 #

如果用Nginx转发，客户端不需要指定端口，并且建议只在测试阶段使用rejectUnauthorized: false（正式环境要确保证书有效，去掉这个配置）：

myIo = io('https://www.example.com.br', {
  reconnect: true,
  // 仅当证书临时有问题时保留，正式环境删除
  rejectUnauthorized: false
});

完成以上步骤后，重启你的Node.js服务器和ASP.NET Core应用，应该就能正常建立HTTPS下的Socket.io连接了。

内容的提问来源于stack exchange，提问作者notExactlyAHero