Nginx 中 server_name的详细使用

目录

1. 简介
2. DNS: 域名与 IP 地址之间的转换
3. server_name的作用
4. 基本用法
5. 通配符和正则表达式
6. 默认服务器
7. 多域名配置
8. 子域名配置
9. 端口监听与 server_name结合
10. 主机文件配置
11. 测试和验证
12. 其他注意事项

简介

server_name是 Nginx 配置文件中的一个重要指令，用于指定 Nginx 服务器块（或虚拟主机）应该响应哪些域名的请求。

DNS 解析的过程

1. 客户端发起请求：当用户在浏览器中输入一个域名（如 example.com）时，浏览器会向本地 DNS 服务器发送查询请求。

   例如，假设你有两台服务器，分别托管 example.com和 admin.example.com。

   ---

   基本用法

   最简单的 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字段。此外，结合端口监听和主机文件配置，你可以轻松实现复杂的域名和端口映射，满足各种开发和生产环境的需求。

   ---

   参考资料

   • Nginx 官方文档
   • Nginx server_name指令
   • mkcert: 生成自签名证书

   ---

   希望这篇笔记能帮助你更好地理解和使用 Nginx 中的 server_name指令。

   # 主站配置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;    }}

   ---

   端口监听与 server_name结合

   如果你希望 Nginx 在非标准端口（如 8082）上监听请求，并且只处理特定域名的请求，可以在 listen指令中明确指定 IP 地址和端口组合。

2. 下划线：server_name _;也可以表示默认服务器。如果 Host字段的值是 example.com，那么 Nginx 就会使用这个 server块中的配置来处理该请求。server_name支持多种匹配方式，包括具体域名、顶级域 DNS 服务器等）进行递归查询，直到找到目标 IP 地址。用户在浏览器中输入 admin.example.com，DNS 会将其解析为某台服务器的 IP 地址，然后 Nginx 会根据 server_name指令判断是否应该由该服务器处理该请求。

   ---

   子域名配置

   如果你想为 example.com的子域名（如 api.example.com和 admin.example.com）创建独立的 server块，可以按照以下步骤进行配置。

配置 Nginx

接下来，我们需要在 Nginx 中为 api.example.com和 admin.example.com分别创建 server块。

Windows

• 打开记事本（以管理员身份运行），然后打开 C:\Windows\System32\drivers\etc\hosts文件。主机文件允许我们在本地将特定的域名映射到指定的 IP 地址，而无需依赖外部 DNS 服务器。例如：

  server {    listen 80;    server_name ~^(?<sub>.+)\.example\.com$;    root /var/www/$sub.example.com;    index index.html;    location / {        try_files $uri $uri/ =404;    }}

  在这个例子中，(?<sub>.+)是一个捕获组，它允许你在后续配置中引用匹配到的子域名部分。

  修改主机文件

  首先，你需要在主机文件中为新的子域名添加条目。

• 递归查询：本地 DNS 服务器会检查其缓存，如果找到了该域名对应的 IP 地址，则直接返回给客户端；如果没有找到，则继续向其他 DNS 服务器（如根 DNS 服务器、

  例如，假设你希望 Nginx 在 192.168.154.101上监听端口 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

  ---

  测试和验证

  1. 测试配置文件：

     • 在修改完 Nginx 配置文件后，先测试配置文件是否有语法错误：

       sudonginx -t

  2. 重载 Nginx：

     • 如果没有问题，重新加载 Nginx 使配置生效：

       sudosystemctl reload nginx

       或者，如果你的系统使用的是不同的初始化系统，可能需要使用 sudo service nginx reload。

  ---

  其他注意事项

  1. 防火墙设置：确保你的防火墙允许通过端口 8082 的流量。

  2. 缓存结果：为了提高效率，DNS 服务器通常会缓存查询结果一段时间（称为 TTL，Time To Live），以便后续相同的查询可以直接从缓存中获取结果，而无需再次进行完整的解析过程。通配符和正则表达式，可以根据实际需求灵活使用。这使得在同一台服务器上托管多个不同域名的网站成为可能。