コンテンツにスキップ
macOS(Apple Silicon)にClamAVを入れて自分のホームをまるごとスキャンする

macOS(Apple Silicon)にClamAVを入れて自分のホームをまるごとスキャンする

2026年5月10日

ClamAVは商用AVと違って、自分のマシンで何が起きているかを可視化しやすいのが面白い。 Apple SiliconのMac(M1/M2/M3)で brew install からホームディレクトリのフルスキャン完了までを実機で走らせ、所要時間と途中で詰まった点を全部記録した。

検証環境は次のとおり。

項目値
OSmacOS 26.3.1 (Tahoe / Build 25D771280a)
CPUApple Silicon (arm64)
Homebrew/opt/homebrew (Apple Silicon配置)
ClamAV1.5.2 (bottle)
ホーム合計286 GB (うち Parallels 117 GB / Library 102 GB)

Intel Macの人はHomebrewのパスが /usr/local になるので、本記事中の /opt/homebrew/... を /usr/local/... に読み替えてください。

1. インストール(実測14秒)

brew install clamav

依存パッケージ込みでbottleがダウンロードされた。

==> Installing clamav dependency: libmagic
🍺  /opt/homebrew/Cellar/libmagic/5.47: 367 files, 13MB
==> Installing clamav dependency: yara
🍺  /opt/homebrew/Cellar/yara/4.5.5: 49 files, 2.4MB
==> Installing clamav
🍺  /opt/homebrew/Cellar/clamav/1.5.2: 181 files, 57.8MB

brew install clamav  8.52s user 4.40s system 90% cpu 14.227 total

合計73 MB。libmagic と yara が一緒に入るのはClamAVのシグネチャにYARAルールが使われるから。

brew info のCaveatsが大事で、設定ファイルは .sample 拡張子で置かれているだけだ。コピーして編集しないと freshclam も clamscan も動かない。

To finish installation & run clamav you will need to edit
the example conf files at /opt/homebrew/etc/clamav/

2. 設定ファイルを生成する(ハマりポイント)

freshclam.conf.sample をコピーするだけでは動かない。サンプルの8行目に Example という単語だけの行がある。これは「サンプルのままの設定ファイルは読み込まない」というセーフティ機構で、コメントアウトしないと freshclam がエラーを出す。

ついでに、デフォルトのDB / ログパスはLinux前提で /var/lib/clamav と /var/log/freshclam.log を指している。macOSではHomebrew配下に揃えたほうが整理できる。

# サンプルをコピー
cp /opt/homebrew/etc/clamav/freshclam.conf.sample \
   /opt/homebrew/etc/clamav/freshclam.conf

# Example 行をコメントアウト & パスを Homebrew 配下に
sed -i '' \
  -e 's/^Example$/#Example/' \
  -e 's|^#DatabaseDirectory /var/lib/clamav|DatabaseDirectory /opt/homebrew/var/lib/clamav|' \
  -e 's|^#UpdateLogFile /var/log/freshclam.log|UpdateLogFile /opt/homebrew/var/log/freshclam.log|' \
  -e 's|^#LogTime yes|LogTime yes|' \
  /opt/homebrew/etc/clamav/freshclam.conf

# 受け皿ディレクトリを作る (これを忘れると Permission denied)
mkdir -p /opt/homebrew/var/lib/clamav /opt/homebrew/var/log

diff で見るとサンプルからの変更はこれだけ。

< Example
> #Example
< #DatabaseDirectory /var/lib/clamav
> DatabaseDirectory /opt/homebrew/var/lib/clamav
< #UpdateLogFile /var/log/freshclam.log
> UpdateLogFile /opt/homebrew/var/log/freshclam.log
< #LogTime yes
> LogTime yes

3. freshclam で定義DBを取得する(実測10秒)

freshclam

出力(一部抜粋)。

ClamAV update process started at Sun May 10 22:05:34 2026
daily database available for download (remote version: 27996)
ERROR: NULL X509 store
ERROR: NULL X509 store
Testing database: '.../tmp.../daily.cvd' ...
Database test passed.
daily.cvd updated (version: 27996, sigs: 355446, f-level: 90, ...)
main database available for download (remote version: 63)
ERROR: NULL X509 store
ERROR: NULL X509 store
main.cvd updated (version: 63, sigs: 3287027, ...)
bytecode database available for download (remote version: 339)
ERROR: NULL X509 store
ERROR: NULL X509 store
bytecode.cvd updated (version: 339, sigs: 80, ...)

freshclam  4.58s user 0.95s system 52% cpu 10.504 total

ダウンロードしたDBは次のとおり。

