Git Remote
Последнее обновление
git remote управляет короткими именами, которые ваш репозиторий использует для удалённых репозиториев - чаще всего это origin, указывающий на ваш репозиторий на GitHub. Вы используете его, чтобы добавить удалённый репозиторий в начале работы, вывести список имеющихся, переименовать или удалить их, а также изменить URL удалённого (например, переключиться с HTTPS на SSH).
Попробуйте это в терминальном playground - настоящая оболочка в вашем браузере, ничего устанавливать не нужно.
Синтаксис
| Command | What it does |
|---|---|
git remote -v | Выводит список удалённых с их URL |
git remote add origin <url> | Добавляет удалённый с именем origin |
git remote set-url origin <url> | Изменяет URL удалённого |
git remote rename origin upstream | Переименовывает удалённый |
git remote remove origin | Удаляет удалённый |
git remote show origin | Показывает подробности об удалённом |
Частые случаи
| Goal | Command |
|---|---|
| Подключить новый репозиторий к GitHub | git remote add origin <url> |
| Переключиться с HTTPS на SSH | git remote set-url origin git@github.com:... |
| Проверить, на что указывает origin | git remote -v |
Пример по шагам
| Шаг | Команда | Результат |
|---|---|---|
| 1 | git remote add origin https://github.com/you/app.git | Регистрирует репозиторий GitHub под именем origin |
| 2 | git remote -v | Показывает origin с его URL для fetch и push |
| 3 | git push -u origin main | Загружает main и настраивает её на отслеживание origin/main |
Частые вопросы о git remote
Что такое удалённый (remote) в Git?
Удалённый - это именованная ссылка на репозиторий, размещённый в другом месте - обычно на GitHub, GitLab или сервере. Имя по умолчанию -
origin. С удалёнными синхронизируются git push, git pull и git fetch. git remote - это команда для управления этими именованными ссылками.Как добавить удалённый?
Выполните
git remote add origin <url>, используя URL репозитория. Это связывает ваш локальный репозиторий с удалённым под именем origin. После этого вы можете делать push командой git push -u origin main. Используйте другое имя (например, upstream), если origin уже занято.Как изменить URL удалённого?
Используйте
git remote set-url origin <new-url>. Так вы переключаете репозиторий с URL HTTPS на URL SSH (или обновляете его после переименования репозитория), не удаляя и не добавляя удалённый заново. Проверьте с помощью git remote -v.Как посмотреть свои удалённые?
Выполните
git remote -v, чтобы вывести каждый удалённый с его URL для fetch и push. Для подробного просмотра одного удалённого - включая его отслеживаемые ветки - используйте git remote show origin.Что делает git remote add origin?
Она сохраняет URL под именем
origin в конфигурации вашего репозитория. Пока ничего не загружается и не скачивается: команда только создаёт имя, чтобы потом вместо полного URL можно было написать git push origin main. Если origin уже существует, Git откажет с ошибкой "remote origin already exists"; чтобы указать другой адрес, используйте git remote set-url origin <url>.Чем origin отличается от upstream?
Оба имени просто условные.
origin это удалённый репозиторий, из которого вы клонировали или в который отправили изменения первым, обычно ваша собственная копия. Когда вы делаете форк проекта, исходный репозиторий часто добавляют вторым удалённым под именем upstream командой git remote add upstream <url>, чтобы получать его изменения и при этом отправлять свои в форк.Как получить ветку из удалённого репозитория?
Выполните
git fetch origin, чтобы скачать все ветки, затем git switch <branch>, чтобы создать локальную ветку, которая отслеживает origin/<branch>. Варианты описаны на странице переключение на удалённую ветку.Могу ли я потренироваться в этом онлайн?
Да. Откройте терминальный playground, чтобы выполнить
git remote в настоящей оболочке в вашем браузере - ничего устанавливать не нужно. Бесплатный интерактивный курс по Git от Coddy также пошагово охватывает подключение к удалённым.Связанные ресурсы
Больше команд Git
