MAGAZINE
ルーターマガジン
BitbucketのSSH 接続先をssh.bitbucket.orgに切り替える方法
はじめに
Bitbucket Cloud の SSH 接続先が変わります。
bitbucket.org に SSH で fetch や push をすると、次のメッセージが表示されます。
------------
Starting November 12, 2026, Bitbucket is moving SSH traffic to ssh.bitbucket.org. Change your host name now to avoid connection disruptions.
https://community.atlassian.com/forums/Bitbucket-articles/Upcoming-change-to-Bitbucket-Cloud-SSH-access-move-from/ba-p/3234032
------------
2026年11月12日から12月10日までは猶予期間で、週末と祝日を除く指定日に 1 日 4 回(日本時間 9 時・15 時・21 時・3 時)、bitbucket.org への SSH が一時的に遮断されるブラウンアウトがあります。遮断時間は 15 分から少しずつ延びて最大 3 時間になり、12月10日に完全に使えなくなります。
既存のリポジトリは、remote URL を ssh.bitbucket.org に書き換える必要があります。
任意のリポジトリの remote URL をワンライナーで書き換える
対象のリポジトリで、次のコマンドを実行します。
git remote set-url origin "$(git remote get-url origin | sed 's/git@bitbucket.org:/git@ssh.bitbucket.org:/')"
実行後の URL は、次のコマンドで確認できます。
git remote -v
URL は次のように変わります。
変更前:
git@bitbucket.org:myteam/myrepo.git
変更後:
git@ssh.bitbucket.org:myteam/myrepo.git
全リポジトリの接続先を設定 1 つで切り替える
リポジトリが多くて 1 つずつ書き換えるのが大変なときは、次のどちらかの設定を 1 回入れる方法もあります。
git の insteadOf を使う
次のコマンドを実行します。
git config --global url."git@ssh.bitbucket.org:".insteadOf "git@bitbucket.org:"
実行すると、~/.gitconfig に次の設定が追記されます。
[url "git@ssh.bitbucket.org:"]
insteadOf = git@bitbucket.org:
この設定を入れると、git@bitbucket.org: への接続が自動で git@ssh.bitbucket.org: に置き換わります。ただし、remote URL そのものは変わりません。git remote -v では置き換え後の ssh.bitbucket.org が表示されますが、.git/config の URL は元のままです。
~/.ssh/config を使う
~/.ssh/config に次の設定を書きます。
Host bitbucket.org
HostName ssh.bitbucket.org
bitbucket.org への SSH 接続が、実際には ssh.bitbucket.org に向くようになります。こちらも remote URL そのものは変わりません。git remote -v では bitbucket.org のまま表示されます。
まとめ
- 2026年11月12日から
bitbucket.orgへの SSH でブラウンアウトが始まり、12月10日に使えなくなる - ワンライナーで remote URL を
ssh.bitbucket.orgに書き換えることができる - 全リポジトリをまとめて切り替えたいときは、
insteadOfか~/.ssh/configの設定を使う方法もある
CONTACT
お問い合わせ・ご依頼はこちらから