nginx バージョンの調べ方：初心者向け解説

By /

Nginx バージョンの調べ方：初心者向け徹底解説（約5000語）

はじめに：Nginx とは何か、そしてなぜバージョンを知る必要があるのか？

インターネットの世界でウェブサイトを公開したり、ウェブアプリケーションを動かしたりするためには、「ウェブサーバー」と呼ばれるソフトウェアが必要です。ウェブサーバーは、あなたがブラウザでウェブサイトのアドレス（URL）を入力したときに、そのウェブサイトの情報を持っているコンピューター（サーバー）にリクエストを送り、サーバーから送り返されてきた情報をあなたのブラウザに表示する役割を担います。

ウェブサーバーにはいくつかの種類がありますが、その中でも特に人気があり、世界中の多くのウェブサイトで使われているのが Nginx（エンジンエックス） です。Nginx は、高速で高性能なウェブサーバーであるだけでなく、リバースプロキシ、ロードバランサー、HTTPキャッシュなどの機能も持ち合わせており、現代のウェブインフラストラクチャにおいて非常に重要な役割を果たしています。Facebook、Netflix、Airbnb といった大規模なサービスでも Nginx が利用されています。

さて、あなたが Nginx を使って何かをしようとする際、あるいはすでに Nginx を使っている環境を管理する際に、必ず知っておくべき基本的な情報の一つが Nginx のバージョン です。

「バージョンなんて、動いていれば気にしなくてもいいんじゃないの？」と思うかもしれません。しかし、Nginx のバージョンを知ることは、安全に、効率的に、そして問題なく Nginx を利用し続ける上で、非常に重要な意味を持ちます。

なぜバージョンを知る必要があるのでしょうか？主な理由は以下の通りです。

  1. セキュリティの確保:

    • ソフトウェアには、時として「脆弱性」と呼ばれるセキュリティ上の欠陥が見つかることがあります。Nginx も例外ではありません。古いバージョンには、すでに知られている脆弱性が含まれている可能性があり、悪意のある第三者による攻撃の標的になるリスクがあります。
    • Nginx の開発元は、これらの脆弱性を修正した新しいバージョンを定期的にリリースしています。あなたが使っているバージョンが最新のセキュリティパッチが適用されているかを確認するために、バージョン情報が必要になります。
    • 特定のセキュリティ脆弱性に関する情報が公開された際に、あなたの Nginx のバージョンがその脆弱性の影響を受ける範囲に含まれるかどうかを確認するためにも、正確なバージョン情報が不可欠です。

  2. 機能の確認と利用:

    • Nginx は常に進化しており、新しいバージョンがリリースされるたびに、新しい機能が追加されたり、既存の機能が改善されたりします。
    • あなたが使いたい特定の機能が、どのバージョンから利用可能になったのかを知ることで、現在のバージョンでその機能が使えるかどうかを判断できます。もし使えない場合は、バージョンアップを検討する必要があるでしょう。
    • 新しい設定ディレクティブ（設定ファイルに記述する命令）やモジュールは、特定のバージョン以降でなければ認識されないことがあります。

  3. 互換性の問題回避:

    • Nginx は他のソフトウェア（例: PHP、Python、Ruby など）と連携して動作することがよくあります。また、特定のサードパーティ製モジュールを追加して機能拡張を行うこともあります。
    • これらの連携するソフトウェアやモジュールが、特定のバージョンの Nginx を要求したり、あるいは特定のバージョンとの組み合わせで問題が発生したりすることがあります。互換性の問題を防ぐために、Nginx のバージョン情報が必要になります。
    • 設定ファイル（nginx.conf など）の記述方法も、ごく稀にバージョンによって変更されることがあります。

  4. 問題解決（デバッグ）:

    • Nginx が予期しない動作をしたり、エラーが発生したりした場合、その原因を特定するためにバージョン情報が非常に役立ちます。
    • オンラインで Nginx の問題について調べたり、サポートフォーラムで質問したりする際に、使っている Nginx のバージョンを正確に伝えることは、適切なアドバイスや解決策を得るための第一歩となります。特定のエラーが特定のバージョンで発生することが知られている場合もあります。
    • 特に、nginx -V コマンドで確認できる詳細なビルド情報（どのモジュールが組み込まれているか、どのようなオプションでコンパイルされたかなど）は、デバッグにおいて非常に重要な手がかりとなります。

このように、Nginx のバージョンを知ることは、日々の運用管理、トラブルシューティング、そしてシステムの安全性と安定性を維持するために不可欠なスキルです。

この記事では、Nginx を初めて使う方や、まだコマンド操作に慣れていない方を対象に、Nginx のバージョンを確認する様々な方法を、非常に詳しく、ステップバイステップで解説していきます。基本的な確認方法から、より詳細な情報の取得方法、そして様々な環境での確認方法まで、幅広くカバーします。

この記事を読めば、あなたは自信を持って Nginx のバージョンを確認できるようになるでしょう。さあ、一緒に Nginx のバージョンを確認する方法を学んでいきましょう！

Nginx バージョンの最も基本的な確認方法：コマンドライン

Nginx のバージョンを確認する最も一般的で簡単な方法は、コマンドライン（ターミナルやコマンドプロンプトとも呼ばれます）を使うことです。Nginx は、その実行ファイル自体に、バージョン情報を表示するためのオプションが用意されています。

主に以下の2つのオプションを使います。

  • -v オプション：簡易的なバージョン情報を表示
  • -V オプション：詳細なバージョン情報とビルド情報を表示

それぞれ詳しく見ていきましょう。

1. -v オプション：簡易バージョン情報の確認

nginx -v コマンドは、Nginx のバージョンを手軽に確認したい場合に便利です。実行すると、Nginx のバージョン番号だけがシンプルに表示されます。

実行方法:

