Tema
En este artículo se explica cómo configurar el agente NinjaOne para utilizarlo a través de un servidor proxy.
Entorno
Gestión de puntos finales de NinjaOne
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
- El agente NinjaOne no tiene configurados los ajustes de proxy
- El agente NinjaOne ya tiene la configuración de proxy configurada
- Configurar un proxy para NinjaOne Remote
- Detección automática de proxy para Windows
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 RMM de NinjaOne para que estos apunten al servidor proxy.
Solución solo para el sistema operativo Windows
Añada las claves de registro que se indican a continuación a cada dispositivo.
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» = «unaContraseña»
Solución para todos los sistemas operativos
Las solicitudes del proxy pedirán 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]Ejemplo:
.NinjaRMMAgent.exe /setproxy -host 127.0.0.1 -port 80 -user root -password helloworldLinux:
./ninjarmm-linagent -set-proxyMac:
./ninjarmm-macagent -set-proxyPara 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 modificar 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 /removeproxyLinux:
./ninjarmm-linagent -remove-proxyMac:
./ninjarmm-macagent -remove-proxyA 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. Sin embargo, no admite el proxy HTTP.
El formato de la variable de entorno del sistema NC_PROXY debe definirse de la siguiente manera:
| Parámetro | Descripció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éjelo 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
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.

Detección automática de proxy para Windows
- Los clientes ahora pueden implementar agentes más fácilmente en entornos de red complejos donde antes esto se configuraba y programaba manualmente. Esto reducirá el tiempo dedicado a la incorporación y la gestión de la configuración de proxy y las implementaciones en toda la flota para los departamentos de TI, y permitirá a los MSP escalar en entornos únicos y diversos.
- 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 será 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
Para desactivar esta función, elimine el valor o establézcalo en 0.
Omitir la configuració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 interrupciones. 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.