Linux中Node.js如何配置文件上传限制

时间：2026-04-26 11:33

在Linux系统中，Node js配置文件上传限制的实战指南在Linux环境下部署Node js应用时，配置文件上传限制是保障服务稳定与安全的关键一步。这事儿主要围绕三个核心点展开：限制单个文件的大小限制整个请求体的大小限制并发上传的文件数量实现这些限制，通常需要借助中间件来完成。下面，我

在Linux系统中，Node.js配置文件上传限制的实战指南

在Linux环境下部署Node.js应用时，配置文件上传限制是保障服务稳定与安全的关键一步。这事儿主要围绕三个核心点展开：

限制单个文件的大小
限制整个请求体的大小
限制并发上传的文件数量

实现这些限制，通常需要借助中间件来完成。下面，我们就以最常用的Express框架配合multer库为例，手把手演示一个完整的配置方案。

环境准备与代码实现

首先，确保你的项目已经安装了必要的依赖。如果还没装，打开终端，执行下面这行命令：

npm install express multer

依赖搞定后，创建一个名为app.js的文件，把下面的代码贴进去。这段代码几乎涵盖了所有常见的上传限制配置：

const express = require('express');
const multer = require('multer');
const app = express();

// 配置multer
const storage = multer.diskStorage({
destination: (req, file, cb) => {
cb(null, 'uploads/');
},
filename: (req, file, cb) => {
cb(null, file.fieldname + '-' + Date.now() + '-' + file.originalname);
}
});

const upload = multer({
storage: storage,
limits: {
fileSize: 10 * 1024 * 1024, // 限制单个文件大小为10MB
files: 5, // 限制并发上传的文件数量为5
parts: 5 // 限制整个请求体的大小为5个部分（即5个文件）
},
fileFilter: (req, file, cb) => {
checkFileType(file, cb);
}
});

// 检查文件类型
function checkFileType(file, cb) {
// 允许的文件扩展名
const filetypes = /jpeg|jpg|png|gif/;
// 检查文件扩展名
const extname = filetypes.test(path.extname(file.originalname).toLowerCase());
// 检查MIME类型
const mimetype = filetypes.test(file.mimetype);

if (mimetype && extname) {
return cb(null, true);
} else {
cb('Error: Images Only!');
}
}

// 上传路由
app.post('/upload', upload.array('myFiles'), (req, res) => {
if (req.files == undefined) {
return res.status(400).send('No files were uploaded.');
}
res.send(req.files);
});

// 启动服务器
app.listen(3000, () => {
console.log('Server started on port 3000');
});

看明白了吗？关键在于multer初始化时的limits对象。这里我们清晰地定义了三个维度的限制：fileSize管住单个文件的体积，files控制一次能传几个文件，而parts则限制了整个请求体的规模。旁边的fileFilter函数也没闲着，它像一道安检门，只放行图片类型的文件。