Unix/Linux/macOS の場合、ターミナルを開いて以下のコマンドを入力し、Enterキーを押します。

bash
nginx -v

Windows の場合、コマンドプロンプトまたは PowerShell を開き、Nginx のインストールディレクトリに移動してから（または Nginx の実行ファイルにパスが通っていればそのまま）、以下のコマンドを入力し、Enterキーを押します。

cmd
nginx.exe -v

多くの場合、Windows で Nginx をインストールしただけではパスが通っていないため、Nginx がインストールされているフォルダ（例: C:\nginx）に移動して実行する必要があります。

cmd
cd C:\nginx
nginx.exe -v

出力例:

コマンドを実行すると、以下のような出力が表示されます。

nginx version: nginx/1.24.0

または

nginx version: nginx/1.25.2

この出力のうち、nginx/ の後に続く 1.24.0 や 1.25.2 の部分が、あなたが現在使っている Nginx のバージョン番号です。

  • 1 はメジャーバージョン
  • 24 や 25 はマイナーバージョン
  • 0 や 2 はパッチレベル

を示します。これらの数字が大きいほど、より新しいバージョンであることを意味します。

-v オプションの注意点:

-v オプションは手軽にバージョン番号を確認できますが、表示されるのはバージョン番号のみです。Nginx がどのようにビルドされたか（どのようなオプションやモジュールが有効になっているかなど）といった詳細な情報は表示されません。

また、OS のパッケージマネージャー（apt, yum, dnf など）を使ってインストールされた Nginx の場合、-v オプションの出力は Nginx 自体のバージョン番号を示しますが、OS ベンダーが独自に加えたパッチや変更が含まれている可能性もあります。より正確で詳細な情報を知りたい場合は、次に説明する -V オプションを使用することをお勧めします。

2. -V オプション：詳細バージョン情報とビルド情報の確認

nginx -V コマンドは、Nginx のバージョン情報だけでなく、その Nginx がどのようにコンパイル（ビルド）されたかに関する非常に詳細な情報を表示します。この情報は、Nginx の設定や問題解決において非常に重要になることがあります。

実行方法:

Unix/Linux/macOS の場合、ターミナルを開いて以下のコマンドを入力し、Enterキーを押します。

bash
nginx -V

Windows の場合、コマンドプロンプトまたは PowerShell を開き、Nginx のインストールディレクトリに移動してから（またはパスが通っていればそのまま）、以下のコマンドを入力し、Enterキーを押します。

cmd
nginx.exe -V

出力例:

-V オプションの出力は -v オプションと比べて非常に多くの情報が含まれます。出力例を見てみましょう（実際の出力は環境によって異なります）。

nginx version: nginx/1.24.0
built by gcc 11.4.0 (Ubuntu 11.4.0-1ubuntu1~22.04)
built with OpenSSL 3.0.2 15 Mar 2022
TLS SNI support enabled
configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --with-cc-opt='-g -O2 --fasynchronous-unwind-tables -fstack-protector-strong -Wformat -Werror=format-security -fPIC -fPIE -Wdate-time -D_FORTIFY_SOURCE=2' --with-ld-opt='-Wl,--Bdynamic -pie -Wl,-z,relro -Wl,-z,now -Wl,--as-needed -lcrypt' --with-file-aio --with-ipv6 --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_auth_request_module --with-http_stub_status_module --with-http_slice_module --with-http_transit_module --with-http_random_index_module --with-http_sub_module --with-http_dav_module --with-http_flv_module --with-http_mp4_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_autoindex_module --with-http_secure_link_module --with-http_body_filter_module --with-http_session_log_module --with-stream --with-stream_ssl_module --with-stream_realip_module --with-stream_sni_preread_module --with-stream_geoip_module --with-mail --with-mail_ssl_module --add-module=/build/nginx-U44fJb/nginx-1.24.0/debian/modules/ngx_http_subs_filter_module

この出力には、以下のような情報が含まれています。

  • nginx version: nginx/1.24.0: これは -v オプションと同じく、Nginx のバージョン番号です。
  • built by ...: Nginx の実行ファイルが、どのコンパイラ（この例では gcc）とバージョンでビルドされたかを示します。OS の情報なども含まれる場合があります。
  • built with ...: ビルド時に使用されたライブラリ（この例では OpenSSL）とそのバージョンを示します。SSL/TLS 関連の機能が有効かどうか、どのバージョンの SSL/TLS がサポートされているかなどを判断するのに役立ちます。
  • TLS SNI support enabled: 特定の機能が有効になっているかを示します。SNI（Server Name Indication）は、一つのIPアドレスで複数のSSL証明書を持つウェブサイトを運用するために必要な機能です。
  • configure arguments: ...: これが -V オプションの最も重要な部分の一つです。Nginx をコンパイルする際に指定されたオプションが全て表示されます。これらのオプションは、Nginx のインストールパス、設定ファイルのパス、ログファイルのパス、PID ファイルのパス、そして有効になっているモジュールなどを決定します。

configure arguments の読み方:

configure arguments の行には、--with-... や --add-module=... といったオプションが多数並んでいます。これらは、Nginx にどのような機能（モジュール）を組み込んでビルドしたかを示しています。

  • --prefix=/etc/nginx: Nginx がインストールされるディレクトリのプレフィックス（基準パス）を指定します。
  • --sbin-path=/usr/sbin/nginx: Nginx の実行ファイル（バイナリ）がどこにインストールされるかを指定します。
  • --conf-path=/etc/nginx/nginx.conf: デフォルトの設定ファイル（nginx.conf）の場所を指定します。
  • --error-log-path=/var/log/nginx/error.log: デフォルトのエラーログファイルの場所を指定します。
  • --http-log-path=/var/log/nginx/access.log: デフォルトのアクセスログファイル（HTTPログ）の場所を指定します。
  • --with-http_ssl_module: HTTP SSL モジュールが有効になっていることを示します。これにより、HTTPS（暗号化された通信）を利用できます。
  • --with-http_v2_module: HTTP/2 モジュールが有効になっていることを示します。これにより、最新の HTTP/2 プロトコルをサポートできます。
  • --add-module=/path/to/module: 標準で含まれていない、外部のモジュールが追加されていることを示します。

