萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Nginx 301 永久重導向:裸域名導向 www 完整設定

應用場景

  • SEO 整合權重:避免 example.com 與 www.example.com 內容重複
  • 統一 Canonical URL
  • CDN/SSL 憑證通常簽發給 www 子網域

設定範例

server {
    listen 80;
    server_name example.com;  # 裸域名

    # 301 永久重導向至 www
    if ($host != 'www.example.com') {
        rewrite ^/(.*)$ https://www.example.com/$1 permanent;
    }
}

關鍵指令解析

指令說明
permanent回傳 HTTP 301 (Moved Permanently),瀏覽器/搜尋引擎會更新書籤/索引
redirect回傳 HTTP 302 (Found),臨時重導向,不傳遞權重
$host請求的 Host 標頭 (不含埠號)
rewrite ^/(.*)$ ...捕獲完整路徑並保留至目標 URL

更優雅的寫法 (避免 if 是 evil)

server {
    listen 80;
    server_name example.com;
    return 301 https://www.example.com$request_uri;
}

server {
    listen 80;
    server_name www.example.com;
    # 實際站點配置...
}

return 301 效能優於 rewrite,語意更清晰,官方推薦做法。

HTTPS 環境完整範例

# HTTP 裸域名 → HTTPS www
server {
    listen 80;
    server_name example.com;
    return 301 https://www.example.com$request_uri;
}

# HTTP www → HTTPS www
server {
    listen 80;
    server_name www.example.com;
    return 301 https://www.example.com$request_uri;
}

# HTTPS www 實際站點
server {
    listen 443 ssl http2;
    server_name www.example.com;
    
    ssl_certificate /path/fullchain.pem;
    ssl_certificate_key /path/privkey.pem;
    
    # ... 站點配置
}

測試驗證

curl -I https://example.com
# HTTP/1.1 301 Moved Permanently
# Location: https://www.example.com/

curl -I https://www.example.com
# HTTP/1.1 200 OK

常見錯誤

  • 在同一 server 區塊同時監聽裸域名與 www → 無限迴圈
  • 忘記在 DNS 設定 @ A 記錄 與 www CNAME/A 記錄
  • 使用 redirect (302) 導致 SEO 權重不傳遞
copyright © 萬盛學電腦網 all rights reserved