Configurar SSH para GitHub

Guía para configurar claves SSH y poder clonar repositorios privados desde tu VPS.

¿Por Qué SSH en Lugar de HTTPS?

✅ No necesitas introducir usuario/contraseña cada vez
✅ Más seguro con autenticación por clave
✅ Funciona con repositorios privados sin problemas
✅ Recomendado para servidores de producción

1. Generar Clave SSH en el VPS

# Conectar al VPS
ssh root@tu-ip-vps

# Generar clave SSH (usar email de tu cuenta GitHub)
ssh-keygen -t ed25519 -C "tu@email.com"

Cuando pregunte:

Enter file: Presiona Enter (usar ubicación por defecto)
Passphrase: Presiona Enter 2 veces (sin passphrase para automatización)

Esto crea dos archivos:

~/.ssh/id_ed25519 - Clave privada (¡NO compartir!)
~/.ssh/id_ed25519.pub - Clave pública (esta la copiarás a GitHub)

2. Copiar la Clave Pública

# Mostrar la clave pública
cat ~/.ssh/id_ed25519.pub

Copia todo el contenido que aparece (empieza con ssh-ed25519).

3. Añadir Clave a GitHub

Ve a GitHub.com y haz login
Click en tu foto de perfil → Settings
En el menú lateral → SSH and GPG keys
Click en New SSH key
Rellena:
- Title: VPS Hostinger (o nombre descriptivo)
- Key: Pega la clave pública copiada
Click en Add SSH key
Confirma con tu contraseña si te la pide

4. Verificar Conexión

# Probar conexión con GitHub
ssh -T git@github.com

Deberías ver:

Hi usuario! You've successfully authenticated, but GitHub does not provide shell access.

Si es la primera vez, preguntará si confías en el host. Escribe yes y presiona Enter.

5. Configurar Git (Opcional)

# Configurar nombre y email para commits
git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

# Verificar configuración
git config --list

6. Clonar Repositorios

Ahora puedes clonar usando SSH:

# Formato SSH (recomendado)
git clone git@github.com:usuario/repositorio.git

# Ejemplo con vps-docs
git clone git@github.com:daniclemente/vps-docs.git

Solución de Problemas

Error: Permission denied (publickey)

# Verificar que la clave existe
ls -la ~/.ssh/

# Verificar agente SSH
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# Verificar conexión
ssh -T git@github.com

Error: Could not open a connection to your authentication agent

# Iniciar agente SSH
eval "$(ssh-agent -s)"

# Añadir clave
ssh-add ~/.ssh/id_ed25519

Clave no se reconoce

# Verificar permisos correctos
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub

Múltiples Claves SSH (Avanzado)

Si usas varias cuentas de GitHub o servicios:

# Crear archivo de configuración SSH
vim ~/.ssh/config

Contenido:

# GitHub personal
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519

# GitHub trabajo (ejemplo)
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work

Luego clonar con:

git clone git@github-work:empresa/repositorio.git

Renovar o Cambiar Clave

Si necesitas cambiar la clave:

# Generar nueva clave con nombre diferente
ssh-keygen -t ed25519 -C "tu@email.com" -f ~/.ssh/id_ed25519_new

# Mostrar nueva clave pública
cat ~/.ssh/id_ed25519_new.pub

# Añadir a GitHub (repetir paso 3)
# Actualizar ~/.ssh/config si usas múltiples claves

Seguridad

⚠️ Nunca compartas tu clave privada

# Clave PRIVADA - NO compartir
~/.ssh/id_ed25519

# Clave PÚBLICA - OK compartir
~/.ssh/id_ed25519.pub

Backup de Claves (Opcional)

# Hacer backup de claves en local (desde tu PC)
scp root@tu-ip-vps:~/.ssh/id_ed25519 ~/backup-ssh/vps-key
scp root@tu-ip-vps:~/.ssh/id_ed25519.pub ~/backup-ssh/vps-key.pub

Guarda estas claves en lugar seguro (gestor de contraseñas, disco cifrado).

Verificación Final

# Probar clonado de repositorio
cd /root
git clone git@github.com:daniclemente/vps-docs.git
cd vps-docs

# Verificar
ls -la

Si todo funciona, ya puedes clonar cualquier repositorio de tu cuenta GitHub.

Siguiente Paso

Vuelve a la guía de despliegue correspondiente para continuar: