部署在AWS EC2 Ubuntu Nginx的Django Channels WSS连接失败排查

以下是部署在AWS EC2 Docker+Nginx环境下WSS连接失效的常见原因：

• Nginx未配置WebSocket代理规则
  Nginx默认不会处理WebSocket的协议升级请求，必须在对应location块中添加专门的代理配置，否则会将WSS请求当作普通HTTP请求处理，导致连接失败。需要添加的关键配置如下：

  location /ws/ {
      proxy_pass http://localhost:8001; # 对应ASGI服务器的地址和端口
      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Forwarded-Proto $scheme;
  }
  

• Docker端口映射错误

  • ASGI服务器（如Daphne）在容器内通常监听特定端口（如8001），需确保Docker运行时已将该端口映射到EC2主机的对应端口，例如：docker run -p 8001:8001 your-image。
  • 需确认ASGI服务在容器内监听的是0.0.0.0而非localhost，否则EC2主机无法访问容器内的服务。

• AWS网络访问限制

  • EC2安全组需开放对应端口的入站规则：如果Nginx监听443端口（HTTPS/WSS），需允许指定IP段或0.0.0.0/0的443端口入站流量；如果ASGI服务直接暴露端口，也要开放对应端口。
  • 网络ACL需同时允许入站和出站的对应端口流量，避免流量被拦截。

• SSL证书配置问题
  WSS依赖HTTPS，若Nginx的SSL配置存在错误（如证书文件路径不正确、证书过期、域名不匹配），会导致TLS握手失败，进而WSS连接失败。需确保ssl_certificate和ssl_certificate_key指向正确的证书文件。

• Channels核心配置错误

  • settings.py中的CHANNEL_LAYERS配置异常：若使用Redis作为通道层后端，需确认Redis服务可被Channels容器访问（如同一Docker网络、正确的地址和端口）；若使用内存后端，仅适用于单实例部署，多容器场景会失效。
  • ASGI路由配置错误：需确认/ws/chat/room1/路径已正确注册到Channels的路由中，否则请求会返回404，导致连接失败。

• Docker容器间网络连通性问题
  若Channels服务与Redis等依赖服务分属不同Docker容器，需确保它们处于同一个Docker网络中，且容器间能通过服务名或IP正常通信，否则通道层无法正常工作，会导致WSS连接异常。

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