小皮面板修改Nginx站点client_max_body_size,须在对应站点vhosts配置文件的server块内添加client_max_body_size 200m;(单位小写m),并同步调整client_body_buffer_size、client_body_temp_path及PHP的post_max_size和upload_max_filesize,最后重启Nginx生效。

小皮面板(phpStudy Pro)里修改 Nginx 站点的 client_max_body_size,关键在于找到对应站点的独立配置文件,而不是直接改主 nginx.conf。因为小皮为每个站点生成了单独的虚拟主机配置,改这里才真正生效。
定位站点配置文件
小皮面板的站点配置默认存放在:
-
Windows:
小皮安装目录\Extensions\Nginx{版本号}\conf\vhosts\{站点名}_{端口}.conf - 常见路径示例:
C:\phpstudy_pro\Extensions\Nginx1.22\conf\vhosts\0localhost_80.conf或myproject_8080.conf - 该文件由小皮自动生成,每次在面板中“添加网站”或“编辑网站”时都会更新
在 server 块中添加配置
打开对应站点的 .conf 文件,在 server { ... } 大括号内(通常放在 server_name 下方、location / 上方)插入一行:
client_max_body_size 200m;
- 单位必须用小写 m(如
200m),写成200M或200MB会导致 Nginx 启动失败 - 若需上传超大文件(如视频),可设为
2g;调试环境且绝对可信,可设为0(不限制) - 不建议只在
http块全局设置——它对所有站点生效,缺乏灵活性
同步检查配套参数(重要)
单设 client_max_body_size 不够,还需确认以下三项是否合理,否则仍可能报 413 或上传中断:
-
client_body_buffer_size:建议设为
512k(避免小文件频繁落盘) -
client_body_temp_path:确保路径存在、磁盘空间充足、Nginx 运行用户(如
SYSTEM或www)有读写权限 -
后端限制匹配:比如 PHP 项目,还要同步调大
php.ini中的post_max_size和upload_max_filesize,且它们应略小于 Nginx 的值(例如 Nginx 设200m,PHP 可设190M)
保存并重载生效
改完保存文件,回到小皮面板:
- 点击右上角「软件管理」→ 找到 Nginx → 点击「重启」
- 或在命令行执行:
nginx -t测试语法,再nginx -s reload(小皮默认支持该命令) - 重启后即可测试上传,验证是否生效


















