在Node.js文件上传中集成ClamAV扫描的详细步骤

 更新时间:2026年04月27日 08:24:02   作者:SonoTommy  
本文介绍了在Node.js文件上传中集成ClamAV扫描的具体步骤,包括安装、使用、Express集成和远程扫描等,该库在文件落盘前完成扫描,返回类型化的verdictsymbol,不依赖第三方运行时,需要的朋友可以参考下

文件上传是常见的攻击面。用户上传的文件可能包含恶意软件、ZIP 炸弹或 伪造的 MIME 类型。大多数 Node.js 项目只做扩展名检查,这远远不够。

pompelmi 是一个 Node.js 库,在文件落盘之前完成扫描,返回类型化的 verdict symbol,不依赖任何第三方运行时。

工作原理

  1. 验证参数是否为字符串,文件是否存在
  2. 通过 child_process 调用 clamscan,读取退出码
  3. 将退出码映射为 Symbol

没有 stdout 解析,没有正则,没有隐式状态。

安装

需要 Node.js 和 ClamAV。

npm install pompelmi

安装 ClamAV:

# macOS
brew install clamav && freshclam
# Debian / Ubuntu
sudo apt-get install -y clamav clamav-daemon && sudo freshclam
# Windows
choco install clamav -y

基本用法

const { scan, Verdict } = require('pompelmi');

const result = await scan('/path/to/file.zip');

switch (result) {
  case Verdict.Clean:
    // 文件安全,继续处理
    break;
  case Verdict.Malicious:
    throw new Error('检测到恶意软件,文件已拒绝');
  case Verdict.ScanError:
    // 扫描未完成,按不可信文件处理
    console.warn('扫描失败,拒绝文件');
    break;
}

返回值:

结果ClamAV 退出码含义
Verdict.Clean0未发现威胁
Verdict.Malicious1匹配到已知病毒签名
Verdict.ScanError2扫描本身失败,文件状态未知

在 Express 中集成

const express = require('express');
const multer  = require('multer');
const { scan, Verdict } = require('pompelmi');
const path = require('path');
const fs   = require('fs');

const app    = express();
const upload = multer({ dest: 'tmp/' });

app.post('/upload', upload.single('file'), async (req, res) => {
  const filePath = path.resolve(req.file.path);

  try {
    const result = await scan(filePath);

    if (result === Verdict.Malicious) {
      fs.unlinkSync(filePath);
      return res.status(422).json({ error: '文件包含恶意软件' });
    }

    if (result === Verdict.ScanError) {
      fs.unlinkSync(filePath);
      return res.status(422).json({ error: '扫描失败,文件已拒绝' });
    }

    // Verdict.Clean — 继续保存文件
    return res.status(200).json({ verdict: 'clean' });

  } catch (err) {
    fs.unlinkSync(filePath);
    return res.status(500).json({ error: err.message });
  }
});

远程扫描(Docker)

如果 ClamAV 运行在容器中,通过 TCP socket 连接:

const result = await scan('/path/to/file.zip', {
  host: '127.0.0.1',
  port: 3310,
});

API 保持不变,verdict 类型不变。

错误处理

try {
  const result = await scan(path.resolve(filePath));
  return result;
} catch (err) {
  // filePath 不是字符串      → 'filePath must be a string'
  // 文件不存在               → 'File not found: <path>'
  // clamscan 不在 PATH 中    → ENOENT
  // 未知退出码               → 'Unexpected exit code: N'
  console.error('扫描异常:', err.message);
  return null;
}

特性

  • 零运行时依赖,仅使用 Node.js 内置 child_process
  • 不解析 stdout,直接读取退出码
  • 支持 TypeScript,verdict 为 Symbol 类型,防止拼写错误
  • 支持本地 clamscan 和远程 clamd TCP socket
  • 跨平台:macOS、Linux、Windows

以上就是在Node.js文件上传中集成ClamAV扫描的详细步骤的详细内容,更多关于Node.js文件上传中集成ClamAV扫描的资料请关注脚本之家其它相关文章!

相关文章

  • node.js学习之base64编码解码

    node.js学习之base64编码解码

    开发者对Base64编码肯定很熟悉,是否对它有很清晰的认识就不一定了。实际上Base64已经简单到不能再简单了,这篇文章给大家通过示例代码介绍了node.js对字符串和图片base64编码解码的方法,有需要的朋友们可以通过本文来进行学习,下面来一起看看吧。
    2016-10-10
  • node实现shell命令管理工具及commander.js学习

    node实现shell命令管理工具及commander.js学习

    这篇文章主要为大家介绍了node实现shell命令管理工具及commander.js学习,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-09-09
  • 如何使用axios库在Node.js中进行代理请求(实践案例)

    如何使用axios库在Node.js中进行代理请求(实践案例)

    axios是一个强大的基于Promise的HTTP客户端,它在浏览器和Node.js环境中均可使用,本文将介绍如何充分利用axios库,在Node.js中进行代理请求的最佳实践,并通过一个实际案例来展示其应用,感兴趣的朋友一起看看吧
    2024-03-03
  • 基于Koa2写个脚手架模拟接口服务的方法

    基于Koa2写个脚手架模拟接口服务的方法

    这篇文章主要介绍了基于Koa2写个脚手架模拟接口服务的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-11-11
  • 安装node-sass的方法步骤

    安装node-sass的方法步骤

    本文主要介绍了安装node-sass的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-05-05
  • nodejs连接mysql数据库及基本知识点详解

    nodejs连接mysql数据库及基本知识点详解

    这篇文章主要介绍了nodejs连接mysql数据库,结合实例形式总结分析了nodejs连接与操作mysql数据库的相关模板、配置及mysql数据库查询、添加数据等操作技巧,需要的朋友可以参考下
    2018-03-03
  • 详解nodejs 文本操作模块-fs模块(二)

    详解nodejs 文本操作模块-fs模块(二)

    这篇文章主要介绍了详解nodejs 文本操作模块-fs模块(二),主要包括文件的读写操作,有兴趣的可以了解一下。
    2016-12-12
  • Node.js脚本提取OPML文件信息实现示例详解

    Node.js脚本提取OPML文件信息实现示例详解

    这篇文章主要为大家介绍了Node.js脚本提取OPML文件信息,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-09-09
  • nw.js实现类似微信的聊天软件

    nw.js实现类似微信的聊天软件

    本文给大家介绍的是使用nw.js实现类似微信的聊天软件,还处于测试阶段,功能非常少,大家一起来添砖加瓦吧。
    2015-03-03
  • nodejs版本管理工具nvm的安装与使用小结

    nodejs版本管理工具nvm的安装与使用小结

    在项目开发过程中,使用到vue框架技术,需要安装node下载项目依赖,本文主要介绍了nodejs版本管理工具nvm的安装与使用小结,具有一定的参考价值,感兴趣的可以了解一下
    2024-01-01

最新评论