Alterar idioma
Português English Русский Deutsch Español Français Italiano Українська Tiếng Việt Türkçe Bahasa Indonesia हिन्दी 日本語 中文
Menu
Preços
Proxies
TIPOS DE PROXY
Soluções
Recursos

Como configurar um proxy no Git

Tópico: Configuração por dispositivo e app Todas as respostas

Em resumo: Execute git config –global http.proxy http://LOGIN:PASSWORD@HOST:PORT para enviar o Git por um proxy HTTP, ou use socks5h://HOST:PORT para SOCKS5. Isso vale só para remotos http e https, não para os SSH. Remova com git config –global –unset http.proxy. As credenciais ficam em texto simples no arquivo de configuração do Git.

O Git acessa remotos http e https pela libcurl, então segue as mesmas regras de proxy do curl. Pegue o host, a porta, o login e a senha em uma linha de Meus Proxies no seu painel.

Configure para todos os seus repositórios

git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT

Isso grava uma linha em ~/.gitconfig. Uma única configuração cobre os remotos http e https. Confira com git config --get http.proxy.

Para um pedido SOCKS5, mude o protocolo com Alterar protocolo, copie os dados de novo e use:

git config --global http.proxy socks5h://LOGIN:PASSWORD@HOST:PORT

O h faz o proxy resolver os nomes de host. A página de proxies SOCKS5 descreve o protocolo.

Codifique os caracteres especiais

O login fica dentro de uma URL, então @ deve ser escrito %40, : como %3A, / como %2F, # como %23 e % como %25. Uma senha sem codificação é cortada e o proxy responde 407.

Um repositório ou um host

Tire o --global dentro de um repositório para configurar o proxy só para ele:

git config http.proxy http://LOGIN:PASSWORD@HOST:PORT

Para limitar o proxy a um host, coloque o host na chave:

git config --global http.https://example.com.proxy http://LOGIN:PASSWORD@HOST:PORT

Variáveis de ambiente

O Git também lê http_proxy, https_proxy e all_proxy do shell, além da lista no_proxy com os hosts a ignorar. Quando está definida, a chave da configuração tem prioridade sobre elas.

Qual escopo usar

A configuração global é a mais simples, mas envia todos os remotos http e https pelo proxy, inclusive servidores internos que o proxy não alcança. Se isso acontecer, restrinja o proxy a um host ou a um repositório, ou liste os hosts internos em no_proxy. Uma chave por host é a escolha mais segura quando só um remoto precisa do proxy.

Remova a configuração

git config --global --unset http.proxy

O que você precisa saber

  • A senha fica armazenada em texto simples no arquivo de configuração do Git. Mantenha esse arquivo privado e não o envie em um commit.
  • Os remotos SSH (git@host:...) ignoram o http.proxy.
  • Um 407 em um git clone significa que o proxy rejeitou o login: o erro 407 de proxy lista as verificações, e a falha de autenticação do proxy trata do modo de lista de IPs permitidos.
  • Use o proxy apenas em repositórios aos quais você tem acesso, como exige a Política de Uso Aceitável. Os planos estão na página de proxies ISP.

Respostas rápidas sobre Git e proxies

O proxy vale para remotos git@?

Não. O http.proxy afeta os remotos http e https. Um remoto git@ funciona por SSH, que tem a sua própria configuração de proxy.

Como uso o proxy em um único host?

Acrescente o host à chave: git config --global http.https://example.com.proxy http://HOST:PORT, com o seu próprio host no lugar de example.com.

Como vejo o que o Git envia?

Execute o comando com GIT_CURL_VERBOSE=1 na frente. A saída mostra a requisição CONNECT enviada ao seu proxy.

Páginas relacionadas