nginx服务器安装及配置文件详解

封面图 • 2025-12-31 • NGINX

Nginx 是一个高性能的 HTTP 和反向代理服务器，广泛用于 Web 服务、负载均衡、反向代理等场景。下面将详细介绍 **Nginx 的安装** 和 **配置文件的结构与详解**。

---

## 一、Nginx 安装（以 Ubuntu 为例）

### 1. 更新系统包
```bash
sudo apt update
sudo apt upgrade -y
```

### 2. 安装 Nginx
```bash
sudo apt install nginx -y
```

### 3. 启动并设置开机自启
```bash
sudo systemctl start nginx
sudo systemctl enable nginx
```

### 4. 检查状态
```bash
sudo systemctl status nginx
```

### 5. 浏览器访问
在浏览器中输入 `http://localhost` 或服务器 IP 地址，如果看到 “Welcome to nginx!” 页面，说明安装成功。

---

## 二、Nginx 配置文件详解

Nginx 的主配置文件通常位于 `/etc/nginx/nginx.conf`，而站点配置文件一般放在 `/etc/nginx/sites-available/`，并通过符号链接到 `/etc/nginx/sites-enabled/` 中。

### 1. 主配置文件：`/etc/nginx/nginx.conf`

#### 基本结构如下：

```nginx
# 全局配置块
user www-data;
worker_processes auto;  # 自动根据 CPU 核心数决定工作进程数
pid /run/nginx.pid;

# 错误日志路径
error_log /var/log/nginx/error.log notice;

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

# 进程 ID 文件
pid /run/nginx.pid;

# 事件处理模型
events {
    worker_connections 1024;  # 每个工作进程最大连接数
    # 使用 epoll 模型（Linux）
    use epoll;
}

# HTTP 服务器配置块
http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

# 日志格式
    access_log  /var/log/nginx/access.log  main;

sendfile        on;
    #tcp_nopush     on;

# keepalive 超时时间
    keepalive_timeout 65;

# gzip 压缩
    gzip  on;

# 包含其他配置文件
    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;
}
```

### 2. 站点配置文件示例（如 `/etc/nginx/sites-available/default`）

```nginx
server {
    listen 80;
    server_name example.com;

location / {
        root /var/www/html;
        index index.html index.htm;
        try_files $uri $uri/ =404;
    }

error_page 404 /404.html;
    location = /404.html {
        internal;
    }

error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        internal;
    }
}
```

---

## 三、常用配置项详解

| 配置项 | 说明 |
|--------|------|
| `listen` | 监听端口或IP地址，如 `listen 80;` |
| `server_name` | 服务器域名或IP |
| `root` | 网站根目录 |
| `index` | 默认索引文件，如 `index.html` |
| `location` | 处理特定 URI 的请求 |
| `try_files` | 尝试查找文件，找不到则返回 404 |
| `proxy_pass` | 反向代理到后端服务，如 `proxy_pass http://127.0.0.1:3000;` |
| `rewrite` | 重写 URL，如 `rewrite ^/old/(.*)$ /new/$1 permanent;` |
| `access_log` | 访问日志路径 |
| `error_log` | 错误日志路径 |
| `gzip` | 是否启用压缩 |
| `keepalive_timeout` | Keep-Alive 超时时间 |

---

## 四、Nginx 常用命令

| 命令 | 说明 |
|------|------|
| `nginx -t` | 检查配置文件是否正确 |
| `nginx -s reload` | 重新加载配置 |
| `nginx -s stop` | 停止服务 |
| `nginx -s quit` | 优雅关闭服务 |
| `systemctl restart nginx` | 重启服务 |
| `journalctl -u nginx` | 查看 Nginx 日志（适用于 systemd） |

---

## 五、常见应用场景

### 1. 反向代理（Reverse Proxy）

```nginx
location / {
    proxy_pass http://backend_server;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}
```

### 2. 负载均衡

```nginx
upstream backend {
    server 192.168.1.101;
    server 192.168.1.102;
    server 192.168.1.103;
}

server {
    listen 80;
    location / {
        proxy_pass http://backend;
    }
}
```

### 3. 静态资源缓存

```nginx
location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
    expires 30d;
    add_header Cache-Control public;
}
```

---

## 六、配置调试技巧

- 使用 `nginx -t` 检查配置语法。
- 使用 `curl http://localhost` 测试网页响应。
- 查看日志：`tail -f /var/log/nginx/access.log` 和 `tail -f /var/log/nginx/error.log`。

---

## 七、总结

Nginx 是一个功能强大、灵活高效的 Web 服务器，通过合理配置可以实现静态资源托管、反向代理、负载均衡等多种功能。掌握其配置文件结构和常用指令是使用 Nginx 的关键。

如果你有具体需求（如搭建博客、部署 Node.js 应用、配置 HTTPS 等），我可以提供更详细的配置示例。欢迎继续提问！