Skip to content

COMO_SUBIR_A_GITHUB.md

Latest commit

 

History

History
437 lines (302 loc) · 8.83 KB

COMO_SUBIR_A_GITHUB.md

File metadata and controls

437 lines (302 loc) · 8.83 KB
Raw

Cómo Subir wipwn-mejorado a Tu GitHub

Guía paso a paso para publicar el repositorio en tu cuenta de GitHub

📋 Requisitos Previos

  • ✅ Cuenta de GitHub (crea una en https://github.com si no tienes)
  • ✅ Git instalado en tu sistema
  • ✅ Acceso a terminal/línea de comandos

🚀 Método 1: Usando GitHub CLI (Recomendado)

Paso 1: Instalar GitHub CLI

En Termux:

pkg install gh -y

En Linux (Debian/Ubuntu):

sudo apt install gh -y

En Linux (Arch):

sudo pacman -S github-cli

Paso 2: Autenticar con GitHub

# Iniciar sesión
gh auth login

# Seleccionar:
# - GitHub.com
# - HTTPS
# - Yes (autenticar con navegador)
# - Seguir instrucciones en el navegador

Paso 3: Crear y Subir Repositorio

# Navegar al directorio
cd ~/wipwn-mejorado

# Crear repositorio en GitHub y hacer push
gh repo create wipwn-mejorado --public --source=. --push

# ¡Listo! Tu repositorio está en GitHub

Paso 4: Verificar

# Ver URL del repositorio
gh repo view --web

🌐 Método 2: Usando Interfaz Web de GitHub

Paso 1: Crear Repositorio en GitHub

  1. Ve a https://github.com
  2. Haz clic en el botón "+" (arriba derecha)
  3. Selecciona "New repository"
  4. Configura el repositorio:
    • Repository name: wipwn-mejorado
    • Description: Generador de PINs WPS con Auto-Attack | 76 Algoritmos | 100% Español
    • Public (seleccionado)
    • NO marcar "Initialize this repository with a README"
  5. Haz clic en "Create repository"

Paso 2: Conectar Repositorio Local

# Navegar al directorio
cd ~/wipwn-mejorado

# Agregar remote (reemplaza samVent2 con tu nombre de usuario)
git remote add origin https://github.com/samVent2/wipwn-mejorado.git

# Renombrar rama a main
git branch -M main

# Hacer push
git push -u origin main

Paso 3: Ingresar Credenciales

GitHub te pedirá autenticación:

Opción A: Token de Acceso Personal (Recomendado)

  1. Ve a https://github.com/settings/tokens
  2. Clic en "Generate new token" → "Generate new token (classic)"
  3. Configura:
    • Note: wipwn-mejorado
    • Expiration: 90 days (o lo que prefieras)
    • Scopes: Marca repo (todos los permisos de repositorio)
  4. Clic en "Generate token"
  5. COPIA EL TOKEN (solo se muestra una vez)
  6. Usa el token como contraseña cuando Git lo pida

Opción B: SSH (Avanzado)

Ver Configurar SSH más abajo

🔑 Método 3: Usando Git con Token

Paso 1: Generar Token de Acceso

  1. Ve a https://github.com/settings/tokens
  2. "Generate new token" → "Generate new token (classic)"
  3. Configura:
    • Note: wipwn-mejorado
    • Scopes: repo
  4. Copia el token

Paso 2: Crear Repositorio y Subir

# Navegar al directorio
cd ~/wipwn-mejorado

# Crear repositorio (reemplaza samVent2 y TU_TOKEN)
curl -H "Authorization: token TU_TOKEN" \
     -d '{"name":"wipwn-mejorado","description":"Generador de PINs WPS con Auto-Attack","private":false}' \
     https://api.github.com/user/repos

# Agregar remote
git remote add origin https://github.com/samVent2/wipwn-mejorado.git

# Renombrar rama
git branch -M main

# Hacer push con token
git push -u https://samVent2:TU_TOKEN@github.com/samVent2/wipwn-mejorado.git main

🔐 Configurar SSH (Opcional)

Ventajas de SSH

  • ✅ No necesitas ingresar contraseña cada vez
  • ✅ Más seguro que HTTPS
  • ✅ Recomendado para uso frecuente

Paso 1: Generar Clave SSH

# Generar clave (presiona Enter para aceptar valores predeterminados)
ssh-keygen -t ed25519 -C "tu.email@ejemplo.com"

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

# Agregar clave al agente
ssh-add ~/.ssh/id_ed25519

Paso 2: Agregar Clave a GitHub

# Copiar clave pública
cat ~/.ssh/id_ed25519.pub
# Copia todo el contenido
  1. Ve a https://github.com/settings/keys
  2. Clic en "New SSH key"
  3. Title: Termux (o nombre de tu dispositivo)
  4. Key: Pega la clave copiada
  5. Clic en "Add SSH key"

Paso 3: Usar SSH en Lugar de HTTPS

# Cambiar remote a SSH
git remote set-url origin git@github.com:samVent2/wipwn-mejorado.git

# Hacer push (no pedirá contraseña)
git push -u origin main

📝 Actualizar README con Tu Usuario

Después de subir el repositorio, actualiza los enlaces:

# Editar README.md
nano ~/wipwn-mejorado/README.md

# Buscar y reemplazar:
# samVent2 → tu_nombre_de_usuario_github

# Guardar cambios
git add README.md
git commit -m "📝 Actualizar enlaces con nombre de usuario"
git push

O hacerlo automáticamente:

cd ~/wipwn-mejorado

# Reemplazar en todos los archivos (reemplaza samVent2)
sed -i 's/samVent2/tu_nombre_real/g' README.md
sed -i 's/samVent2/tu_nombre_real/g' GUIA_USO_TERMUX.md
sed -i 's/samVent2/tu_nombre_real/g' MANUAL_INSTALACION.md
sed -i 's/samVent2/tu_nombre_real/g' install.sh

# Commit y push
git add .
git commit -m "📝 Actualizar enlaces con nombre de usuario"
git push

🎨 Personalizar Repositorio en GitHub

Agregar Descripción

  1. Ve a tu repositorio en GitHub
  2. Clic en ⚙️ Settings
  3. En "About" (parte superior derecha):
    • Description: Generador de PINs WPS con Auto-Attack | 76 Algoritmos | 100% Español
    • Website: (opcional) tu sitio web
    • Topics: wps wifi pentesting termux reaver security español
  4. Clic en "Save changes"

Agregar Banner/Logo (Opcional)

Puedes crear un logo y agregarlo al README:

<div align="center">
  <img src="logo.png" alt="wipwn-mejorado" width="200"/>
</div>

Habilitar GitHub Pages (Opcional)

Para crear una página web del proyecto:

  1. Ve a Settings → Pages
  2. Source: Deploy from a branch
  3. Branch: main → / (root)
  4. Clic en "Save"

📊 Agregar Badges al README

Agrega badges para hacer el README más atractivo:

![GitHub stars](https://img.shields.io/github/stars/samVent2/wipwn-mejorado?style=social)
![GitHub forks](https://img.shields.io/github/forks/samVent2/wipwn-mejorado?style=social)
![GitHub issues](https://img.shields.io/github/issues/samVent2/wipwn-mejorado)
![GitHub license](https://img.shields.io/github/license/samVent2/wipwn-mejorado)
![Python version](https://img.shields.io/badge/python-3.6+-blue.svg)

🔄 Comandos Git Útiles

Ver Estado

git status

Agregar Cambios

# Agregar archivo específico
git add archivo.py

# Agregar todos los cambios
git add .

Hacer Commit

git commit -m "Mensaje descriptivo"

Subir Cambios

git push

Ver Historial

git log --oneline

Crear Rama

# Crear y cambiar a nueva rama
git checkout -b nueva-caracteristica

# Hacer cambios, commit, push
git push -u origin nueva-caracteristica

Actualizar desde GitHub

git pull

🐛 Solución de Problemas

Error: "remote origin already exists"

# Eliminar remote existente
git remote remove origin

# Agregar nuevamente
git remote add origin https://github.com/samVent2/wipwn-mejorado.git

Error: "failed to push some refs"

# Forzar push (cuidado, sobrescribe)
git push -f origin main

# O mejor, hacer pull primero
git pull origin main --rebase
git push origin main

Error: "Permission denied (publickey)"

Si usas SSH y falla:

# Verificar que la clave está agregada
ssh -T git@github.com

# Debería mostrar:
# Hi samVent2! You've successfully authenticated...

Si no funciona, repite Configurar SSH

Error: "Authentication failed"

Si usas HTTPS:

  1. Verifica tu nombre de usuario
  2. Usa un token de acceso personal en lugar de contraseña
  3. O cambia a SSH

✅ Verificación Final

Después de subir el repositorio:

  1. ✅ Ve a https://github.com/samVent2/wipwn-mejorado
  2. ✅ Verifica que todos los archivos están presentes
  3. ✅ Prueba el comando de instalación: 
    curl -sL https://raw.githubusercontent.com/samVent2/wipwn-mejorado/main/install.sh | bash
  4. ✅ Comparte el enlace con la comunidad

🎉 ¡Listo!

Tu repositorio está ahora en GitHub y disponible para:

  • ✅ Que otros lo usen
  • ✅ Recibir contribuciones
  • ✅ Reportar issues
  • ✅ Hacer forks
  • ✅ Dar estrellas ⭐

URL de tu repositorio:

https://github.com/samVent2/wipwn-mejorado

Comando de instalación:

curl -sL https://raw.githubusercontent.com/samVent2/wipwn-mejorado/main/install.sh | bash

📞 Soporte

Si tienes problemas para subir el repositorio:

  1. Revisa la documentación de GitHub
  2. Busca en GitHub Community
  3. Abre un issue en el repositorio original

¿Subida exitosa?

¡Comparte tu repositorio con la comunidad! 🚀