Nginx保姆级部署教程（2025最新版）

Nginx保姆级部署教程（2025最新版）

一、环境准备

1. 操作系统

   • 支持Linux（CentOS、Ubuntu等）、Windows（需通过源码编译）。
   • 本文以 CentOS 7 和 Ubuntu 22.04 为例。

   • 依赖工具安装

     # CentOS
     yum install -y wget vim gcc make openssl openssl-devel pcre pcre-devel zlib zlib-devel
     # Ubuntu
     sudo apt update
     sudo apt install -y build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev libssl-dev
     

二、Nginx安装

1. 源码编译安装（推荐）

# 下载Nginx稳定版（以1.26.2为例）
wget http://nginx.org/download/nginx-1.26.2.tar.gz
tar -zxvf nginx-1.26.2.tar.gz
cd nginx-1.26.2
# 配置编译参数（支持SSL、HTTP2等模块）
./configure --prefix=/usr/local/nginx \
--with-http_ssl_module \
--with-http_stub_status_module \
--with-pcre
# 编译并安装
make && make install

2. 包管理器安装（Ubuntu）

sudo apt install nginx
# 验证安装
nginx -v

三、Nginx基础配置

1. 启动与停止

# 启动
/usr/local/nginx/sbin/nginx  # 源码安装路径
systemctl start nginx        # Ubuntu包管理器安装
# 停止
/usr/local/nginx/sbin/nginx -s stop
systemctl stop nginx
# 重载配置（修改配置文件后执行）
nginx -s reload

2. 防火墙配置

# CentOS（firewalld）
firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --reload
# Ubuntu（ufw）
sudo ufw allow 'Nginx Full'
sudo ufw reload

3. 默认配置文件详解

配置文件路径：/usr/local/nginx/conf/nginx.conf（源码安装）或 /etc/nginx/nginx.conf（包管理器安装）

核心配置块：

http {
    server {
        listen 80;                  # 监听端口
        server_name example.com;     # 域名
        root /var/www/html;          # 网站根目录
        index index.html;            # 默认首页
        location / {
            try_files $uri $uri/ /index.html;  # 处理前端路由
        }
        # 反向代理配置
        location /api/ {
            proxy_pass http://backend-server:8080;  # 后端服务地址
            proxy_set_header Host $host;
        }
    }
}

四、静态资源部署

1. 配置静态资源目录

location /static/ {
    root /var/www/static;   # 路径拼接：root路径 + location路径
    # 或使用 alias（路径替换）
    # alias /var/www/static/;
}

• root与alias区别：
  • root：路径拼接（如访问 /static/image.jpg，实际路径为 /var/www/static/static/image.jpg）。
  • alias：路径替换（如访问 /static/image.jpg，实际路径为 /var/www/static/image.jpg）。

    2. 错误页面配置

    error_page 404 /404.html;
    location = /404.html {
        root /var/www/error_pages;
        internal;  # 仅允许内部访问
    }
    

    ---

    五、反向代理与负载均衡

    1. 反向代理示例

    location /api/ {
        proxy_pass http://127.0.0.1:8000;  # 后端服务地址
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    

    2. 负载均衡配置

    upstream backend_servers {
        server 192.168.1.101:8080 weight=3;  # 权重3
        server 192.168.1.102:8080;           # 默认权重1
        ip_hash;  # 基于IP的会话保持
    }
    server {
        location / {
            proxy_pass http://backend_servers;
        }
    }
    

    ---

    六、SSL证书配置（HTTPS）

    server {
        listen 443 ssl;
        server_name example.com;
        ssl_certificate /etc/ssl/certs/example.com.crt;
        ssl_certificate_key /etc/ssl/private/example.com.key;
        # 安全增强配置
        ssl_protocols TLSv1.2 TLSv1.3;
        ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256';
        ssl_prefer_server_ciphers on;
    }
    

    证书获取方式：

    • 使用Let’s Encrypt免费证书（推荐）：

      sudo certbot --nginx -d example.com
      

    • 自签名证书（测试环境）：

      openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /path/to/key -out /path/to/cert
      

      ---

      七、常见问题解决

      1. 启动报错：libpcre.so.1 not found

         ln -s /usr/local/lib/libpcre.so.1 /lib64/  # CentOS
         

      2. 配置文件语法错误

         nginx -t  # 检查配置语法
         

      3. 端口被占用

         lsof -i :80  # 查看占用进程
         kill -9 
         

      ---

      八、高级功能扩展

      • 日志分割：使用logrotate定期切割日志文件。
      • Gzip压缩：在nginx.conf中启用gzip on;。
      • 防盗链配置：通过valid_referers限制资源引用来源。

        ---

        总结

        以上为Nginx从安装到高级配置的全流程教程，覆盖静态资源托管、反向代理、负载均衡及HTTPS加密等核心场景。若需更详细配置（如高可用集群、缓存优化），可参考：Nginx官方文档 或 CSDN相关专题。

        
        （图片来源网络，侵删）
        
        （图片来源网络，侵删）
        
        （图片来源网络，侵删）