解決nginx啟動問題的實用方法

一、Nginx 簡介

Nginx（(Engine x)）是一個高性能的HTTP和反向代理伺服器，也是一個IMAP/POP3/SMTP伺服器。由於它的高性能、穩定性和許多高級功能，Nginx 在網路伺服器、反向代理、緩存伺服器、負載平衡伺服器、安全控制伺服器等方面都得到了廣泛應用。

二、 Nginx 啟動流程

Nginx 的啟動流程如下圖：

pcre_exec() -頭文件regex.h
ngx_regex_compile() -頭文件ngx_regex.h
/* 1. nginx從指定的配置文件或目錄中解析出配置，根據解析結果生成對應的配置結構體
*/
if (ngx_conf_parse(cf, NULL) != NGX_CONF_OK) {
    ngx_log_error(NGX_LOG_EMERG, cycle->log, 0, "nginx configuration 
file %s test failed", confParam);
    return NGX_ERROR;
}
/* 2.逐一初始化解析後得到的每個模塊，添加到全局模塊列表中
*/
if (ngx_init_modules(cycle) != NGX_OK) {
    ngx_log_error(NGX_LOG_EMERG, cycle->log, 0, "init modules error");
    return NGX_ERROR;
}
/* 3.按順序執行每個模塊的 create_conf() 函數，為每個模塊創建一個配置數據結構
*/
if (ngx_conf_full_name(cycle, ngx_cycle->conf_file->data, 0) 
    != NGX_OK) {
    return NGX_ERROR;
}
if (ngx_open_files(cycle) != NGX_OK) {
    return NGX_ERROR;
}
if (ngx_close_listening_sockets(cycle) == NGX_ERROR) {
    return NGX_ERROR;
}
/* 4.調用 ngx_init_modules 函數初始化模塊
*/
if (ngx_init_modules(cycle) != NGX_OK) {
    return NGX_ERROR;
}
/* 5.調用 ngx_cycle_init 進行初始化，初始化worker_processes和worker_cpu_affinity
*/
if (ngx_cycle_init(cycle) != NGX_OK) {
    return NGX_ERROR;
}
/* 6.啟動 worker 進程，並在 master 進程中循環監控 worker 運行狀態
*/
if (ngx_master_process_cycle(cycle) != NGX_OK) {
    return NGX_ERROR;
}
/* 7.收尾工作，釋放申請的資源
*/
ngx_destroy_pool(cf->pool);
ngx_close_connection(ngx_cycle->connection);
return NGX_OK;

三、Nginx 啟動失敗原因分析

1. 埠被佔用

在啟動Nginx時，如果你使用的埠被其他程序佔用，Nginx 無法打開相應的埠，Nginx 將會啟動失敗。

2021/10/29 11:42:18 [emerg] 23876#23876: bind() to 0.0.0.0:80 
failed (98: Address already in use)

解決方法：

• 修改 Nginx 配置文件中的監聽埠
• 查找埠佔用進程並將其殺死

2. 配置文件錯誤

Nginx 的配置文件默認位於 /etc/nginx/nginx.conf，如果在配置文件中有語法錯誤，它將阻止 Nginx 啟動。此時，Nginx 將顯示一個警告消息並退出。

nginx: [emerg] "worker_processes" directive is not allowed here in 
/etc/nginx/nginx.conf:1

解決方法：

• 檢查配置文件中的錯誤並更正
• 使用 Nginx 配置檢查器檢查語法錯誤

3. 構建版本與伺服器不兼容

如果你的伺服器和 Nginx 的構建版本不兼容，Nginx 將無法啟動。

nginx: [emerg] module "/usr/lib/nginx/modules/ngx_http_geoip_module.so" 
version 1012001 instead of 1015002 in /etc/nginx/nginx.conf:28

解決方法：使用與伺服器和 Nginx 構建版本兼容的 Nginx 版本

四、 Nginx 啟動問題解決方法

1. Docker 啟動 Nginx

運行 Nginx Docker 鏡像需要使用以下命令：

docker run --name nginx -v /nginx.conf:/etc/nginx/nginx.conf 
-v /logs:/var/log/nginx -d nginx

• 使用 -d 參數來將鏡像啟動到後台
• 使用 -p 來指定埠
• 使用-v來將主機的配置文件或目錄掛載到 Docker 容器

2. 檢查埠是否被佔用

在啟動 Nginx 之前，可以使用以下命令來檢查埠是否被佔用：

netstat -ano | grep 

• 使用 netstat 列出所有佔用埠的進程
• 使用 grep 過濾指定埠

3. 檢查配置文件

檢查 Nginx 的配置文件是否正確是解決啟動問題的關鍵。使用以下命令檢查配置文件：

nginx -t

如果出現以下輸出，則表示配置文件中沒有語法錯誤。

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

4. 檢查 Nginx 安裝版本

確保在安裝 Nginx 時下載了與您的伺服器和架構兼容的正確版本。檢查 Nginx 版本的命令如下：

nginx -v

如果 Nginx 未正確安裝，則輸出將類似於：

nginx: command not found

5. 日誌分析

在運行 Nginx 時，它使用日誌文件記錄活動。在許多情況下，分析日誌文件是解決啟動問題的關鍵。Nginx 日誌存儲在 /var/log/nginx/ 目錄下。

解鎖啟動問題之後，Nginx 就可以正常工作了。您可以使用以下命令停止 Nginx 服務：

nginx -s stop

或者使用以下命令重啟服務：

nginx -s reload

在處理 Nginx 啟動問題時，始終檢查錯誤日誌以診斷任何問題。詳細檢查配置文件、版本和安裝文件有助於解鎖此類型的問題。