タイトル: ローカルとリモートリポジトリの有無を同期
SEOタイトル: git remote 完全ガイド — add/rm/-v/set-url/rename/prune、origin と upstream の使い分け
| この記事の要点 |
|
git remote とは
Git のリモート (remote)とは「ローカルリポジトリが認識している他のリポジトリの別名」のことです。git clone 直後は通常 origin という名前で clone 元が登録されます。
「リモート」は名前 ↔ URL の対応表に過ぎず、登録するだけでは何もダウンロードされません。実際の同期は fetch / pull / push で行います。
現在のリモート一覧を見る
# 名前だけ
git remote
# origin
# URL も
git remote -v
# origin git@github.com:user/repo.git (fetch)
# origin git@github.com:user/repo.git (push)
# 詳細 (HEAD ブランチ、トラッキング設定など)
git remote show origin
# * remote origin
# Fetch URL: git@github.com:user/repo.git
# Push URL: git@github.com:user/repo.git
# HEAD branch: main
# Remote branches:
# main tracked
# develop tracked
# Local branch configured for 'git pull':
# main merges with remote main
# Local refs configured for 'git push':
# main pushes to main (up to date)リモートを追加 / 削除
# 追加
git remote add origin git@github.com:user/repo.git
# 別名で追加 (本家を upstream として)
git remote add upstream git@github.com:original-owner/repo.git
# 削除
git remote rm origin
git remote remove origin # rm の別名
# リネーム
git remote rename origin githubURL を変更する: set-url
HTTPS で clone したものを SSH に切り替えたい、Bitbucket から GitHub へ移管した、独自ドメインに変えた、などの場面で頻用します。
# 変更
git remote set-url origin git@github.com:user/repo.git
# push 専用に別 URL (fetch は元のまま)
git remote set-url --push origin git@github.com:user/repo.git
# 確認
git remote -v典型的なフロー: clone から push まで
# 1. 既存リモートを clone
git clone git@github.com:user/repo.git
cd repo
git remote -v # origin 登録済
# ―――― あるいは ――――
# 1'. ローカルで作って後からリモート登録
mkdir myproject && cd myproject
git init
echo "# myproject" > README.md
git add README.md
git commit -m "Initial commit"
# 2. GitHub などで空リポジトリを作っておき URL を控える
# 3. リモートを登録
git remote add origin git@github.com:user/myproject.git
# 4. 初回 push (-u で upstream 紐付け)
git branch -M main
git push -u origin main
# 5. 以後は短く
git push
git pullfetch / pull / push の役割
| コマンド | 動作 | ローカル変更への影響 |
|---|---|---|
git fetch | リモートの最新を取り込む (origin/main 等の追跡ブランチを更新) | ★ なし (安全) |
git pull | fetch + 現在のブランチに merge (デフォルト) or rebase | あり (自動マージ) |
git push | ローカルのコミットをリモートに送る | — |
git fetch --prune | fetch + 消えたリモートブランチをローカル追跡から削除 | 追跡情報のみ |
origin と upstream: OSS で fork する場合
OSS にコントリビュートするときは、本家を upstream、自分の fork を origin として登録するのが定番です。
# 1. 自分の fork を clone (origin = fork)
git clone git@github.com:myuser/awesome.git
cd awesome
# 2. 本家を upstream として追加
git remote add upstream git@github.com:upstream-owner/awesome.git
git remote -v
# origin git@github.com:myuser/awesome.git (fetch/push)
# upstream git@github.com:upstream-owner/awesome.git (fetch/push)
# 3. 本家の更新を取り込む (upstream → ローカル main → fork へ push)
git checkout main
git fetch upstream
git merge upstream/main
# または
git rebase upstream/main
git push origin main
# 4. 機能ブランチで作業 → fork へ push → PR
git checkout -b feature/x
# ... commit ...
git push -u origin feature/x複数リモートの一例
# 同じプロジェクトを GitHub と GitLab の両方にバックアップ
git remote add github git@github.com:user/repo.git
git remote add gitlab git@gitlab.com:user/repo.git
# 個別に push
git push github main
git push gitlab main
# 両方に一度に push したい場合
# origin の Push URL を複数登録する技
git remote set-url --add --push origin git@github.com:user/repo.git
git remote set-url --add --push origin git@gitlab.com:user/repo.git
git push origin main # 両方に飛ぶ消えたリモートブランチを掃除
同僚がリモートでブランチを削除しても、ローカルの origin/branch は残り続けます。これを掃除するのが --prune です。
# Dry-run で何が消えるか確認
git remote prune origin --dry-run
# 実行
git remote prune origin
# fetch と同時に prune (こちらが手軽)
git fetch --prune
git fetch -p
# pull に統合
git config --global fetch.prune true # 以後 fetch 時に常に prune
# それでもローカルブランチは残るので個別に削除
git branch -d feature/old # マージ済みなら -d
git branch -D feature/old # 未マージでも強制 -Dトラッキング (upstream) 設定
ローカルブランチがどのリモートブランチを追跡するかを設定すると、git push / git pull を引数なしで使えるようになります。
# 初回 push で紐付け
git push -u origin feature/x
# 既存ブランチに後から設定
git branch --set-upstream-to=origin/feature/x feature/x
git branch -u origin/feature/x # 短縮形
# 確認
git branch -vv
# * feature/x abcd123 [origin/feature/x] commit msg
# main efgh456 [origin/main] another commit
# 解除
git branch --unset-upstreamよくあるトラブル
| 症状 | 原因 | 対処 |
|---|---|---|
fatal: remote origin already exists. | add しようとしたが既にある | git remote set-url で上書き or rm してから add |
fatal: 'origin' does not appear to be a git repository | リモート未登録 | git remote -v で確認、未登録なら add |
remote: Permission to ... denied | SSH 鍵 / PAT 認証エラー | ssh -T git@github.com で鍵確認、PAT 期限確認 |
The requested URL returned error: 403 | HTTPS で credential helper が古い PAT を握りっぱなし | git credential-manager erase / OS のキーチェーン削除 |
| push したのに反映されていない | 別ブランチや別リモートに飛んだ | git remote -v とgit branch -vv で確認 |
FAQ
Q: origin という名前を変えたい
A: git remote rename origin github で OK。以後は git push github main のように使えます。
Q: 移管したけど CI が古い URL を見続けている
A: ローカル / CI 両方で git remote set-url を実行する必要があります。CI 側はリポジトリ設定の Webhook / 連携 URL も新リポジトリに差し替えてください。
Q: git remote update と git fetch --all の違い
A: ほぼ同じです。git remote update はすべてのリモートを fetch します。git fetch --all も同じ動作で、現代は後者が一般的です。