rafttech/clamav-rest

目录

• 简介
• 先决条件
• 安装
• 快速开始
  • 状态码
• 配置
  • 环境变量
  • 网络
• 维护/监控
  • Shell访问
  • Prometheus指标
• 开发
• 参考资料

简介

这是一个二合一Docker镜像，运行开源病毒扫描器ClamAV（[***] API接口与ClamAV进程交互。

先决条件

该容器本身功能有限，需配合额外服务或通信工具与其交互才能发挥作用。

安装

镜像的自动构建版本可在Docker Hub获取（https://hub.docker.com/r/ajilaag/clamav-rest%EF%BC%89%EF%BC%8C%E8%BF%99%E6%98%AF%E6%8E%A8%E8%8D%90%E7%9A%84%E5%AE%89%E8%A3%85%E6%96%B9%E5%BC%8F%E3%80%82

bash
docker pull hub.docker.com/ajilaag/clamav-rest:(镜像标签)

可用镜像标签：

• latest - ClamAV与REST API的最新版本

快速开始

运行clamav-rest镜像：

bash
docker run -p 9000:9000 -p 9443:9443 -itd --name clamav-rest ajilaag/clamav-rest

测试服务是否能检测常见测试病毒签名：

HTTP

bash
$ curl -i -F "file=@eicar.com.txt" http://localhost:9000/scan
HTTP/1.1 100 Continue

HTTP/1.1 406 Not Acceptable
Content-Type: application/json; charset=utf-8
Date: Mon, 28 Aug 2017 20:22:34 GMT
Content-Length: 56

{ Status: "FOUND", Description: "Eicar-Test-Signature" }

HTTPS

bash
$ curl -i -k -F "file=@eicar.com.txt" https://localhost:9443/scan
HTTP/1.1 100 Continue

HTTP/1.1 406 Not Acceptable
Content-Type: application/json; charset=utf-8
Date: Mon, 28 Aug 2017 20:22:34 GMT
Content-Length: 56

{ Status: "FOUND", Description: "Eicar-Test-Signature" }

测试服务对干净文件返回200状态：

HTTP

bash
$ curl -i -F "file=@clamrest.go" http://localhost:9000/scan

HTTP/1.1 100 Continue

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Mon, 28 Aug 2017 20:23:16 GMT
Content-Length: 33

{ Status: "OK", Description: "" }

HTTPS

bash
$ curl -i -k -F "file=@clamrest.go" https://localhost:9443/scan

HTTP/1.1 100 Continue

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Mon, 28 Aug 2017 20:23:16 GMT
Content-Length: 33

{ Status: "OK", Description: "" }

状态码

• 200 - 干净文件（无已知感染）
• 400 - ClamAV对文件返回通用错误
• 406 - 检测到感染
• 412 - 无法解析文件
• 501 - 未知请求

配置

环境变量

以下是可用于自定义安装的所有选项：

网络

维护/监控

Shell访问

为了调试和维护，您可能需要访问容器的shell：

bash
docker exec -it (容器名称，例如 clamav-rest) /bin/sh

Prometheus指标

已实现Prometheus指标（[***]

HTTP: curl http://localhost:9000/metrics

HTTPS: curl https://localhost:9443/metrics

开发

构建Golang（Linux）二进制文件和Docker镜像：

bash
# env GOOS=linux GOARCH=amd64 go build
docker build . -t clamav-go-rest
docker run -p 9000:9000 -p 9443:9443 -itd --name clamav-rest clamav-go-rest

参考资料

• [***]