SOCKS5 프록시 지원 사용
개요
이 가이드에서는 SOCKS5 프록시를 사용하여 MongoDB 인스턴스에 연결하는 방법에 대해 설명합니다. SOCKS5는 프록시 서버를 통해 네트워크 서비스에 연결하기 위한 표준화된 프로토콜입니다.
팁
SOCKS5 프로토콜에 대해 자세히 알아보려면 SOCKS에 대한 Wikipedia 항목을 참조하세요.
SOCKS 패키지 설치
Node.js 드라이버 버전 6.0부터 애플리케이션에서 SOCKS5 프록시 지원을 사용하려면 socks 패키지를 설치해야 합니다. 셸에서 다음 명령을 실행하여 socks를 설치할 수 있습니다.
npm i socks
SOCKS5 클라이언트 옵션
MongoClientOptions 인스턴스 또는 연결 URI에서 옵션을 설정하여 연결에 대한 SOCKS5 프록시 지원을 구성할 수 있습니다. 다음 표에서는 SOCKS5와 관련된 클라이언트 옵션에 대해 설명합니다.
이름 | 허용되는 값 | 기본값 | 설명 |
|---|---|---|---|
proxyHost | 문자열 | null | SOCKS5 프록시 IPv4 주소, IPv6 주소 또는 도메인 이름을 지정합니다. |
proxyPort | 음수가 아닌 정수 | 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 문서를 참조하세요.