如何配置nginx实现子域名访问？常见问题及解决方法详解。

Nginx配置子域名详解

配置前的准备

在动手配置之前,需完成以下基础工作，确保后续步骤顺利推进：

环境检查

• Nginx版本：建议使用 ≥1.20 版本（支持子域名配置的核心功能）；
• 模块加载：通过 nginx -V 命令确认已加载 rewrite、ssl 等模块（若缺失需手动编译或启用）；
• 系统权限：确保当前用户具有 sudo 权限，用于修改配置文件和重启服务。

目录结构规划

• 主配置目录：/etc/nginx/（存放全局配置和虚拟主机文件）；
• 虚拟主机目录：在 sites-available/ 下创建子域名配置文件（如 sub.example.com.conf），通过软链接启用（ln -s ../sites-available/sub.example.com ../sites-enabled/）；
• 站点根目录：为每个子域名准备独立的根目录（如 /var/www/sub.example.com），存放网站文件。

文件权限设置

• 配置文件权限需为 -rwxr-xr-x（如 chmod 644 /etc/nginx/sites-available/sub.example.com）；
• 站点根目录权限建议为 755（如 chmod 755 /var/www/sub.example.com）。

核心配置步骤

Nginx 配置子域名的核心逻辑是“虚拟主机（Virtual Host）”，通过 server 块匹配子域名并指向对应站点资源，以下是详细流程：

修改主配置文件（/etc/nginx/nginx.conf）

在 http 块下添加虚拟主机配置，示例（以 sub.example.com 为例）：

server { listen 80; # 监听HTTP端口 server_name sub.example.com; # 匹配子域名 root /var/www/sub.example.com; # 站点根目录 index index.html; # 默认索引文件 location / { try_files $uri $uri/ =404; # 静态资源处理逻辑 } }

创建虚拟主机配置文件

在 sites-available/ 下新建文件（如 sub.example.com.conf与上述示例一致，根据需求调整 root、index 等参数。

启用虚拟主机

执行以下命令创建软链接,使配置生效：

测试与生效

• 语法检查：nginx -t 命令验证配置无错误；
• 重启服务：sudo systemctl restart nginx 使配置立即生效。

配置参数说明（表格）

常见配置细节与优化

HTTPS（SSL）配置

现代网站需支持 HTTPS，可通过 Let’s Encrypt 自动获取免费证书：

• 安装工具：sudo apt install certbot python3-certbot-nginx；
• 获取证书：sudo certbot --nginx -d sub.example.com（需确认子域名已解析到服务器IP）；
• 配置示例： server { listen 443 ssl http2; server_name sub.example.com; root /var/www/sub.example.com; index index.html; ssl_certificate /etc/letsencrypt/live/sub.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/sub.example.com/privkey.pem; ssl_protocols TLSv1.2 TLSv1.3; # HSTS（强制HTTPS） add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always; }

性能优化

• 静态资源缓存： location ~* .(css|js|jpg|png|gif|ico)$ { expires 1y; # 缓存1年 add_header Cache-Control "public, immutable"; }
• Gzip压缩： gzip on; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

访问控制

限制特定IP访问管理后台：

location /admin/ { allow 192.168.1.1; # 允许IP deny all; # 拒绝其他IP }

测试与排查

• 访问测试：通过浏览器访问子域名（如 http://sub.example.com），检查状态码（200 表示成功）；
• 命令行测试：使用 curl -I http://sub.example.com 验证响应头；
• 常见错误排查：
  • 404：检查 root 目录是否存在文件，或 server_name 匹配错误；
  • 502：后端服务（如 PHP-FPM）未启动，通过 systemctl status php-fpm 查看状态。

FAQs

如何为子域名配置HTTPS（使用Let’s Encrypt）？

• 解答：首先安装 certbot 和 python3-certbot-nginx，执行 sudo certbot --nginx -d sub.example.com 命令，它会自动配置 Nginx 使用 Let’s Encrypt 证书，并设置 HSTS 头，配置中需确保 ssl_certificate 和 ssl_certificate_key 指向正确的证书文件路径。

当多个子域名共享同一个后端应用（如PHP-FPM）时，如何高效配置？

• 解答：使用 Nginx 的 upstream 模块配置后端服务器组，在虚拟主机配置中指向该组，示例：

  upstream php-fpm { server 127.0.0.1:9000; # PHP-FPM 监听地址 keepalive 32; # 连接池大小 } server { listen 80; server_name blog.example.com, news.example.com; root /var/www/app; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ .php$ { include snippets/fastcgi-php.conf; fastcgi_pass php-fpm; } }

  通过 upstream 实现负载均衡和会话共享，提升多子域名访问性能。