Zenn
💻

VSCodeでSSH接続が失敗する場合の対処法と設定

に公開
VS Code
SSH
Config
remotessh
tech

本記事では、Visual Studio Code（VSCode）でSSH接続時に発生するトラブルの対処法と設定方法を詳しく解説します。

前提条件

  • ローカルマシンにVSCodeとRemote-SSH拡張機能をインストール済み。
  • リモートサーバにSSH接続できること（ターミナル経由で確認済み）。

問題：SSH接続が失敗する（ポートが取得できないエラー）

VSCodeのRemote-SSH接続で以下のようなエラーが出ることがあります。

Failed to parse remote port from server output

これは主にVSCodeサーバが起動時に正しいポート番号を返さない時に発生します。

解決方法

次のコマンドで、リモートサーバ上のVSCodeサーバを一旦削除し、再接続を試みます。

ssh user@remote_host
rm -rf ~/.vscode-server
exit

この操作により、VSCodeサーバが再インストールされ、問題が解決することが多いです。

SSH設定ファイル（config）の記述方法

VSCodeで頻繁にSSH接続する場合、~/.ssh/configを設定すると便利です。

例：

Host myserver
  HostName 10.21.10.22
  User ubuntu
  IdentityFile ~/.ssh/id_rsa
  ForwardAgent yes

各項目の説明

  • Host：任意の接続名。
  • HostName：リモートサーバのIPアドレスまたはホスト名。
  • User：接続ユーザー名。
  • IdentityFile：使用するSSH秘密鍵の場所。
  • ForwardAgent：SSHエージェント転送を有効化。

VSCodeからの接続方法

  1. VSCodeの左側のメニューから Remote Explorer を開く。
  2. 接続したいサーバ名をクリックする。

または、Ctrl+Shift+P（MacはCmd+Shift+P）でコマンドパレットを開き、「Remote-SSH: Connect to Host」を選択して接続可能です。

よくある問題と対処法

SSHキー関連の問題

SSHキーを使用している場合、キーのパーミッションを正しく設定します。

chmod 600 ~/.ssh/id_rsa

サーバ上でVSCodeサーバが起動できない場合

サーバのストレージ容量やパーミッション問題を確認してください。

df -h
ls -la ~/.vscode-server

まとめ

VSCodeのRemote-SSH機能は便利ですが、時にトラブルが起きることもあります。まずは.vscode-serverを削除し、再インストールする方法を試しましょう。日常的に使用するサーバは~/.ssh/configで簡単に管理し、快適な開発環境を整えましょう！

Discussion