aikidosecurity/local-scanner

Aikido 本地扫描解决方案 Docker 镜像

1. 镜像概述

Aikido 本地扫描解决方案 Docker 镜像是 Aikido 提供的容器化部署包，用于在企业内部环境中运行安全扫描工具。该镜像将 Aikido 的扫描功能封装为容器，简化本地部署流程，支持在隔离网络环境中执行安全检测，确保扫描数据不离开企业内部网络，满足数据隐私和合规要求。

2. 核心功能与特性

• 本地化安全扫描：支持对代码库、依赖项、配置文件等进行多维度漏洞检测，覆盖OWASP Top 10、敏感信息泄露、配置错误等常见安全问题。
• 数据隐私保护：扫描过程完全在企业内部网络完成，原始数据和扫描结果无需上传至外部服务，降低数据泄露风险。
• 容器化部署优势：简化安装流程，无需手动配置依赖环境；支持快速升级和回滚，降低维护成本。
• 灵活扫描策略：支持自定义扫描范围、频率及规则集，适配不同场景下的安全检测需求。
• 集成能力：可与企业内部CI/CD流水线、漏洞管理平台对接，实现自动化安全检测与结果上报。

3. 使用场景与适用范围

• 企业内部安全审计：定期对内部系统、应用及代码进行安全合规检查。
• 开发环境漏洞检测：在开发阶段集成扫描能力，提前发现并修复漏洞，减少生产环境风险。
• 私有代码库扫描：对企业私有Git仓库、SVN仓库等进行代码安全分析。
• 高合规要求行业：、、政务等对数据隐私和隔离性有严格要求的领域。

4. 使用方法与配置说明

4.1 基本部署（Docker Run）

通过以下命令启动容器，执行基础扫描任务：

bash
docker run -d \
  --name aikido-onprem-scanner \
  -v /path/to/local/data:/app/data \  # 挂载本地目录存储扫描结果和配置
  -e AIKIDO_LICENSE_KEY="your-license-key" \  # 配置Aikido许可证密钥
  -e SCAN_TARGET="/app/data/target" \  # 指定扫描目标路径（容器内路径）
  aikido/onprem-scanner:latest

4.2 环境变量配置

4.3 持久化数据

为避免容器重启后丢失配置和扫描结果，需挂载本地目录至容器内关键路径：

• /app/data：存储扫描结果、配置文件及日志
• /app/config：自定义扫描规则和策略文件（可选，如无需自定义可忽略）

示例挂载命令：

bash
docker run -d \
  --name aikido-onprem-scanner \
  -v /local/aikido/data:/app/data \
  -v /local/aikido/config:/app/config \  # 挂载自定义配置
  -e AIKIDO_LICENSE_KEY="your-license-key" \
  aikido/onprem-scanner:latest

4.4 Docker Compose 配置示例

创建 docker-compose.yml 文件简化部署：

yaml
version: '3.8'
services:
  aikido-scanner:
    image: aikido/onprem-scanner:latest
    container_name: aikido-onprem-scanner
    volumes:
      - ./data:/app/data
      - ./config:/app/config
    environment:
      - AIKIDO_LICENSE_KEY=your-license-key
      - SCAN_TARGET=/app/data/target
      - SCAN_FREQUENCY=0 3 * * *  # 每日凌晨3点执行扫描
      - LOG_LEVEL=info
      - RESULT_FORMAT=html
    restart: unless-stopped

启动服务：docker-compose up -d

4.5 查看扫描结果

扫描结果默认存储在挂载的本地目录 ./data/results 下，根据 RESULT_FORMAT 配置生成对应格式文件。可通过以下命令查看容器日志确认扫描状态：

bash
docker logs aikido-onprem-scanner

5. 升级与维护

• 升级镜像：

  bash
  docker pull aikido/onprem-scanner:latest
  docker stop aikido-onprem-scanner
  docker rm aikido-onprem-scanner
  # 重新执行 docker run 或 docker-compose up -d 启动新版本
  

• 查看版本：

  bash
  docker run --rm aikido/onprem-scanner:latest --version
  

6. 注意事项

• 确保宿主机网络策略允许容器访问扫描目标（如内部代码库、数据库等）。
• 许可证密钥需通过 Aikido 官方渠道获取，过期后扫描功能将无法使用。
• 挂载目录需设置适当权限（建议 chmod 755），避免容器内权限不足导致无法读写数据。