腳本之家服務器常用軟件

快捷導航

Nginx中指令server_name的詳細使用指南

更新時間：2025年07月25日 09:25:57 作者：我是姜承錄

對于Web開發(fā)者來說,Nginx是一個強大且靈活的Web服務器和反向代理服務器,下面這篇文章主要介紹了Nginx中指令server_name詳細使用的相關資料,文中通過代碼介紹的非常詳細,需要的朋友可以參考下

簡介

server_name 是 Nginx 配置文件中的一個重要指令，用于指定 Nginx 服務器塊（或虛擬主機）應該響應哪些域名的請求。通過正確配置 server_name，你可以在同一臺服務器上托管多個不同的網站，并確保每個域名的請求都能被正確處理。

DNS 解析的過程

客戶端發(fā)起請求：當用戶在瀏覽器中輸入一個域名（如 example.com）時，瀏覽器會向本地 DNS 服務器發(fā)送查詢請求。
遞歸查詢：本地 DNS 服務器會檢查其緩存，如果找到了該域名對應的 IP 地址，則直接返回給客戶端；如果沒有找到，則繼續(xù)向其他 DNS 服務器（如根 DNS 服務器、頂級域 DNS 服務器等）進行遞歸查詢，直到找到目標 IP 地址。
返回結果：一旦找到目標 IP 地址，DNS 服務器會將結果返回給客戶端，瀏覽器就可以使用該 IP 地址與目標服務器建立連接。
緩存結果：為了提高效率，DNS 服務器通常會緩存查詢結果一段時間（稱為 TTL，Time To Live），以便后續(xù)相同的查詢可以直接從緩存中獲取結果，而無需再次進行完整的解析過程。

主機文件的作用

在開發(fā)環(huán)境中，我們通常使用 主機文件（/etc/hosts 或 C:\Windows\System32\drivers\etc\hosts）來模擬 DNS 解析。主機文件允許我們在本地將特定的域名映射到指定的 IP 地址，而無需依賴外部 DNS 服務器。這對于測試和開發(fā)非常有用，因為它可以快速配置自定義域名，并且不會影響其他用戶的網絡環(huán)境。

例如，在主機文件中添加以下行：

192.168.154.101 admin.dhl101

這行配置表示，當瀏覽器嘗試訪問 admin.dhl101 時，它會直接解析為 IP 地址 192.168.154.101，而不會去查詢外部 DNS 服務器。

DNS 與 Nginx 的關系

Nginx 使用 server_name 指令來匹配 HTTP 請求中的 Host 頭字段，以確定哪個 server 塊應該處理該請求。因此，DNS 解析的結果（即域名對應的 IP 地址）決定了請求會被發(fā)送到哪臺服務器，而 Nginx 則根據 server_name 指令進一步確定具體的處理邏輯。

例如，假設你有兩臺服務器，分別托管 example.com 和 admin.example.com。用戶在瀏覽器中輸入 admin.example.com，DNS 會將其解析為某臺服務器的 IP 地址，然后 Nginx 會根據 server_name 指令判斷是否應該由該服務器處理該請求。

server_name的作用

server_name 指令告訴 Nginx，在接收到 HTTP 請求時，如果請求頭中的 Host 字段匹配指定的域名，則該請求應由這個特定的 server 塊來處理。這使得在同一臺服務器上托管多個不同域名的網站成為可能。

基本用法

最簡單的 server_name 配置是為一個具體的域名指定一個 server 塊。例如：

