简介
什么是 HarborGuard?
HarborGuard
是一个现代化的容器安全扫描平台,通过集成多种安全扫描工具来简化容器安全管理。它提供直观的Web
界面,帮助用户管理和可视化Docker
镜像的安全评估。
主要特点
- 全面的扫描能力:
- 支持
Trivy
、Grype
、Syft
、Dockle
、OSV Scanner
和Dive
等6
种主流容器安全工具。 - 自动进行漏洞检测与分类、生成软件物料清单 (
SBOM
) 以及容器最佳实践验证。
- 支持
- 先进的可视化:
- 提供交互式漏洞散点图、历史扫描对比图表和实时进度监控。
- 支持按严重性进行过滤和分组。
- 优秀的开发者体验:
- 采用
React 19 + Next.js 15
现代化架构。 - 使用
TypeScript
、Prisma ORM
,并支持SQLite/PostgreSQL
数据库。 - 支持通过环境变量进行全面配置,适应不同的部署需求。
- 采用
- 企业级就绪:
- 提供
RESTful API
用于程序化访问。 - 支持批量报告导出和持久化的扫描历史。
- 提供
应用场景
该平台主要用于解决容器安全工作流中的各种问题,尤其适合以下场景:
- 统一管理:取代管理多个命令行工具输出的繁琐工作,提供一个统一的仪表盘来查看所有扫描结果。
- 历史追溯:持久化存储扫描结果,方便进行历史数据对比和趋势分析。
- 合规性报告:可以方便地导出单个工具的报告或完整的
ZIP
包以满足合规性要求。 - 实时监控:通过
WebSocket
集成,实时跟踪扫描进度。
HarborGuard
通过其强大的功能和良好的用户体验,成为容器安全管理的理想选择。
安装
在群晖上以 Docker 方式安装。
HarborGuard
支持SQLite/PostgreSQL
数据库,个人使用SQlite
就足矣
docker cli 安装
如果你熟悉命令行,可能用 docker cli
更快捷
# 新建文件夹 harborguard 和 子目录
mkdir -p /volume1/docker/harborguard/data
# 进入 harborguard 目录
cd /volume1/docker/harborguard
# 运行容器
docker run -d \
--restart unless-stopped \
--name harborguard \
-p 3495:3000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v $(pwd)/data:/data \
-e DATABASE_URL="file:/data/app.db" \
ghcr.io/harborguard/harborguard:latest
docker-compose 安装
也可以用 docker-compose
安装,将下面的内容保存为 docker-compose.yml
文件
version: '3.8'
services:
harborguard:
image: ghcr.io/harborguard/harborguard:latest
container_name: harborguard
restart: unless-stopped
ports:
- "3495:3000"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./data:/data
environment:
DATABASE_URL: "file:/data/app.db"
然后执行下面的命令
# 新建文件夹 harborguard 和 子目录
mkdir -p /volume1/docker/harborguard/data
# 进入 harborguard 目录
cd /volume1/docker/harborguard
# 将 docker-compose.yml 放入当前目录
# 一键启动
docker-compose up -d
运行
第一次启动的时间有点长,需要在日志中看到数据库初始化成功并且 Web
启动才能访问
[DB] Initialization completed successfully
▲ Next.js 15.4.6
- Local: http://13c71a5528fa:3000
- Network: http://13c71a5528fa:3000
✓ Starting...
✓ Ready in 849ms
[ScannerService] Created new instance ek4soy
在浏览器中输入 http://群晖IP:3495
就能看到界面
点左上角 New Scan
--> Local
--> 搜索框
选中一个本地镜像,例如 portainer/portainer-ce:latest
点 Start Scan
开始扫描
稍等一会儿就会有结果
查看详情,可以看到不同引擎诊断的结果
一般来说,正规途径下载的都不会有大问题,但漏洞总归是很难避免的
可以继续扫描其他的镜像
参考文档
HarborGuard/HarborGuard: Modern container security scanning platform with multi-tool integration.
地址:https://github.com/HarborGuard/HarborGuard
Harbor Guard
地址:https://demo.harborguard.co/