Ubuntu Nginx配置文件与管理

#1. Nginx配置文件结构

#配置文件位置

复制主配置文件: /etc/nginx/nginx.conf
全局配置: /etc/nginx/nginx.conf
站点配置目录: /etc/nginx/sites-available/
已启用站点: /etc/nginx/sites-enabled/
额外配置: /etc/nginx/conf.d/
模块配置: /etc/nginx/modules-available/

#配置层次结构

复制nginx.conf (主配置)
├── http 块
│   ├── upstream 块 (负载均衡)
│   ├── server 块 (虚拟主机)
│   │   ├── location 块 (URL匹配)
│   │   └── 其他server级别指令
│   └── 其他http级别指令
└── events 块 (连接处理)

#2. 常用配置示例

#基础服务器配置

复制server {
    listen 80;
    server_name example.com www.example.com;
    
    root /var/www/example.com;
    index index.html index.htm index.php;
    
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    # PHP处理
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
    }
    
    # 静态文件缓存
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
    
    # 禁止访问敏感文件
    location ~ /\.(env|git|ht|svn) {
        deny all;
    }
}

#反向代理配置

复制server {
    listen 80;
    server_name app.example.com;
    
    location / {
        proxy_pass http://localhost:3000;  # 后端应用地址
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        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_cache_bypass $http_upgrade;
        proxy_read_timeout 90s;
    }
}

#HTTPS配置 (Let’s Encrypt证书)

复制server {
    listen 443 ssl;
    server_name example.com www.example.com;
    
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256';
    
    # 其他配置同HTTP服务器部分
    root /var/www/example.com;
    index index.html;
    
    location / {
        try_files $uri $uri/ =404;
    }
}

# HTTP重定向到HTTPS
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

#3. Ubuntu中Nginx配置管理流程

#创建新站点配置

复制# 1. 创建配置文件
sudo nano /etc/nginx/sites-available/example.com

# 2. 创建网站根目录
sudo mkdir -p /var/www/example.com
sudo chown -R www-data:www-data /var/www/example.com
sudo chmod -R 755 /var/www/example.com

# 3. 启用站点 (创建符号链接)
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

# 4. 测试配置
sudo nginx -t

# 5. 重新加载配置 (不中断现有连接)
sudo systemctl reload nginx

#禁用站点

复制# 1. 删除符号链接
sudo unlink /etc/nginx/sites-enabled/example.com

# 2. 测试配置
sudo nginx -t

# 3. 重新加载配置
sudo systemctl reload nginx

#配置片段复用 (snippets)

复制# 创建配置片段
sudo nano /etc/nginx/snippets/ssl-params.conf

# 在server块中包含
include snippets/ssl-params.conf;

#4. 配置文件验证与服务管理命令

#配置测试

复制# 检查配置文件语法
sudo nginx -t

# 仅检查不输出详细信息
sudo nginx -t -q

# 检查特定配置文件
sudo nginx -T  # 输出所有配置文件内容

#服务管理

复制# 重新加载配置 (平滑重启，不中断连接)
sudo systemctl reload nginx
# 或
sudo nginx -s reload

# 完全重启服务 (会短暂中断连接)
sudo systemctl restart nginx

# 查看Nginx状态
sudo systemctl status nginx

# 查看Nginx进程
ps aux | grep nginx

# 查看监听端口
sudo ss -tulpn | grep nginx

#5. 常用调试命令

复制# 查看错误日志 (实时)
sudo tail -f /var/log/nginx/error.log

# 查看访问日志 (实时)
sudo tail -f /var/log/nginx/access.log

# 仅查看错误日志中的错误
sudo grep -i error /var/log/nginx/error.log

# 查看Nginx版本和编译参数
nginx -v    # 版本
nginx -V    # 详细版本和编译参数

# 在不启动服务的情况下测试配置
sudo nginx -t

#6. 常见配置问题解决

#配置后无法访问

1. 检查配置语法: sudo nginx -t

2. 检查防火墙设置: sudo ufw status

3. 检查文件权限:

   复制sudo chown -R www-data:www-data /var/www/your_site
   sudo chmod -R 755 /var/www/your_site

4. 检查SELinux (如果启用): sudo setenforce 0 (临时禁用)

#403 Forbidden错误

复制# 检查Nginx运行用户是否有权限访问文件
sudo -u www-data ls -la /var/www/your_site

# 修复权限
sudo chmod -R 755 /var/www/your_site
sudo chown -R www-data:www-data /var/www/your_site

#502 Bad Gateway错误

1. 检查后端服务是否运行

2. 检查proxy_pass指向是否正确

3. 增加超时设置:

   复制proxy_connect_timeout 60s;
   proxy_read_timeout 120s;

#7. 配置备份与恢复

复制# 备份所有配置
sudo tar -czf nginx-config-backup-$(date +%F).tar.gz /etc/nginx

# 恢复配置
sudo tar -xzf nginx-config-backup-2023-01-01.tar.gz -C /
sudo nginx -t && sudo systemctl reload nginx

#8. 最佳实践

1. 每个站点一个配置文件 - 便于管理和故障排查
2. 修改前备份 - sudo cp /etc/nginx/sites-available/example.com /etc/nginx/sites-available/example.com.bak
3. 先测试再应用 - 始终使用 sudo nginx -t 验证配置
4. 平滑重启 - 优先使用 sudo systemctl reload nginx 而不是 restart
5. 注释清晰 - 在配置文件中添加说明性注释
6. 权限最小化 - 仅授予Nginx访问所需文件的权限

复制# 良好注释示例
# 以下配置于2023-01-15添加，用于解决移动设备样式问题
location ~* \.(css|js)$ {
    add_header Cache-Control "public, max-age=86400";
}

重要提示:

• 每次修改配置后必须运行 sudo nginx -t 测试配置
• 配置正确后再运行 sudo systemctl reload nginx 应用更改
• 重启而不是重新加载会导致短暂的服务中断
• 配置文件错误可能导致Nginx无法启动，确保有备份
• 使用 sudo journalctl -u nginx -f 实时查看Nginx服务日志