MAGAZINE

ルーターマガジン

開発環境

BitbucketのSSH 接続先をssh.bitbucket.orgに切り替える方法

2026.11.12

はじめに

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

お問い合わせ・ご依頼はこちらから