一、默認(rèn)值與錯(cuò)誤提示

• 默認(rèn)值：client_max_body_size 1m;
• Nginx 默認(rèn)允許的請(qǐng)求體最大為 1 MiB，超過(guò)該值會(huì)返回 413 Request Entity Too Large 錯(cuò)誤。
• 錯(cuò)誤提示示例：

HTTP/1.1 413 Request Entity Too Large
Content-Type: text/html

二、如何配置 client_max_body_size

該指令可放置在 http、server 或 location 塊中，后者會(huì)覆蓋前者的配置：

http {
    # 全局設(shè)置，作用于所有 server
    client_max_body_size 50m;
    server {
        listen 80;
        server_name example.com;
        # 針對(duì)某個(gè)虛擬主機(jī)單獨(dú)設(shè)置
        client_max_body_size 100m;
        location /upload {
            # 針對(duì)特定路徑再度覆蓋
            client_max_body_size 200m;
            proxy_pass http://backend;
        }
    }
}

說(shuō)明：在嵌套塊中聲明的 client_max_body_size 會(huì)覆蓋祖先塊中的同名指令citeturn1search1。
單位：支持 k、m、g（不區(qū)分大小寫），如 10K、2m、1G。

三、client_max_body_size 的最大上限

Nginx 在內(nèi)部將該值存儲(chǔ)為 C 語(yǔ)言類型 off_t，其位寬決定了上限：

64 位可執(zhí)行文件

• off_t 為 64 位有符號(hào)整數(shù)，理論最大值為 2?³ − 1 字節(jié)（約 9.22×10¹? 字節(jié)，≈ 8 EiB），故可將 client_max_body_size 設(shè)置至 2^63 而不報(bào)錯(cuò)。

32 位可執(zhí)行文件（未啟用大文件支持）

• off_t 為 32 位有符號(hào)整數(shù)，其最大值約為 2³¹ − 1（約 2 GiB），即 2147483647 字節(jié)。若需突破此限制，可在編譯時(shí)定義 _FILE_OFFSET_BITS=64 啟用大文件支持，使 off_t 拓展至 64 位。

四、取消大小檢查（無(wú)限制上傳）

將 client_max_body_size 設(shè)置為 0，可禁用對(duì)請(qǐng)求體大小的檢查，允許無(wú)限制上傳或 POST 請(qǐng)求：

server {
    listen 80;
    server_name unlimited.example.com;
    # 取消大小限制
    client_max_body_size 0;
    location / {
        proxy_pass http://backend;
    }
}

說(shuō)明：設(shè)置為 0 時(shí)，Nginx 不再在自身層面攔截任何大小的請(qǐng)求體。

五、實(shí)戰(zhàn)示例

按需放寬單接口限制

server {
    listen 80;
    server_name upload.example.com;
    # 默認(rèn)允許 10MiB
    client_max_body_size 10m;
    location /api/v1/upload {
        # 單接口放寬至 500MiB
        client_max_body_size 500m;
        proxy_pass http://backend_upload;
    }
}

開啟無(wú)限制上傳

server {
    listen 80;
    server_name files.example.com;
    # 完全取消 Nginx 層面的大小限制
    client_max_body_size 0;
    location /files {
        proxy_pass http://backend_files;
    }
}

六、配置驗(yàn)證

# 檢查配置語(yǔ)法
nginx -t
# 重載 Nginx（應(yīng)用新配置）
nginx -s reload

隨后可使用 curl 或前端上傳大文件，確認(rèn)是否仍出現(xiàn) 413 錯(cuò)誤，并查看 /var/log/nginx/error.log 以排查問(wèn)題。

七、小結(jié)

• 核心指令：client_max_body_size 決定 Nginx 層面的請(qǐng)求體大小上限。
• 默認(rèn)值：1 MiB（1m）。
• 最大上限：由 off_t 位寬決定，64 位環(huán)境支持至 2?³ − 1 字節(jié)，32 位環(huán)境（未啟用大文件支持）限約 2 GiB。
• 取消限制：設(shè)置為 0 即可禁用檢查，允許無(wú)限制上傳。

通過(guò)上述配置與示例，您可以靈活地調(diào)整或取消 Nginx 的上傳大小限制，滿足從小型表單到超大文件傳輸?shù)母鞣N業(yè)務(wù)需求。

到此這篇關(guān)于Nginx 文件上傳大小限制及 client_max_body_size最大值問(wèn)題記錄的文章就介紹到這了,更多相關(guān)nginx 文件上傳大小限制內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論