こんにちは。yunoです。
VirtualBox上に構築したUbuntu ServerへSSH接続しようとしたところ、次のエラーが発生しました。
ssh: connect to host 192.168.56.11 port 22: Connection refused
接続先へのping通信は成功していたため、最初はなぜSSH接続できないのか分かりませんでした。
調査した結果、今回の環境では、接続先のUbuntu ServerにOpenSSH Serverがインストールされていなかったことが原因でした。
OpenSSH ServerをインストールしてSSHサービスを起動したところ、正常に接続できるようになりました。
この記事では、実際に発生したエラーをもとに、原因の調査から修正、復旧確認までを紹介します。
1. 今回の検証環境
AnsibleでLinuxサーバ3台を管理するため、VirtualBox上にUbuntu Serverの検証環境を構築していました。
今回のSSH接続で使用したのは、次の2台です。
| 項目 | 管理サーバ | 接続先サーバ |
|---|---|---|
| ホスト名 | controller | tokyo |
| OS | Ubuntu Server 24.04 | Ubuntu Server 24.04 |
| IPアドレス | 192.168.56.10 | 192.168.56.11 |
| 役割 | Ansible管理用 | Ansible管理対象 |
ネットワークアダプターには、NATとHost-Onlyアダプターを使用しています。
今回は、controller から tokyo へのSSH接続を確認します。
2. SSH接続時にConnection refusedが発生
まず、管理サーバの controller から、接続先の tokyo へSSH接続を試しました。
ssh tokyo@192.168.56.11
ところが、次のエラーが発生しました。
ssh: connect to host 192.168.56.11 port 22: Connection refused
Connection refused は、TCP接続要求が拒否されたことを示しています。
SSH接続では通常TCPの22番ポートを使用しますが、接続先でSSHサービスが起動していない場合などに、このエラーが発生することがあります。
ただし、このエラーだけで原因を特定することはできません。
そこで、まずは通信状況を確認することにしました。
3. pingは成功していた
SSH接続の前に、controller から tokyo へのping通信を確認していました。
ping 192.168.56.11
今回の検証では、パケットロスが0%であることを確認できていました。
つまり、少なくともICMPによるIP通信は成功しています。
ここで重要なのが、pingが成功していても、SSH接続できるとは限らないという点です。
pingとSSHでは、確認している通信が異なります。
| 項目 | ping | SSH |
|---|---|---|
| 主な目的 | 通信相手への到達性確認 | リモートログイン |
| 使用するプロトコル | ICMP | TCP |
| ポート番号 | 使用しない | 通常22番 |
| 確認できること | ICMP通信への応答 | SSH接続の可否 |
pingが成功していても、SSHサービスが停止していたり、TCPの22番ポートへの通信が制限されていたりすれば、SSH接続できません。
今回もpingは成功していたため、次は接続先サーバのSSHサービスを確認することにしました。
4. SSHサービスの状態を確認する
接続先の tokyo で、次のコマンドを実行しました。
sudo systemctl status ssh
すると、次のメッセージが表示されました。
Unit ssh.service could not be found.
このメッセージは、systemdが ssh.service というサービスユニットを見つけられなかったことを示しています。
Ubuntuでは、OpenSSH Serverを導入すると、通常 ssh.service を使用してSSHサーバを管理できます。
今回の環境では、接続先の tokyo にOpenSSH Serverがインストールされていませんでした。
そのため、SSH接続を受け付けるためのサービスが利用できない状態でした。
補足:SSHサービスが見つからない場合の確認方法
Unit ssh.service could not be found. と表示された場合でも、そのメッセージだけでOpenSSH Server未導入と断定することはできません。
パッケージの導入状況を調べるには、例えば次のコマンドを使用できます。
dpkg -l openssh-server
これは追加の確認方法です。今回の検証で実行したコマンドとして紹介しているものではありません。
パッケージの状態や、サービスユニットが存在するかを確認することで、原因をさらに絞り込めます。
5. OpenSSH Serverをインストールする
原因が分かったので、接続先の tokyo 側で修正します。
5-1. パッケージ情報を更新する
まず、次のコマンドを実行しました。
sudo apt update
これは、APTが参照するパッケージ情報を更新するコマンドです。
インストール済みのパッケージを一括でアップグレードするものではありません。
5-2. OpenSSH Serverをインストールする
続いて、OpenSSH Serverをインストールしました。
sudo apt install -y openssh-server
openssh-server は、Linuxサーバが外部からのSSH接続を受け付けるためのパッケージです。
また、-y はインストール時の確認に自動で同意するオプションです。
5-3. SSHサービスを起動する
インストール後、次のコマンドを実行しました。
sudo systemctl enable --now ssh
このコマンドでは、次の2つをまとめて実行できます。
-
enable:システム起動時にサービスが自動起動するよう設定する -
--now:今回の操作でサービスを直ちに起動する
これで、SSH接続を受け付けるための準備を進められました。
6. SSHサービスが起動しているか確認する
インストールとサービス起動後、次のコマンドを実行しました。
systemctl is-active ssh
実行結果は次のとおりです。
active
active と表示されたため、SSHサービスが起動していることを確認できました。
ただし、ここで注意したいことがあります。
SSHサービスがactiveでも、別のサーバからSSH接続できるとは限りません。
例えば、ファイアウォールやネットワーク設定によって通信が制限されている可能性もあります。
そのため、サービスの状態確認だけで終了せず、実際に接続元からSSH接続を再実行します。
7. SSH接続を再実行する
再び管理サーバの controller から、接続先の tokyo へSSH接続を試しました。
ssh tokyo@192.168.56.11
今度は正常に接続できました。
これで、今回発生した Connection refused は解消できました。
今回の検証では、OpenSSH Serverの導入とSSHサービスの起動によって、接続できる状態に復旧しました。
8. Connection refusedが発生するその他の原因
今回はOpenSSH Server未導入が原因でしたが、Connection refused が発生する原因はこれだけではありません。
例えば、次のような可能性があります。
| 考えられる原因 | 確認する内容 |
|---|---|
| OpenSSH Server未導入 | パッケージの導入状況 |
| SSHサービス停止 | systemctl status ssh |
| SSHの待受ポートが異なる | SSHサーバの設定 |
| 接続先IPアドレスの誤り | 接続先のIPアドレス |
| ファイアウォールによる拒否 | 通信制御の設定 |
なお、ファイアウォールが通信を破棄する設定になっている場合は、Connection refused ではなくタイムアウトになることもあります。
また、SSH接続時には、ほかにも次のようなエラーが発生することがあります。
| エラー | 主に確認すること |
|---|---|
Connection refused |
SSHサービス・待受ポート・接続先 |
Connection timed out |
通信経路・ファイアウォール・到達性 |
Permission denied (publickey) |
公開鍵認証・ユーザー・権限設定 |
これらは、すべて同じ原因で発生するわけではありません。
エラーメッセージを確認し、通信・サービス・認証のどの段階で問題が発生しているかを切り分けることが重要です。
※この節は一般的な参考情報です。今回の実機検証で再現したエラーは Connection refused のみです。
9. 今回の原因と対応を整理する
今回の検証結果をまとめると、次のようになります。
| 確認項目 | 実際の結果 |
|---|---|
| ping通信 | 成功 |
| 最初のSSH接続 | Connection refused |
| SSHサービス確認 | Unit ssh.service could not be found. |
| 原因 | OpenSSH Server未導入 |
| 修正 | openssh-serverのインストールとサービス起動 |
| SSHサービス状態 | active |
| SSH再接続 | 成功 |
今回の切り分けは、次の流れでした。
controllerからtokyoへping
↓
通信成功
↓
SSH接続を試す
↓
Connection refused
↓
tokyo側でSSHサービスを確認
↓
ssh.serviceが見つからない
↓
OpenSSH Server未導入と判明
↓
OpenSSH Serverをインストール
↓
SSHサービスを起動
↓
サービス状態がactive
↓
controllerからSSH再接続
↓
接続成功
今回の経験から、pingが成功していても、SSH接続に必要なサービスまで正常とは限らないことが分かりました。
また、エラーが発生した際に、すぐにネットワーク設定を変更するのではなく、すでに正常だと確認できている部分と、まだ確認できていない部分を分けて考えることが重要だと感じました。
10. まとめ
今回は、Ubuntu Server 24.04の検証環境で発生した Connection refused の原因調査と解決方法を紹介しました。
今回確認できたのは、次の内容です。
-
controllerからtokyoへのping通信は成功していた - SSH接続では
Connection refusedが発生した -
systemctl status sshでSSHサービスが見つからなかった - 接続先にOpenSSH Serverがインストールされていなかった
- OpenSSH Serverをインストールし、SSHサービスを起動した
- SSHサービスが
activeになり、SSH接続にも成功した
今回の問題は、Ansibleそのものではなく、接続先LinuxサーバのSSH環境にありました。
Ansibleで複数台のLinuxサーバを管理する場合も、まずはSSHなどの基本的な通信環境が正常に動作している必要があります。
今後も、実機検証で遭遇したエラーについて、発生した問題 → 原因調査 → 修正 → 復旧確認の流れで記録していきたいと思います。
関連記事:Ansibleの環境構築から学びたい方へ
今回のSSH接続エラーは、Ansibleの検証環境を構築している途中で発生しました。
SSH接続ができるようになったら、次はAnsibleを使って複数台のLinuxサーバへ接続する環境を構築できます。
私がVirtualBox上で管理サーバ1台とLinuxサーバ3台を構築し、Inventory設定や日次点検まで実践した内容は、以下の有料noteにまとめています。
Ansible基礎編|Linuxサーバ3台の管理・日次点検まで実践
今回の記事が、SSH接続エラーで困っている方の参考になればうれしいです。
ここまでお読みいただき、ありがとうございました。