Git Remote
Última atualização
git remote gerencia os nomes abreviados que seu repositório usa para repositórios remotos - mais comumente origin, apontando para o seu repositório no GitHub. Você o usa para adicionar um remoto ao começar, listar os que você tem, renomeá-los ou removê-los, e alterar a URL de um remoto (por exemplo, mudando de HTTPS para SSH).
Experimente isto no terminal playground - um shell real no seu navegador, nada para instalar.
Sintaxe
| Command | What it does |
|---|---|
git remote -v | Lista os remotos com suas URLs |
git remote add origin <url> | Adiciona um remoto chamado origin |
git remote set-url origin <url> | Altera a URL de um remoto |
git remote rename origin upstream | Renomeia um remoto |
git remote remove origin | Remove um remoto |
git remote show origin | Mostra detalhes sobre um remoto |
Casos comuns
| Goal | Command |
|---|---|
| Conectar um novo repositório ao GitHub | git remote add origin <url> |
| Mudar de HTTPS para SSH | git remote set-url origin git@github.com:... |
| Verificar para onde origin aponta | git remote -v |
Exemplo prático
| Passo | Comando | Resultado |
|---|---|---|
| 1 | git remote add origin https://github.com/you/app.git | Registra o repositório do GitHub com o nome origin |
| 2 | git remote -v | Lista origin com as suas URLs de fetch e de push |
| 3 | git push -u origin main | Envia a main e faz ela rastrear origin/main |
Perguntas frequentes sobre git remote
O que é um remoto do Git?
Um remoto é uma referência nomeada a um repositório hospedado em outro lugar - normalmente no GitHub, GitLab ou um servidor. O nome padrão é
origin. Os remotos são com o que git push, git pull e git fetch sincronizam. git remote é o comando para gerenciar essas referências nomeadas.Como eu adiciono um remoto?
Execute
git remote add origin <url>, usando a URL do repositório. Isso vincula seu repositório local ao remoto com o nome origin. Depois você pode fazer push com git push -u origin main. Use um nome diferente (como upstream) se origin já estiver em uso.Como eu altero a URL de um remoto?
Use
git remote set-url origin <new-url>. É assim que você muda um repositório de uma URL HTTPS para uma SSH (ou a atualiza depois que um repositório é renomeado) sem remover e readicionar o remoto. Verifique com git remote -v.Como eu vejo meus remotos?
Execute
git remote -v para listar cada remoto com suas URLs de fetch e push. Para uma visão detalhada de um remoto - incluindo suas branches rastreadas - use git remote show origin.O que o git remote add origin faz?
Ele salva uma URL com o nome
origin na configuração do seu repositório. Nada é enviado nem baixado ainda: o comando só cria o nome, para que depois você possa digitar git push origin main em vez da URL completa. Se origin já existir, o Git recusa com "remote origin already exists"; use git remote set-url origin <url> para apontar o nome para outro lugar.Qual é a diferença entre origin e upstream?
Os dois são apenas nomes convencionais.
origin é o remoto de onde você clonou ou para onde fez o primeiro push, geralmente a sua própria cópia. Quando você faz um fork de um projeto, o repositório original costuma ser adicionado como um segundo remoto chamado upstream com git remote add upstream <url>, para você baixar as mudanças dele enquanto faz push no seu fork.Como baixo uma branch de um remoto?
Rode
git fetch origin para baixar todas as branches e depois git switch <branch> para criar uma branch local que rastreia origin/<branch>. A página fazer checkout de uma branch remota cobre as variações.Posso praticar isto online?
Sim. Abra o terminal playground para executar
git remote em um shell real no seu navegador - nada para instalar. O curso interativo e gratuito de Git da Coddy também cobre a conexão a remotos passo a passo.Recursos relacionados
Mais comandos do Git
