如何在Ubuntu中用Node.js处理文件上传

下面，咱们就一步步来搭建这个文件上传服务。整个过程逻辑清晰，跟着做就行。

1. 环境准备与项目初始化

首先，你得确保系统里已经装好了Node.js和npm。如果还没装，直接去Node.js官网下载对应Ubuntu的版本安装就行，这是基础。

接下来，创建一个专门的项目文件夹，并在终端里进入这个目录。然后，用一个简单的命令初始化项目，生成package.json文件：

npm init -y

有了项目骨架，就该安装核心依赖了。这里我们需要两个包：创建Web服务的express，和处理文件上传的multer。

npm install express multer

2. 构建核心应用逻辑

依赖装好后，在项目文件夹里创建一个app.js文件，这就是我们服务的主文件。把下面的代码放进去，每一部分都有其关键作用：

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

// 设置存储引擎
const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, 'uploads/');
  },
  filename: function (req, file, cb) {
    cb(null, file.fieldname + '-' + Date.now() + '-' + file.originalname);
  }
});

// 初始化上传
const upload = multer({
  storage: storage,
  limits: { fileSize: 10 * 1024 * 1024 }, // 限制文件大小为10MB
  fileFilter: function (req, file, cb) {
    checkFileType(file, cb);
  }
}).single('file'); // ‘file’是表单中的文件字段名称

// 检查文件类型
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', (req, res) => {
  upload(req, res, (err) => {
    if (err) {
      res.status(400).send({ message: err });
    } else {
      if (req.file == undefined) {
        res.status(400).send({ message: 'No File Selected!' });
      } else {
        res.send({
          message: 'File Uploaded!',
          file: `uploads/${req.file.filename}`
        });
      }
    }
  });
});

// 启动服务器
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => console.log(`Server started on port ${PORT}`));

这段代码干了这么几件关键事：定义了文件存到哪、怎么命名；限制了只能上传10MB以内的图片；并设置了一个/upload接口来接收文件。

3. 创建存储目录并启动服务

代码里指定了文件要存到uploads文件夹，所以你得在项目根目录下手动创建这个文件夹，不然程序会报错找不到路径。

最后，在终端里运行下面这条命令，你的文件上传服务就正式启动了：

node app.js

4. 测试上传功能

服务跑起来之后，怎么验证它好不好使呢？很简单，拿Postman或者任何你顺手的API测试工具，向http://localhost:3000/upload发送一个POST请求。

这里有个细节必须注意：请求的Content-Type需要设置为multipart/form-data，并且表单里文件字段的名称必须和我们代码中定义的一致，也就是file。设置对了，你就能收到“File Uploaded!”的成功响应，并且文件已经乖乖躺在uploads文件夹里了。

至此，一个具备基本文件类型检查、大小限制和自定义存储功能的Node.js上传服务，就已经在Ubuntu上搭建完成了。你可以在此基础上，继续扩展错误处理、文件预览等更多高级功能。