# Git proxy SOCKS5: http.proxy e socks5h | ProxyJam

Git proxy SOCKS5 ou HTTP: configure com git config http.proxy, por host ou por repositório, com login e senha, e saiba como remover.

- Canonical: https://proxyjam.com/pt/faq/git-proxy-config/
- Updated: 2026-11-18
- Language: pt

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.


## 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.



O Git acessa remotos http e https pela libcurl, então segue as mesmas regras de proxy do
[curl](/pt/faq/curl-proxy/). Pegue o host, a porta, o login e a senha em uma linha de **Meus
Proxies** no seu [painel](https://app.proxyjam.com).

## 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](/pt/socks5-proxies/)
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](/pt/faq/proxy-error-407/) lista as verificações, e a
  [falha de autenticação do proxy](/pt/faq/proxy-authentication-failed/) 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](/pt/acceptable-use-policy/). Os planos estão na página de
  [proxies ISP](/pt/isp-proxies/).