server {
    listen 80;
    server_name example.com;

    root /var/www/example.com;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

在這個例子中，Nginx 將會檢查所有進來的 HTTP 請求，并查看請求頭中的 Host 字段。如果 Host 字段的值是 example.com，那么 Nginx 就會使用這個 server 塊中的配置來處理該請求。

通配符和正則表達式

server_name 支持通配符和正則表達式，以便更靈活地匹配域名。

通配符

前綴通配符：*.example.com 可以匹配任何以 .example.com 結尾的子域名，如 sub1.example.com、sub2.example.com 等。

server {
    listen 80;
    server_name *.example.com;

    root /var/www/example.com;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

后綴通配符：Nginx 不直接支持后綴通配符，但可以通過正則表達式實現類似功能。

正則表達式

使用 ~ 開頭的 server_name 可以包含正則表達式。例如：

server {
    listen 80;
    server_name ~^(?<sub>.+)\.example\.com$;

    root /var/www/$sub.example.com;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

在這個例子中，(?<sub>.+) 是一個捕獲組，它允許你在后續(xù)配置中引用匹配到的子域名部分。

默認服務器

如果你希望某個 server 塊作為默認服務器（即在沒有其他服務器塊匹配時處理請求），可以使用以下方式：

空字符串：server_name ""; 表示這個 server 塊是默認服務器。
下劃線：server_name _; 也可以表示默認服務器。

例如：

server {
    listen 80 default_server;
    server_name _;

    root /var/www/default;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

多域名配置

你可以為同一個 server 塊指定多個域名，用空格分隔。例如：

server {
    listen 80;
    server_name example.com www.example.com;

    root /var/www/example.com;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

這樣，Nginx 會將對 example.com 和 www.example.com 的請求都路由到這個 server 塊。

子域名配置

如果你想為 example.com 的子域名（如 api.example.com 和 admin.example.com）創(chuàng)建獨立的 server 塊，可以按照以下步驟進行配置。

修改主機文件

首先，你需要在主機文件中為新的子域名添加條目。假設你已經在主機文件中設置了 192.168.154.101 example.com，現在需要添加 api.example.com 和 admin.example.com。

Windows

打開記事本（以管理員身份運行），然后打開 C:\Windows\System32\drivers\etc\hosts 文件。

在文件末尾添加以下行：

192.168.154.101 api.example.com
192.168.154.101 admin.example.com

macOS 和 Linux

打開終端，并使用文本編輯器（如 nano, vim, emacs 等）編輯 /etc/hosts 文件。例如，使用 nano 編輯器，你可以運行：
```
sudo nano /etc/hosts
```

在文件末尾添加以下行：

192.168.154.101 api.example.com
192.168.154.101 admin.example.com

保存并退出編輯器（對于 nano，按 Ctrl + X，然后按 Y 確認保存更改，最后按 Enter 退出）。

配置 Nginx

接下來，我們需要在 Nginx 中為 api.example.com 和 admin.example.com 分別創(chuàng)建 server 塊。

# 主站配置
server {
    listen 80;
    server_name example.com www.example.com;

    root /var/www/example.com;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

# API 子域名配置
server {
    listen 80;
    server_name api.example.com;

    root /var/www/api.example.com;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    # 如果你有 API 服務，可以添加以下配置
    location /api {
        proxy_pass http://localhost:3000;  # 假設 API 服務運行在本地端口 3000
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# Admin 子域名配置
server {
    listen 80;
    server_name admin.example.com;

    root /var/www/admin.example.com;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

端口監(jiān)聽與server_name結合

如果你希望 Nginx 在非標準端口（如 8082）上監(jiān)聽請求，并且只處理特定域名的請求，可以在 listen 指令中明確指定 IP 地址和端口組合。

例如，假設你希望 Nginx 在 192.168.154.101 上監(jiān)聽端口 8082，并且只處理 admin.dhl101 的請求：

server {
    listen 192.168.154.101:8082;
    server_name admin.dhl101;

    root /var/www/login;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

主機文件配置

確保你的主機文件中有以下條目，以便瀏覽器能夠正確解析 admin.dhl101：

192.168.154.101 admin.dhl101

測試和驗證

測試配置文件：
- 在修改完 Nginx 配置文件后，先測試配置文件是否有語法錯誤：
```
sudo nginx -t
```
重載 Nginx：
- 如果沒有問題，重新加載 Nginx 使配置生效：
```
sudo systemctl reload nginx
```
  或者，如果你的系統(tǒng)使用的是不同的初始化系統(tǒng)，可能需要使用 sudo service nginx reload。
訪問 URL：
- 打開瀏覽器，訪問 http://admin.dhl101:8082/，確認是否能夠正常加載 /var/www/login 目錄下的內容。

其他注意事項

防火墻設置：確保你的防火墻允許通過端口 8082 的流量。你可以使用以下命令檢查和配置防火墻規(guī)則：
```
sudo ufw allow 8082/tcp  # 對于 UFW
sudo firewall-cmd --add-port=8082/tcp --permanent  # 對于 firewalld
sudo firewall-cmd --reload
```
SELinux 設置（適用于 CentOS/RHEL）：如果你的系統(tǒng)啟用了 SELinux，確保 Nginx 有權限監(jiān)聽非標準端口。你可以使用以下命令：
```
sudo semanage port -a -t http_port_t -p tcp 8082
```

HTTPS 配置：如果你希望為 admin.dhl101 配置 HTTPS，可以使用 mkcert 工具生成自簽名證書。以下是 HTTPS 配置的示例：

server {
    listen 192.168.154.101:8082 ssl;
    server_name admin.dhl101;

    ssl_certificate /path/to/admin.dhl101.pem;
    ssl_certificate_key /path/to/admin.dhl101-key.pem;

    root /var/www/login;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

總結

通過正確配置 server_name，你可以在同一臺服務器上托管多個不同的網站，并確保每個域名的請求都能被正確處理。server_name 支持多種匹配方式，包括具體域名、通配符和正則表達式，可以根據實際需求靈活使用。此外，結合端口監(jiān)聽和主機文件配置，你可以輕松實現復雜的域名和端口映射，滿足各種開發(fā)和生產環(huán)境的需求。

如果你有更多問題或需要進一步的幫助，請隨時查閱 Nginx 官方文檔或尋求社區(qū)支持。