git remote

Compartir y actualizar

Gestiona los repositorios remotos con los que sincronizas

El comando 'git remote' lista, añade y elimina remotos — nombres cortos para las URL de otros repositorios. git clone crea uno llamado origin. Los forks suelen añadir un segundo, upstream, que apunta al proyecto original. Añadir un remoto no descarga nada; eso lo hace git fetch <name>.

Sinopsis

git remote [-v | --verbose]
git remote add <name> <url>
git remote remove <name>
git remote rename <old> <new>
git remote set-url <name> <newurl>
git remote show <name>
[ ] opcional| o<arg> valor a sustituir... repetible--flag opción

Opciones

Haz clic en una opción para desplegarla

Principiante (1)

Muestra la URL de cada remoto, para fetch y push.

RecomendadoVer exactamente de qué URL descargas y a cuál subes

Ejemplo

git remote -v

Elegir la opción adecuada

origin frente a upstream

Los dos remotos habituales de un fork

ComandoApunta a¿Subes ahí?
originTu copia (el fork)Sí
upstreamEl proyecto originalNo — haces fetch desde él

Ejemplos

Listar remotos

git remote -v

Los nombres con sus URL.

Añadir el original de un fork

git remote add upstream git@github.com:acme/shop.git

Un segundo remoto.

Cambiar una URL

git remote set-url origin git@github.com:you/shop.git

P. ej. pasar de HTTPS a SSH.

Detalles

git remote show origin

Ramas e información de seguimiento.

Ejemplos de flujos de trabajo

1
git remote add upstream git@github.com:acme/shop.git

Una vez

2
git fetch upstream

Descargar sus commits

3
git merge upstream/main

Llevarlos a tu main

4
git push

Actualizar tu fork

Solución de problemas

error: remote origin already exists

Causa: El nombre ya está usado

Usa set-url para cambiarlo, u otro nombre

fatal: 'upstream' does not appear to be a git repository

Causa: El remoto no está configurado

Añádelo con git remote add

Consejos y trampas

Buenas prácticas

  • ✓Llama upstream al original de un fork.
  • ✓Revisa git remote -v antes de tu primer push.

Errores comunes

  • ✗Esperar que git remote add descargue commits — ejecuta git fetch después.
  • ✗Subir a upstream en lugar de a origin en un fork.

Preguntas frecuentes

A:

git remote rename old new.

A:

git remote remove <name> — sus ramas de seguimiento remoto también se van.