Tutoriales de VPS
git clone GitHub con timeout en VPS: SSH 443, proxy y HTTPS (2026)
Revisa protocolo y configuración reales de Git, compara peticiones pequeñas, corrige puertos o proxy y valida permisos con el usuario de despliegue.

Si git clone, git fetch o un despliegue agota el tiempo al conectar con GitHub, quizá detenido en Cloning into..., pero el navegador abre el repositorio, identifica primero HTTPS o SSH, acceso directo o proxy. Abrir la web no demuestra que salga SSH por 22 ni que la cuenta de despliegue tenga permiso.
Esta guía cubre GitHub.com: conexión real, peticiones pequeñas, puertos/proxy, autenticación y despliegue. Enterprise Server y dominios empresariales con residencia de datos requieren su documentación; el endpoint público SSH por 443 no es intercambiable con esos servicios.
| Error o síntoma | Primera comprobación |
|---|---|
Could not resolve host: github.com | DNS del VPS y resolución del proxy |
connect to host github.com port 22: Connection timed out | Salida SSH por 22 y ruta de red |
Fallo hacia 127.0.0.1:7890 o proxy antiguo | Disponibilidad real del proxy configurado |
SSL certificate problem | Hora, CA, inspección TLS y confianza de Git |
Permission denied (publickey) | SSH alcanzó autenticación: claves/cuenta |
Repository not found, 401/403 | URL, permisos, credenciales y política de organización |
RPC failed, HTTP/2 stream, early EOF | Transferencia interrumpida: protocolo, proxy, logs y tamaño |
GitHub menciona firewalls, proxies y reglas como causas habituales; consulta problemas de conexión. Un clone fallido no justifica por sí solo cambiar a un espejo o generar claves nuevas.
Usa el mismo usuario, terminal o servicio que falla:
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)='
Si aún no existe el repositorio local, omite git remote -v y revisa la URL prevista. Una salida vacía puede significar simplemente que no se configuró esa opción.
https://github.com/OWNER/REPO.git usa HTTPS; [email protected]:OWNER/REPO.git normalmente SSH. url.*.insteadOf puede reescribir la URL: un comando aparentemente HTTPS puede acabar en SSH. --show-origin identifica el archivo de configuración.
Comprueba dónde está el proxy. 127.0.0.1:7890 en tu ordenador apunta a él; en el VPS, al propio VPS. Solo funciona si esa máquina ejecuta el proxy. La configuración HTTP tampoco redirige automáticamente OpenSSH.
Las URL y variables pueden incluir credenciales. Examínalas localmente y elimina usuarios, contraseñas y tokens antes de compartir; no publiques registros de configuración sin revisar.
Prueba DNS/HTTPS y consulta referencias de un repositorio 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 no descarga todo el repositorio. El ejemplo público no necesita token privado y sirve como comparación. Revisa las reescrituras para conocer el protocolo real.
Si la web funciona y Git falla, investiga configuración/proxy/TLS específicos de Git. Si funciona el público pero falla el privado, revisa primero URL y permisos. Una petición pequeña no valida packs grandes, LFS ni submódulos.
Prueba SSH por 22:
ssh -vT -o ConnectTimeout=10 [email protected]
En la primera conexión, compara la huella con las oficiales de GitHub antes de aceptar. No ocultes problemas de identidad con StrictHostKeyChecking=no.
GitHub puede autenticar correctamente, indicar que no ofrece shell y devolver 1. Lee la cuenta autenticada y valida acceso al repositorio: un código distinto de cero no implica siempre puerto bloqueado. Consulta la prueba SSH.
Con HTTPS funcionando y SSH 22 agotando tiempo, revisa salida, grupos de seguridad, red del proveedor y proxies. GitHub.com ofrece esta alternativa oficial:
ssh -T -p 443 -o ConnectTimeout=10 [email protected]
El host es ssh.github.com. Es SSH en 443, no HTTPS; equipos que solo permiten HTTPS real pueden bloquearlo. Verifica la huella oficial en la primera conexión.
Tras autenticar, prueba una URL explícita sin modificar otras conexiones:
git clone ssh://[email protected]:443/OWNER/REPO.git
Sustituye OWNER/REPO por el repositorio real. La guía SSH por 443 excluye trasladar directamente este endpoint a Enterprise Server y Enterprise Cloud con residencia de datos.
Para dirigir las URL SSH habituales de github.com por 443, respalda ~/.ssh/config, revisa los bloques Host y combina:
Host github.com
HostName ssh.github.com
Port 443
User git
Conserva IdentityFile, alias y ajustes necesarios. No sobrescribas todo el archivo ni dupliques bloques incompatibles. Varias cuentas requieren mantener la selección de sus claves.
Consulta valores efectivos y prueba:
ssh -G [email protected] | grep -Ei '^(hostname|port|user|identityfile|proxycommand|proxyjump) '
ssh -T [email protected]
Revierte solo estos campos o restaura la copia cuando no sean necesarios. La salida hacia GitHub no requiere cambiar el servidor SSH del VPS.
Si los logs muestran dirección antigua, puerto incorrecto o proxy local inexistente, confirma que esté permitido conectar directamente. Entonces prueba sin persistir cambios:
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
Elimina variables habituales y vacía el proxy HTTP general/de URL GitHub para ese comando. Pueden seguir aplicándose opciones más específicas, remotes y reescrituras; no ignora toda la configuración Git.
Si funciona, usa --show-origin para localizar el ajuste roto en shell, entorno del servicio, repositorio o configuración global. Registra el original y modifica solo lo confirmado. Conserva ~/.gitconfig y proxies que necesiten otros proyectos.
Si el acceso requiere un proxy controlado, repara escucha, dirección, autenticación y certificados. Que falle la prueba directa no demuestra que el proxy esté bien. Consulta reglas de git-config.
Para certificados, comprueba hora, paquetes CA e inspección TLS autorizada. Obtén su CA mediante un canal administrativo fiable y configura la confianza correctamente. Mantén validación HTTPS: http.sslVerify=false y GIT_SSL_NO_VERIFY omiten identidad. Una IP cualquiera en hosts puede ser antigua, usar otra ruta o introducir riesgos.
Si los logs apuntan a HTTP/2 o compatibilidad del intermediario, compara una petición HTTP/1.1:
git -c http.version=HTTP/1.1 \
ls-remote https://github.com/vercel/next.js.git HEAD
Si mejora, revisa versiones Git/libcurl/proxy y la transferencia real. No corrige DNS, SSH ni permisos, y no garantiza resolver todos los early EOF. Ante RPC failed, cambiar protocolo, buffers y TLS a la vez oculta la causa. Un http.postBuffer enorme no es solución universal; consulta opciones git-config.
Si IPv4 funciona y el acceso predeterminado no, compara rutas:
curl -4 -I --connect-timeout 5 --max-time 15 https://github.com/
ssh -4 -T -o ConnectTimeout=10 [email protected]
Revisa direcciones IPv6, rutas y DNS si difieren. Un fallo aislado no justifica desactivar todo IPv6. Comprueba SSH y HTTPS por separado.
Permission denied (publickey) indica autenticación SSH. Consulta la clave real, cuenta/deploy key y selección que muestra ssh -vT. Root, usuario de despliegue y CI pueden tener configuraciones diferentes.
GitHub no acepta la contraseña de cuenta para operaciones Git HTTPS privadas; usa token adecuado o herramienta admitida. Repository not found puede significar URL incorrecta o falta de acceso. También importan SSO, alcance y caducidad. Consulta errores de clone.
Mantén tokens fuera de URL, scripts, historial y logs. Para un solo repositorio, evalúa credenciales restringidas. Repara autenticación y autorización antes de probar el destino: cambiar puertos no concede permisos.
Identifica si se atascan packs, LFS, submódulos o la posterior instalación de dependencias. LFS/submódulos pueden contactar otros hosts que la consulta inicial no cubre.
Si basta historia reciente, considera clone superficial. Para objetos bajo demanda, considera partial clone:
git clone --depth 1 https://github.com/OWNER/REPO.git
git clone --filter=blob:none https://github.com/OWNER/REPO.git
Son alternativas, no pasos consecutivos. La historia limitada afecta versiones, merges y CI; partial clone puede descargar durante checkout u operaciones posteriores. Consulta git-clone. Reducen transferencia apropiada, no bloqueos ni errores de autenticación.
Si depende del horario, registra hora/ruta/error y consulta GitHub Status. Comparar horarios y redes distingue incidencias, congestión y ajustes locales sin asumir limitación de velocidad.
Ejecuta git ls-remote de solo lectura contra el repositorio objetivo, luego clona en otro directorio o haz fetch controlado para confirmar el commit. Un repositorio público no prueba acceso privado. Evita git pull arbitrarios en producción con cambios pendientes.
Si CI o el agente sigue fallando, revisa DNS, proxy, claves y ajustes con su usuario/servicio/contenedor real. La sesión SSH interactiva puede diferir del entorno heredado por el servicio. Conserva registros y restringe las trazas; revisa y anonimiza antes de compartir.
- Resolución: DNS del VPS y systemd-resolved.
- Claves de host cambiadas: huellas y reparación segura de known_hosts.
- Entorno del runner distinto: GitHub Actions e aislamiento.