ファイルサイズシグネチャ数
main.cvd85 MB3,287,027
daily.cvd22 MB355,446
bytecode.cvd275 KB80

合計で約107 MB、約364万シグネチャ。これに加えて、*.cvd.sign 署名ファイルが9 KBずつある。

ERROR: NULL X509 store の正体

ClamAV 1.5系からCVDにX.509証明書ベースの追加検証が入った。しかしmacOSビルド(Homebrew bottle)では証明書ストアの初期化に失敗し、このERRORが出る。これは既知の挙動だ。 直後に Database test passed. が出ており、DB自体のSHA / FP検証は通っているので、実際の問題はない(*.cvd の改ざんは別経路で検知される)。 ただし、ログに ERROR の文字列が並ぶので、CIなどで固定文字列をgrepしていると誤報になる。手動で見るぶんには気にしなくていいが、自動監視のフィルタではこのパターンを除外しておくと良い。

4. 動作確認にEICARテストファイルを置く

EICAR(European Institute for Computer Antivirus Research)のテスト文字列は、AVベンダ全社が「無害だが必ず検出する」と運用上で合意しているシグネチャだ。本物のマルウェアを使わずに動作確認できる。

mkdir -p ~/clamav-test
printf 'X5O!P%%@AP[4\\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*' \
  > ~/clamav-test/eicar.com

clamscan ~/clamav-test/eicar.com
/Users/user/clamav-test/eicar.com: Eicar-Test-Signature FOUND

----------- SCAN SUMMARY -----------
Known viruses: 3627854
Engine version: 1.5.2
Scanned files: 1
Infected files: 1
Data scanned: 68 B
Time: 7.760 sec (0 m 7 s)

68バイトのファイル1件で7.76秒かかった。この時間のほぼすべてが、エンジンの起動とDBのロードに使われている。 重いのはスキャン本体ではなく初期化なので、呼び出しを何度も直列に走らせる用途では、clamd(常駐デーモン)と clamdscan を組み合わせたほうが圧倒的に速い。今回は単発のフルスキャンが目的なので clamscan のままで進める。

5. ホームディレクトリのフルスキャン

du -sh ~ で見ると286 GBあり、問題はその内訳だった。

117G  /Users/user/Parallels       # 仮想マシンのディスクイメージ
102G  /Users/user/Library         # アプリ データ / キャッシュ / コンテナ
 13G  /Users/user/Documents
8.7G  /Users/user/.cache
 7G   /Users/user/go
6.7G  /Users/user/.ollama

そこで、ParallelsのVMディスク(117 GB)と Library/Caches・Library/Containers 系を除外することにした。理由は次の3つ。

  1. VMディスクは .hdd バンドル内部にゲストOSの全データが入っており、ClamAVはそこを再帰的に展開してスキャンしようとする。これは「自分のMacをスキャンしたい」というスコープから完全に外れる
  2. Library/Containers 配下はmacOSのSandbox/TCCの制御対象で、clamscan プロセスにフルディスクアクセス権限を付与していない限り、Permission denied の山になる。出力ノイズが膨大
  3. Library/Caches は内容が常に入れ替わる。スキャン中に消えるファイルが多く、Can't open file 警告が大量に出る

商用AV製品(Sophos, ESET等)はAppleのEndpoint Securityフレームワークで権限を持つのでContainerの中も読めるが、Homebrew版ClamAVは普通のユーザ権限で動く。tccutil で許可を渡すこともできるが、本記事では「素の状態」を優先した。

実行コマンド。

nohup clamscan -r -i \
  --max-filesize=100M \
  --max-scansize=400M \
  --exclude-dir='^/Users/user/Parallels' \
  --exclude-dir='^/Users/user/Library/Caches' \
  --exclude-dir='^/Users/user/Library/Containers' \
  --exclude-dir='^/Users/user/Library/Group Containers' \
  /Users/user > ~/clamav-test/logs/home-scan.log 2>&1 &

オプションの意味。

オプション意味
-r再帰的にディレクトリを下る
-i感染ファイルのみ表示(クリーンなファイルのログを抑制)
--max-filesize=100M100MBを超えるファイルはスキップ。VMディスクや動画など
--max-scansize=400M1ファイルから展開される総量がこれを超えたら打ち切る(圧縮爆弾対策)
--exclude-dir='^...'パス先頭一致で除外

実行中の様子。

PID 55770, 98% CPU (single-thread)
RSS 341 MB → 220 MB (DB ロード後はメモリ常駐)

ClamAVはシングルスレッドのスキャナだ。マルチコアの恩恵を得るには clamdscan で並列化するか、clamscan を複数同時起動して対象を分割するしかない。

