nginx server_name配置多個域名時的坑

更新時間：2025年05月28日 09:20:12 作者：zzhongcy

Nginx配置多個server_name時,$server_name默認(rèn)取第一個值,導(dǎo)致PHP獲取錯誤,下面就來介紹一下該問題的解決,感興趣的可以了解一下

server_name 指令詳解

server_name 指令設(shè)置基于域名的虛擬主機(jī)，?個ip的服務(wù)器可以配置多個域名。下?這些server_name是有效的:

server_name domain.com;
server_name domain.com www.domain.com;
server_name *.domain.com;
server_name .domain.com;
server_name domain.*;
server_name "";

多個域名之間以空格分隔。nginx允許?個虛擬主機(jī)有?個或多個名字，也可以使?通配符"*"來設(shè)置虛擬主機(jī)的名字。

server_name指令在接到請求后的匹配順序分別為：

1、準(zhǔn)確的server_name匹配，例如：domain.com www.domain.com
2、以通配符開始的字符串： .domain.com .domain.com
3、以通配符結(jié)束的字符串：www.
4、匹配正則表達(dá)式：~^(?.+).domain.com$

nginx將按照1,2,3,4的順序?qū)erver name進(jìn)?匹配，有?項匹配以后就會停?搜索，類似于location指令。

背景

為了區(qū)分線上環(huán)境和測試環(huán)境，我弄了個自己測試專用的域名test.daemoncoder.com，線上環(huán)境的正式域名是www.daemoncoder.com。nginx里的server_name配置改為：

# 只列出了我們關(guān)心的配置，省略了其他無關(guān)部分
server {
    server_name www.daemoncoder.com test.daemoncoder.com;
    ...
}

但是使用時發(fā)現(xiàn)請求一直報錯，重定向到錯誤頁面，于是開始了問題的定位。

問題的定位

根據(jù)業(yè)務(wù)上報錯時打的日志，定位到請求公共處理的部分里有這么一個判斷：

if ($_SERVER['SERVER_NAME'] != parse_url($_SERVER['HTTP_REFERER'], PHP_URL_HOST)) {
    $this->redirectError();
}

判斷請求referer里解析出的域名如果和nginx里的$server_name變量里的域名如果不一樣，就跳到錯誤頁面，也是前面說的問題。

那么問題來了，看referer中的域名為什么和 $_SERVER['SERVER_NAME'] 不一致呢？我請求用的鏈接形式如 http://test.daemoncoder.com/xxx 這種形式，但是最終在PHP這一層取到 $_SERVER['SERVER_NAME'] 的值為 www.daemoncoder.com，而 HTTP_REFERER 里的域名為：test.daemoncoder.com。

可以看到 SERVER_NAME 的取值和我們的預(yù)期不一致，nginx是怎么把這個變量傳過來的，需要從 nginx 的 fastcgi_params 配置文件中找一下 SERVER_NAME 的定義：

fastcgi_param SERVER_NAME $server_name;

可以看到 nginx 里的 $server_name 變量就是我們PHP里取的$_SERVER['SERVER_NAME'] 的來源。

問題的原因

通過上面的定位，我們基本可以看到問題的根本原因了（敲黑板，劃重點）：

當(dāng)nginx配置里一個server節(jié)點下，server_name配置多個域名時，$server_name變量的值都是配置的第一個。

再回顧下我的 nginx 配置：

# 只列出了我們關(guān)心的配置，省略了其他無關(guān)部分
server {
    server_name www.daemoncoder.com test.daemoncoder.com;
    ...
}

server_name 結(jié)點有兩個：www.daemoncoder.com 和 test.daemoncoder.com，當(dāng)我用測試域名去訪問頁面的時候，可以匹配到 test.daemoncoder.com 這個域名，所以會根據(jù)當(dāng)前這個server節(jié)點的配置來處理這個請求，但是 nginx 會把 $server_name 的值設(shè)置為當(dāng)前 server 節(jié)點的配置的第一個 server_name，也就是 www.daemoncoder.com。如果配置改為：

server_name test.daemoncoder.com www.daemoncoder.com;

那么用測試域名請求就可以得到期望的值了（但是正式域名就出問題了）。

解決方式

第一種方式就是把配置文件按域名拆分到各自單獨的server節(jié)點下，也就是：

# 省略其他無關(guān)部分
server {
    server_name www.daemoncoder.com;
    ...
}
server {
    server_name test.daemoncoder.com;
    ...
}

這樣用不同的域名訪問會落到各自對應(yīng)的配置中，解析到的 $server_name 也都是各自的值。

第二種方式是修改 nginx SERVER_NAME 使用 $host 變量，也就是把

fastcgi_param SERVER_NAME $server_name;

修改為：

fastcgi_param SERVER_NAME $host;

$host變量的解析都是當(dāng)前請求的host，不會受 server_name 是否配置多個域名的影響，這樣我們在PHP里取 $_SERVER['SERVER_NAME'] 取出的值就是實際請求的域名，也可以解決問題（但是代碼里的這個判斷邏輯在測試環(huán)境似乎就沒有意義了，問題不大）。