CUIとVSCodeからUbuntuにSSH接続する方法（GUIも）

Last updated at 2025-04-11Posted at 2024-05-15

はじめに

Windows(WSLも含む）またはmacOSからUbuntu22.04へSSH接続する方法について解説します。以下の4つの方法について解説します。

サーバPCのIPアドレスを確認する
サーバ（Ubuntu 22.04）で以下のコマンドをターミナルから実行し、IPアドレスを調べます。
```
ip a
```
リモートログインの有効化
サーバPCで「設定」→「共有」→「リモートログイン」をONにします。
OpenSSHのインストール
OpenSSHをインストールします。システムを最新の状態にし、OpenSSHをインストールしてください。
```
sudo apt update && sudo apt upgrade
sudo apt install openssh-server
```
インストールが完了したら、OpenSSHを有効にします。
次のコマンドを実行してください。
```
sudo systemctl enable --now ssh
```

拡張機能のインストール
VSCodeに「Remote - SSH」拡張機能をインストールします。
SSH設定ファイルの編集
- Ctrl+Shift+P を押してコマンドパレットを開きます。
- 「Remote-SSH: SSH 構成ファイルを開く」を選択します。
- configファイルに以下の設定を追加します。
```
Host 任意のホスト名
    HostName IP_ADDRESS
    User USER_NAME
```

SSH鍵を利用することで、毎回パスワードを入力する手間を省くことができます。

クライアントPCで以下のコマンドを実行します。
```
ssh-keygen -t rsa -b 4096 -C "your-email@example.com"
```
公開鍵（id_rsa.pub）をサーバに登録します。

方法1（Windows＆WSL＆macOS）

以下のコマンドを順に実行します。

scp ~/.ssh/id_rsa.pub USER_NAME@IP_ADDRESS:~/
ssh USER_NAME@IP_ADDRESS
mkdir -p ~/.ssh
cat id_rsa.pub >> ~/.ssh/authorized_keys
rm ~/id_rsa.pub

X11アプリケーションを表示する方法について解説します。

WindowsからUbuntu 22.04のX11アプリケーション（GUI）を表示するには、SSH接続時に-Xまたは-Yオプションを使用します。以下に手順を説明します。

クライアント側の準備
Windows上でX11サーバ（例：XmingやVcXsrv）をインストールし、起動しておきます。 macOSの場合はXQuartzでできます。

ターミナルを開きます。
-Xまたは-Yオプションを付けてSSH接続します。
```
ssh -X USER_NAME@IP_ADDRESS
```
- -X：X11転送を有効にします。
- -Y：信頼済みのX11転送を有効にします。（セキュリティのリスクが低い環境で推奨）
接続後DISPLAYの設定をします。（クライアント側のIPアドレスであることに注意してください）
```
export DISPLAY=CLIENT_IP_ADDRESS:0.0
```
X11アプリケーションを起動します。例として、xclockを実行します。
```
xclock
```
正常に動作していれば、クライアント側の画面にアプリケーションのウィンドウが表示されます。

VSCodeのRemote - SSHでX11転送を有効にするには、SSH構成ファイルに以下を追加します。

configファイルを編集します。

Host 任意のホスト名
    HostName IP_ADDRESS
    User USER_NAME
    ForwardX11 yes
    ForwardX11Trusted yes

※Remote - SSH拡張機能はWindowsのsshを使用しています。そのため、WSLの公開鍵をサーバーにコピーしても、VSCodeのRemote - SSH拡張機には反映されないことに注意してください。

この設定により、Windows上でUbuntuサーバのGUIアプリケーションを表示できるようになります。

SSH機能の対応バージョン
VScodeのSSH接続はx86_64であればUbuntu 16.04以降、AArch64であればUbuntu18.04以降でサポートされています（2024年12月時点）。
XサーバでGUI表示する際macOSだと表示できないアプリケーションがある
ParaviewやRvizの表示をすると、以下のようなエラーを吐き表示できませんでした。
```
libGL error: No matching fbConfigs or visuals found
libGL error: failed to load driver: swrast
```
2.7.8にダウングレードすれば動くとありました。しかしこれを行うと、そもそもSSH接続ができなくなりました。2016年と情報が古い情報だったので、他の依存ソフトの影響で対処できなくなったのかもしれません。もし、解決方法があれば更新します。