/ /

Driver de Nodo.js

Docs Home

Librerías de clientes

Node.js

Driver de Nodo.js

Docs Home

Librerías de clientes

Node.js

Driver de Nodo.js

Habilitar la compatibilidad con el proxy SOCKS5

Overview

En esta guía, aprenderá a conectarse a instancias de MongoDB mediante un proxy SOCKS5. SOCKS5 es un protocolo estandarizado para conectarse a servicios de red a través de un servidor proxy.

Tip

Para obtener más información sobre el protocolo SOCKS5, consulte la entrada de Wikipedia sobre MEDIAS.

Instalar el paquete de calcetines

A partir de la versión 6.0 del controlador Node.js, debe instalar el socks Paquete para usar la compatibilidad con el proxy SOCKS5 en su aplicación. Puede instalar socks ejecutando el siguiente comando en su shell:

npm i socks

Opciones del cliente SOCKS5

Puede configurar opciones en su instancia MongoClientOptions o en la URI de su conexión para configurar la compatibilidad del proxy SOCKS5 con su conexión. La siguiente tabla describe las opciones de cliente relacionadas con SOCKS5:

Nombre	Valores permitidos	Valor por defecto	Descripción
proxyHost	string	`null`	Especifica la dirección IPv4, la dirección IPv6 o el nombre de dominio del proxy SOCKS5.
proxyPort	non-negative integer	`null`	Especifica el número de puerto TCP del servidor proxy SOCKS5. Si estableces la opción `proxyHost`, el valor de esta opción se establece por defecto en `1080`.
proxyUsername	string	`null`	Especifica el nombre de usuario para la autenticación en el servidor proxy SOCKS5. Si configuras esta opción en una string de longitud cero, el controlador la ignora.
proxyPassword	string	`null`	Especifica la contraseña para la autenticación al servidor proxy SOCKS5. Si configuras esta opción en una string de longitud cero, el controlador la ignora.

Importante

El controlador genera un error si configura las opciones proxyPort, proxyUsername o proxyPassword sin configurar la opción proxyHost.

Ejemplo

Este ejemplo muestra cómo instanciar un MongoClient compatible con el proxy SOCKS5. El siguiente código de ejemplo especifica las opciones del servidor proxy y se conecta a 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);

Tip

El código de ejemplo anterior utiliza marcadores de posición para la URI de conexión y los detalles del servidor proxy. Para ejecutar este código, debe reemplazar estos marcadores de posición con la información de su implementación y servidor proxy.

Información Adicional

Para obtener más información sobre5 la compatibilidad del proxy SOCKS, consulte la especificación SOCKS de MongoDB.5

Documentación de la API

Para obtener más información sobre los métodos y tipos analizados en esta guía, consulte la siguiente documentación de API:

Volver

Protocolo de seguridad TLS

Integración con Mongoose