これらの情報は、あなたが Nginx を使って何か特定のことをしたいと思ったときに、「この機能を使うには、このモジュールが有効になっている必要があるな」とか、「設定ファイルはどこにあるんだろう？」といった疑問を解決するのに役立ちます。特に、特定の機能が期待通りに動作しない場合に、必要なモジュールがコンパイル時に含まれているか確認することは、デバッグの非常に重要なステップとなります。

-V オプションがなぜ重要か:

前述のように、-V オプションは単なるバージョン番号以上の情報を提供します。この情報が重要な理由をさらに詳しく見てみましょう。

  • インストールパスと設定ファイルパスの確認: 多くのNginxに関する情報は、設定ファイル（nginx.conf）に記述されています。--conf-path オプションで、その設定ファイルがどこにあるかを確認できます。また、ログファイルやPIDファイルの場所も確認できます。これらのパスを知っていることは、設定を変更したり、ログを見て問題を調査したりする上で不可欠です。
  • 有効なモジュールの確認: Nginx の機能の大部分はモジュールとして提供されます。例えば、SSL/TLS 通信を行うには http_ssl_module、リバースプロキシとして使うには標準の HTTP モジュール群、特定の認証を行うには http_auth_request_module などが必要です。あなたが使おうとしている機能が、現在の Nginx のビルドでサポートされているかどうかは、configure arguments の --with- オプションを見れば分かります。もし必要なモジュールが含まれていない場合は、その機能は利用できません（Nginx を再ビルドするか、必要なモジュールが組み込まれたバージョンをインストールする必要があります）。
  • コンパイルオプションの確認: --with-cc-opt や --with-ld-opt といったオプションは、Nginx のパフォーマンスやセキュリティ、安定性に影響を与えるコンパイル時の設定を示します。これらは通常、Nginx の熟練者が特定の要件に合わせて調整するものですが、問題が発生した場合やパフォーマンスを改善したい場合に、これらの設定が適切かどうかを確認する手がかりになります。
  • ライブラリの依存関係の確認: built with ... の情報で、Nginx が依存している重要なライブラリ（OpenSSL など）のバージョンが分かります。これらのライブラリに脆弱性が見つかることもあり、その場合、Nginx 自体のバージョンだけでなく、依存ライブラリのバージョンも確認する必要があります。

-v オプションは手軽なバージョン確認に、-V オプションはより詳細な情報を必要とする場合や問題調査に、それぞれ使い分けるのが良いでしょう。初心者の方でも、まずは -v でバージョン番号を確認し、さらに詳しく知りたいと思ったり、問題に直面したりしたときに -V を試してみる、という流れで学習していくのがおすすめです。

様々な環境での Nginx バージョン確認方法

Nginx は様々なオペレーティングシステム（OS）にインストールして利用できます。また、インストール方法もいくつかあります。ここでは、代表的な環境やインストール方法におけるバージョン確認の手順を説明します。

基本的な確認方法は nginx -v または nginx -V ですが、Nginx の実行ファイル（バイナリ）を見つける方法や、パッケージマネージャーを使った確認方法などが環境によって異なります。

1. Linux/Unix 系 OS

Linux はサーバー用途で最もよく使われる OS です。Ubuntu, CentOS, Debian, RHEL (Red Hat Enterprise Linux), Fedora, Arch Linux など、様々なディストリビューションがあります。Unix 系 OS としては macOS や FreeBSD なども含まれます。

多くの Linux ディストリビューションでは、Nginx はパッケージマネージャーを通じてインストールされます。これにより、インストールやアップデートが容易になります。

  • コマンドラインによる確認 (nginx -v, nginx -V):

    • ほとんどの Linux 環境では、Nginx をインストールすると nginx コマンドがシステムの実行パス（PATH 環境変数）に追加されます。これにより、どのディレクトリにいても nginx コマンドを実行できます。

    • ターミナルを開き、シンプルに以下のコマンドを実行します。

      “`bash
      nginx -v

      または

      nginx -V
      ``
      * もし      command not found` と表示される場合は、Nginx がインストールされていないか、Nginx の実行ファイルにパスが通っていない可能性があります。（トラブルシューティングのセクションを参照してください）

  • パッケージマネージャーによる確認:

    • パッケージマネージャーを使うと、インストールされている Nginx のバージョンだけでなく、その OS のリポジトリで提供されている Nginx のバージョン情報（利用可能な最新バージョンなど）を確認することもできます。
    • Debian/Ubuntu 系 (apt コマンド):
      • インストールされている Nginx のバージョンを確認する場合：
        bash
        apt list --installed nginx
        または
        bash
        apt show nginx | grep Version
        （apt show nginx は Nginx パッケージの詳細情報を表示します）
      • 利用可能な（リポジトリにある）Nginx のバージョンを確認する場合：
        bash
        apt list nginx
        または
        bash
        apt-cache policy nginx
        (apt-cache policy はインストール済みバージョンとリポジトリバージョンを比較するのに便利です)
    • RHEL/CentOS/Fedora 系 (yum または dnf コマンド):
      • インストールされている Nginx のバージョンを確認する場合：
        bash
        yum info nginx # CentOS 7 以前など
        # または
        dnf info nginx # CentOS 8 以降、Fedora など
        （これらのコマンドは詳細情報の中にバージョンを含みます）
      • 利用可能な（リポジトリにある）Nginx のバージョンを確認する場合：
        bash
        yum list nginx # CentOS 7 以前など
        # または
        dnf list nginx # CentOS 8 以降、Fedora など
    • パッケージマネージャーのコマンドは、Nginx 自体のバージョンだけでなく、そのパッケージがいつビルドされたか、どのリポジトリから来たか、といった情報も提供することがあります。これは、特定のディストリビューションが提供する Nginx パッケージのバージョンと、Nginx 公式サイトで公開されているバージョンが微妙に異なる場合があるため、重要な情報となり得ます。

