nginx安装及其配置详细教程

封面图 • 2025-05-04 • NGINX

以下是 Nginx 的安装及配置的详细教程，分为两个部分：**安装**和**配置**。

---

### **一、安装 Nginx**

#### 1. 系统环境准备
- 操作系统：CentOS 7（其他 Linux 发行版类似，如 Ubuntu）
- 已安装 `gcc` 和 `pcre` 开发库（Nginx 编译依赖）

#### 2. 安装 Nginx

##### 方法 1：通过包管理器安装（推荐）
```bash
# 更新系统包
sudo yum update -y

# 安装 Nginx
sudo yum install epel-release -y
sudo yum install nginx -y

# 启动 Nginx 并设置开机自启
sudo systemctl start nginx
sudo systemctl enable nginx
```

##### 方法 2：源码编译安装
如果需要自定义 Nginx 配置或模块，可以使用源码编译的方式安装。

1. 下载 Nginx 源码：
   ```bash
   wget http://nginx.org/download/nginx-1.25.3.tar.gz
   tar -zxvf nginx-1.25.3.tar.gz
   cd nginx-1.25.3
   ```

2. 安装依赖项：
   ```bash
   sudo yum install gcc pcre-devel zlib-devel openssl-devel -y
   ```

3. 编译安装：
   ```bash
   ./configure --prefix=/usr/local/nginx \
               --with-http_ssl_module \
               --with-http_v2_module \
               --with-http_realip_module

make
   sudo make install
   ```

4. 启动 Nginx：
   ```bash
   /usr/local/nginx/sbin/nginx
   ```

---

### **二、Nginx 配置**

Nginx 的主要配置文件位于 `/etc/nginx/nginx.conf` 或 `/usr/local/nginx/conf/nginx.conf`。以下是一个完整的配置示例：

#### 1. 基本配置
```nginx
# 全局配置
user nginx;
worker_processes auto; # 自动检测 CPU 核心数
error_log /var/log/nginx/error.log warn;

# 事件模块配置
events {
    worker_connections 1024; # 每个工作进程的最大连接数
}

# HTTP 模块配置
http {
    include       /etc/nginx/mime.types; # MIME 类型配置
    default_type  application/octet-stream;

# 日志格式
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

access_log  /var/log/nginx/access.log  main;

# 设置客户端请求头大小
    client_max_body_size 10M;

# 负载均衡配置（可选）
    upstream backend {
        server 192.168.1.1:8080;
        server 192.168.1.2:8080;
    }

# 虚拟主机配置
    server {
        listen       80; # 监听端口
        server_name  localhost;

# 静态文件目录
        root   /usr/share/nginx/html;
        index  index.html index.htm;

# 防止目录浏览
        autoindex off;

# 访问日志
        access_log  /var/log/nginx/host.access.log  main;

# 默认首页
        location / {
            try_files $uri $uri/ =404;
        }

# 反向代理配置（例如指向后端服务）
        location /api/ {
            proxy_pass http://backend/;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }

# 错误页面
        error_page 404 /404.html;
        location = /404.html {
            internal;
        }
    }
}
```

#### 2. 配置说明
- **全局配置**：
  - `user`：指定运行 Nginx 的用户。
  - `worker_processes`：设置工作进程数量。
  - `error_log`：错误日志路径。

- **事件模块**：
  - `worker_connections`：每个工作进程的最大并发连接数。

- **HTTP 模块**：
  - `include`：包含 MIME 类型配置文件。
  - `client_max_body_size`：限制客户端上传文件的大小。
  - `upstream`：负载均衡配置，支持多个后端服务器。

- **虚拟主机配置**：
  - `server_name`：域名或 IP 地址。
  - `root`：静态文件目录。
  - `location`：匹配不同的 URL 路径，支持反向代理和静态资源处理。

#### 3. 测试配置
在修改配置文件后，需要测试配置是否正确：
```bash
sudo nginx -t
```
如果配置无误，会显示以下提示：
```
nginx: configuration file /etc/nginx/nginx.conf test is successful
```

#### 4. 重新加载 Nginx
如果配置文件有更改，需要重新加载 Nginx：
```bash
sudo systemctl reload nginx
```

---

### **三、常见问题排查**
1. **Nginx 无法启动**：
   - 检查日志文件 `/var/log/nginx/error.log`。
   - 确保监听端口未被占用。

2. **反向代理失败**：
   - 确保后端服务正常运行。
   - 检查防火墙规则，确保端口开放。

3. **静态文件无法访问**：
   - 检查 `root` 路径是否正确。
   - 确保文件权限设置为可读。

---

通过以上步骤，您可以完成 Nginx 的安装与基本配置，并根据需求进一步优化。如果还有其他问题，请随时提问！