スキャン結果: 74分でディスクフルになり停止

ここが今回いちばん書きたかったところで、スキャンは SCAN SUMMARY が出ないまま終わった。正確には、プロセスは終了しないまま、clamscan 自身がエラーを出し続けて先に進まなくなった。

ログ末尾はこんな感じ。

LibClamAV Error: cli_gentempfd_with_prefix: Can't create temporary file
  /var/folders/c2/.../T//clamav-46bbf1b1...tmp: No space left on device
LibClamAV Error: cli_gentempfd_with_prefix: Can't create temporary file
  /var/folders/c2/.../T//clamav-e26d2bb7...tmp: No space left on device
... (以下、`No space left on device` が延々と続く)
LibClamAV Warning: cli_unzip: failed to create temporary file ...

原因は、スキャン開始前のディスクの空きが3.2 GBしかなかったことだ。 ClamAVはアーカイブ(zip / xz / tar / Office文書 / .ipa / .apk / Mach-O Universal Binaryなど)を $TMPDIR 配下に展開してからスキャンする。286 GBのホームを走査すると、Goモジュールキャッシュ・npmキャッシュ・Xcodeの中間ビルド成果物・Dockerレイヤなど、無数の中規模アーカイブが次々に展開され、テンポラリにたまった分で空きを使い切った。

ClamAV本体のメモリ使用量は約200 MBで問題なかったが、$TMPDIR は大量に消費するので、Macでは特に注意が必要だ。回避策は次のいずれか。

  • clamscan --tempdir=/path/to/spacious/volume で別ボリュームを指定(外付けSSDなど)
  • --scan-archive=no でアーカイブ展開を一切やらない(速いが、暗号化・難読化済みアーカイブ内のマルウェアを見逃す)
  • --max-files=N --max-recursion=N で深さ制限
  • スキャン前に du -sh $TMPDIR を確認、最低でも20 GB以上の空きを確保

実際に検出された7件

74分の間に拾われたヒットはこの7件。

~/go/pkg/mod/cache/download/github.com/klauspost/compress/@v/v1.18.2.zip:
    Heuristics.Zip.OverlappingFiles FOUND
~/go/pkg/mod/cache/download/github.com/klauspost/compress/@v/v1.18.3.zip:
    Heuristics.Zip.OverlappingFiles FOUND
~/go/pkg/mod/github.com/klauspost/[email protected]/zip/testdata/FuzzReader-raw.zip:
    Heuristics.Zip.OverlappingFiles FOUND
~/go/pkg/mod/github.com/klauspost/[email protected]/zip/testdata/FuzzReader-raw.zip:
    Heuristics.Zip.OverlappingFiles FOUND
~/go/pkg/mod/cache/download/github.com/vulncheck-oss/go-exploit/@v/v1.51.0.zip:
    Txt.Backdoor.MetasploitPayload-9874938-0 FOUND
~/go/pkg/mod/github.com/vulncheck-oss/[email protected]/payload/bindshell/bindshell_test.go:
    Txt.Backdoor.MetasploitPayload-9874938-0 FOUND
~/clamav-test/eicar.com:
    Eicar-Test-Signature FOUND

カテゴリ別に意味を読むと次のようになる。

  1. Eicar-Test-Signature(1件): 自分で置いたテストファイル。期待どおりの検出
  2. Heuristics.Zip.OverlappingFiles(4件): klauspost/compress(Goのzip高速実装)のテストフィクスチャ。ヒューリスティックによる検出で、YARAや既知ハッシュに基づく検出ではない。「ZIPのローカルヘッダがオーバラップしている = ZIP仕様の隙を突いた構造」は、まさに klauspost/compress がフェイルセーフ実装でテストしたい対象そのもの。ファイルとしては完全に正当
  3. Txt.Backdoor.MetasploitPayload-9874938-0(2件): vulncheck-oss/go-exploit という正規の脆弱性検証ライブラリに含まれる、Metasploitペイロードのサンプル文字列を検出。シグネチャベースなので、これも当然のヒット

つまり、7件はすべて誤検出か、意図したヒットだった。逆に言えば、開発者のMacには「シグネチャに引っかかるが正当な研究用・テスト用のデータ」が普通に入っている。自動隔離(--move, --remove)は絶対に避けたほうがいい。手動で1件ずつパスを見て判断する運用が現実的だ。

途中で出たエラー / ワーニングの内訳

スキャンは完走しなかったが、ログ全537行の内訳は次のとおり。

