はじめに
VSCodeを使ってリモートのサーバーにSSH接続して開発を行っていると,突然SSH接続ができなくなることがあります.本記事では,SSH接続ができなくなった際に試した解決策を備忘録としてまとめます.
症状
- VSCodeからSSH接続を試みるとエラーが発生する.
- コマンドライン(ターミナル)から
ssh
コマンドを使うと接続できる.
この場合,VSCodeの設定やリモートサーバーの環境に問題がある可能性が高いです.
試した対処法
1. .vscode-server
ディレクトリのリセット
VSCodeのRemote-SSH拡張機能が使用する .vscode-server
ディレクトリに問題があるのかもと思い,これを削除して再作成してみました.
.vscode-server
ディレクトリを削除
sudo rm -rf ~/.vscode-server
.vscode-server
ディレクトリを再作成
mkdir ~/.vscode-server
パーミッションの設定(777ではなく,775でもいいかも)
sudo chmod 777 ~/.vscode-server
2. ディスク容量の確認
1をしてだけではだめだったので,次にしたことです.
ディスクの空き容量が不足していると,VSCodeのリモートサーバー関連の処理が正常に動作しないことがあります.空き容量を確認し,不要なデータを削除します.
ディスク使用状況の確認
df -h
出力例(ディスク容量が不足している場合)
Filesystem Size Used Avail Use% Mounted on
/dev/nvme0n1p2 916G 881G 0 100% /
上記のように Use%
が100%になっていると,空き容量がなくなっています.
不要なデータを削除
私直近で大規模なデータをダウンロードしていたので,それが原因だったようです.
ディスクを圧迫している可能性があります.不要なファイルを削除し,容量を確保します.
再確認(空き容量が確保されたか確認)
df -h
出力例(空き容量が確保された場合)
Filesystem Size Used Avail Use% Mounted on
/dev/nvme0n1p2 916G 836G 34G 97% /
3. VSCodeからSSH接続を再試行
ディスク容量を確保し,.vscode-server
の設定をリセットした後,VSCodeから再度SSH接続を試みます.
結果,無事にSSH接続できるようになりました.
まとめ
VSCodeでSSH接続ができなくなった場合,以下の点を確認することで解決できる可能性があります.
-
.vscode-server
ディレクトリのリセット - ディスク容量の確認と不要なデータの削除
- 再度VSCodeからSSH接続を試す