Solución de problemas

Configurar ajustes de proxy

Configurar ajustes de proxy para Bob Shell en entornos empresariales con restricciones de red

Mensajes de error

Errores de conexión o tiempos de espera al intentar usar Bob Shell, como:

  • "No se puede conectar a los servicios Bob"
  • "Solicitud de red fallida"
  • "Tiempo de espera de conexión agotado"
  • "Verificación de certificado SSL fallida"
  • Errores "ECONNREFUSED" o "ETIMEDOUT"

Causas comunes

Tu organización requiere que todo el tráfico HTTP/HTTPS fluya a través de un servidor proxy en lugar de permitir conexiones directas. Esto es común en entornos empresariales con políticas de seguridad de red estrictas.

Solución

Configura los ajustes de proxy para Bob Shell usando variables de entorno para enrutar el tráfico a través del servidor proxy de tu organización.

Establecer variables de entorno de proxy

Abre tu archivo de configuración de shell en un editor de texto:

  • Para Bash: ~/.bashrc o ~/.bash_profile
  • Para Zsh: ~/.zshrc
  • Para Fish: ~/.config/fish/config.fish

Agrega las siguientes variables de entorno a tu archivo de configuración de shell:

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=https://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1

Reemplaza proxy.example.com:8080 con la dirección y puerto reales del servidor proxy de tu organización.

Nota:

La variable NO_PROXY especifica direcciones que deben omitir el proxy. Agrega cualquier dominio interno o dirección IP que no requiera acceso proxy.

Guarda el archivo de configuración y recárgalo:

# Para Bash
source ~/.bashrc

# Para Zsh
source ~/.zshrc

# Para Fish
source ~/.config/fish/config.fish

Verifica que las variables de entorno estén configuradas:

echo $HTTP_PROXY
echo $HTTPS_PROXY

Prueba la conectividad de Bob Shell iniciando una nueva sesión.

Configurar validación de certificados SSL

Si tu proxy usa certificados autofirmados o autoridades de certificación personalizadas, es posible que necesites configurar la validación de certificados SSL.

Agrega la configuración SSL a tu archivo de configuración de shell:

# Deshabilitar validación SSL estricta (no recomendado para producción)
export NODE_TLS_REJECT_UNAUTHORIZED=0

# O proporcionar certificados CA personalizados (recomendado)
export NODE_EXTRA_CA_CERTS=/path/to/your/ca-bundle.crt
Advertencia:

Deshabilitar la validación SSL (NODE_TLS_REJECT_UNAUTHORIZED=0) reduce la seguridad y solo debe usarse temporalmente. Proporciona el paquete de certificados de tu organización usando NODE_EXTRA_CA_CERTS.

Obtén el paquete de certificados de tu organización de tu equipo de TI y guárdalo en una ubicación segura.

Actualiza la ruta NODE_EXTRA_CA_CERTS para que apunte a tu archivo de paquete de certificados.

Recarga tu configuración de shell y prueba la conectividad de Bob Shell.

Configuración temporal de proxy

Para una configuración temporal de proxy sin modificar tu archivo de configuración de shell, establece las variables de entorno en tu sesión de terminal actual:

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=https://proxy.example.com:8080
bobshell

Estas configuraciones solo se aplicarán a la sesión de terminal actual y se perderán cuando cierres el terminal.

¿Cómo es este tema?