在Node.js文件上傳中集成ClamAV掃描的詳細步驟

更新時間：2026年04月27日 08:24:02 作者：SonoTommy

本文介紹了在Node.js文件上傳中集成ClamAV掃描的具體步驟,包括安裝、使用、Express集成和遠程掃描等,該庫在文件落盤前完成掃描,返回類型化的verdictsymbol,不依賴第三方運行時,需要的朋友可以參考下

工作原理

驗證參數(shù)是否為字符串，文件是否存在
通過 child_process 調用 clamscan，讀取退出碼
將退出碼映射為 Symbol

沒有 stdout 解析，沒有正則，沒有隱式狀態(tài)。

安裝

需要 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:
    // 文件安全，繼續(xù)處理
    break;
  case Verdict.Malicious:
    throw new Error('檢測到惡意軟件，文件已拒絕');
  case Verdict.ScanError:
    // 掃描未完成，按不可信文件處理
    console.warn('掃描失敗，拒絕文件');
    break;
}

返回值：

結果	ClamAV 退出碼	含義
`Verdict.Clean`	0	未發(fā)現(xiàn)威脅
`Verdict.Malicious`	1	匹配到已知病毒簽名
`Verdict.ScanError`	2	掃描本身失敗，文件狀態(tài)未知

在 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 — 繼續(xù)保存文件
    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;
}