¿Ya eres cliente de NinjaOne? Inicia sesión para ver más guías y las últimas actualizaciones.

Agente Ninja: Configuración para uso en servidor proxy

  • Última actualización 29 de junio de 2026

Tema

En este artículo se explica cómo configurar el agente NinjaOne para su uso a través de un servidor proxy. 

Entorno

NinjaOne Endpoint Management

Descripción

Un servidor proxy reenvía el tráfico de red entre un dispositivo e Internet. Las organizaciones suelen utilizar un proxy para controlar, filtrar o supervisar el tráfico.

Debe configurar los ajustes de proxy en los siguientes casos:

  • El agente NinjaOne no tiene configurados los ajustes de proxy.
  • El agente NinjaOne ya tiene configurados ajustes de proxy incorrectos.

Consulte NinjaOne: Funcionalidad compatible a través de un servidor proxy para obtener información sobre qué funcionalidades son compatibles a través de un proxy

Índice

Detección automática de proxy para Windows

  • La implementación simplificada del agente elimina la configuración manual y la creación de scripts personalizados en redes complejas. Esta automatización reduce el tiempo de incorporación de las flotas de TI y permite a los MSP gestionar entornos únicos a gran escala.
  • Cuando un agente se ejecuta en un sistema operativo Windows que admite una configuración de proxy nativa, el agente detectará y utilizará la configuración nativa para la conectividad, de modo que ya no es necesaria la configuración manual del agente.
  • Cuando el agente no pueda conectarse a través de la configuración de proxy detectada automáticamente, se conectará directamente al servidor de NinjaOne, de modo que los agentes puedan permanecer conectados al panel de control.

Para habilitar esta función, añada un nuevo valor DWORD al registro de Windows:

[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeNinjaRMM LLCNinjaRMMAgentServer] ProxyAutoDiscovery = 1

ProxyAuto1.png

Para desactivar esta función, elimine el valor o establézcalo en 0.

Si el agente RMM de NinjaOne no tiene configurados los ajustes de proxy

En este caso, ha creado una organización para un nuevo cliente y necesita añadir la configuración de proxy a los agentes NinjaOne RMM para que estos apunten al servidor proxy.

Solución solo para el sistema operativo Windows

Añada las siguientes claves de registro a cada dispositivo.

Nota importante: La ruta varía en función de la arquitectura del dispositivo (32 bits, 64 bits)

Dispositivo de 32 bits:

[HKEY_LOCAL_MACHINESOFTWARENinjaRMM LLCNinjaRMMAgentServer]

Dispositivo de 64 bits:

[HKEY_LOCAL_MACHINESOFTWAREWow6432NodeNinjaRMM LLCNinjaRMMAgentServer]

Ejemplo: 

  • «ProxyHost» = «192.168.32.144»(ProxyHost debe ser un valor de cadena)
  • "ProxyPort" = dword:00000c38 (ProxyPort debe ser un DWORD (32 bits))

opcional:

  • "ProxyAuthName" = "SomeUserName"
  • «ProxyAuthPassword» = «aPassword»

Solución para todos los sistemas operativos

Las solicitudes del proxy preguntarán por el tipo, el host y el puerto. El nombre de usuario y la contraseña son opcionales.

Ejecute el siguiente comando desde la carpeta del agente de NinjaOne:

Windows:

.NinjaRMMAgent.exe /setproxy  -host [IP] -port [PORT] -user [USER] -password [PASSWORD]
Nota importante: Estos parámetros le permitirán implementar la configuración del proxy de forma silenciosa y masiva. Puede ejecutar este comando desde un script personalizado dentro de NinjaOne.

Ejemplo:

.NinjaRMMAgent.exe /setproxy -host 127.0.0.1 -port 80 -user root -password helloworld

Linux:

./ninjarmm-linagent -set-proxy

Mac:

./ninjarmm-macagent -set-proxy

Para que se apliquen los nuevos ajustes de proxy, es necesario reiniciar el servicio NinjaOne. Siga las instrucciones de este artículo para reiniciar el agente desde un script personalizado.

Si el agente de NinjaOne ya tiene configurados los ajustes de proxy

En este caso, debe eliminar o cambiar la configuración de proxy del agente de NinjaOne.

Solución solo para el sistema operativo Windows

Siga los pasos anteriores para modificar las claves del Registro de cada dispositivo.

Para que se apliquen los nuevos ajustes de proxy, es necesario reiniciar el servicio NinjaOne. Siga las instrucciones de este artículo para reiniciar el agente desde un script personalizado.

La contraseña del proxy se oculta automáticamente tras el primer inicio de sesión correcto con esta contraseña.

Solución para todos los sistemas operativos

Ejecute el siguiente comando desde la carpeta del agente de NinjaOne: 

Windows:

 .NinjaRMMAgent.exe /removeproxy

Linux:

 ./ninjarmm-linagent -remove-proxy

Mac:

./ninjarmm-macagent -remove-proxy

A continuación, sigue los pasos anteriores para configurar el proxy a través de la línea de comandos.

Configurar un proxy para NinjaOne Remote

Establecer un proxy para un jugador o streamer requiere pasos adicionales. NinjaOne Remote admite el uso de proxies HTTP(s) y SOCKS5 con soporte de red. NinjaOne Remote también admite el proxy HTTP, pero recomendamos encarecidamente utilizar HTTP(s) en su lugar. 

El formato de la variable de entorno del sistema NC_PROXY debe definirse de la siguiente manera:

ParámetroDescripción

NC_PROXY

192.168.1.1:1080:nombre de usuario:contraseña

192.168.1.1

Dirección IIP del proxy HTTP(S)/SOCKS5

1080

Puerto del proxy (8080 es el valor predeterminado habitual para el proxy HTTPS)

usuario

Nombre de usuario para el proxy (déjelo en blanco si no hay usuario)

contraseña

Contraseña para el nombre de usuario (déjalo en blanco si no hay contraseña)

Nota: Aunque no haya nombre de usuario ni contraseña, los dos puntos al final siguen siendo obligatorios. (p. ej., 192.168.1.1:8080:user: o 192.168.1.1:8080:

Durante el inicio, el reproductor o el streamer comprueba esta variable de entorno y, si existe y tiene el formato correcto, utiliza ese parámetro para establecer la conexión a través de ese proxy.

Ejemplo de configuración de NC_PROXY para Windows

Nota importante: Deberá utilizar la variable de entorno del sistema.

Para crear una nueva variable del sistema, ve a Configuración > Sistema > Acerca de > Configuración avanzada del sistema > Variables de entorno y, a continuación, en Variables del sistema, haz clic en Nuevo.

NewSystemVariableII.png

Configuración de omisión del proxy 

Cuando el proxy está configurado, pero no hay acceso a Internet a través de él, el agente/patcher tiene la capacidad de detectar una conexión directa a Internet y cambiar a ella sin problemas. Esto resulta especialmente útil en situaciones en las que un usuario pasa de un entorno con un proxy configurado y en funcionamiento, como una oficina, a una ubicación diferente donde ya no hay un proxy disponible, o viceversa.

Como puede ver en el terminal, para que la configuración del proxy surta efecto, debe reiniciar el agente NinjaOne RMM.

Recursos adicionales

FAQ

Próximos pasos