macOS(Apple Silicon)にClamAVを入れて自分のホームをまるごとスキャンする
ClamAVは商用AVと違って、自分のマシンで何が起きているかを可視化しやすいのが面白い。
Apple SiliconのMac(M1/M2/M3)で brew install からホームディレクトリのフルスキャン完了までを実機で走らせ、所要時間と途中で詰まった点を全部記録した。
検証環境は次のとおり。
| 項目 | 値 |
|---|---|
| OS | macOS 26.3.1 (Tahoe / Build 25D771280a) |
| CPU | Apple Silicon (arm64) |
| Homebrew | /opt/homebrew (Apple Silicon配置) |
| ClamAV | 1.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/logdiff で見るとサンプルからの変更はこれだけ。
< 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.cvd | 85 MB | 3,287,027 |
daily.cvd | 22 MB | 355,446 |
bytecode.cvd | 275 KB | 80 |
合計で約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つ。
- VMディスクは
.hddバンドル内部にゲストOSの全データが入っており、ClamAVはそこを再帰的に展開してスキャンしようとする。これは「自分のMacをスキャンしたい」というスコープから完全に外れる Library/Containers配下はmacOSのSandbox/TCCの制御対象で、clamscanプロセスにフルディスクアクセス権限を付与していない限り、Permission deniedの山になる。出力ノイズが膨大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=100M | 100MBを超えるファイルはスキップ。VMディスクや動画など |
--max-scansize=400M | 1ファイルから展開される総量がこれを超えたら打ち切る(圧縮爆弾対策) |
--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カテゴリ別に意味を読むと次のようになる。
Eicar-Test-Signature(1件): 自分で置いたテストファイル。期待どおりの検出Heuristics.Zip.OverlappingFiles(4件):klauspost/compress(Goのzip高速実装)のテストフィクスチャ。ヒューリスティックによる検出で、YARAや既知ハッシュに基づく検出ではない。「ZIPのローカルヘッダがオーバラップしている = ZIP仕様の隙を突いた構造」は、まさにklauspost/compressがフェイルセーフ実装でテストしたい対象そのもの。ファイルとしては完全に正当Txt.Backdoor.MetasploitPayload-9874938-0(2件):vulncheck-oss/go-exploitという正規の脆弱性検証ライブラリに含まれる、Metasploitペイロードのサンプル文字列を検出。シグネチャベースなので、これも当然のヒット
つまり、7件はすべて誤検出か、意図したヒットだった。逆に言えば、開発者のMacには「シグネチャに引っかかるが正当な研究用・テスト用のデータ」が普通に入っている。自動隔離(--move, --remove)は絶対に避けたほうがいい。手動で1件ずつパスを見て判断する運用が現実的だ。
途中で出たエラー / ワーニングの内訳
スキャンは完走しなかったが、ログ全537行の内訳は次のとおり。
| 件数 | パターン | 意味 |
|---|---|---|
| 430 | index_local_file_headers_within_bounds | ZIPとして認識した小さなファイルの形式が不正。Goモジュールキャッシュの *.ziphash などの小さなファイルが、疑似的にZIPのマジックを持っているのが原因 |
| 77 | cli_unzip: failed to create temporary file | テンポラリファイルの作成失敗(上記のディスクフルが原因) |
| 16 | cli_gentempfd_with_prefix: ... No space left on device | 同上(より低レイヤの直接的なエラー) |
| 4 | cli_scanxz: premature end of compressed stream | 途中で切れたxzアーカイブ。スナップショット途中のキャッシュファイルなどで発生しやすい |
| 1 | cli_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 denied | DBディレクトリが存在しないか、書き込み権限がない | mkdir -p してオーナーを自分にする |
ERROR: NULL X509 store(連発) | macOS bottleの証明書ストア初期化失敗(CVD検証は別経路で通る) | 無視してよい。CIのフィルタからは除外 |
clamscan: ... Permission denied | macOSの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化する