nginx配置入门

封面图 • 2025-10-05 • NGINX

Nginx 是一个高性能的 HTTP 和反向代理服务器，常用于 Web 服务、负载均衡、静态资源托管等。下面是一个 **Nginx 配置入门指南**，帮助你快速上手。

---

## 🧰 一、安装 Nginx

### Linux（Ubuntu/Debian）：
```bash
sudo apt update
sudo apt install nginx
```

### Linux（CentOS/RHEL）：
```bash
sudo yum install epel-release
sudo yum install nginx
```

### macOS（使用 Homebrew）：
```bash
brew install nginx
```

---

## 📁 二、Nginx 配置文件结构

默认配置文件路径：

- **Ubuntu/Debian**: `/etc/nginx/nginx.conf`
- **CentOS/RHEL**: `/etc/nginx/nginx.conf`
- **站点配置文件**: `/etc/nginx/sites-available/`（通常通过符号链接到 `sites-enabled/`）

---

## 🧩 三、基本配置示例

### 1. 默认配置（显示欢迎页面）

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

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

> 将 `example.com` 替换为你的域名或 IP 地址。

### 2. 反向代理配置（将请求转发给后端服务）

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

location / {
        proxy_pass http://localhost:3000;  # 后端服务地址
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}
```

### 3. 静态文件服务（如图片、CSS、JS）

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

location /static/ {
        alias /var/www/static/;
        expires 30d;
    }
}
```

---

## 🔧 四、常用命令

| 命令 | 说明 |
|------|------|
| `nginx -t` | 检查配置文件语法 |
| `systemctl restart nginx` | 重启 Nginx |
| `systemctl status nginx` | 查看 Nginx 状态 |
| `nginx -s reload` | 重新加载配置文件（不中断连接） |

---

## 🔄 五、常见问题排查

### 1. 配置错误
运行以下命令检查配置：
```bash
nginx -t
```

如果报错，请根据提示修改配置文件。

### 2. 权限问题
确保 Nginx 有权限访问网站根目录（如 `/var/www/html`）。

### 3. 端口冲突
确认 80 或 443 端口没有被其他程序占用。

---

## 🌐 六、进阶配置（可选）

| 功能 | 配置片段 |
|------|----------|
| HTTPS | 使用 SSL 证书（如 Let's Encrypt） |
| 负载均衡 | 使用 `upstream` 模块 |
| URL 重写 | 使用 `rewrite` 指令 |
| 缓存 | 使用 `proxy_cache` 或 `expires` 指令 |

---

## 📚 七、参考文档

- [Nginx 官方文档](https://nginx.org/en/docs/)
- [Nginx 配置详解](https://www.nginx.com/resources/wiki/start/)
- [Let's Encrypt 证书配置教程](https://letsencrypt.org/)

---

如果你有具体的使用场景（比如部署 Node.js、PHP、静态网站等），我可以为你提供更详细的配置示例。需要吗？