Linuxでcurlを使用してサーバーの接続性をテストする方法

はじめに

Linuxのシステム管理において、サーバーの接続性を確認することは基本的なスキルです。このチュートリアルでは、cURLツールを使用してサーバーの接続性をテストするプロセスを解説します。cURL（Client URL）は、さまざまなネットワークプロトコルを介してデータ転送を行うためのコマンドラインユーティリティであり、ネットワーク診断やトラブルシューティングに欠かせないツールです。

このチュートリアルを終える頃には、cURLを使用してサーバーの可用性の確認、応答時間の測定、HTTPステータスコードの分析、および接続問題のトラブルシューティングを行う方法を理解できるようになります。これらのスキルは、Webサーバー、API、あるいはLinux環境内のあらゆるネットワークサービスを管理する上で非常に役立ちます。

cURLの基本を理解する

cURLは、HTTP、HTTPS、FTPなど、さまざまなプロトコルを使用してデータを転送できる強力なコマンドラインツールです。接続テストに入る前に、cURLとは何か、そして基本的な操作方法について理解しましょう。

cURLのインストール

cURLユーティリティは、Ubuntu 22.04環境を含むほとんどのLinuxディストリビューションにプリインストールされています。cURLがインストールされているか確認するには、ターミナルを開いて以下を実行します。

curl --version

以下のような出力が表示されるはずです。

curl 7.81.0 (x86_64-pc-linux-gnu) libcurl/7.81.0 OpenSSL/3.0.2 zlib/1.2.11 brotli/1.0.9 zstd/1.4.8 libidn2/2.3.2 libpsl/0.21.0 (+libidn2/2.3.2) libssh/0.9.6/openssl/zlib nghttp2/1.43.0 librtmp/2.3 OpenLDAP/2.5.13
Release-Date: 2022-01-05
Protocols: dict file ftp ftps gopher gophers http https imap imaps ldap ldaps mqtt pop3 pop3s rtmp rtsp scp sftp smb smbs smtp smtps telnet tftp
Features: alt-svc AsynchDNS brotli GSS-API HSTS HTTP2 HTTPS-proxy IDN IPv6 Kerberos Largefile libz NTLM NTLM_WB PSL SPNEGO SSL TLS-SRP UnixSockets zstd

これでcURLがインストールされていること、およびバージョンとサポートされているプロトコルや機能が確認できました。

基本的なcURLの構文

cURLを使用する際の基本的な構文は以下の通りです。

curl [options] [URL]

試しに、Webサイトのコンテンツを取得する簡単なcURLコマンドを実行してみましょう。

curl https://example.com

このコマンドは、example.comに対してGETリクエストを送信し、HTMLレスポンスをターミナルに表示します。以下のようなHTMLコードが表示されるはずです。

<!doctype html>
<html>
  <head>
    <title>Example Domain</title>
    <!-- More HTML content -->
  </head>
  <body>
    <div>
      <h1>Example Domain</h1>
      <p>This domain is for use in illustrative examples in documents...</p>
      <!-- More content -->
    </div>
  </body>
</html>

出力をファイルに保存する

出力をターミナルに表示する代わりに、-o または --output オプションを使用してファイルに保存することもできます。

curl -o example.html https://example.com

このコマンドは、example.comからのレスポンスを example.html という名前のファイルに保存します。ファイルが作成されたことを確認するには、以下を実行します。

ls -l example.html

ファイルが存在することを示す出力が表示されるはずです。

-rw-rw-r-- 1 labex labex 1256 Mar 28 12:34 example.html

ファイルの内容を表示するには、以下を実行します。

cat example.html

先ほどターミナルに表示されたものと同じHTMLコンテンツが表示されるはずです。

cURLでのHTTPメソッドの理解

cURLはデフォルトでHTTP GETメソッドを使用しますが、-X オプションを使用して他のメソッドを指定することもできます。一般的なHTTPメソッドには以下が含まれます。

GET: サーバーからデータを取得する
POST: サーバーにデータを送信する
PUT: サーバー上の既存データを更新する
DELETE: サーバー上のデータを削除する
HEAD: GETと似ているが、ヘッダーのみを取得する

後のステップでは、これらの異なるメソッドを使用してサーバーの接続性や機能をテストする方法を探ります。

基本的なサーバー接続テスト

cURLの基本を理解したところで、それを使ってサーバーの接続性をテストしてみましょう。サーバーが稼働しており、正しく応答しているかを確認する能力は、システム管理者や開発者にとって不可欠なスキルです。

単純な接続テスト

最も基本的な接続テストは、サーバーにリクエストを送信して応答があるかを確認することです。Googleのサーバーへの接続性をテストしてみましょう。

