Django Channels部署HTTPS WebSocket问题排查求助

一、Nginx SSL配置核心问题检查 #

1. 确认WSS反向代理配置完整 #

Nginx必须添加WebSocket协议升级指令，否则无法建立WSS连接，对比你的配置是否缺失以下关键内容：

location /ws/ {
    # 转发到Daphne容器的WS服务地址（需与Docker Compose中服务名一致）
    proxy_pass http://daphne:8001;

    # WebSocket协议升级必备配置
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";

    # 传递HTTPS环境标识，让Django识别请求协议
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;

    # 延长超时时间避免连接过早断开
    proxy_connect_timeout 7d;
    proxy_send_timeout 7d;
    proxy_read_timeout 7d;
}

• 注意/ws/前缀要和Django Channels路由的前缀完全匹配
• proxy_pass要使用Docker服务名而非主机IP，确保容器间网络互通

2. 验证SSL证书配置有效性 #

检查Nginx是否能正确加载证书，配置示例如下：

server {
    listen 443 ssl;
    server_name pypilot.app;

    # 证书路径需对应Nginx容器内的挂载路径
    ssl_certificate /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;

    # 启用安全的SSL协议版本
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
}

• 查看Nginx容器日志（docker logs nginx），如果出现SSL_CTX_use_PrivateKey_file类错误，说明证书路径错误或权限不足
• 必须使用包含中间证书的fullchain.pem，而非单独的域名证书

3. 避免HTTP重定向干扰WS连接 #

如果配置了HTTP转HTTPS跳转，需单独放行WS请求：

server {
    listen 80;
    server_name pypilot.app;

    location / {
        return 301 https://$host$request_uri;
    }
    # 直接转发HTTP的WS请求，不跳转HTTPS
    location /ws/ {
        proxy_pass http://daphne:8001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

二、Docker Compose配置常见问题排查 #

1. 确保服务在同一网络 #

Docker Compose默认创建专属网络，但需明确配置：

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d
      - ./ssl:/etc/nginx/ssl  # 挂载本地证书目录到容器
    depends_on:
      - daphne
    networks:
      - app-network

  daphne:
    build: .
    # 必须绑定0.0.0.0，否则容器外无法访问
    command: daphne -b 0.0.0.0 -p 8001 pypilot.asgi:application
    volumes:
      - .:/code
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

• 不要在Daphne命令中添加SSL参数，Nginx已完成SSL终止，Daphne只需处理HTTP协议的WS请求

2. 验证容器间连通性 #

在Nginx容器内执行curl http://daphne:8001/ws/，如果返回WebSocket connection expected，说明Daphne服务正常且网络连通；如果超时，检查网络配置或Daphne启动状态

三、Django Settings必要配置 #

1. 配置HTTPS信任源 #

ALLOWED_HOSTS = ['pypilot.app', '你的主机IP']
CSRF_TRUSTED_ORIGINS = ['https://pypilot.app']
# 让Django识别Nginx转发的HTTPS请求
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')

2. Channels通道层配置确认 #

CHANNEL_LAYERS = {
    'default': {
        'BACKEND': 'channels_redis.core.RedisChannelLayer',
        'CONFIG': {
            "hosts": [('redis', 6379)],
        },
    },
}

• 确保Redis服务在Docker网络内可访问，否则Daphne无法处理WebSocket消息

四、快速定位问题的步骤 #

1. 查看浏览器控制台错误：ERR_SSL_PROTOCOL_ERROR指向Nginx SSL配置；502 Bad Gateway指向Daphne服务或网络问题；403 Forbidden检查CSRF或ALLOWED_HOSTS
2. 查看容器日志：docker logs nginx和docker logs daphne获取具体错误信息
3. 用wscat测试连接：wscat -w 0 -c wss://pypilot.app/ws/，根据返回信息定位问题

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