>운영 및 유지보수 >엔진스 >WebSocket Proxying에 대한 Nginx를 어떻게 구성합니까?

WebSocket Proxying에 대한 Nginx를 어떻게 구성합니까?

Emily Anne Brown
Emily Anne Brown원래의
2025-03-17 17:01:02970검색

WebSocket Proxying에 대한 Nginx를 어떻게 구성합니까?

WebSocket Proxying 용 Nginx를 구성하려면 Nginx가 WebSocket 프로토콜 및 업그레이드 요청을 올바르게 처리 할 수 ​​있는지 확인해야합니다. 다음은이를 설정하는 방법에 대한 단계별 가이드입니다.

  1. nginx 구성 파일 편집 :
    nginx 구성 파일 (일반적으로 /etc/nginx/nginx.conf 에 위치하거나 /etc/nginx/sites-available/ site-specific 구성을 위해).
  2. WebSocket 프록시 설정 추가 :
    WebSocket 지원을 활성화하려는 http 또는 server 블록 내에서 다음 구성 스 니펫을 추가하십시오.

     <code class="nginx">http { ... server { listen 80; server_name example.com; location / { proxy_pass http://your_backend_server; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; proxy_cache_bypass $http_upgrade; } } }</code>
    • proxy_http_version 1.1 nginx가 http/1.1을 사용하여 WebSocket 연결에 필요한 HTTP/1.1을 사용하도록합니다.
    • proxy_set_header Upgrade $http_upgradeproxy_set_header Connection "upgrade" WebSocket 업그레이드 요청을 처리하는 데 중요합니다.
    • proxy_cache_bypass $http_upgrade 는 WebSocket Connections가 캐싱을 우회하도록합니다.
  3. nginx를 테스트하고 다시 시작합니다.
    이러한 변경을 한 후 nginx -t 로 구문 오류 구성을 테스트 한 다음 sudo systemctl reload nginx 또는 sudo systemctl restart nginx .

WebSocket 연결에 필요한 NGINX 설정은 무엇입니까?

Nginx가 WebSocket 연결을 올바르게 처리하려면 NGINX 구성의 location 블록 내에서 다음 설정이 필요합니다.

  • proxy_pass : WebSocket 요청이 프록시 될 백엔드 서버를 지정합니다.
  • proxy_http_version 1.1 : http 프로토콜 버전을 1.1로 설정하여 WebSocket 연결에 필요합니다.
  • proxy_set_header Upgrade $http_upgrade : Upgrade 헤더의 값을 클라이언트에서 백엔드 서버로 전달합니다.
  • proxy_set_header Connection "upgrade" : Connection 헤더를 "업그레이드"로 설정하여 WebSocket 업그레이드 요청을 표시합니다.
  • proxy_set_header Host $host : 호스트 헤더를 클라이언트에서 백엔드 서버로 전달합니다.
  • proxy_cache_bypass $http_upgrade : WebSocket 연결을 캐시하지 않아야하므로 WebSocket Connections를 우회하는지 확인하십시오.

이러한 설정은 WebSocket 연결이 올바르게 처리되고 백엔드 서버로 전달되도록하기 위해 함께 작동합니다.

Nginx가 WebSocket 프로토콜 업그레이드를 올바르게 처리하는 방법은 무엇입니까?

Nginx가 WebSocket 프로토콜 업그레이드를 올바르게 처리하려면 이전 섹션에 설명 된대로 필요한 구성을 구현해야합니다. 다음은 업그레이드가 올바르게 처리되는지 확인하기위한 추가 팁입니다.

  1. 구성 확인 :
    nginx 구성에 필요한 모든 설정, 특히 proxy_set_header Upgrade $http_upgradeproxy_set_header Connection "upgrade" 포함했는지 확인하십시오.
  2. 브라우저 개발자 도구 사용 :
    브라우저에서 웹 응용 프로그램을 열고 브라우저의 개발자 도구를 사용하여 네트워크 요청을 검사하십시오. WebSocket 연결을 찾고 성공적인 업그레이드 응답 (상태 코드 101)을 표시하는지 확인하십시오.
  3. NGINX 로그 모니터링 :
    WebSocket 관련 오류가 없는지 확인하려면 NGINX 액세스 및 오류 로그를 확인하십시오. 로그는 /var/log/nginx/ 에서 찾을 수 있습니다. 성공적인 WebSocket 업그레이드는 오류를 기록하지 않습니다.
  4. WebSocket 클라이언트 도구로 테스트 :
    wscat 또는 websocat 과 같은 명령 줄 도구를 사용하여 WebSocket 연결을 수동으로 시작하고 NGINX를 통해 성공적으로 연결했는지 확인하십시오.
  5. 백엔드 서버 호환성 보장 :
    백엔드 서버 (예 : Node.js, Java 등)가 WebSocket 연결을 처리하고 업그레이드 요청을 올바르게 처리하도록 구성되어 있는지 확인하십시오.

이 단계를 수행하면 NGINX가 WebSocket 프로토콜 업그레이드를 올바르게 처리하고 있는지 확인할 수 있습니다.

Nginx에서 WebSocket Proxying이 실패하면 어떤 문제 해결 단계를 따라야합니까?

Nginx에서 WebSocket Proxying과 관련된 문제가 발생하면 다음과 같은 문제 해결 단계를 수행하십시오.

  1. nginx 구성 확인 :
    WebSocket 프록싱의 구성 설정이 적절한 http , serverlocation 블록에 올바르게 추가되어 있는지 확인하십시오. nginx -t 사용하여 구문 오류 구성을 테스트하십시오.
  2. nginx 로그 검사 :
    WebSocket 관련 오류 또는 문제에 대해 NGINX 액세스 및 오류 로그 ( /var/log/nginx/ )를 검사하십시오. WebSocket 연결 및 업그레이드 요청과 관련된 항목을 찾으십시오.
  3. 백엔드 서버 구성 확인 :
    WebSocket 연결 및 업그레이드 요청을 처리하도록 백엔드 서버가 올바르게 구성되어 있는지 확인하십시오. WebSocket 관련 오류에 대한 백엔드 서버의 로그를 확인하십시오.
  4. 브라우저 개발자 도구 사용 :
    브라우저 개발자 도구를 사용하여 네트워크 요청 및 WebSocket 연결을 검사하십시오. 연결 단계 또는 데이터 전송 중에 오류가 있는지 확인하십시오.
  5. WebSocket 클라이언트 도구로 테스트 :
    wscat 또는 websocat 와 같은 도구를 사용하여 명령 줄에서 직접 WebSocket 연결을 테스트하십시오. 이를 통해 문제가 Nginx 또는 백엔드 서버가 있는지 분리하는 데 도움이 될 수 있습니다.
  6. 방화벽 또는 프록시 문제를 확인하십시오.
    Nginx와 백엔드 서버간에 WebSocket 연결을 차단하는 방화벽이나 프록시가 없거나 클라이언트와 NGINX 사이에 방화벽이나 프록시가 없는지 확인하십시오.
  7. 연결 타이밍 모니터 :
    WebSocket 연결은 설정하는 데 너무 오래 걸리면 실패 할 수 있습니다. 필요한 경우 nginx의 proxy_read_timeoutproxy_send_timeout 을 조정하십시오.
  8. WebSocket 프로토콜 버전 확인 :
    클라이언트와 서버 모두 지원되는 WebSocket 프로토콜 버전을 사용하고 있는지 확인하십시오. 불일치는 연결 고장으로 이어질 수 있습니다.

이러한 문제 해결 단계를 체계적으로 수행함으로써 Nginx에서 WebSocket Proxing의 문제를 식별하고 해결할 수 있어야합니다.

위 내용은 WebSocket Proxying에 대한 Nginx를 어떻게 구성합니까?의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.