curl -I https://www.google.com

-I オプション（または --head）は、cURLに対してHEADリクエストを送信するように指示します。これにより、ボディコンテンツなしでヘッダーのみが取得されます。これは迅速な接続確認に便利です。以下のような出力が表示されるはずです。

HTTP/2 200
content-type: text/html; charset=ISO-8859-1
date: Tue, 28 Mar 2023 12:34:56 GMT
server: gws
content-length: 219
x-xss-protection: 0
x-frame-options: SAMEORIGIN

HTTP/2 200 は接続が成功したことを示しており、サーバーが稼働して応答していることがわかります。

HTTPステータスコードの確認

HTTPステータスコードは、クライアントのリクエスト結果を示すためにサーバーが送信する標準化された応答です。一般的なステータスコードには以下があります。

200: OK - リクエストが成功した
301/302: リダイレクト - リソースが移動した
404: Not Found - リソースが存在しない
500: Internal Server Error - サーバーでエラーが発生した

存在しないURLをテストして、404応答を確認してみましょう。

curl -I https://www.google.com/nonexistent-page

出力には404ステータスコードが含まれるはずです。

HTTP/2 404
content-type: text/html; charset=UTF-8
date: Tue, 28 Mar 2023 12:35:01 GMT
server: gws
content-length: 1565
...

応答時間の測定

サーバーが応答するまでにかかる時間を測定するには、-w オプションとフォーマット文字列を使用します。

curl -s -o /dev/null -w "Connect: %{time_connect}s\nTotal: %{time_total}s\n" https://www.google.com

このコマンドの解説：

-s: サイレントモードで動作（進捗やエラーメッセージを表示しない）
-o /dev/null: 出力を /dev/null にリダイレクト（破棄）する
-w "...": タイミング情報を含むフォーマットされた出力を表示する

以下のような出力が表示されるはずです。

Connect: 0.052s
Total: 0.157s

これにより、接続を確立するまでにかかった時間と、リクエストが完了するまでの合計時間がわかります。

ドメイン名解決のテスト

接続の問題はDNSに起因することがあります。ドメイン名がIPアドレスに解決できるかをテストするには、以下を実行します。

curl -v https://www.example.com 2>&1 | grep "Trying"

これは -v（verbose）オプションを使用し、接続先のIPアドレスを示す "Trying" 行をフィルタリングしています。以下のような出力が表示されるはずです。

* Trying 93.184.216.34:443...

これで、ドメイン名が正常にIPアドレスに解決されたことが確認できました。

単純な接続テストスクリプトの作成

複数のサイトへの接続性をテストする簡単なシェルスクリプトを作成してみましょう。テキストエディタを開きます。

nano connection_test.sh

ファイルに以下の内容を追加します。

#!/bin/bash

echo "Testing server connectivity..."

for site in google.com example.com github.com nonexistent-site.xyz; do
  echo -n "Testing $site: "

  ## 5秒のタイムアウトでcurlを使用
  status_code=$(curl -s -o /dev/null -w "%{http_code}" --connect-timeout 5 "https://$site" 2> /dev/null)

  if [ $? -eq 0 ] && [ "$status_code" -lt 400 ]; then
    echo "OK (Status: $status_code)"
  else
    echo "Failed (Status: $status_code)"
  fi
done

echo "Testing complete!"

Ctrl+O を押して Enter で保存し、Ctrl+X で終了します。

スクリプトを実行可能にします。

chmod +x connection_test.sh

スクリプトを実行します。

./connection_test.sh

各サイトの接続状態を示す出力が表示されるはずです。

Testing server connectivity...
Testing google.com: OK (Status: 200)
Testing example.com: OK (Status: 200)
Testing github.com: OK (Status: 200)
Testing nonexistent-site.xyz: Failed (Status: 000)
Testing complete!

このスクリプトを使用すると、複数のサーバーへの接続性を一度に素早く確認できます。

cURLによる高度な接続テスト

基本的な接続テストを理解したところで、詳細なトラブルシューティングやテストに役立つcURLの高度な機能を探ってみましょう。

詳細デバッグのためのVerboseモードの使用

Verboseモード（-v オプション）は、リクエストとレスポンスの全プロセスを表示するため、接続問題のトラブルシューティングに非常に役立ちます。

curl -v https://example.com

出力は包括的で、DNS解決、TLSハンドシェイク、リクエストヘッダー、レスポンスヘッダーなどが表示されます。

