filefrog/clamav

filefrog/clamav镜像说明

镜像概述

本镜像封装了ClamAV的全套工具（不含clamscan），旨在提供轻量、易部署的病毒扫描解决方案，支持Docker本地运行和Kubernetes集群部署，可用于检测文件系统中的***内容。

核心功能

1. 包含clamd（病毒扫描守护进程）和freshclam（病毒数据库更新工具）
2. 支持通过卷挂载共享病毒数据库，实现数据库持久化与更新
3. 内置EICAR测试文件，可验证扫描功能有效性
4. 提供TCP/3310端口的CLAM协议接口，支持远程扫描请求

使用场景

1. Docker本地环境：扫描本地文件或挂载的主机目录
2. Kubernetes集群：作为集群附加组件，扫描节点或应用数据
3. 一次性扫描：针对特定文件/目录执行临时病毒检测

配置说明与部署示例

Docker部署

基础运行（内置数据库）

bash
docker run --rm -it filefrog/clamav

持久化数据库并启动更新服务

bash
# 启动clamd守护进程（共享数据库卷）
docker run --rm -d -v /srv/clamav:/var/lib/clamav \
           --name clamd \
           filefrog/clamav clamd

# 启动freshclam更新数据库
docker run --rm -d -v /srv/clamav:/var/lib/clamav \
           --name freshclam \
           filefrog/clamav freshclam

# 转发端口以支持远程访问
docker run --rm -d -v /srv/clamav:/var/lib/clamav -p 3310:3310 \
           --name clamd \
           filefrog/clamav clamd

执行扫描命令

bash
# 进入容器扫描指定路径
docker exec -it clamd clamdscan /usr

Kubernetes部署

使用提供的YAML文件部署到集群：

bash
kubectl apply -n your-namespace -f https://github.com/filefrog/clamav/blob/master/deploy/k8s.yml

扫描功能测试

通过EICAR文件验证扫描效果：

bash
# Docker容器内测试
docker exec -it clamd clamdscan /var/lib/eicar/eicar.com

# 远程TCP接口测试
telnet 127.0.0.1 3310
> SCAN /var/lib/eicar/eicar.com

镜像构建与发布

使用Makefile构建或推送镜像：

bash
# 本地构建
make build

# 推送到Docker Hub（替换为自己的镜像名）
IMAGE=your-username/clamav make build push

# 指定版本标签
IMAGE=your-username/clamav TAG=20240501 make build push