萬盛學電腦網

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

為 WDCP 面板 LNMP 編譯加入 IPv6 支援:Nginx 重新編譯實戰

背景

WDCP (WDlinux Control Panel) 預設編譯的 Nginx **未包含 IPv6 模組** (`--with-ipv6`)。若伺服器已獲分配 IPv6 位址,Nginx 無法 `listen [::]:80`,導致 IPv6 用戶無法存取。需重新編譯 Nginx 加入 IPv6 支援。

步驟 1:確認當前編譯參數

/www/wdlinux/nginx/sbin/nginx -V

輸出範例:

configure arguments: --user=www --group=www --prefix=/www/wdlinux/nginx-1.0.12 --with-http_stub_status_module --with-http_ssl_module

**缺少 `--with-ipv6`**,確認需重編譯。

步驟 2:進入源碼目錄並重新配置

cd /root/lanmp/nginx-1.0.12  # WDCP 預設源碼目錄,若無請找對應版本源碼

./configure \
  --user=www \
  --group=www \
  --prefix=/www/wdlinux/nginx-1.0.12 \
  --with-http_stub_status_module \
  --with-http_ssl_module \
  --with-ipv6

輸出結尾出現 `Configuration summary` 含 `IPv6 support: yes` 即配置成功。

步驟 3:編譯 (不安裝,僅產出二進制檔)

make

編譯過程約 2-10 分鐘視 CPU 核心數而定。產出 `objs/nginx` 執行檔。

步驟 4:熱替換 Nginx 二進制檔 (零停機)

# 備份原執行檔
cp /www/wdlinux/nginx/sbin/nginx /www/wdlinux/nginx/sbin/nginx.bak.$(date +%F)

# 替換新編譯的二進制檔
cp objs/nginx /www/wdlinux/nginx/sbin/nginx

# 平滑重載 (Master 進程重讀配置、啟動新 Worker、舊 Worker 自然結束)
/www/wdlinux/nginx/sbin/nginx -s reload

步驟 5:驗證 IPv6 監聽生效

# 檢查編譯參數已含 --with-ipv6
/www/wdlinux/nginx/sbin/nginx -V 2>&1 | grep -o with-ipv6

# 檢查監聽埠包含 IPv6
ss -tlnp | grep nginx
# 應見
# LISTEN 0 128 [::]:80 [::]:* users:(("nginx",pid=xxx,fd=6))
# LISTEN 0 128 0.0.0.0:80 0.0.0.0:* users:(("nginx",pid=xxx,fd=5))

步驟 6:修改站點配置啟用 IPv6 監聽

編輯 WDCP 站點配置檔 (通常在 `/www/wdlinux/nginx/conf/vhost/域名.conf`):

server {
    listen 80;
    listen [::]:80;          # 新增此行,監聽 IPv6
    server_name example.com www.example.com;
    # ... 其他配置保持不變
}

重載生效:`/www/wdlinux/nginx/sbin/nginx -s reload`

步驟 7:防火牆/安全群組放行 IPv6 埠

  • 伺服器防火牆:`ip6tables -A INPUT -p tcp --dport 80 -j ACCEPT` (或 `firewall-cmd --permanent --add-port=80/tcp --zone=public` 含 IPv6)。
  • 雲廠商控制台:安全群組/防火牆規則新增 **IPv6 入站規則**,埠 80/443,來源 `::/0`。

驗證 IPv6 可達性

避坑指南

  1. 源碼版本必須一致:`nginx -V` 顯示的版本號 (如 1.0.12) 必須與源碼目錄版本完全一致,否則配置檔語法可能不相容。
  2. 不要執行 `make install`:會覆蓋配置檔、HTML 預設頁、日誌目錄結構。僅替換 `sbin/nginx` 二進制檔。
  3. 模組相依性:若原編譯包含第三方模組 (如 `ngx_pagespeed`、WAF 模組),重新配置時**必須同樣加入對應 `--add-module=...` 參數**,否則模組遺失導致配置錯誤。
  4. WDCP 升級會覆蓋:WDCP 面板升級可能重新編譯 Nginx 覆蓋你的二進制檔。建議將編譯腳本存為 `/root/rebuild_nginx_ipv6.sh`,升級後重跑一次。
同理可為 Apache (WDCP 使用 httpd) 重新編譯加入 `mod_proxy_wstunnel` 等模組,原理相同:`./configure` 參數對齊 → `make` → 替換 `httpd` 二進制檔 → `apachectl graceful`。
copyright © 萬盛學電腦網 all rights reserved