SOCKS5 프록시 지원 활성화
개요
이 가이드에서는 SOCKS5 프록시를 사용하여 MongoDB 인스턴스에 연결하는 방법에 대해 설명합니다. SOCKS5는 프록시 서버를 통해 네트워크 서비스에 연결하기 위한 표준화된 프로토콜입니다.
팁
SOCKS 프로토콜 에 학습 보려면5 SOCKS에 대한 Wikipedia 항목을 참조하세요.
SOCKS 패키지 설치
Node.js 드라이버 버전 6.0부터 애플리케이션에서 SOCKS5 프록시 지원을 사용하려면 socks 패키지를 설치해야 합니다. 셸에서 다음 명령을 실행하여 socks를 설치할 수 있습니다.
npm i socks
SOCKS5 클라이언트 옵션
MongoClientOptions 인스턴스 또는 연결 URI에서 옵션을 설정하여 연결에 대한 SOCKS5 프록시 지원을 구성할 수 있습니다. 다음 표에서는 SOCKS5와 관련된 클라이언트 옵션에 대해 설명합니다.
이름 | 허용되는 값 | 기본값 | 설명 |
|---|---|---|---|
proxyHost | 문자열 | null | SOCKS5 프록시 IPv4 주소, IPv6 주소 또는 도메인 이름을 지정합니다. |
proxyPort | non-negative integer | null | SOCKS5 프록시 서버의 TCP 포트 번호를 지정합니다. proxyHost 옵션을 설정하면 이 옵션의 기본값은 1080(으)로 설정됩니다. |
proxyUsername | 문자열 | null | SOCKS5 프록시 서버에 인증할 사용자 이름을 지정합니다. 이 옵션을 길이가 0인 문자열로 설정하면 드라이버는 이를 무시합니다. |
proxyPassword | 문자열 | null | SOCKS5 프록시 서버에 대한 인증을 위한 비밀번호를 지정합니다. 이 옵션을 길이가 0인 문자열로 설정하면 드라이버는 이를 무시합니다. |
중요
proxyHost 옵션을 설정하지 않고 proxyPort, proxyUsername 또는 proxyPassword 옵션을 설정하면 드라이버에서 오류가 발생합니다.
예시
이 예에서는 SOCKS5 프록시 지원을 사용하는 MongoClient를 인스턴스화하는 방법을 보여 줍니다. 다음 예시 코드는 프록시 서버 옵션을 지정하고 MongoDB에 연결하는 코드입니다.
// Replace the placeholder with your connection string const uri = "<connection string uri>"; // Replace the placeholders with your SOCKS5 proxy server details const socksOptions = { proxyHost: "<host>", proxyPort: 1080, proxyUsername: "<username>", proxyPassword: "<password>", }; // Create a new client with the proxy server details const client = new MongoClient(uri, socksOptions);
팁
앞의 샘플 코드에서는 연결 URI 및 프록시 서버 세부 정보에 자리 표시자를 사용합니다. 이 코드를 실행하려면 이러한 자리 표시자를 배포 및 프록시 서버에 대한 정보로 바꿔야 합니다.
추가 정보
SOCKS5 프록시 지원에 대한 자세한 내용은 MongoDB SOCKS5 사양을 참조하세요.
API 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 문서를 참조하세요.