vuls/goval-dictionary

goval-dictionary Docker镜像文档

镜像概述

goval-dictionary Docker镜像是用于构建本地OVAL（Open Vulnerability and Assessment Language）漏洞数据库的工具容器化版本。该工具可从多个Linux发行版官方源获取漏洞数据，存储为sqlite、MySQL等格式的本地数据库，并提供命令行查询和HTTP服务器功能，便于漏洞信息的快速检索与集成。

核心功能与特性

• 多发行版支持：获取RedHat、Debian、Ubuntu、SUSE、Oracle Linux、Alpine等主流Linux发行版的OVAL漏洞数据
• 多数据库兼容：支持sqlite3（默认）、MySQL、PostgreSQL、Redis等数据库存储
• 灵活查询方式：提供命令行查询（按包名、CVE-ID）和HTTP服务器模式
• 代理支持：可通过HTTP代理获取数据，适应受限网络环境
• 数据持久化：支持外部挂载数据卷，确保数据库文件持久化存储

使用场景

• 作为漏洞扫描工具（如Vuls）的本地漏洞数据源，提升扫描效率
• 安全审计与合规检查，快速查询特定系统或组件的漏洞信息
• 企业内部漏洞情报平台搭建，整合多发行版漏洞数据

使用方法

镜像拉取

bash
docker pull kotakanbe/goval-dictionary:latest

基础命令格式

bash
docker run -v /path/to/local/data:/data \
  kotakanbe/goval-dictionary \
  [command] [flags]

说明：/path/to/local/data为本地目录，用于持久化数据库文件和日志，容器内对应路径为/data

主要命令示例

1. 获取漏洞数据（fetch）

获取RedHat漏洞数据（版本5/6/7/8）

bash
docker run -v $(pwd)/data:/data \
  kotakanbe/goval-dictionary \
  fetch redhat 5 6 7 8 \
  --dbpath /data/oval.sqlite3 \
  --log-dir /data/log

获取Debian漏洞数据（版本7/8/9/10）

bash
docker run -v $(pwd)/data:/data \
  kotakanbe/goval-dictionary \
  fetch debian 7 8 9 10 \
  --dbpath /data/oval.sqlite3

获取Ubuntu漏洞数据（版本14/16/18/20）

bash
docker run -v $(pwd)/data:/data \
  kotakanbe/goval-dictionary \
  fetch ubuntu 14 16 18 20 \
  --dbpath /data/oval.sqlite3

获取Alpine漏洞数据（版本3.10/3.11/3.12）

bash
docker run -v $(pwd)/data:/data \
  kotakanbe/goval-dictionary \
  fetch alpine 3.10 3.11 3.12 \
  --dbpath /data/oval.sqlite3

2. 启动HTTP服务器（server）

bash
docker run -d -p 1324:1324 \
  -v $(pwd)/data:/data \
  --name goval-server \
  kotakanbe/goval-dictionary \
  server \
  --bind 0.0.0.0 \
  --port 1324 \
  --dbpath /data/oval.sqlite3

访问示例：查询Ubuntu 16.04的CVE-2017-***漏洞
curl http://localhost:1324/cves/ubuntu/16/CVE-2017-15400 | jq

3. 命令行查询（select）

按包名查询（如RedHat 7的golang包）

bash
docker run -v $(pwd)/data:/data \
  kotakanbe/goval-dictionary \
  select --by-package redhat 7 golang x86_64 \
  --dbpath /data/oval.sqlite3

按CVE-ID查询（如CVE-2017-6009）

bash
docker run -v $(pwd)/data:/data \
  kotakanbe/goval-dictionary \
  select --by-cveid redhat 7 CVE-2017-6009 \
  --dbpath /data/oval.sqlite3

配置参数说明

全局参数

服务器模式参数（server命令）

Docker Compose配置示例

yaml
version: '3'
services:
  goval-dictionary:
    image: kotakanbe/goval-dictionary:latest
    volumes:
      - ./data:/data
    ports:
      - "1324:1324"
    command: server --bind 0.0.0.0 --dbpath /data/oval.sqlite3
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

数据持久化

为确保数据库和日志数据不丢失，需将容器内/data目录挂载到本地目录：

bash
mkdir -p ./data/{db,log}
docker run -v $(pwd)/data/db:/data \
  -v $(pwd)/data/log:/data/log \
  kotakanbe/goval-dictionary fetch redhat 7 8 --dbpath /data/oval.sqlite3

注意事项

• 首次运行fetch命令时，根据获取的发行版和版本数量，数据下载和处理可能需要较长时间
• 使用MySQL/PostgreSQL等网络数据库时，需确保容器可访问数据库服务，并正确配置--dbpath为连接字符串（如mysql://user:pass@host:port/dbname?parseTime=true）
• HTTP服务器模式下，建议配合反向代理（如Nginx）使用，以提升安全性和性能