🚀 高性能反向代理服务器 —— Nginx 完整使用手册

适配场景：静态资源托管、动态服务代理、负载均衡、动静分离、高并发架构
支持平台：Linux（CentOS / Ubuntu）、Docker、云服务器
推荐组合：Nginx + uWSGI + Python/Django/Flask / Nginx + Docker

一、什么是 Nginx？

Nginx（发音：engine-x）是一个高性能的 HTTP 服务器 和 反向代理服务器，以其 低内存占用 和 超高并发处理能力 著称。

🔍 核心特点

✅ 当前全球约 40% 的网站使用 Nginx 作为前端入口，包括 Netflix、GitHub、京东等大型平台。

二、Nginx 的主要用途

三、安装 Nginx

✅ CentOS/RHEL 系统

sudo yum update -y
sudo yum install -y nginx

✅ Ubuntu/Debian 系统

sudo apt update -y
sudo apt install -y nginx

💡 安装完成后，终端输出 Complete! 表示成功。

🔍 查看版本号

nginx -v
# 显示：nginx version: nginx/1.24.0

四、Nginx 常用命令（核心操作）

✅ 最佳实践：修改配置后务必先测试再重载！

sudo nginx -t && sudo nginx -s reload

五、启动、停止、重启服务

⚙️ 系统服务管理（推荐方式）

✅ 启动

# CentOS 7+
sudo systemctl start nginx

# Ubuntu
sudo systemctl start nginx

✅ 停止

sudo systemctl stop nginx

✅ 重启

sudo systemctl restart nginx

✅ 查看状态

sudo systemctl status nginx

✅ 若提示“Active: active (running)”，表示运行正常。

六、解决 403 Forbidden 错误（常见问题）

当你访问页面返回 403 Forbidden，请按以下步骤排查：

❌ 问题 1：用户权限不一致

• 查看 Nginx 工作进程所属用户：

ps aux | grep "nginx: worker process" | awk '{print $1}'

• 修改 nginx.conf 中的 user 指令：

user www-data;  # 例如：Ubuntu 默认为 www-data
# 或
user nginx;

✅ 重启服务使生效：

sudo systemctl restart nginx

❌ 问题 2：缺少默认首页文件

在 location 配置中指定了 index index.html，但目录下无该文件：

server {
    listen       80;
    server_name  localhost;
    root         /data/www;
    index        index.html index.htm;  # 必须存在这些文件
}

✅ 解决方案：

echo "<h1>Welcome to Nginx!</h1>" > /data/www/index.html
sudo systemctl restart nginx

❌ 问题 3：目录权限不足

如果 Nginx 用户（如 www-data）无法读取 /data/www 目录：

# 授予所有者读写权限（仅测试阶段）
sudo chmod -R 755 /data/www

# 更安全做法：设置属主为 nginx
sudo chown -R www-data:www-data /data/www
sudo chmod -R 755 /data/www

✅ 推荐使用 755 权限，避免 777 导致安全隐患。

❌ 问题 4：SELinux 限制（CentOS/RHEL）

查看状态：

/usr/sbin/sestatus

若显示 SELinux status: enabled，则可能阻止访问。

✅ 临时解决方案（测试阶段）：

sudo setenforce 0

✅ 永久关闭（需编辑配置）：

sudo vim /etc/selinux/config

修改为：

SELINUX=disabled

⚠️ 重启生效：

sudo reboot

💡 警告：生产环境不应关闭 SELinux，应使用 setsebool 或 chcon 设置特定目录的上下文。

sudo setsebool -P httpd_can_network_connect on
sudo chcon -R -t httpd_exec_t /data/www

七、Nginx 配置详解：location 指令

🔧 指令语法

location [modifier] /pattern/ {
    ...
}

📌 示例：静态资源与动态代理分离