2. Windows

Windows はサーバー OS としては Linux ほど一般的ではありませんが、開発環境や特定の用途で Nginx を利用することがあります。Windows 版の Nginx は、通常公式サイトからダウンロードして、任意のディレクトリに解凍して使用します。

  • コマンドプロンプトまたは PowerShell による確認:

    • Windows で Nginx のバージョンを確認するには、Nginx の実行ファイルがあるディレクトリに移動し、コマンドプロンプトまたは PowerShell でコマンドを実行する必要があります。
    • まず、Nginx をインストール（解凍）したディレクトリを開きます。例えば C:\nginx とします。
    • コマンドプロンプトまたは PowerShell を開きます。

    • Nginx ディレクトリに移動します。

      cmd
      cd C:\nginx
      * 以下のコマンドを実行します。

      “`cmd
      nginx.exe -v

      または

      nginx.exe -V
      ``
      * もし      nginx.exeへのパスをシステムの環境変数PATHに追加していれば、Nginx ディレクトリに移動する必要はありません。どのディレクトリからでもnginx.exe -vまたはnginx.exe -V` を実行できます。

    • Windows 版の Nginx は、Linux 版と比べて利用できるモジュールなどに制限がある場合があります。-V オプションの出力で、どのようなモジュールが組み込まれているかを確認することをおすすめします。

3. macOS

macOS も Unix ベースの OS であり、開発環境やローカルテスト目的で Nginx を使用することがあります。macOS で Nginx をインストールする最も一般的な方法は、Homebrew というパッケージマネージャーを使用することです。

  • Homebrew による確認:

    • Homebrew でインストールされた Nginx のバージョンを確認するには、以下のコマンドを使います。

      bash
      brew info nginx
      * このコマンドは、インストールされている Nginx のバージョン、インストールパス、依存関係など、詳細な情報が表示されます。表示される情報の中にバージョン番号が含まれています。
      * 例：
      nginx: stable 1.25.2 (bottled), HEAD
      ...
      この場合、インストールされているステーブルバージョンは 1.25.2 です。
      * コマンドラインで直接バージョンを確認したい場合は、Homebrew によってインストールされた Nginx の実行ファイルにパスが通っていることを確認し、以下のコマンドを実行します。

      “`bash
      nginx -v

      または

      nginx -V
      “`
      Homebrew は通常、実行ファイルに自動的にパスを設定してくれます。

  • 手動インストールまたは MacPorts による確認:

    • 公式サイトからダウンロードして手動でインストールした場合や、Homebrew 以外のパッケージマネージャー（MacPorts など）を使った場合は、インストール方法によって実行ファイルの場所が異なります。
    • 実行ファイルの場所が分かっている場合は、その場所を指定してコマンドを実行します。
      bash
      /usr/local/nginx/sbin/nginx -v # 例：手動で /usr/local/nginx にインストールした場合
      # または
      /opt/local/sbin/nginx -v # 例：MacPorts でインストールした場合

    • 実行ファイルの場所が分からない場合は、which nginx コマンドで実行ファイルのパスを調べられる場合があります。

      “`bash
      which nginx

      出力例：/usr/local/bin/nginx

      ``
      パスが分かれば、そのパスを使って      -vや-V` オプションを実行できます。

4. Docker コンテナ内

近年、Nginx は Docker コンテナとして利用されることが非常に多くなっています。Docker コンテナ内で動作している Nginx のバージョンを確認するには、そのコンテナに接続してコマンドを実行する必要があります。

  • Docker コンテナに接続して確認:

    • まず、バージョンを確認したい Nginx コンテナの ID または名前を調べます。以下のコマンドで実行中のコンテナ一覧が表示されます。

      bash
      docker ps
      * コンテナ一覧から、Nginx コンテナの CONTAINER ID または NAMES を特定します。
      * 次に、そのコンテナ内でコマンドを実行します。Nginx コンテナの多くは Linux ベースであり、シェルとして bash や sh が利用可能です。

      “`bash
      docker exec -it <コンテナIDまたはコンテナ名> bash # bash が利用可能な場合

      または

      docker exec -it <コンテナIDまたはコンテナ名> sh # sh が利用可能な場合
      “`
      このコマンドで、コンテナのシェルに接続できます。
      * コンテナのシェルに入ったら、通常の Linux 環境と同様に Nginx のバージョン確認コマンドを実行します。

      “`bash
      nginx -v

      または

      nginx -V
      ``
      * バージョン確認が終わったら、      exitコマンドでコンテナのシェルから抜けます。
      *      docker exec` コマンドは、コンテナ内で指定したコマンドを実行するものです。シェルに接続せずに、直接バージョン確認コマンドだけを実行することも可能です。

      “`bash
      docker exec <コンテナIDまたはコンテナ名> nginx -v

      または

      docker exec <コンテナIDまたはコンテナ名> nginx -V
      “`
      この場合、コマンドの出力がそのままターミナルに表示されます。こちらの方が手軽にバージョンを確認できます。

    • Docker Image の作成者によっては、Nginx の実行ファイルが標準的なパスにない場合や、シェルがインストールされていないコンテナイメージ（Distroless イメージなど）を使用している場合があります。その場合は、イメージのドキュメントを確認するか、イメージの内容を調べて実行ファイルの場所を特定する必要がありますが、一般的な公式 Nginx イメージなどでは上記のコマンドで問題なく確認できるはずです。

5. ソースコードからビルドした場合

