mkodockx/docker-clamav

docker-clamav

!ClamAV Logo

!ClamAV latest.stable

镜像概述和主要用途

Docker化的开源防病毒守护进程，主要用于：

• 与文件共享容器（如https://hub.docker.com/_/nextcloud/%EF%BC%89%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8
• 通过REST代理（如https://github.com/solita%E5%BC%80%E5%8F%91%E7%9A%84https://github.com/solita/clamav-rest%EF%BC%89%E4%BD%BF%E7%94%A8
• 通过TCP端口3310直接连接到clamav

该镜像构建时包含最新病毒数据库，运行时后台执行freshclam持续更新病毒签名数据库，clamd监听暴露的3310端口。

发布版本

最新版本可在官方https://hub.docker.com/r/mkodockx/docker-clamav registry获取，提供不同平台的版本。

使用方法和配置说明

容器以用户clamav运行，uid=101，gid=102。

支持的平台

Debian（默认，:latest, :buster-slim, :stretch-slim）

• buster-slim
• stretch-slim

bash
docker run -d -p 3310:3310 mkodockx/docker-clamav:buster-slim

Alpine（:alpine, :alpine-edge）

• alpine
• alpine-edge

bash
docker run -d -p 3310:3310 mkodockx/docker-clamav:alpine

推荐的链接使用方式

为避免将端口暴露给所有用户，推荐使用链接方式：

bash
docker run -d --name av mkodockx/docker-clamav(:alpine)
docker run -d --link av:av application-with-clamdscan-or-something

环境变量

代理配置

感谢@mchus提供的代理配置支持：

• HTTPProxyServer：设置代理服务器
• HTTPProxyPort：设置代理服务器端口

数据库镜像

可指定freshclam的特定镜像：

• DatabaseMirror：镜像Web服务器的主机名

自定义配置文件

可挂载自定义配置文件到容器：

• FRESHCLAM_CONF_FILE：自定义freshclam.conf文件路径，例如/mnt/freshclam.conf
• CLAMD_CONF_FILE：自定义clamd.conf文件路径，例如/mnt/clamd.conf

持久化

病毒更新定义存储在/var/lib/clamav。通过挂载该目录作为卷可实现持久化：

bash
docker run -d -p 3310:3310 -v ./clamav:/var/lib/clamav mkodockx/docker-clamav:latest

docker-compose配置

与Nextcloud配合的示例可参考https://github.com/mko-x/docker-clamav/blob/master/docker-compose.yml%E3%80%82%E4%BD%BF%E7%94%A8%E6%97%B6%E4%BB%8D%E9%9C%80%E5%9C%A8Nextcloud%E4%B8%AD%E9%85%8D%E7%BD%AE%22%E9%98%B2%E7%97%85%E6%AF%92%E6%96%87%E4%BB%B6%22%E5%BA%94%E7%94%A8%E3%80%82

教程参考：[***]

健康检查

镜像提供check.sh文件用于检查容器健康状态。需配置docker run或compose文件启用健康检查。启动周期应根据系统需求调整，网络连接慢、CPU和IO速度有限的环境可能需要更大的值。

示例

通过docker run：

bash
docker run --health-cmd=./check.sh \
            --health-start-period=120s \
            --health-interval=60s \
            --health-retries=3 \
            -p 3310:3310 mkodockx/docker-clamav:alpine

通过docker-compose：

yaml
services:
  clamav:
    healthcheck:
      test: ["CMD", "./check.sh"]
      interval: 60s
      retries: 3
      start_period: 120s

多架构支持

该镜像支持多种平台：

• x86
• amd64
• arm32v7
• arm64v8

已知分支

• https://github.com/kuanfandevops/docker-clamav 提供OpenShift支持