在 Debian 上自定义 Nginx 配置文件

一 准备与环境检查

• 更新索引并安装 Nginx：sudo apt update && sudo apt install nginx -y
• 启动服务并设为开机自启：sudo systemctl start nginx && sudo systemctl enable nginx
• 确认运行状态：sudo systemctl status nginx（应显示 active (running)）
• 如启用防火墙，放行 Web 流量：sudo ufw allow ‘Nginx Full’（或分别放行 80/443 端口）

二 配置文件结构与目录

• 主配置文件：/etc/nginx/nginx.conf，采用分层结构：
  • 全局块：如 worker_processes、error_log、pid
  • events 块：如 worker_connections
  • http 块：如 include mime.types、log_format、access_log、sendfile、keepalive_timeout，并通过 include 引入其他配置
• 常用包含路径：
  • /etc/nginx/conf.d/*.conf
  • /etc/nginx/sites-enabled/（Debian 惯例：在 sites-available 中存放站点配置，用符号链接到 sites-enabled 启用）
• 典型关系：main → http → server → location；location 用于按 URI 匹配并定义处理方式

三 创建并启用虚拟主机

• 创建站点目录与示例首页：
  • sudo mkdir -p /var/www/example.com
  • echo “

    Hello, example.com

    ” | sudo tee /var/www/example.com/index.html
• 新建站点配置（/etc/nginx/sites-available/example.com.conf）：
  • sudo nano /etc/nginx/sites-available/example.com.conf
  • 示例内容：
    • server {
      • listen 80;
      • server_name example.com www.example.com;
      • root /var/www/example.com;
      • index index.html;
      • location / {
        • try_files $uri $uri/ =404;
        • }
      • error_page 404 /404.html;
      • location = /404.html {
        • root /var/www/example.com;
        • }
      • error_page 500 502 503 504 /50x.html;
      • location = /50x.html {
        • root /var/www/example.com;
        • }
      • }
• 启用站点（创建符号链接）：
  • sudo ln -s /etc/nginx/sites-available/example.com.conf /etc/nginx/sites-enabled/
• 语法检查与生效：
  • sudo nginx -t
  • sudo systemctl reload nginx
• 域名解析：在域名注册商将 example.com 与 www.example.com 的 A/AAAA 记录指向服务器 IP
• 访问测试：浏览器打开 http://example.com 应看到示例页面

四 常用自定义示例

• 反向代理到本地应用（如运行在 3000 端口）：
  • location / {
    • proxy_pass http://127.0.0.1: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;
    • }
• 启用 Gzip 压缩（在 http 块中）：
  • gzip on;
  • gzip_vary on;
  • gzip_types text/plain text/css application/json application/javascript text/xml application/xml+rss text/javascript;
• 静态资源缓存（示例对图片类缓存 30 天）：
  • location ~* .(jpg|jpeg|png|gif|ico|svg)$ {
    • expires 30d;
    • add_header Cache-Control “public, no-transform”;
    • }
• 安全与隐藏版本：
  • 在 http 或 server 块：server_tokens off;
  • 禁止访问敏感文件：location ~ /.ht { deny all; }

五 维护与排错

• 配置语法检查：sudo nginx -t（每次修改后先执行）
• 热重载：sudo systemctl reload nginx（不中断现有连接）
• 查看日志：
  • 访问日志：/var/log/nginx/access.log
  • 错误日志：/var/log/nginx/error.log
• 常见问题速查：
  • 403 Forbidden：检查目录权限与 index 指令，确认 root 路径正确
  • 502 Bad Gateway：多为上游（如应用或 PHP-FPM）未启动或 fastcgi_pass 地址不匹配
  • 站点未生效：确认已在 sites-enabled 中存在符号链接，且 server_name 与访问域名一致
  • 端口被占用：ss -tulpen | grep ‘:80|:443’，释放或更换端口后重载 Nginx