腳本之家服務器常用軟件

快捷導航

Nginx?413修改上傳文件大小限制的方法詳解

更新時間：2025年05月22日 11:02:13 作者：牛肉胡辣湯

在使用?Nginx?作為?Web?服務器時,有時會遇到客戶端嘗試上傳大文件時返回???413?Request?Entity?Too?Large???的錯誤,本文將介紹如何通過配置?Nginx?來解決這個問題,有需要的可以參考下

1. 理解 ??413 Request Entity Too Large?? 錯誤

當 Nginx 接收到的請求體（通常是 POST 請求中的數(shù)據(jù)）超過其默認設置的最大值時，就會返回 ??413 Request Entity Too Large?? 錯誤。默認情況下，Nginx 對請求體的大小限制是 1MB。這個限制可以通過配置文件中的 ??client_max_body_size?? 指令來調(diào)整。

2. 修改 Nginx 配置

2.1 打開 Nginx 配置文件

首先，需要找到 Nginx 的主配置文件 ??nginx.conf??。通常，這個文件位于 ??/etc/nginx/nginx.conf?? 或 ??/etc/nginx/conf.d/?? 目錄下。你可以使用文本編輯器打開它：

sudo nano /etc/nginx/nginx.conf

2.2 設置 ??client_max_body_size??

在 Nginx 配置文件中，可以在 ??http??、??server?? 或 ??location?? 塊中設置 ??client_max_body_size??。根據(jù)你的需求選擇合適的位置進行設置。

全局設置：如果你希望所有服務器塊和位置都使用相同的文件大小限制，可以在 http 塊中設置：

http {
    client_max_body_size 10M;  # 允許的最大文件大小為 10MB
}

特定服務器塊設置：如果你只想對某個特定的虛擬主機設置文件大小限制，可以在 server 塊中設置：

server {
    listen 80;
    server_name example.com;
 
    client_max_body_size 20M;  # 允許的最大文件大小為 20MB
 
    location / {
        root /var/www/html;
        index index.html index.htm;
    }
}

特定位置設置：如果你只想對某個特定的 URL 路徑設置文件大小限制，可以在 location 塊中設置：

server {
    listen 80;
    server_name example.com;
 
    location /upload {
        client_max_body_size 50M;  # 允許的最大文件大小為 50MB
        proxy_pass http://backend;
    }
}

2.3 保存并退出

完成配置后，保存文件并退出編輯器。

3. 測試 Nginx 配置

在重新加載 Nginx 之前，建議先測試配置文件是否有語法錯誤：

sudo nginx -t

如果測試結果顯示沒有問題，可以繼續(xù)重新加載 Nginx 以應用新的配置：

sudo systemctl reload nginx

或者使用以下命令：

sudo service nginx reload

4. 驗證更改

為了驗證更改是否生效，可以嘗試上傳一個大于原有限制的文件。如果成功上傳且沒有出現(xiàn) ??413 Request Entity Too Large?? 錯誤，則說明配置已經(jīng)生效。

通過上述步驟，你可以輕松地調(diào)整 Nginx 的文件上傳大小限制，從而避免 ??413 Request Entity Too Large?? 錯誤。根據(jù)實際需求，可以選擇在全局、特定服務器或特定位置進行設置。

5.方法補充

當使用Nginx作為Web服務器時，有時會遇到客戶端上傳大文件時返回413 Request Entity Too Large錯誤。這是因為Nginx默認的客戶端請求體大小限制較?。ㄍǔＪ?MB）。為了允許上傳更大的文件，你需要調(diào)整Nginx配置中的??client_max_body_size??指令。

下面是一個具體的示例，展示如何在Nginx配置文件中設置允許上傳的最大文件大?。?/p>

1. 編輯Nginx配置文件

通常，Nginx的主要配置文件位于??/etc/nginx/nginx.conf??，但更常見的是在站點特定的配置文件中進行修改，這些文件通常位于??/etc/nginx/conf.d/??目錄下或??/etc/nginx/sites-available/??目錄下。

示例：修改站點配置文件

假設你的站點配置文件是??/etc/nginx/sites-available/mysite??，你可以編輯這個文件來增加??client_max_body_size??指令。

server {
    listen 80;
    server_name example.com;
 
    # 其他配置...
 
    location / {
        # 設置允許上傳的最大文件大小為10M
        client_max_body_size 10M;
 
        # 其他location配置...
    }
 
    # 如果你有其他location塊，也可以單獨設置
    location /upload/ {
        # 設置允許上傳的最大文件大小為50M
        client_max_body_size 50M;
 
        # 其他location配置...
    }
}

2. 重啟Nginx服務

修改配置文件后，需要重啟Nginx服務以使更改生效。

在Debian/Ubuntu系統(tǒng)上：

sudo systemctl restart nginx

在CentOS/RHEL系統(tǒng)上：

sudo systemctl restart nginx

3. 驗證配置

重啟Nginx后，可以通過嘗試上傳一個大于原限制大小的文件來驗證配置是否成功。如果不再出現(xiàn)413錯誤，說明配置已經(jīng)生效。

注意事項

??client_max_body_size??可以設置在http、server或location上下文中。
設置過大的值可能會導致服務器資源占用過高，因此需要根據(jù)實際情況合理設置。
如果使用了反向代理，可能還需要在后端服務器（如PHP-FPM）中調(diào)整相應的上傳限制。

通過以上步驟，你可以輕松地調(diào)整Nginx的上傳文件大小限制，以滿足不同應用的需求。

在使用Nginx時，如果遇到“413 Request Entity Too Large”錯誤，這通常意味著客戶端嘗試上傳的文件超過了Nginx默認允許的最大文件大小。Nginx默認的最大請求體大小是1MB。要解決這個問題，你需要修改Nginx配置文件來增加允許的上傳文件大小。

修改步驟

找到Nginx配置文件：

Nginx的主要配置文件通常位于??/etc/nginx/nginx.conf??或??/etc/nginx/conf.d/??目錄下的某個文件中。
如果你使用的是虛擬主機（Virtual Hosts），配置文件可能位于??/etc/nginx/sites-available/??或??/etc/nginx/conf.d/??目錄下。

編輯配置文件：

使用文本編輯器打開配置文件，例如使用??nano??或??vim??：

sudo nano /etc/nginx/nginx.conf

或者針對特定的虛擬主機配置文件：

sudo nano /etc/nginx/sites-available/your-site

添加或修改client_max_body_size?指令：

??client_max_body_size??指令用于設置客戶端請求的最大允許大小。這個值可以設置為具體的字節(jié)數(shù)或使用K、M、G等單位。

你可以將這個指令添加到不同的上下文中，具體取決于你的需求：

全局設置：在??http??塊中設置，影響所有服務器和位置。

http {
    client_max_body_size 10M;  # 允許的最大文件大小為10MB
    ...
}

特定服務器設置：在??server??塊中設置，僅影響該服務器塊內(nèi)的所有位置。

server {
    listen 80;
    server_name yourdomain.com;
    client_max_body_size 10M;  # 允許的最大文件大小為10MB
    ...
}

特定位置設置：在??location??塊中設置，僅影響該位置。

server {
    listen 80;
    server_name yourdomain.com;
    location /upload {
        client_max_body_size 10M;  # 允許的最大文件大小為10MB
        ...
    }
    ...
}

保存并退出編輯器：