Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
도구/GitHubGitHub/aquasecurity/trivy-action
Vulnerability ScannersContainer SecurityCode AnalysisCloud SecurityDevSecOpsSecret DetectionSupply Chain SecurityMisconfiguration
GitHubaquasecurity/trivy-action

trivy-action

Trivy를 GitHub action으로 실행하여 Docker 컨테이너 이미지의 취약점을 스캔합니다.

저장소 보기
1.4k3574913일 전Kitploit 검토 완료
공유

Trivy Action

Trivy를 위한 GitHub Action

[![GitHub Release][release-img]][release] [![GitHub Marketplace][marketplace-img]][marketplace] [![License][license-img]][license]

목차

  • 사용법
    • CI 파이프라인 스캔
    • CI 파이프라인 스캔 (Trivy Config 사용)
    • 캐시
    • Trivy 설정
    • Tarball 스캔
    • 템플릿과 함께 Trivy 사용
    • GitHub 코드 스캐닝과 함께 Trivy 사용
    • Trivy를 사용하여 Git 저장소 스캔
    • Trivy를 사용하여 rootfs 디렉터리 스캔
    • Trivy를 사용하여 Infrastructure as Code 스캔
    • Trivy를 사용하여 SBOM 생성
    • Trivy를 사용하여 프라이빗 레지스트리 스캔
    • 코드 스캐닝이 활성화되지 않은 경우 Trivy 사용
  • 사용자 지정
    • inputs
    • 환경 변수
    • Trivy 설정 파일

사용법

CI 파이프라인 스캔

name: build
on:
  push:
    branches:
      - main
  pull_request:
jobs:
  build:
    name: Build
    runs-on: ubuntu-24.04
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Build an image from Dockerfile
        run: docker build -t docker.io/my-organization/my-app:${{ github.sha }} .
      - name: Run Trivy vulnerability scanner
        uses: aquasecurity/[email protected]
        with:
          image-ref: 'docker.io/my-organization/my-app:${{ github.sha }}'
          format: 'table'
          exit-code: '1'
          ignore-unfixed: true
          vuln-type: 'os,library'
          severity: 'CRITICAL,HIGH'

CI 파이프라인 스캔 (Trivy Config 사용)

name: build
on:
  push:
    branches:
    - main
  pull_request:
jobs:
  build:
    name: Build
    runs-on: ubuntu-24.04
    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Run Trivy vulnerability scanner in fs mode
      uses: aquasecurity/[email protected]
      with:
        scan-type: 'fs'
        scan-ref: '.'
        trivy-config: trivy.yaml

이 경우 trivy.yaml은 리포지토리의 일부로 체크인되는 YAML 구성입니다. 자세한 정보는 Trivy 웹사이트에서 확인할 수 있으며, 예시는 다음과 같습니다:

format: json
exit-code: 1
severity: CRITICAL
secret:
  config: config/trivy/secret.yaml

trivy.yaml 파일에서 모든 옵션을 정의할 수 있습니다. 액션을 통해 개별 옵션을 지정하는 것은 하위 호환성을 위해 남겨둔 것입니다. 다음 항목은 구성 파일로 정의할 수 없으므로 반드시 정의해야 합니다:

  • scan-ref: fs, repo 스캔을 사용하는 경우.
  • image-ref: image 스캔을 사용하는 경우.
  • scan-type: 스캔 유형을 정의합니다(예: image, fs, repo 등).

옵션의 우선순위

Trivy는 옵션에 대해 정의된 우선순위 순서가 있는 Viper를 사용합니다. 순서는 다음과 같습니다:

  • GitHub Action 플래그
  • 환경 변수
  • 구성 파일
  • 기본값

캐시

이 액션에는 스캔 중에 다운로드되는 경우 취약점 DB, Java DB 및 검사 번들을 캐시하고 복원하는 기능이 내장되어 있습니다. 캐시는 기본적으로 $GITHUB_WORKSPACE/.cache/trivy 디렉터리에 저장됩니다. 캐시는 스캔이 시작되기 전에 복원되고 스캔이 완료된 후에 저장됩니다.

내부적으로 actions/cache를 사용하지만 구성 설정이 더 적게 필요합니다. 캐시 입력은 선택 사항이며, 캐싱은 기본적으로 활성화되어 있습니다.

캐싱 비활성화

캐싱을 비활성화하려면 cache 입력을 false로 설정하세요. 하지만 속도 제한 문제를 피하려면 활성화된 상태로 두는 것을 권장합니다.

    - name: Run Trivy scanner without cache
      uses: aquasecurity/[email protected]
      with:
        scan-type: 'fs'
        scan-ref: '.'
        cache: 'false'

기본 브랜치에서 캐시 업데이트

GitHub Actions의 브랜치 간에는 캐시 접근에 대한 제한이 있다는 점에 유의하세요. 기본적으로 워크플로는 현재 브랜치 또는 기본 브랜치(보통 main 또는 master)에서 생성된 캐시에 접근하고 복원할 수 있습니다. 브랜치 간에 캐시를 공유해야 하는 경우, 기본 브랜치에서 캐시를 생성하고 현재 브랜치에서 복원해야 할 수 있습니다.

워크플로를 최적화하려면 cron 작업을 설정하여 기본 브랜치의 캐시를 정기적으로 업데이트할 수 있습니다. 이렇게 하면 이후 스캔에서 DB를 다시 다운로드하지 않고 캐시된 DB를 사용할 수 있습니다.