件数パターン意味
430index_local_file_headers_within_boundsZIPとして認識した小さなファイルの形式が不正。Goモジュールキャッシュの *.ziphash などの小さなファイルが、疑似的にZIPのマジックを持っているのが原因
77cli_unzip: failed to create temporary fileテンポラリファイルの作成失敗(上記のディスクフルが原因)
16cli_gentempfd_with_prefix: ... No space left on device同上(より低レイヤの直接的なエラー)
4cli_scanxz: premature end of compressed stream途中で切れたxzアーカイブ。スナップショット途中のキャッシュファイルなどで発生しやすい
1cli_writen書き込み失敗(これもディスク起因)

index_local_file_headers_within_bounds の430件はディスクとは関係ない純粋な誤検知ログで、GoやNodeのエコシステムを使うMacなら必ず出る。ClamAVのErrorには無視してよいものが含まれる、という事実をまず受け入れる必要がある。

結局スキャンの「結果」はどうなのか

SCAN SUMMARY ブロックは出ていないので、通常の意味でのスキャン完了ではない。ただし、途中までの記録は次のとおり。

  • 開始: 2026-05-10 22:10:32
  • 異常終了: 2026-05-10 23:24:53 (ログ最終更新)
  • 経過: 74分21秒
  • 検出(FOUND): 7件。すべて誤検出か意図したヒット
  • ピークCPU: 99%(シングルスレッド)
  • ピークRSS: 約340 MB → 後半は120 MB前後で安定
  • ホーム実スキャン量: 286 GBのうち、Parallelsと Library/{Caches,Containers,Group Containers} を除いた約67 GBを7割程度処理した時点で停止(推定)

6. 詰まりどころ早見表

症状原因対処
freshclam: ERROR: Please edit the example config file before running freshclam!サンプルそのままの Example 行が残っている8行目をコメントアウト
freshclam: Can't create new file ...: Permission deniedDBディレクトリが存在しないか、書き込み権限がないmkdir -p してオーナーを自分にする
ERROR: NULL X509 store(連発)macOS bottleの証明書ストア初期化失敗(CVD検証は別経路で通る)無視してよい。CIのフィルタからは除外
clamscan: ... Permission deniedmacOSのTCC / Sandboxや Library/Containers の権限--exclude-dir で除外。深く読みたい場合は tccutil でフルディスクアクセスを付与
スキャンが終わらないVMディスクや巨大ファイルを再帰的に展開している--max-filesize / --max-scansize / --exclude-dir
cli_gentempfd_with_prefix: No space left on deviceアーカイブの展開で $TMPDIR の空きを使い切った--tempdir= で大きいボリュームを指定。最低20 GBは確保
index_local_file_headers_within_bounds: Invalid offset arguments が大量に出るZIPではない小さなファイルをZIPと誤認している無視してよい。Go / npmのキャッシュがあると数百件出る
cli_scanxz: premature end of compressed stream途中で切れたxz無視してよい
1ファイルのスキャンに7秒かかるDBのロードに時間がかかっているclamd + clamdscan で常駐させる

7. 常用するなら clamd 化を検討

clamscan は毎回約7秒のロードが入るので、単発の用途に向く。常用したいなら、clamd をデーモンとして動かし、clamdscan から呼び出すのが一般的なやり方だ。Homebrewなら次のコマンドで起動できる。

sudo brew services start clamav

これで clamd がUNIX socketで待ち受けるので、clamdscan <path> を1回実行するだけで、1秒以内に結果が返る。 ただし、clamd.conf でも同様に、Example 行のコメントアウトとTCPSocket / LocalSocketの設定が必要になる。

まとめ

  • インストールは14秒、DB取得は10秒で、どちらも早い
  • 本当の難所は、freshclam.conf の Example 行と、DB / ログパスのデフォルト値。Linux前提なので、macOSでは必ず置換する
  • ERROR: NULL X509 store は無視してよい既知の挙動(ClamAV 1.5系 / Homebrew bottle)
  • 「ホームのフルスキャン」は ~/ の全部をスキャンすることではない。Macでは Library/Containers・Library/Caches・Parallels を除外しないと、ノイズで本当に怪しいヒットが埋もれる
  • $TMPDIR の空き容量が命取りになる。今回は3.2 GBで始めて、74分でENOSPCにより止まった。アーカイブ展開分を含めて20 GB以上の空きを確保し、--tempdir を指定するのが現実的
  • 検出ヒットには正当なデータが混ざる。開発者のMacでは、Go / Node / セキュリティ研究系のテストデータがシグネチャに引っかかる。--remove / --move による自動隔離は危険
  • シングルスレッドで重い。常用するなら clamd 化する

参考