如何解決香港伺服器的 NGINX 502 Bad Gateway 問題？

在香港伺服器租用環境中運行時，遇到 NGINX 反向代理設定中的 502 Bad Gateway 錯誤可能會令人煩惱。本指南將深入探討實用解決方案，並附帶實際範例和經過實戰檢驗的配置。

瞭解 NGINX 中的 502 Bad Gateway

502 Bad Gateway 表示您的 NGINX 伺服器作為反向代理無法從上游伺服器獲得有效回應。在香港的伺服器環境中，這通常源於網路延遲、防火牆配置或資源限制。

常見觸發因素包括：

• 上游伺服器當機
• PHP-FPM 套接字通訊問題
• 工作連線數不足
• 記憶體限制
• 網路逾時設定

快速診斷步驟

首先，檢查您的 NGINX 服務狀態：

systemctl status nginx
tail -f /var/log/nginx/error.log

讓我們檢查您的 NGINX 配置中的潛在問題。以下是一個典型的反向代理設定，並標出了常見問題：

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://backend_server;
        proxy_buffers 16 4k;
        proxy_buffer_size 2k;
        proxy_connect_timeout 300;
        proxy_send_timeout 300;
        proxy_read_timeout 300;
        proxy_busy_buffers_size 64k;
    }
}

常見問題及解決方案

1. PHP-FPM 套接字問題

檢查 PHP-FPM 狀態和套接字權限：

ls -la /var/run/php-fpm/php-fpm.sock
systemctl status php-fpm

如果缺少套接字檔案，驗證 PHP-FPM 配置：

listen = /var/run/php-fpm/php-fpm.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660

2. 記憶體限制

針對香港伺服器環境，最佳化您的記憶體設定：

worker_processes auto;
worker_rlimit_nofile 65535;
events {
    worker_connections 65535;
    use epoll;
    multi_accept on;
}

NGINX 配置最佳化

實施這些代理設定以提高穩定性：

http {
    proxy_buffer_size 128k;
    proxy_buffers 4 256k;
    proxy_busy_buffers_size 256k;
    proxy_temp_file_write_size 256k;
    proxy_connect_timeout 300s;
    proxy_send_timeout 300s;
    proxy_read_timeout 300s;
}

系統級故障排除

使用這些指令監控系統資源：

# 檢查當前連線數
netstat -anp | grep :80 | wc -l

# 監控即時連線
watch -n1 "netstat -anp | grep :80 | wc -l"

# 檢查記憶體問題
free -m
vmstat 1

在 /etc/security/limits.conf 中調整系統限制：

* soft nofile 65535
* hard nofile 65535
nginx soft nofile 65535
nginx hard nofile 65535

香港特定最佳化

在香港伺服器租用時，需要考慮這些獨特因素：

• 與中國大陸的跨境延遲
• 國際頻寬分配
• 區域防火牆配置

針對跨境流量最佳化您的 NGINX 配置：

location / {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
    proxy_next_upstream_tries 3;
    proxy_next_upstream_timeout 10s;
}

監控和預防

實施此監控配置：

http {
    log_format upstream_time '$remote_addr - $remote_user [$time_local] '
                            '"$request" $status $body_bytes_sent '
                            '"$http_referer" "$http_user_agent"'
                            'rt=$request_time uct="$upstream_connect_time" '
                            'uht="$upstream_header_time" urt="$upstream_response_time"';
    
    access_log /var/log/nginx/access.log upstream_time;
}

故障排除清單

偵錯 502 錯誤時，請遵循這個系統方法：

1. 檢查 NGINX 和後端服務：
   systemctl status nginx
   systemctl status php-fpm

2. 驗證日誌：
   tail -f /var/log/nginx/error.log
   tail -f /var/log/nginx/access.log

3. 測試後端連通性：
   curl -I http://backend_server

4. 檢查套接字權限：
   ls -la /var/run/php-fpm/php-fpm.sock

常見問題解答

問：為什麼我的 NGINX 在尖峰期會返回 502 錯誤？

答：通常是由於 worker_connections 限制或 PHP-FPM 程序耗盡導致。調整這些設定：

events {
    worker_connections 10240;
}

# php-fpm.conf
pm = dynamic
pm.max_children = 50
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 35

最終最佳化建議

在香港伺服器環境中實施這些進階調整以獲得最佳效能：

http {
    keepalive_timeout 65;
    keepalive_requests 100;
    
    # FastCGI 最佳化
    fastcgi_buffering on;
    fastcgi_buffers 16 16k;
    fastcgi_buffer_size 32k;
    
    # Gzip 設定
    gzip on;
    gzip_comp_level 5;
    gzip_types text/plain text/css application/javascript;
}

請記住定期監控您的 NGINX 反向代理效能，並根據您的具體伺服器需求調整配置。這些解決方案特別適用於處理跨境流量和高併發場景的香港伺服器。