server {
    listen 80;
    server_name localhost;

    # 静态资源（优先级高于正则）
    location ~* \.(gif|jpg|png|css|js|html)$ {
        root /usr/share/nginx/statics;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    # 动态请求代理
    location /api/ {
        proxy_pass http://127.0.0.1:8081/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_connect_timeout 10s;
        proxy_send_timeout 10s;
        proxy_read_timeout 10s;
    }

    # 默认路由到后端应用
    location / {
        proxy_pass http://127.0.0.1:8080/;
    }
}

✅ 推荐：对静态资源添加 expires 头和缓存控制。

八、反向代理配置（核心功能）

✅ 应用场景

将 http://yourdomain.com/api/ 请求转发至后端应用服务（如 Flask、Django、uWSGI）。

📂 配置方式一：使用 proxy_pass

location /api/ {
    proxy_pass http://127.0.0.1:8081/;
    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;
}

📂 配置方式二：使用 uwsgi_pass（uWSGI 协议）

location / {
    include uwsgi_params;
    uwsgi_pass 127.0.0.1:8081;
}

✅ 适用于 Python Web 框架（Django/Flask）通过 uWSGI 运行。

九、负载均衡配置（多实例部署）

✅ 定义上游服务器组

upstream myapp {
    # 轮询（默认）
    server 192.168.1.10:8080;
    server 192.168.1.11:8080;

    # 权重分配（能力越大，处理越多）
    # server 192.168.1.12:8080 weight=2;

    # IP哈希（保证同一客户端始终访问同一后端）
    # ip_hash;

    # 会话保持 + 权重
    ip_hash;
    server 192.168.1.13:8080 weight=1;
    server 192.168.1.14:8080 weight=2;
}

✅ 应用到 Server 块

server {
    listen 80;
    server_name app.yourdomain.com;

    location / {
        proxy_pass http://myapp;
        proxy_connect_timeout 10s;
        proxy_send_timeout 10s;
        proxy_read_timeout 10s;
    }
}

✅ Nginx 支持三种负载均衡策略：

十、动静分离（性能优化关键）

目标：让静态资源由 Nginx 直接响应，减少后端应用压力。

🎯 架构图说明

浏览器 → [请求] → 
          ↓
      [Nginx 代理] ←─┐
          ↓           │
[静态资源] ←───────┘   [动态资源 → uWSGI → Python App]

✅ 配置示例（基于 Docker）

📁 目录结构

/opt/docker_nginx/
├── conf.d/
│   └── default.conf
├── statics/
│   ├── style.css
│   ├── script.js
│   └── avatar.jpg

📄 default.conf

server {
    listen 80;
    server_name localhost;

    # 静态资源路径
    location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg)$ {
        root /usr/share/nginx/statics;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    # 动态请求代理
    location / {
        proxy_pass http://192.168.174.128:8080/;
    }
}

📄 docker-compose.yml

version: '3.1'
services:
  nginx:
    image: nginx:alpine
    container_name: nginx-proxy
    ports:
      - "80:80"
    volumes:
      - ./conf.d:/etc/nginx/conf.d
      - ./statics:/usr/share/nginx/statics
    restart: always

⚠️ 权限问题修复：

# 给静态目录赋权
chmod -R 755 /opt/docker_nginx/statics/
chown -R 101:101 /opt/docker_nginx/statics/  # nginx 容器内用户 UID

✅ 访问测试：http://localhost/style.css 应能直接返回文件。

十一、高级功能建议（生产必备）

🔗 Let's Encrypt 配置教程参考：https://certbot.eff.org

十二、总结：最佳实践清单

✅ 必须遵守的 10 条黄金法则：

📌 附录：一键部署脚本模板

💻 setup-nginx.sh

#!/bin/bash
echo "🚀 正在部署 Nginx 动静分离服务..."

# 创建目录
mkdir -p /opt/docker_nginx/{conf.d,statics}

# 写入配置
cat > /opt/docker_nginx/conf.d/default.conf <<'EOF'
server {
    listen 80;
    server_name localhost;

    location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg)$ {
        root /usr/share/nginx/statics;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    location / {
        proxy_pass http://127.0.0.1:8080/;
        proxy_set_header Host $host;
    }
}
EOF

# 创建静态文件夹并赋权
touch /opt/docker_nginx/statics/test.png
chmod -R 755 /opt/docker_nginx/statics
chown -R 101:101 /opt/docker_nginx/statics

# 启动 Docker
docker-compose up -d

echo "✅ Nginx 静动分离部署完成！"
echo "🌐 访问地址：http://localhost/test.png"

✅ 使用方法：

chmod +x setup-nginx.sh
sudo ./setup-nginx.sh

🔗 官方文档：https://nginx.org/en/docs/