nginx配置域名、设置文件上传大小

封面图 • 2025-12-17 • NGINX

在 Nginx 中配置域名和设置文件上传大小，通常涉及两个主要部分：

1. **配置域名（即配置一个虚拟主机）**
2. **设置文件上传大小限制（通过 `client_max_body_size` 参数）**

下面是一个完整的示例配置，供你参考。

---

## 一、Nginx 配置域名

假设你的域名是 `example.com`，网站文件放在 `/var/www/html` 目录下。

### 示例配置文件（通常位于 `/etc/nginx/sites-available/example.com` 或 `/etc/nginx/conf.d/example.com.conf`）：

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

# 设置根目录
    root /var/www/html;
    index index.html index.htm;

location / {
        try_files $uri $uri/ =404;
    }

# 设置文件上传大小
    client_max_body_size 20M;  # 允许上传最大 20MB 的文件

# 如果需要支持更大的文件上传，可以调整这个值
    # client_max_body_size 100M;

# 可选：如果使用 FastCGI（如 PHP），可能还需要设置一些参数
    # include fastcgi_params;
    # fastcgi_pass unix:/var/run/php/php-fpm.sock;
    # fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
```

---

## 二、设置文件上传大小

在上面的配置中，我们设置了：

```nginx
client_max_body_size 20M;
```

这表示客户端最多可以上传 20MB 的文件。你可以根据需要修改这个值，例如：

- `1M`：1MB
- `10M`：10MB
- `100M`：100MB
- `500M`：500MB
- `1G`：1GB

> 注意：如果你使用的是 PHP，还需要在 PHP 的配置文件（`php.ini`）中设置：
>
> ```ini
> upload_max_filesize = 20M
> post_max_size = 20M
> ```
>
> 否则即使 Nginx 允许上传大文件，PHP 也会拒绝。

---

## 三、启用配置并测试

1. **保存配置文件**（如 `example.com`）

2. **创建符号链接到 `sites-enabled` 目录**（如果使用 `sites-available` 模式）：

```bash
   sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
   ```

3. **检查配置是否有错误**：

```bash
   sudo nginx -t
   ```

4. **重新加载 Nginx 配置**：

```bash
   sudo systemctl reload nginx
   ```

---

## 四、验证配置是否生效

你可以用以下命令查看当前的 Nginx 配置中 `client_max_body_size` 是否被正确读取：

```bash
nginx -V 2>&1 | grep -- '--with-http_client_body_buffer_size'
```

或者直接查看配置文件内容。

---

## 五、其他注意事项

- 如果你使用 HTTPS，请将 `listen 80;` 改为 `listen 443 ssl;` 并配置 SSL 证书。
- 如果你使用反向代理（如 `proxy_pass`），也要注意在 `location` 块中设置 `client_max_body_size`。

---

如有更多关于 Nginx 配置的问题，欢迎继续提问！