Nginx を公式サイトからダウンロードしたソースコードを使って、自分でコンパイル・インストールした場合も、バージョン確認方法はコマンドラインが基本です。

  • コマンドラインによる確認:
    • ソースコードからビルドする場合、インストール先のディレクトリを自分で指定することが多いです。例えば --prefix=/usr/local/nginx のように指定してインストールした場合、Nginx の実行ファイルは通常 /usr/local/nginx/sbin/nginx に配置されます。

    • この場合、Nginx の実行ファイルをフルパスで指定してコマンドを実行する必要があります。

      “`bash
      /usr/local/nginx/sbin/nginx -v

      または

      /usr/local/nginx/sbin/nginx -V
      ``
      * もし、インストール時に指定したディレクトリの      sbinサブディレクトリにパスが通っている場合は、他の環境と同様にnginx -vやnginx -Vだけで実行できます。
      * ソースコードからビルドした場合、      -Vオプションのconfigure arguments` は、あなたがコンパイル時に指定したオプションがそのまま反映されます。これは、自分で特定のモジュールを追加したり、特別なコンパイルオプションを指定したりした場合に、それらが正しく反映されているかを確認するのに非常に重要です。

バージョン確認に関する応用知識

Nginx のバージョン情報は、単なる数字の羅列ではありません。そこから読み取れる情報には、Nginx の運用や管理に役立つ重要な意味が含まれています。ここでは、バージョン確認に関連するいくつかの応用的な知識を解説します。

1. ビルド情報の読み方と重要性（再確認）

先ほど -V オプションの出力で触れた configure arguments は、Nginx がどのようにビルドされたかを示す「設計図」のようなものです。この情報がなぜそれほど重要なのか、さらに掘り下げてみましょう。

  • インストールディレクトリと各種ファイルのパス:

    • --prefix=PATH：Nginx のインストール先ディレクトリのプレフィックス。他のファイルパスが相対的に決定される基準となるパスです。
    • --sbin-path=PATH：Nginx の実行ファイル（バイナリ）のパス。
    • --conf-path=PATH：主設定ファイル（nginx.conf）のパス。
    • --error-log-path=PATH：デフォルトのエラーログファイルのパス。
    • --http-log-path=PATH：デフォルトのアクセスログファイル（HTTP）のパス。
    • --pid-path=PATH：Nginx のマスタープロセスのプロセスID（PID）が書き込まれるファイルのパス。
    • これらのパスを知ることは、設定ファイルの編集、ログファイルの確認、Nginx プロセスの管理など、日常的な運用作業において不可欠です。特に複数の環境で Nginx を扱ったり、人によってインストール方法が異なったりする場合、これらのパスがどこに設定されているかを確認することが作業の第一歩となります。

  • 有効になっているモジュール:

    • --with-MODULE_NAME：Nginx に標準で付属しているモジュールを有効にしてビルドしたことを示します。例えば --with-http_ssl_module なら SSL/TLS 通信機能が有効です。
    • --add-module=PATH：Nginx に標準で付属していない、外部のサードパーティ製モジュールを追加してビルドしたことを示します。例えば、特定の高度なキャッシュ機能や Web Application Firewall (WAF) モジュールなどがこれに該当します。
    • Nginx の機能はモジュールによって提供されるため、あなたが使いたい特定の機能（例: WebSockets、GeoIP によるアクセス制御、特定の画像処理モジュールなど）が、現在使っている Nginx のビルドに含まれているかどうかは、この configure arguments を確認することで判断できます。もし必要なモジュールが含まれていない場合は、その機能は使えません。

  • コンパイルオプション (--with-cc-opt, --with-ld-opt):

    • これらは、Nginx を C コンパイラ（CC）とリンカ（LD）でビルドする際に渡される追加のオプションです。
    • --with-cc-opt='...'：コンパイラに渡されるオプション。最適化レベル (-O2)、デバッグ情報の付加 (-g)、セキュリティ関連のフラグ (-fstack-protector-strong, -Wformat, -Werror=format-security など) が含まれることが多いです。
    • --with-ld-opt='...'：リンカに渡されるオプション。共有ライブラリの扱い、セキュリティ関連のフラグ (-Wl,-z,relro -Wl,-z,now) などが含まれることが多いです。
    • これらのオプションは、Nginx の実行ファイルのパフォーマンス、サイズ、セキュリティ機能に影響を与えます。例えば、OS のパッケージで提供される Nginx は、その OS のセキュリティポリシーに沿ったコンパイルオプションでビルドされていることが多いです。自分でソースからビルドする場合は、これらのオプションをカスタマイズして、特定の目的に最適化することができます。初心者の方がこれらのオプションを直接変更する必要は少ないかもしれませんが、問題が発生した場合に、どのようなコンパイルオプションが使われているかを知ることは、原因調査の参考になることがあります。

ビルド情報は、単にバージョン番号を知るだけでなく、「この Nginx はどのような設定で、どのような機能を持って動いているのか」を理解するための、非常に貴重な情報源なのです。特に自分で Nginx をコンパイルした場合は、意図した通りのオプションでビルドされているかを確認するために、-V オプションの出力は必ず確認するべきです。

2. メインラインバージョンとステーブルバージョン

