nginx -V / nginx -T în Nginx

nginx -v | nginx -V | nginx -T

Ce face nginx -V / nginx -T

nginx -v afișează doar versiunea, iar nginx -V (literă mare) afișează în plus compilatorul, versiunea OpenSSL și toate argumentele configure folosite la compilare. Din această listă afli ce module sunt incluse, de exemplu --with-http_ssl_module, --with-http_v2_module sau --with-http_v3_module.

nginx -T testează configurația exact ca nginx -t, apoi afișează conținutul tuturor fișierelor de configurare, în ordinea în care sunt incluse, fiecare precedat de un comentariu # configuration file .... Este cel mai rapid mod de a vedea configurația „reală” când ai multe fișiere în conf.d/ și sites-enabled/.

Ambele comenzi scriu pe ieșirea de eroare (stderr), așa că pentru a le filtra cu grep trebuie redirecționat stderr: nginx -V 2>&1 | grep ....

Opțiuni și argumente

Opțiune / Parametru	Descriere
-v	Afișează versiunea Nginx.
-V	Afișează versiunea, compilatorul, versiunea OpenSSL și argumentele de compilare (modulele incluse).
-T	Testează configurația și o afișează integral, cu toate fișierele incluse.
-h, -?	Afișează ajutorul cu toate opțiunile liniei de comandă.

Exemple

Exemplul 1: Versiunea și modulele

Ieșire tipică pe Ubuntu 24.04 (lista de argumente este scurtată):

nginx -V

Ieșire în terminal

nginx version: nginx/1.24.0 (Ubuntu)
built with OpenSSL 3.0.13 30 Jan 2024
TLS SNI support enabled
configure arguments: --with-cc-opt='-g -O2 ...' --prefix=/usr/share/nginx --conf-path=/etc/nginx/nginx.conf --http-log-path=/var/log/nginx/access.log --error-log-path=stderr --lock-path=/var/lock/nginx.lock --pid-path=/run/nginx.pid --with-compat --with-pcre-jit --with-http_ssl_module --with-http_stub_status_module --with-http_realip_module --with-http_auth_request_module --with-http_v2_module --with-http_dav_module --with-http_slice_module --with-threads --with-http_addition_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_sub_module

Exemplul 2: Verificarea unui modul anume

Redirecționăm stderr în stdout ca să putem filtra:

nginx -V 2>&1 | grep -o with-http_v2_module

Ieșire în terminal

with-http_v2_module

Exemplul 3: Căutarea unei directive în toată configurația

Aflăm în ce fișiere apare server_name; -T include și comentariile cu numele fișierelor.

sudo nginx -T 2>/dev/null | grep -E '^# configuration file|server_name'

Ieșire în terminal

# configuration file /etc/nginx/nginx.conf:
# configuration file /etc/nginx/mime.types:
# configuration file /etc/nginx/sites-enabled/example.com:
    server_name example.com www.example.com;
# configuration file /etc/nginx/sites-enabled/default:
    server_name _;

Greșeli frecvente

• Confundarea -v cu -V: doar varianta cu literă mare arată modulele compilate.
• Rularea nginx -T fără sudo: fișierele care nu pot fi citite produc erori, iar configurația afișată este incompletă.
• Publicarea ieșirii nginx -T pe forumuri fără a o verifica: poate conține parole din proxy_set_header Authorization sau alte date sensibile.

Comenzi înrudite

• nginx -t: Testează sintaxa fișierelor de configurare fără a opri sau reporni serverul.
• nginx.conf și sites-available: Cum sunt organizate fișierele de configurare: nginx.conf, include, conf.d, sites-available și sites-enabled.
• listen: Stabilește adresa IP și portul pe care un bloc server acceptă conexiuni.