ASP.NET Core WebSocket远程服务器部署及客户端连接问题咨询

一、远程服务器部署WebSocket服务 #

1. 准备远程服务器 #

选一台云服务器（基础配置实例即可），系统推荐Ubuntu或CentOS。核心要开放WebSocket服务使用的端口：

• 在云服务商的安全组控制台，添加入站规则，允许目标端口（比如你本地用的8080）的TCP流量
• 服务器系统防火墙也要放行端口：Ubuntu下执行ufw allow 8080；CentOS下执行firewall-cmd --permanent --add-port=8080/tcp && firewall-cmd --reload

2. 上传代码到服务器 #

把本地的WebSocket服务器代码传到远程服务器，常用两种方式：

• 用scp命令直接传输：scp -r ./your-ws-server root@[服务器公网IP]:/home/
• 如果代码托管在Git仓库，直接在服务器上克隆：git clone https://your-repo-url.git

3. 安装依赖并启动服务 #

以Node.js为例（其他语言逻辑类似）：

• 安装Node.js和npm：Ubuntu下apt update && apt install nodejs npm -y
• 进入项目目录，安装依赖：cd /home/your-ws-server && npm install
• 后台运行服务（避免SSH断开后服务终止）：
  • 安装进程管理器pm2：npm install -g pm2
  • 启动服务：pm2 start server.js --name ws-server
  • 验证服务状态：pm2 status，显示online即为正常

4. 本地测试服务器连通性 #

在本地终端用wscat（先装npm install -g wscat）测试：wscat -c ws://[服务器公网IP]:8080，能收到服务器响应就说明部署成功。

二、客户端配置远程连接 #

1. 修改连接地址 #

把本地代码里的ws://localhost:8080替换为远程服务器的公网IP或域名，示例：

// 客户端连接代码
const socket = new WebSocket('ws://[服务器公网IP]:8080');
// 用域名的话：new WebSocket('ws://your-domain.com:8080');

2. 处理跨域问题 #

如果客户端是网页应用，且部署在和WebSocket服务器不同的域名下，需要在服务器端配置跨域允许：

• Node.js的ws库可以在创建服务器时添加CORS配置：

const WebSocket = require('ws');
const wss = new WebSocket.Server({
  port: 8080,
  cors: {
    origin: 'https://your-client-domain.com' // 生产环境指定具体域名，别用*
  }
});

3. 验证客户端连接 #

部署客户端后，打开浏览器控制台，查看Network面板的WS选项，如果连接状态显示OPEN，且能正常收发消息，就说明连接成功。

三、常见问题排查 #

• 端口未开放：检查云安全组和服务器防火墙的规则，确保目标端口的TCP入站流量被允许
• 服务意外终止：用pm2 logs ws-server查看日志，排查代码错误或依赖问题
• 连接超时：确认服务器公网IP是否正确，域名是否已解析到对应IP
• 生产环境加密连接：如果要使用wss（加密WebSocket），需要配置SSL证书（比如Let's Encrypt免费证书），客户端连接地址改为wss://your-domain.com（默认443端口，无需额外指定）

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