Nginx の公式サイトを見ると、ダウンロードページに「Mainline version」と「Stable version」という2つのバージョン系列があることに気づくでしょう。あなたが使っている Nginx がどちらの系列に属しているかを確認することも重要です。

  • メインラインバージョン (Mainline version):

    • 最新の開発状況を反映したバージョンです。新しい機能や改善点が積極的に取り込まれています。
    • 新しい機能を使いたい場合や、最新の修正が必要な場合に選択されます。
    • 新しい機能が含まれる分、予期しないバグが含まれている可能性も比較的高いと言えます。（ただし、Nginx の開発は安定性を重視しており、メインラインバージョンでも大きく不安定ということは少ないです。）
    • バージョン番号の形式は、通常 1.X.Y となり、X が奇数になります。（例: 1.25.x, 1.23.x, 1.21.x）

  • ステーブルバージョン (Stable version):

    • メインラインバージョンから派生し、比較的新しい機能の追加は凍結され、主にバグ修正やセキュリティパッチのみが行われるバージョンです。
    • 本番環境など、特に安定性が求められる環境での利用が推奨されます。
    • バージョン番号の形式は、通常 1.X.Y となり、X が偶数になります。（例: 1.24.x, 1.22.x, 1.20.x）

どちらのバージョン系列を使っているかを確認する方法:

nginx -v または nginx -V コマンドの出力で、バージョン番号を確認します。バージョン番号 1.X.Y の X の部分が奇数か偶数かで判断できます。

  • nginx version: nginx/1.25.2 → X が 25（奇数）なので、メインラインバージョン
  • nginx version: nginx/1.24.0 → X が 24（偶数）なので、ステーブルバージョン

あなたが使っている Nginx がどちらの系列かを知ることで、そのバージョンがどのような性質（新機能が多いか、安定性重視か）を持っているかを理解できます。もし本番環境でメインラインバージョンを使っている場合は、安定性重視の観点からステーブルバージョンへの切り替えを検討する、といった判断材料になります。

3. Nginx Plus について

Nginx には、オープンソース版の Nginx とは別に、F5, Inc. が提供する商用版の Nginx Plus があります。Nginx Plus はオープンソース版をベースに、高度な監視機能、動的リコンフィギュレーション、高度なロードバランシングアルゴリズム、セッション永続性、アクティブヘルスチェックなど、エンタープライズレベルの機能が追加されています。

もしあなたが Nginx Plus を使用している場合、バージョン表記がオープンソース版とは少し異なります。

  • バージョン表記: nginx-plus/X.Y または nginx-plus/X.YmZ といった形式になります。（例: nginx-plus/R29）R29 のような表記はリリースバージョンを示し、オープンソース版のバージョン番号とは直接対応しません。
  • バージョン確認コマンド: オープンソース版と同様に、コマンドラインで nginx -v または nginx -V を実行することでバージョンを確認できます。
    bash
    nginx -v
    # 出力例：nginx version: nginx-plus/R29
    bash
    nginx -V
    # 出力例には、nginx-plus の特定のビルド情報や、追加された商用機能に関する情報が含まれることがあります。
    Nginx Plus のバージョン表記や利用可能な機能については、Nginx Plus の公式ドキュメントを参照する必要があります。もし職場で Nginx Plus を使っている場合は、そのバージョン確認方法も把握しておきましょう。

なぜバージョンの詳細な情報 (-V) が特に重要なのか？

前述の通り、-V オプションは多くの詳細情報を提供します。これらの情報が、特に Nginx の運用や問題解決においてどれほど重要なのか、具体的なシナリオを挙げて説明します。

  1. デバッグと問題調査:

    • エラー発生時: Nginx が起動しない、特定のページでエラーが発生する、リクエスト処理に失敗するなど、問題が発生した場合、まず確認すべきことの一つが Nginx のログファイルです（パスは -V の --error-log-path で確認できます）。ログに記録されたエラーメッセージは、問題の原因を特定する手がかりとなりますが、そのエラーがどのバージョンで発生しているか、どのようなモジュールが有効になっているかは、原因特定の非常に重要な情報となります。例えば、特定のモジュール（例: サードパーティ製のモジュール）との組み合わせでバグが発生している場合、そのモジュールの名前が -V の出力に含まれているかを確認します。また、設定ファイルパスが分かれば、すぐに設定内容を確認できます。
    • 予期しない動作: Nginx が設定通りに動かない場合、考えられる原因は設定ミス、モジュールの不足、バージョン特有の挙動などが考えられます。-V オプションで有効なモジュール一覧を確認し、必要なモジュールが含まれているかをチェックすることは、設定内容を疑う前にできる重要なステップです。例えば、gzip 圧縮が効かない場合に --with-http_gzip_module が含まれているかを確認するなどです。

  2. セキュリティ関連の確認:

    • 脆弱性の影響確認: 特定のバージョンの Nginx や、Nginx が依存するライブラリ（OpenSSL など）にセキュリティ脆弱性が見つかったというニュースを聞いたとします。その脆弱性が、あなたが使っている Nginx のバージョンに影響するかどうかは、nginx version: ... と built with OpenSSL ... の情報を確認することで判断できます。もし影響を受けるバージョンであれば、速やかにバージョンアップや回避策の適用を検討する必要があります。
    • セキュリティ機能の有効化: 一部のセキュリティ機能（例: 特定の暗号スイートのサポート、SNI、HTTP/2 の特定のセキュリティ強化機能など）は、コンパイルオプションや依存ライブラリのバージョンに依存します。-V オプションの出力で、これらの機能が有効になっているかを確認できます。例えば、最近のサイトでは必須になりつつある HTTP/2 を使うためには、--with-http_v2_module が含まれている必要があります。

  3. パフォーマンスチューニング:

    • Nginx のパフォーマンスは、コンパイル時に指定されるオプションによって微妙に異なる場合があります。例えば、特定の最適化フラグや、特定のプラットフォームに合わせたビルドオプションが指定されているかどうかは、パフォーマンスに影響を与える可能性があります。また、高性能なサードパーティ製モジュール（例えば、より高速なキャッシュや圧縮モジュール）が組み込まれているかどうかも、-V の出力で確認できます。

  4. 新しい機能の利用可能性確認:

    • Nginx の新しいバージョンがリリースされると、新しい機能や設定ディレクティブが追加されます。あなたが使いたい新しい機能が、現在のバージョンで利用可能かどうかは、まずバージョン番号を確認します。そして、もしその機能が特定のモジュールに依存する場合は、-V オプションの出力でそのモジュールが有効になっているかを確認する必要があります。

  5. 環境の標準化と再現性:

    • 複数のサーバーで同じ構成の Nginx を運用する場合、すべてのサーバーで Nginx のバージョン、依存ライブラリ、そしてコンパイルオプションが一致していることを確認することは非常に重要です。これは、環境による挙動の違いを防ぎ、問題発生時の原因特定を容易にします。-V オプションの出力を比較することで、環境間の違いを詳細に把握できます。特に、自動化されたデプロイメントを行う場合、特定のバージョン・ビルドの Nginx が確実にデプロイされているかを確認するステップとして -V の出力チェックを組み込むことがあります。