*   Trying 93.184.216.34:443...
* Connected to example.com (93.184.216.34) port 443 (#0)
* ALPN: offers h2
* ALPN: offers http/1.1
* TLSv1.3 (OUT), TLS handshake, Client hello (1):
* TLSv1.3 (IN), TLS handshake, Server hello (2):
* TLSv1.3 (IN), TLS handshake, Encrypted Extensions (8):
* TLSv1.3 (IN), TLS handshake, Certificate (11):
* TLSv1.3 (IN), TLS handshake, CERT verify (15):
* TLSv1.3 (IN), TLS handshake, Finished (20):
* TLSv1.3 (OUT), TLS handshake, Finished (20):
* SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384
* ALPN: server accepted h2
* Server certificate:
*  subject: C=US; ST=California; L=Los Angeles; O=Internet Corporation for Assigned Names and Numbers; CN=www.example.org
*  start date: Nov 24 00:00:00 2022 GMT
*  expire date: Nov 24 23:59:59 2023 GMT
*  subjectAltName: host "example.com" matched cert's "example.com"
*  issuer: C=US; O=DigiCert Inc; CN=DigiCert TLS RSA SHA256 2020 CA1
*  SSL certificate verify ok.
* using HTTP/2
* h2 [:method: GET]
* h2 [:path: /]
* h2 [:scheme: https]
* h2 [:authority: example.com]
* h2 [user-agent: curl/7.81.0]
* h2 [accept: */*]
* Using Stream ID: 1
> GET / HTTP/2
> Host: example.com
> user-agent: curl/7.81.0
> accept: */*
>
* TLSv1.3 (IN), TLS handshake, Newsession Ticket (4):
* Connection state changed (MAX_CONCURRENT_STREAMS == 100)!
< HTTP/2 200
< age: 587269
< cache-control: max-age=604800
< content-type: text/html; charset=UTF-8
< date: Tue, 28 Mar 2023 12:40:01 GMT
< etag: "3147526947+ident"
< expires: Tue, 04 Apr 2023 12:40:01 GMT
< last-modified: Thu, 17 Oct 2019 07:18:26 GMT
< server: ECS (nyb/1D2B)
< vary: Accept-Encoding
< x-cache: HIT
< content-length: 1256
<
<!doctype html>
<html>
<head>
    <title>Example Domain</title>
    <!-- More HTML content -->
</head>
<body>
    <div>
        <h1>Example Domain</h1>
        <p>This domain is for use in illustrative examples in documents...</p>
        <!-- More content -->
    </div>
</body>
</html>
* Connection #0 to host example.com left intact

この詳細な出力により、接続がどこで失敗しているかを正確に特定できます。

異なるHTTPメソッドのテスト

テスト用APIエンドポイントに対してPOSTリクエストをテストしてみましょう。

curl -X POST -d "name=test&email=test@example.com" https://httpbin.org/post

このコマンドの解説：

-X POST: POSTリクエストを指定
-d "name=test&email=test@example.com": リクエストでフォームデータを送信

送信したデータを示すJSONレスポンスが返ってくるはずです。

{
  "args": {},
  "data": "",
  "files": {},
  "form": {
    "email": "test@example.com",
    "name": "test"
  },
  "headers": {
    "Accept": "*/*",
    "Content-Length": "32",
    "Content-Type": "application/x-www-form-urlencoded",
    "Host": "httpbin.org",
    "User-Agent": "curl/7.81.0",
    "X-Amzn-Trace-Id": "Root=1-642295b1-0d2340ef34f2e8ea6270241a"
  },
  "json": null,
  "origin": "198.51.100.42",
  "url": "https://httpbin.org/post"
}

カスタムヘッダーを使用したテスト

多くのAPIでは、認証やコンテンツタイプの指定のために特定のヘッダーが必要です。これをテストしてみましょう。

curl -H "User-Agent: MyCustomAgent" -H "Authorization: Bearer test-token" https://httpbin.org/headers

このコマンドの解説：

-H "User-Agent: MyCustomAgent": カスタムUser-Agentヘッダーを設定
-H "Authorization: Bearer test-token": Authorizationヘッダーを設定

レスポンスには、リクエストで送信されたヘッダーが表示されます。

{
  "headers": {
    "Accept": "*/*",
    "Authorization": "Bearer test-token",
    "Host": "httpbin.org",
    "User-Agent": "MyCustomAgent",
    "X-Amzn-Trace-Id": "Root=1-642295c3-73cac0a73b34b1c93a8ce520"
  }
}

異なるエンドポイントの応答時間のテスト

異なるサーバーの応答時間を比較するスクリプトを作成してみましょう。

nano response_time.sh

以下の内容を追加します。

#!/bin/bash

echo "Testing response times..."

for site in google.com bing.com baidu.com duckduckgo.com yahoo.com; do
  echo -n "$site: "
  curl -s -o /dev/null -w "%{time_total}s" "https://$site"
  echo ""
done

echo "Testing complete!"

ファイルを保存し、実行可能にします。

chmod +x response_time.sh

スクリプトを実行します。

./response_time.sh

各サイトの応答時間が表示されます。

Testing response times...
google.com: 0.187s
bing.com: 0.232s
baidu.com: 0.412s
duckduckgo.com: 0.298s
yahoo.com: 0.342s
Testing complete!

これは、異なるサーバーのパフォーマンスを比較したり、サーバーのパフォーマンスを長期的に監視したりするのに便利です。

特定のポートへのTCP接続テスト

サーバー上の特定のポートが開いているかを確認する必要がある場合があります。cURLはこれにも使用できます。

curl -v telnet://example.com:80

ポートが開いている場合、接続成功メッセージが表示されます。

* Trying 93.184.216.34:80...
* Connected to example.com (93.184.216.34) port 80 (#0)

Ctrl+C を押して接続を終了します。

同様に、セキュアな接続もテストできます。

curl -v https://example.com:443

Verbose出力により、接続が成功したか、問題があったかがわかります。

包括的なサーバー監視ツールの作成

cURLを使用した接続テストのさまざまな手法を学んだところで、それらを組み合わせた、より包括的なサーバー監視ツールを作成してみましょう。

包括的なサーバー監視スクリプト

新しいスクリプトファイルを作成します。

nano server_monitor.sh

以下の内容を追加します。

#!/bin/bash

## サーバー監視スクリプト
## 指定されたサーバーの可用性とパフォーマンスをチェックします

## 出力用の色を定義
GREEN='\033[0;32m'
RED='\033[0;31m'
YELLOW='\033[0;33m'
NC='\033[0m' ## 色なし

## サーバー状態をチェックする関数
check_server() {
  local url=$1
  local timeout=5

  echo -e "\n${YELLOW}Testing $url:${NC}"

  ## 接続をテストしてステータスコードを取得
  status_code=$(curl -s -o /dev/null -w "%{http_code}" --connect-timeout $timeout "$url" 2> /dev/null)

  if [ "$status_code" -eq 200 ]; then
    echo -e "${GREEN}✓ Status: $status_code (OK)${NC}"
  elif [ "$status_code" -ge 100 ] && [ "$status_code" -lt 400 ]; then
    echo -e "${GREEN}✓ Status: $status_code (Success/Redirect)${NC}"
  elif [ "$status_code" -ge 400 ] && [ "$status_code" -lt 500 ]; then
    echo -e "${RED}✗ Status: $status_code (Client Error)${NC}"
  elif [ "$status_code" -ge 500 ]; then
    echo -e "${RED}✗ Status: $status_code (Server Error)${NC}"
  else
    echo -e "${RED}✗ Status: Connection failed${NC}"
  fi

  ## 接続が成功した場合に応答時間を測定
  if [ "$status_code" -gt 0 ]; then
    response_time=$(curl -s -o /dev/null -w "%{time_total}" --connect-timeout $timeout "$url" 2> /dev/null)
    echo -e "• Response time: ${response_time}s"

    ## サーバーヘッダーを取得
    echo "• Server headers:"
    curl -s -I --connect-timeout $timeout "$url" | grep -E 'Server:|Content-Type:|Date:' | sed 's/^/  /'
  fi
}

## メイン関数
main() {
  echo -e "${YELLOW}===== Server Connectivity Monitor =====${NC}"
  echo "Started at: $(date)"

  ## 監視するサーバーのリスト
  servers=(
    "https://www.google.com"
    "https://www.github.com"
    "https://www.example.com"
    "https://httpbin.org/status/404" ## 404ステータスを返す
    "https://httpbin.org/status/500" ## 500ステータスを返す
  )

  ## 各サーバーをチェック
  for server in "${servers[@]}"; do
    check_server "$server"
  done

  echo -e "\n${YELLOW}===== Monitoring Complete =====${NC}"
  echo "Finished at: $(date)"
}

## メイン関数を実行
main

ファイルを保存し、実行可能にします。

chmod +x server_monitor.sh

スクリプトを実行します。

./server_monitor.sh

各サーバーの包括的なステータス概要が表示されます。

===== Server Connectivity Monitor =====
Started at: Tue Mar 28 13:15:01 UTC 2023

Testing https://www.google.com:
✓ Status: 200 (OK)
• Response time: 0.186s
• Server headers:
  Date: Tue, 28 Mar 2023 13:15:02 GMT
  Content-Type: text/html; charset=ISO-8859-1
  Server: gws

Testing https://www.github.com:
✓ Status: 200 (OK)
• Response time: 0.247s
• Server headers:
  Server: GitHub.com
  Date: Tue, 28 Mar 2023 13:15:02 GMT
  Content-Type: text/html; charset=utf-8

Testing https://www.example.com:
✓ Status: 200 (OK)
• Response time: 0.132s
• Server headers:
  Content-Type: text/html; charset=UTF-8
  Date: Tue, 28 Mar 2023 13:15:03 GMT
  Server: ECS (nyb/1D2B)

Testing https://httpbin.org/status/404:
✗ Status: 404 (Client Error)
• Response time: 0.189s
• Server headers:
  Date: Tue, 28 Mar 2023 13:15:03 GMT
  Content-Type: text/html; charset=utf-8
  Server: gunicorn/19.9.0

Testing https://httpbin.org/status/500:
✗ Status: 500 (Server Error)
• Response time: 0.192s
• Server headers:
  Date: Tue, 28 Mar 2023 13:15:03 GMT
  Content-Type: text/html; charset=utf-8
  Server: gunicorn/19.9.0

===== Monitoring Complete =====
Finished at: Tue Mar 28 13:15:04 UTC 2023

定期的な接続チェックのスケジュール

サーバーを定期的に監視するには、cronジョブを設定できます。実際の運用環境では、このスクリプトをcrontabに追加して定期的に実行するかもしれません。デモンストレーションとして、指定した期間、1分ごとに監視を実行する簡単なラッパースクリプトを作成してみましょう。

nano scheduled_monitor.sh

以下の内容を追加します。

#!/bin/bash

## スケジュール監視スクリプト
## server_monitor.sh を定期的に実行します

## 期間パラメータが提供されているかチェック
if [ $## -ne 1 ]; then
  echo "Usage: $0 <duration_in_minutes>"
  exit 1
fi

duration=$1
interval=60 ## 秒
iterations=$((duration * 60 / interval))

echo "Starting scheduled monitoring for $duration minutes..."
echo "Press Ctrl+C to stop monitoring"

for ((i = 1; i <= iterations; i++)); do
  echo -e "\n===== Run $i of $iterations ====="
  ./server_monitor.sh

  ## 最後の反復の後はスリープしない
  if [ $i -lt $iterations ]; then
    echo "Next check in $interval seconds..."
    sleep $interval
  fi
done

echo "Scheduled monitoring completed."

ファイルを保存し、実行可能にします。

chmod +x scheduled_monitor.sh

2分間スクリプトを実行します（必要に応じて増減可能です）。

./scheduled_monitor.sh 2

これにより、サーバー監視スクリプトが2分間、1分ごとに実行されます。

Starting scheduled monitoring for 2 minutes...
Press Ctrl+C to stop monitoring

===== Run 1 of 2 =====
===== Server Connectivity Monitor =====
...
(monitoring output)
...
Next check in 60 seconds...
(waits for 60 seconds)

===== Run 2 of 2 =====
===== Server Connectivity Monitor =====
...
(monitoring output)
...
Scheduled monitoring completed.

運用環境では通常cronジョブを設定しますが、このスクリプトは、この実験演習中にスケジュールされた監視を実行する簡単な方法を提供します。

まとめ

この実験では、Linux環境でサーバーの接続性をテストするためにcURLを使用する方法を学びました。基本から始め、単純なHTTPリクエストの送信やレスポンスのファイル保存方法を習得しました。その後、HTTPステータスコードの確認、応答時間の測定、詳細デバッグのためのVerboseモードの使用など、より複雑な操作へと進みました。

サーバー監視や接続テストにおけるcURLの威力を示す、いくつかの実用的なスクリプトを作成しました。

複数のサーバーへの接続性をチェックする基本的な接続テストスクリプト
サーバーのパフォーマンスを測定・比較する応答時間比較スクリプト
サーバーの状態、応答時間、ヘッダー情報に関する詳細を提供する包括的なサーバー監視ツール
定期的な接続チェックを自動化するスケジュール監視スクリプト

これらのツールと手法は、システム管理者、開発者、およびネットワークシステムを扱うすべての人にとって非常に貴重です。cURLを習得したことで、Linux環境における接続問題の診断と解決のための強力なツールを手に入れました。

今後もLinuxシステムを扱う上で、cURLは接続テストだけでなく、APIとの対話、ファイルのダウンロード、さまざまなネットワーク関連タスクの自動化にも役立つことを覚えておいてください。この実験で得たスキルは、将来のより高度なネットワーク運用やトラブルシューティングの基盤となります。