萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx 安裝路徑與配置檔標準佈局速查 (編譯安裝 vs 套件安裝)

Nginx 的安裝佈局因安裝方式 (源碼編譯 vs 系統套件) 而異。掌握標準路徑有利於配置管理、日誌分析、模組擴展與多版本共存。本文對比兩種主流安裝方式的目錄結構差異。

源碼編譯安裝預設佈局 (./configure --prefix=/usr/local/nginx)

/usr/local/nginx/
├── sbin/nginx           # 主執行檔
├── conf/
│   ├── nginx.conf       # 主配置檔
│   ├── mime.types
│   ├── fastcgi_params
│   ├── proxy_params
│   ├── scgi_params
│   ├── uwsgi_params
│   └── vhost/           # 建議建立:虛擬主機配置目錄
│       ├── example.com.conf
│       └── api.example.com.conf
├── html/                # 預設 DocumentRoot (含 50x.html, index.html)
├── logs/
│   ├── access.log
│   └── error.log
├── modules/             # 動態模組 .so (Nginx 1.9.11+)
│   └── ngx_http_geoip_module.so
└── pid/                 # nginx.pid (若配置 pid 路徑)

RHEL/CentOS 套件安裝佈局 (yum/dnf install nginx)

/etc/nginx/
├── nginx.conf           # 主配置
├── conf.d/              # 虛擬主機/模組配置片段 (*.conf 自動 include)
│   ├── default.conf
│   ├── ssl.conf
│   └── vhost_*.conf
├── fastcgi_params
├── mime.types
├── proxy_params
├── scgi_params
├── uwsgi_params
└── modules/  -> /usr/lib64/nginx/modules

/var/log/nginx/
├── access.log
└── error.log

/var/lib/nginx/          # 體積暫存 (fastcgi/proxy/client_body)
├── client_body/
├── fastcgi/
├── proxy/
├── scgi/
└── uwsgi/

/usr/lib64/nginx/modules/ # 動態模組實體
/usr/sbin/nginx           # 主程式 (systemd 管理)

Debian/Ubuntu 套件安裝佈局 (apt install nginx)

/etc/nginx/
├── nginx.conf
├── conf.d/
├── sites-available/     # 可用站點配置
├── sites-enabled/  -> ../sites-available/  # 啟用站點 (軟連結)
├── mods-available/      # 模組配置
├── mods-enabled/  -> ../mods-available/
├── snippets/            # 可重用配置片段
├── fastcgi_params
├── mime.types
└── proxy_params

/var/www/html/           # 預設根目錄
/var/log/nginx/          # 日誌
/usr/lib/nginx/modules/  # 模組
/usr/sbin/nginx          # 主程式

關鍵目錄與檔案功能對照

功能編譯安裝RPM 安裝DEB 安裝
主程式/usr/local/nginx/sbin/nginx/usr/sbin/nginx/usr/sbin/nginx
主配置/usr/local/nginx/conf/nginx.conf/etc/nginx/nginx.conf/etc/nginx/nginx.conf
虛擬主機目錄/usr/local/nginx/conf/vhost/ (自建)/etc/nginx/conf.d//etc/nginx/sites-enabled/
預設網站根目錄/usr/local/nginx/html//usr/share/nginx/html//var/www/html/
日誌目錄/usr/local/nginx/logs//var/log/nginx//var/log/nginx/
動態模組/usr/local/nginx/modules//usr/lib64/nginx/modules//usr/lib/nginx/modules/
PID 檔/usr/local/nginx/logs/nginx.pid/run/nginx.pid/run/nginx/nginx.pid
控制命令/usr/local/nginx/sbin/nginx -s reloadsystemctl reload nginxsystemctl reload nginx

虛擬主機配置範例 (通用)

# /etc/nginx/conf.d/example.com.conf (RPM)
# /usr/local/nginx/conf/vhost/example.com.conf (編譯)
# /etc/nginx/sites-available/example.com (DEB)

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
    root /var/www/example.com;
    index index.html index.php;

    access_log /var/log/nginx/example.com_access.log main;
    error_log /var/log/nginx/example.com_error.log warn;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php-fpm/www.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht { deny all; }
}

操作鐵律

⚠ 任何配置變更前:
1. cp nginx.conf nginx.conf.bak.$(date +%F) 備份
2. nginx -t 語法檢查 (必須輸出 syntax is ok / test is successful)
3. nginx -s reload 或 systemctl reload nginx 平滑重載
絕不直接重啟 (reload 保持連線不中斷,worker 平滑換代)

copyright © 萬盛學電腦網 all rights reserved