このように、-V オプションが提供する詳細なビルド情報は、Nginx を安全に、効率的に、そして安定して運用するために、初心者の方から経験豊富な管理者まで、すべての人にとって不可欠なものです。最初は全ての情報の意味を理解する必要はありませんが、バージョン番号、コンパイルオプションに含まれるパス、そして --with- で始まるモジュール名の部分は、特に注目して見る価値があります。

バージョン確認で困ったときは？（トラブルシューティング）

Nginx のバージョンを確認しようとして、予期しない状況に遭遇することがあります。ここでは、バージョン確認時によくある問題とその解決策について説明します。

  1. nginx コマンドが見つからない (command not found)

    • 原因:
      • Nginx がシステムにインストールされていない。
      • Nginx はインストールされているが、その実行ファイル（バイナリ）があるディレクトリが、システムの実行パス（PATH 環境変数）に含まれていない。
    • 解決策:
      • まず、本当に Nginx がインストールされているか確認します。Linux の場合は、パッケージマネージャーを使ってインストール済みパッケージを検索します（例: apt list --installed nginx, yum list installed nginx, dnf list installed nginx）。Windows や macOS で手動インストールした場合は、インストールしたはずのディレクトリが存在するか確認します。
      • もしインストールされていない場合は、目的のOSや環境に合った方法で Nginx をインストールします（パッケージマネージャーを使うのが最も簡単で推奨されます）。
      • もしインストールされているがコマンドが見つからない場合は、Nginx の実行ファイルがどこにあるかを特定します。一般的な場所は /usr/sbin/nginx, /usr/local/sbin/nginx, /usr/local/nginx/sbin/nginx などです。Windows の場合は解凍したディレクトリの直下や sbin サブディレクトリなどです。
      • 実行ファイルの場所が特定できたら、そのフルパスを指定してコマンドを実行してみます（例: /usr/sbin/nginx -v）。これでバージョンが表示されれば、コマンドが見つからなかった原因はパスが通っていないことです。
      • 永続的に nginx コマンドを使えるようにするには、Nginx の実行ファイルがあるディレクトリを PATH 環境変数に追加します。具体的な手順は OS やシェルの種類によって異なりますので、「[OS名] PATH 環境変数 設定」などで検索してみてください。

  2. nginx プロセスが実行中でない

    • バージョン確認自体は Nginx プロセスが実行されていなくても可能ですが、もし「Nginx が動いていないみたいだけど、バージョン確認はできるの？」と思った場合のために説明します。
    • 原因: Nginx のマスタープロセスが起動していない。設定ファイルにエラーがある、ポートが競合している、必要な権限がないなど、様々な理由で Nginx の起動に失敗している可能性があります。
    • 解決策:
      • Nginx のバージョン確認コマンド (nginx -v または nginx -V) は、Nginx の実行ファイル自体に組み込まれている機能なので、Nginx のウェブサーバー機能が実際に起動している必要はありません。プロセスが実行されていなくてもバージョン確認は可能です。
      • もし Nginx が起動しない原因を調べたい場合は、まずエラーログファイルを確認します（パスは -V オプションの --error-log-path で確認できます）。起動時のエラーメッセージが記録されているはずです。
      • 設定ファイルの構文チェックを行うコマンドもあります (nginx -t)。設定ファイルに間違いがないかを確認できます。
      • Nginx を起動するコマンドを実行してみます（例: sudo systemctl start nginx または sudo service nginx start）。起動に失敗する場合は、表示されるメッセージやログファイルを確認します。

  3. 権限エラー (Permission denied)

    • 原因: Nginx の実行ファイルや関連ファイル（設定ファイル、ログファイルなど）にアクセスまたは実行するための権限がないユーザーでコマンドを実行しようとした。
    • 解決策:
      • バージョン確認コマンド自体は通常、root 権限がなくても実行できます。しかし、-V オプションが出力するパスの中には、root 権限が必要なディレクトリ（例: /var/log/nginx）が含まれていることがあります。また、システムによっては Nginx の実行ファイル自体が特定の権限設定になっている場合があります。
      • Permission denied エラーが発生した場合は、コマンドの前に sudo を付けて、root 権限（または管理者権限）で実行してみます。
        bash
        sudo nginx -v
        # または
        sudo nginx -V
      • ただし、sudo を使う際は十分に注意してください。特に -V オプションは情報を表示するだけなので安全ですが、他の Nginx コマンドを sudo で実行する際は、意図しない変更を加えてしまわないよう、コマンドの意味をよく理解してから実行しましょう。
      • ファイルやディレクトリの権限設定に問題がないか確認することも、根本的な解決策となります（ls -l /path/to/nginx などで確認）。

  4. -v または -V オプションが効かない（非常に古いバージョンなど）

    • 原因: これは非常に稀なケースですが、もしあなたが Nginx のごく初期のバージョンを使用している場合、バージョン確認のコマンドオプションが現在と異なる可能性があります。
    • 解決策:
      • Nginx の歴史の中で、バージョン確認のためのコマンドオプション (-v, -V) が大きく変更されたという話は聞きません。したがって、この問題が発生する可能性はほとんどありません。
      • もし本当に -v や -V が認識されない場合は、考えられるのは、その実行ファイルが本物の Nginx バイナリではない、あるいは非常に特殊な方法でビルドされた Nginx である、といったケースです。そのような場合は、その Nginx がどのようにインストールされたか、どのようなドキュメントが付属しているかを確認する必要があります。

