devopstom/docker-clamav

Docker ClamAV

用于启动ClamAV守护进程的Docker容器。

概述

本镜像提供了运行ClamAV防病毒软件守护进程的容器化解决方案，支持在Docker和Kubernetes环境中部署，可用于提供病毒扫描服务，具备灵活的配置选项和病毒库自动更新功能。

入门指南

以下说明涵盖如何在Docker和Kubernetes集群中启动容器。

前提条件

运行此容器需安装Docker：

• Windows
• OS X
• Linux

可选：

• Kubernetes集群（用于启用Kubernetes API发现其他节点）

使用方法

Docker运行示例

以下示例将启动单个ClamAV实例：

bash
docker run --name clamav -d -p 3310:3310 quay.io/ukhomeofficedigital/clamav:latest

Kubernetes使用

有关Kubernetes部署示例，请参见kubernetes examples。

环境变量

以下是可用的环境变量及其默认值。默认情况下，容器不依赖Kubernetes。

• CLAMD_SETTINGS_CSV="LogVerbose=yes,VirusEvent=/custom_alert.sh"
  用于自定义clamd配置，格式为CSV的键值对（Key=Value，不同于clamd.conf文件的Key Value格式）。
  参考clamd.conf了解更多设置，默认配置见./clamd.conf。
  常用设置示例：

  • VirusEvent=/path/to/alert_script.sh：挂载自定义告警脚本时，提供病毒检测告警功能
  • LogClean=yes：记录每次扫描操作

• FRESHCLAM_SETTINGS_CSV="LogVerbose=yes"
  用于自定义freshclam配置，格式同上。
  参考freshclam.conf了解更多设置，默认配置见./freshclam.conf。

• UPDATE=true（默认）：在后台启动freshclam守护进程，监控防病毒定义更新
  UPDATE=false：等待独立的sidecar容器完成首次更新后再启动服务

• UPDATE_ONLY=true：配置为sidecar容器，在前台运行更新进程
  UPDATE_ONLY=false（默认）：正常运行clamd和freshclam

端口

容器暴露以下端口：

• 3310：用于访问Clam AV API

贡献

欢迎提交拉取请求和问题。对于特别大的PR，建议先在issue中讨论。

请注意，本项目遵循Contributor Code of Conduct。参与本项目即表示同意遵守其条款。

版本控制

使用SemVer进行版本控制。可用版本见https://github.com/UKHomeOffice/docker-clamav/tags%E3%80%82

作者

• Lewis Marshall - 初始开发 - https://github.com/LewisMarshall

另见参与本项目的https://github.com/UKHomeOffice/docker-clamav/contributors%E3%80%82

许可证

本项目采用MIT许可证 - 详见LICENSE.md文件。

致谢

• [***]

待办事项

• 确保数据库访问不需要用户999权限（以便挂载卷）
• 解决启动时间过长问题（见上一点）
• 添加Travis测试