# Note: This workflow only updates the cache. You should create a separate workflow for your actual Trivy scans.
# In your scan workflow, set TRIVY_SKIP_DB_UPDATE=true and TRIVY_SKIP_JAVA_DB_UPDATE=true.
name: Update Trivy Cache

on:
  schedule:
    - cron: '0 0 * * *'  # Run daily at midnight UTC
  workflow_dispatch:  # Allow manual triggering

jobs:
  update-trivy-db:
    runs-on: ubuntu-latest
    steps:
      - name: Setup oras
        uses: oras-project/setup-oras@v1

      - name: Get current date
        id: date
        run: echo "date=$(date +'%Y-%m-%d')" >> $GITHUB_OUTPUT

      - name: Download and extract the vulnerability DB
        run: |
          mkdir -p $GITHUB_WORKSPACE/.cache/trivy/db
          oras pull ghcr.io/aquasecurity/trivy-db:2
          tar -xzf db.tar.gz -C $GITHUB_WORKSPACE/.cache/trivy/db
          rm db.tar.gz

      - name: Download and extract the Java DB
        run: |
          mkdir -p $GITHUB_WORKSPACE/.cache/trivy/java-db
          oras pull ghcr.io/aquasecurity/trivy-java-db:1
          tar -xzf javadb.tar.gz -C $GITHUB_WORKSPACE/.cache/trivy/java-db
          rm javadb.tar.gz

      - name: Cache DBs
        uses: actions/cache/save@v4
        with:
          path: ${{ github.workspace }}/.cache/trivy
          key: cache-trivy-${{ steps.date.outputs.date }}

스캔을 실행할 때 다운로드 과정을 건너뛰려면 환경 변수 TRIVY_SKIP_DB_UPDATE와 TRIVY_SKIP_JAVA_DB_UPDATE를 설정하세요.

    - name: Run Trivy scanner without downloading DBs
      uses: aquasecurity/[email protected]
      with:
        scan-type: 'image'
        scan-ref: 'myimage'
      env:
        TRIVY_SKIP_DB_UPDATE: true
        TRIVY_SKIP_JAVA_DB_UPDATE: true

Trivy 설정

기본적으로 이 액션은 첫 번째 단계로 aquasecurity/setup-trivy를 호출하며, 이는 version 입력으로 지정된 trivy 버전을 설치합니다. 다른 방법으로 이미 trivy를 설치한 경우, 예를 들어 aquasecurity/setup-trivy를 직접 호출했거나 이 액션을 여러 번 호출하는 경우에는 skip-setup-trivy 입력을 사용하여 이 단계를 비활성화할 수 있습니다.

Trivy 수동 설정

name: build
on:
  push:
    branches:
    - main
  pull_request:
jobs:
  build:
    name: Build
    runs-on: ubuntu-24.04
    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Manual Trivy Setup
      uses: aquasecurity/[email protected]
      with:
        cache: true
        version: v0.76.2

    - name: Run Trivy vulnerability scanner in repo mode
      uses: aquasecurity/[email protected]
      with:
        scan-type: 'fs'
        ignore-unfixed: true
        format: 'sarif'
        output: 'trivy-results.sarif'
        severity: 'CRITICAL'
        skip-setup-trivy: true

Trivy Action을 여러 번 호출할 때 설정 건너뛰기

또 다른 일반적인 사용 사례는 빌드에서 이 액션을 여러 번 호출하는 경우이며, 이때 후속 호출에서 skip-setup-trivy를 true로 설정할 수 있습니다. 예를 들어

name: build

on:
  push:
    branches:
      - main
  pull_request:

jobs:
  test:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - name: Check out Git repository
        uses: actions/checkout@v4

      # The first call to the action will invoke setup-trivy and install trivy
      - name: Generate Trivy Vulnerability Report
        uses: aquasecurity/[email protected]
        with:
          scan-type: "fs"
          output: trivy-report.json
          format: json
          scan-ref: .
          exit-code: 0

      - name: Upload Vulnerability Scan Results
        uses: actions/upload-artifact@v4
        with:
          name: trivy-report
          path: trivy-report.json
          retention-days: 30
도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 궁극의 OSINT 툴킷: 조사 그래프, 신뢰도 점수 산정, 별칭 패밀리, 지도, 타임라인 및 보고서. 49개 모듈, 400개 이상 사이트, API 키 불필요.

    837
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # GhostLock 원탭 실행 앱 (CVE-2026-43499)

    536
  • 3

    ARTEX

    baarai/artex

    LLM 멀티 에이전트 자율 침투 테스트 플랫폼으로, 플래너/워커 에이전트, 자산 및 탐색 그래프, MITM 트래픽 기록, 취약점 재테스트 기능을 제공합니다.

    424
  • 4

    redforge

    cybersecurity91/redforge

    브라우저 측 레드 팀 툴킷으로, 정찰, 페이로드 생성, 자격 증명 공격, 암호화, 인코딩 및 참여 보고를 위한 102개의 오프라인 도구를 제공합니다.

    355
  • 5

    looking-glass

    anonghosty/looking-glass

    Shadowserver 보고서를 MongoDB로 수집하고 이를 대화형 지도, 분석, 발견 사항, 권고 및 경영진 대시보드로 재생하는 CSIRT 플랫폼입니다.

    294
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI 네이티브 사이버보안을 위한 행동 체계—의도가 통제된 실행이 되고, 증거가 운영 메모리가 되며, 모든 운영이 다음 운영을 개선하는 곳.

    276

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →