自宅サーバーでWebサイトを運営していると、
サーバーの設定ファイルやプログラムを編集する機会が多くなります。
以前は WinSCPでファイルをダウンロード → 編集 → アップロード という方法を使っていました。
しかし現在は VSCodeの「Remote SSH」機能を使って、サーバーを直接編集しています。
この方法だと
- ファイル転送が不要
- 保存するとサーバーに即反映
- ターミナル操作も同時にできる
というメリットがあり、かなり作業効率が良くなりました。
今回は、VSCode Remote SSHを使ってUbuntu Serverを直接編集する方法をまとめます。
開発環境
現在の環境は次の通りです。
開発PC
Windowsサーバー
Ubuntu Server
Docker
WordPress
VSCodeからSSH接続して、
サーバー上のファイルを直接編集しています。
VSCodeをインストール
まずはVSCodeをインストールします。
公式サイト

Windowsの場合はダウンロードしたインストーラーを実行するだけでOKです。
Remote SSH拡張をインストール
VSCodeを起動したら、拡張機能をインストールします。
拡張機能検索で
Remote - SSH
を検索してインストールします。
この拡張機能を使うと、
VSCodeからSSH接続してサーバーを直接編集できるようになります。
SSH接続設定
SSH接続先を設定します。
VSCodeで
Ctrl + Shift + P
を押します。
コマンドパレットが開くので
Remote-SSH: Open SSH Configuration File
を選択します。
すると
~/.ssh/config
が開きます。
ここに接続情報を書きます。
例
Host ubuntu-server
HostName 192.168.1.10
User ubuntu
Port 22
項目の意味
| 項目 | 説明 |
|---|---|
| Host | 接続名 |
| HostName | サーバーIP |
| User | ログインユーザー |
| Port | SSHポート |
VSCodeからサーバーに接続
再び
Ctrl + Shift + P
を押します。
次に
Remote-SSH: Connect to Host
を選択します。
先ほど設定した
ubuntu-server
を選択すると、SSH接続が開始されます。
初回接続時には
VSCode Serverが自動でサーバー側にインストールされます。
サーバーフォルダを開く
接続できたら
File
Open Folder
を選択します。
例えば
/var/www
などを開くと、サーバー上のファイルをそのまま編集できます。
編集すると即サーバーに反映
VSCodeでファイルを編集して保存すると、
サーバーのファイルが直接更新されます
つまり
ダウンロード
↓
編集
↓
アップロード
という作業が不要になります。
ターミナルもそのまま使える
VSCodeのターミナルを開くと
Ubuntu Serverのターミナル
がそのまま使えます。
例えば
docker ps
や
nginx -t
などもVSCode内で実行できます。
まとめ
VSCode Remote SSHを使うと、
- サーバーファイルを直接編集
- ファイル転送不要
- ターミナルも統合
- Docker操作も可能
という形で、サーバー管理がかなり効率化されます。
自宅サーバーで
- WordPress運営
- Pythonスクリプト
- Webアプリ開発
などを行う場合は、かなり便利な環境だと思います。


コメント