深入理解nginx root配置

一、基本概念

在nginx配置中，root指定了文檔根目錄，對於一個請求，nginx會查找文檔根目錄下的文件或文件夾。如果root沒有設置，則nginx默認使用安裝時的默認目錄。

在nginx配置文件中，可以通過以下方式設置root：

server{
  listen 80;
  server_name www.example.com;
  root /var/www;
}

在上面的配置中，文檔根目錄被設置為/var/www/。這意味著，在接收到一個來自www.example.com的請求時，nginx將嘗試從/var/www目錄下查找相應的文件或文件夾。

二、root指令與別名指令的比較

除了root指令，nginx還提供了別名指令。兩者在路徑名處理上存在不同。

具體而言，當請求中包含URI時，root指令會將URI與root拼接起來，作為最終的文件路徑。而別名指令則是將URI替換為路徑名，直接映射到相應的文件或文件夾。

以一個示例來看：

server{
  listen 80;
  server_name www.example.com;
  root /var/www;
  location /static/ {
    alias /var/data/;
  }
}

對於一個請求www.example.com/static/index.html，root指令會將URI和root拼接起來，最終文件路徑為/var/www/static/index.html。而別名指令則會將URI替換為/var/data/index.html。

需要注意的是，在使用別名指令時，URI末尾的斜杠會被忽略。

三、root指令與虛擬主機配置

在使用虛擬主機配置時，root指令並不會直接修改文檔根目錄，而是僅僅確定其中的一個子目錄。

具體而言，可以在每個server塊中定義不同的root路徑，以實現不同虛擬主機返回不同的頁面。但是，在location塊中，root指令會覆蓋之前在server塊中配置的root路徑。

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

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

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

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

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

在上面的配置中，www.example.com和admin.example.com都有自己的文檔根目錄。在location塊中，使用try_files指令嘗試匹配請求的頁面。如果找不到，返回404錯誤。

四、root指令與開發部署

在開發部署中，我們經常需要將代碼部署到不同的目錄中，因為不同的分支可能需要訪問不同的代碼。在這種情況下，使用root指令可以快速切換文檔根目錄。

需要注意的是，在多人協作開發中，如果使用了相對路徑，可能會導致問題。建議使用絕對路徑來設置root路徑。

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

  root /var/www/develop/website;
  index index.html;
}

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

  root /var/www/release/website;
  index index.html;
}

在上面的配置中，為不同的環境設置了不同的文檔根目錄。通過修改root路徑，可以快速切換代碼的部署位置。

五、總結

在nginx配置中，root指令用於指定文檔根目錄，是重要的配置之一。需要注意的是，使用root指令時，URI會和root拼接起來，形成最終的文件路徑。同時，別名指令和虛擬主機配置也會影響root路徑的處理邏輯。