Solução de problemas

Configurar definições de proxy

Configurar definições de proxy para Bob Shell em ambientes empresariais com restrições de rede

Mensagens de erro

Erros de conexão ou timeouts ao tentar usar o Bob Shell, como:

  • "Não é possível conectar aos serviços Bob"
  • "Solicitação de rede falhou"
  • "Timeout de conexão"
  • "Falha na verificação do certificado SSL"
  • Erros "ECONNREFUSED" ou "ETIMEDOUT"

Causas comuns

Sua organização exige que todo o tráfego HTTP/HTTPS flua através de um servidor proxy em vez de permitir conexões diretas. Isso é comum em ambientes empresariais com políticas de segurança de rede rigorosas.

Solução

Configure as definições de proxy para Bob Shell usando variáveis de ambiente para rotear o tráfego através do servidor proxy da sua organização.

Definir variáveis de ambiente de proxy

Abra seu arquivo de configuração de shell em um editor de texto:

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

Adicione as seguintes variáveis de ambiente ao seu arquivo de configuração 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

Substitua proxy.example.com:8080 pelo endereço e porta reais do servidor proxy da sua organização.

Nota:

A variável NO_PROXY especifica endereços que devem ignorar o proxy. Adicione quaisquer domínios internos ou endereços IP que não exijam acesso proxy.

Salve o arquivo de configuração e recarregue-o:

# Para Bash
source ~/.bashrc

# Para Zsh
source ~/.zshrc

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

Verifique se as variáveis de ambiente estão definidas:

echo $HTTP_PROXY
echo $HTTPS_PROXY

Teste a conectividade do Bob Shell iniciando uma nova sessão.

Configurar validação de certificado SSL

Se o seu proxy usar certificados autoassinados ou autoridades de certificação personalizadas, você pode precisar configurar a validação de certificado SSL.

Adicione a configuração SSL ao seu arquivo de configuração de shell:

# Desabilitar validação SSL rigorosa (não recomendado para produção)
export NODE_TLS_REJECT_UNAUTHORIZED=0

# Ou fornecer certificados CA personalizados (recomendado)
export NODE_EXTRA_CA_CERTS=/path/to/your/ca-bundle.crt
Aviso:

Desabilitar a validação SSL (NODE_TLS_REJECT_UNAUTHORIZED=0) reduz a segurança e deve ser usado apenas temporariamente. Forneça o pacote de certificados da sua organização usando NODE_EXTRA_CA_CERTS.

Obtenha o pacote de certificados da sua organização da sua equipe de TI e salve-o em um local seguro.

Atualize o caminho NODE_EXTRA_CA_CERTS para apontar para o seu arquivo de pacote de certificados.

Recarregue sua configuração de shell e teste a conectividade do Bob Shell.

Configuração temporária de proxy

Para uma configuração temporária de proxy sem modificar seu arquivo de configuração de shell, defina as variáveis de ambiente em sua sessão de terminal atual:

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

Essas configurações se aplicarão apenas à sessão de terminal atual e serão perdidas quando você fechar o terminal.

Como está este tópico?