Cursorで突然、Remote - SSHによるSSH接続ができなくなったら

CursorのSSH接続で突然エラーが出た時の対処法

はじめに

CursorでSSH接続すると、サーバー上にcursor-serverという開発環境がダウンロードされ、それを起動してローカルから接続する仕組みになっているようです。VS Codeのフォークなので、基本的にはVS Codeと同じ仕組みのはず。

普段は問題なく接続できていたのに、突然エラーで接続できなくなった場合、このcursor-server周りのトラブルを疑うと良いです。

エラーの例

"hoge" への接続を確立できません: Got bad result from install script.

このようなエラーが出る場合、cursor-serverのダウンロードやインストールに失敗している可能性があります。

起きるとき

VPN内のサーバーに対してCursorでSSH接続を確立しようとしているときに、VPNが不安定になって切れたときはほぼ毎回起こっている気がします。

解決方法

まず、ターミナル等別の手段でサーバーにSSH接続します。

サーバー上で以下のコマンドを実行し、cursor-serverを削除します。

cd ~/
rm -rf .cursor-server

その後、再度SSH接続を行うと、新しくcursor-serverのダウンロードとインストールが始まります。これが完了するまで待つと、接続できるようになるかもしれません。

参考

本当にわからない VSCode の設定

VS Code の Remote Development は仕組みを理解してないと危ない