深入理解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路径的处理逻辑。