これらのトラブルシューティング手順は、バージョン確認時だけでなく、Nginx の一般的な運用管理においても役立ちます。エラーメッセージをよく読み、落ち着いて対処することが大切です。

バージョンの更新について（補足）

バージョン確認ができるようになったら、次に考えたくなるのは「私の Nginx は最新バージョンを使っているか？」ということです。そして、もし最新でなければ、バージョンアップを検討することになるでしょう。

なぜバージョンを最新に保つことが推奨されるのでしょうか？

  • セキュリティ: 前述のように、新しいバージョンにはセキュリティ脆弱性に対する修正が含まれています。既知の脆弱性が存在する古いバージョンを使い続けることは、セキュリティ上の大きなリスクとなります。
  • バグ修正: ウェブサーバーは複雑なソフトウェアであり、バグは避けられません。新しいバージョンでは、発見されたバグが修正され、ソフトウェアの安定性が向上します。
  • 新機能と改善: 新しいバージョンでは、パフォーマンスの向上、新しいプロトコル（HTTP/3 など）への対応、新しい設定ディレクティブ、便利なモジュールの追加など、様々な改善や新機能が提供されます。これらを利用することで、より効率的で高機能なウェブサイトやアプリケーションを構築・運用できます。

ただし、バージョンアップには注意も必要です。

  • 設定ファイルの互換性: ごく稀に、新しいバージョンで設定ディレクティブの挙動が変わったり、廃止されたりすることがあります。特にメジャーバージョンやマイナーバージョンを大きく飛び越えてアップデートする場合、既存の設定ファイルがそのままでは動かない可能性があります。
  • モジュールの互換性: 外部のサードパーティ製モジュールを使っている場合、そのモジュールが新しいバージョンの Nginx に対応しているか確認が必要です。
  • 依存関係: Nginx が依存しているライブラリ（OpenSSL, PCRE, zlib など）も、バージョンアップによって変更されることがあります。
  • テスト: 本番環境に適用する前に、開発環境やステージング環境で新しいバージョンの Nginx と既存の設定、アプリケーションが問題なく連携して動作するか十分にテストを行うことが非常に重要です。

バージョンの更新方法も、インストール方法によって異なります。

  • パッケージマネージャー: パッケージマネージャーを使ってインストールした場合、最も簡単な更新方法はパッケージマネージャーの更新コマンドを利用することです（例: sudo apt update && sudo apt upgrade nginx）。これにより、OS のリポジトリで提供されている最新バージョンの Nginx に更新されます。
  • ソースコードからビルド: ソースコードからビルドした場合は、新しいバージョンのソースコードをダウンロードし、再度 configure、make、make install の手順を実行する必要があります。その際、古い設定オプションを再利用したり、新しいオプションを追加したりすることになります。
  • Docker: Docker イメージを使っている場合は、Nginx の新しいバージョンを含む新しいイメージを取得し、そのイメージを使ってコンテナを再作成または更新します。Dockerfile を使っている場合は、ベースイメージのバージョンを更新して再ビルドします。

バージョンの更新は、Nginx を安全かつ快適に使い続ける上で重要なステップですが、特に本番環境での作業は慎重に行う必要があります。まずはバージョン確認で現状を把握し、必要に応じて計画的にバージョンアップを行いましょう。

まとめ

この記事では、Nginx のバージョンを確認する方法について、初心者の方にも分かりやすく詳細に解説しました。

  • Nginx のバージョンを知ることは、セキュリティ、機能、互換性、そして問題解決のために非常に重要です。
  • 最も基本的なバージョン確認方法は、コマンドラインで nginx -v または nginx -V コマンドを実行することです。
    • -v は簡易的なバージョン番号のみを表示します。
    • -V はバージョン番号に加えて、ビルド情報やコンパイルオプションなど、非常に詳細な情報を表示します。特に -V の出力は、Nginx の構成を理解し、問題解決を行う上で不可欠な情報源です。
  • バージョン確認の方法は、利用している OS や Nginx のインストール方法（パッケージマネージャー、手動、Docker など）によって異なりますが、基本的には nginx コマンドの実行パスを特定することがポイントです。
  • バージョン確認に関連する応用知識として、ビルド情報の読み方、メインラインバージョンとステーブルバージョンの違い、Nginx Plus についても解説しました。
  • バージョン確認時に発生しうるトラブル（コマンドが見つからない、権限エラーなど）とその解決策も紹介しました。
  • 最後に、バージョンの更新の重要性と、更新時の注意点について補足しました。

Nginx のバージョン確認は、Nginx を扱う上で最も基本的なスキルの一つです。この記事で学んだコマンドや情報の読み取り方をぜひ実践して、あなたの Nginx 環境のバージョン情報を正確に把握してください。

あなたが Nginx のバージョンを常に意識し、必要に応じて適切な情報を参照できるようになることで、より安全で安定したシステム運用が可能になります。Nginx の学習はバージョン確認から始まります。この記事が、あなたの Nginx 理解の一助となれば幸いです。

さらに Nginx について学びたいと思ったら、次は Nginx の設定ファイル（nginx.conf）の構造や、ログファイルの確認方法などを学んでいくのがおすすめです。これらの知識とバージョン情報と組み合わせることで、Nginx の動作をより深く理解できるようになります。

これで、Nginx バージョンの調べ方に関する詳細な解説は終了です。長い記事でしたが、最後までお読みいただきありがとうございました。

コメントする

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

上部へスクロール