Nginx 的安裝佈局因安裝方式 (源碼編譯 vs 系統套件) 而異。掌握標準路徑有利於配置管理、日誌分析、模組擴展與多版本共存。本文對比兩種主流安裝方式的目錄結構差異。
/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 路徑)
/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 管理)
/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 reload | systemctl reload nginx | systemctl 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 平滑換代)