Tutoriais de VPS
git clone GitHub em timeout no VPS: SSH 443, proxy e HTTPS (2026)
Confira protocolo e configuração reais do Git, compare requisições pequenas, corrija portas ou proxy e valide permissões com o usuário de deploy.

Se git clone, git fetch ou um deploy fica em timeout ao conectar ao GitHub, talvez parado em Cloning into..., mas o navegador abre o repositório, identifique primeiro HTTPS ou SSH, conexão direta ou proxy. A página abrir não comprova saída SSH por 22 nem permissão da conta de deploy.
Este guia cobre GitHub.com: conexão real, requisições pequenas, portas/proxy, autenticação e deploy. Enterprise Server e domínios empresariais com residência de dados exigem documentação própria; o endpoint público SSH por 443 não é intercambiável com esses serviços.
| Erro ou sintoma | Primeira verificação |
|---|---|
Could not resolve host: github.com | DNS do VPS e resolução do proxy |
connect to host github.com port 22: Connection timed out | Saída SSH por 22 e rota de rede |
Falha em 127.0.0.1:7890 ou proxy antigo | Disponibilidade real do proxy configurado |
SSL certificate problem | Relógio, CAs, inspeção TLS e confiança do Git |
Permission denied (publickey) | SSH chegou à autenticação: chaves/conta |
Repository not found, 401/403 | URL, permissões, credenciais e política da organização |
RPC failed, HTTP/2 stream, early EOF | Transferência interrompida: protocolo, proxy, logs e tamanho |
O GitHub cita firewalls, proxies e regras como causas comuns; consulte problemas de conexão. Clone falhar sozinho não justifica trocar por um espelho ou gerar novas chaves.
Use o mesmo usuário, terminal ou serviço que apresenta o erro:
git --version
git remote -v
git config --show-origin --get-regexp '^url\..*\.insteadof$'
git config --show-origin --get-urlmatch http.proxy https://github.com/
git config --show-origin --get-urlmatch http.sslVerify https://github.com/
env | grep -iE '^(http_proxy|https_proxy|all_proxy|no_proxy)='
Sem repositório local, pule git remote -v e confira a URL pretendida. Saída vazia pode apenas indicar opção não configurada.
https://github.com/OWNER/REPO.git usa HTTPS; [email protected]:OWNER/REPO.git normalmente SSH. url.*.insteadOf pode reescrever a URL, fazendo um comando aparentemente HTTPS usar SSH. --show-origin identifica o arquivo de configuração.
Confira onde está o proxy. 127.0.0.1:7890 no seu computador aponta para ele; no VPS, para o próprio VPS. Só funciona se essa máquina executar o proxy. A configuração HTTP também não encaminha automaticamente OpenSSH.
URLs e variáveis podem conter credenciais. Examine localmente e remova usuários, senhas e tokens antes de compartilhar; não publique logs brutos de configuração.
Teste DNS/HTTPS e consulte referências de um repositório público:
getent ahosts github.com
curl -I --connect-timeout 5 --max-time 15 https://github.com/
GIT_TERMINAL_PROMPT=0 git ls-remote https://github.com/vercel/next.js.git HEAD
git ls-remote não baixa o repositório inteiro. O exemplo público não exige token privado e serve de comparação. Confira reescritas para identificar o protocolo real.
Se a web funciona e Git falha, investigue configurações/proxy/TLS específicos do Git. Se o público funciona e o privado não, priorize URL e permissões. Requisição pequena não valida packs grandes, LFS ou submódulos.
Teste SSH por 22:
ssh -vT -o ConnectTimeout=10 [email protected]
Na primeira conexão, compare a impressão digital com as oficiais do GitHub antes de aceitar. Não esconda problemas de identidade usando StrictHostKeyChecking=no.
O GitHub pode autenticar, informar que não oferece shell e retornar 1. Leia a conta autenticada e valide o repositório: saída diferente de zero não significa necessariamente porta bloqueada. Veja o teste SSH.
Com HTTPS disponível e SSH 22 em timeout, confira saída, grupos de segurança, rede do provedor e proxies. O GitHub.com oferece esta alternativa oficial:
ssh -T -p 443 -o ConnectTimeout=10 [email protected]
O host é ssh.github.com. É SSH na porta 443, não HTTPS; equipamentos que aceitam somente HTTPS real podem bloquear. Confira a impressão digital oficial na primeira conexão.
Após autenticar, teste uma URL explícita sem alterar outras conexões:
git clone ssh://[email protected]:443/OWNER/REPO.git
Substitua OWNER/REPO pelo repositório real. A orientação SSH por 443 também exclui aplicar diretamente esse endpoint ao Enterprise Server e Enterprise Cloud com residência de dados.
Para direcionar URLs SSH usuais do github.com por 443, faça backup de ~/.ssh/config, confira os blocos Host e combine:
Host github.com
HostName ssh.github.com
Port 443
User git
Preserve IdentityFile, aliases e opções necessárias. Não sobrescreva o arquivo inteiro nem duplique blocos conflitantes. Várias contas exigem manter suas regras de seleção de chaves.
Confira opções efetivas e teste:
ssh -G [email protected] | grep -Ei '^(hostname|port|user|identityfile|proxycommand|proxyjump) '
ssh -T [email protected]
Desfaça apenas esses campos ou restaure o backup quando não precisar mais. A saída para GitHub não exige alterar o servidor SSH do VPS.
Se logs mostram endereço antigo, porta errada ou proxy local inexistente, confirme se acesso direto é permitido. Então teste sem persistir alterações:
env -u http_proxy -u https_proxy -u all_proxy \
-u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY \
git -c http.proxy= -c http.https://github.com/.proxy= \
ls-remote https://github.com/vercel/next.js.git HEAD
Remove variáveis comuns e limpa o proxy HTTP geral/de URL GitHub nesse comando. Configurações mais específicas, remotes e reescritas ainda podem atuar; não ignora todas as opções Git.
Se funcionar, use --show-origin para localizar o ajuste quebrado em shell, ambiente do serviço, repositório ou configuração global. Registre o original e altere apenas o confirmado. Preserve ~/.gitconfig e proxies usados por outros projetos.
Se o acesso exige proxy controlado, corrija escuta, endereço, autenticação e certificados. Um teste direto falhar não comprova que o proxy esteja certo. Veja regras git-config.
Para certificados, confira relógio, pacote de CAs e inspeção TLS autorizada. Obtenha a CA por canal administrativo confiável e configure a confiança corretamente. Preserve validação HTTPS: http.sslVerify=false e GIT_SSL_NO_VERIFY ignoram identidade. Uma IP qualquer em hosts pode estar antiga, usar rota errada ou introduzir riscos.
Se logs apontam a HTTP/2 ou compatibilidade de intermediário, compare uma requisição HTTP/1.1:
git -c http.version=HTTP/1.1 \
ls-remote https://github.com/vercel/next.js.git HEAD
Se melhorar, confira versões Git/libcurl/proxy e transferência real. Não corrige DNS, SSH ou permissões nem garante resolver todo early EOF. Ao encontrar RPC failed, mudar protocolo, buffers e TLS juntos esconde a causa. http.postBuffer enorme não é solução universal; veja opções git-config.
Se IPv4 funciona e conexão padrão não, compare rotas:
curl -4 -I --connect-timeout 5 --max-time 15 https://github.com/
ssh -4 -T -o ConnectTimeout=10 [email protected]
Confira IPv6, rotas e DNS quando diferirem. Uma falha isolada não justifica desativar todo IPv6. Investigue SSH e HTTPS separadamente.
Permission denied (publickey) indica autenticação SSH. Confira chave real, conta/deploy key e seleção mostrada por ssh -vT. Root, usuário de deploy e CI podem ter configurações diferentes.
O GitHub não aceita senha da conta para operações Git HTTPS privadas; use token adequado ou ferramenta suportada. Repository not found pode significar URL errada ou falta de acesso. SSO, escopo e validade também importam. Veja erros de clone.
Mantenha tokens fora de URLs, scripts, histórico e logs. Para um único repositório, avalie credenciais restritas. Corrija autenticação e autorização antes de testar o alvo: trocar portas não concede permissão.
Identifique se travam packs, LFS, submódulos ou instalação posterior de dependências. LFS/submódulos podem acessar outros hosts fora da cobertura da consulta inicial.
Se basta histórico recente, considere clone raso. Para objetos sob demanda, considere partial clone:
git clone --depth 1 https://github.com/OWNER/REPO.git
git clone --filter=blob:none https://github.com/OWNER/REPO.git
São alternativas, não passos consecutivos. Histórico limitado afeta cálculo de versão, merges e CI; partial clone pode baixar durante checkout e operações posteriores. Veja git-clone. Reduzem transferências adequadas, não bloqueios ou erros de autenticação.
Se depende do horário, registre horário/rota/erro e consulte GitHub Status. Comparar horários e redes distingue incidentes, congestionamento e configuração local sem presumir limitação de velocidade.
Execute git ls-remote de leitura contra o repositório alvo, depois clone em novo diretório ou faça fetch controlado para confirmar o commit. Um repositório público não comprova acesso privado. Evite git pull arbitrário em produção com alterações pendentes.
Se CI ou agente ainda falhar, confira DNS, proxy, chaves e opções sob o usuário/serviço/contêiner real. O shell SSH interativo pode diferir do ambiente herdado pelo serviço. Preserve registros e restrinja traces; revise e remova dados sensíveis antes de compartilhar.
- Resolução: DNS do VPS e systemd-resolved.
- Chaves de host alteradas: impressões digitais e reparo seguro de known_hosts.
- Ambiente diferente do runner: GitHub Actions e isolamento.