EN KO

Noir 설치

Hak
Noir는 런타임 의존성 없이 단일 바이너리로 배포돼. 대부분의 사용자에게 Homebrew가 가장 빠르지만, 시스템에 맞는 걸 선택해.

아래 방법들은 모두 동일한 noir 바이너리를 설치하므로 하나만 고르면 됩니다. 대체로 간편한 순서로 정리했으니, 사용하는 플랫폼과 패키지 매니저에 맞는 항목을 선택하고 나머지는 건너뛰어도 됩니다.

Homebrew (macOS 및 Linux)

가장 간편한 방법. Noir에는 공식 Homebrew formula가 있습니다.

설치:

brew install noir

업데이트:

brew upgrade noir
Zsh, Bash, Fish용 셸 자동완성이 함께 설치됩니다.

Snapcraft (Linux)

Snap 패키지는 대부분의 Linux 배포판에서 동작하고, 백그라운드에서 자동 업데이트됩니다.

설치:

sudo snap install noir

수동 업데이트:

sudo snap refresh noir

Docker

호스트에 직접 설치하고 싶지 않거나, CI/CD 파이프라인에서 쓸 때 유용합니다.

최신 이미지 다운로드/업데이트:

docker pull ghcr.io/owasp-noir/noir:latest

현재 디렉토리를 스캔하려면 아래와 같이 실행합니다.

docker run --rm -v $(pwd):/tmp ghcr.io/owasp-noir/noir:latest -b /tmp

이미지 태그는 OCI/Docker 컨벤션을 따라 v 프리픽스 없이 발행됩니다. 예: :0.30.0, :0.30, :latest. (v0.29.1까지는 :vX.Y.Z 형태를 썼으므로, 핀 박힌 참조가 있다면 업데이트가 필요합니다.) 사용 가능한 태그 목록은 GitHub Packages 페이지에서 확인할 수 있습니다.

Nix

Nix 사용자라면 Flakes로 설치할 수 있습니다.

설치:

nix profile add github:owasp-noir/noir

업데이트:

nix profile upgrade github:owasp-noir/noir
**팁:** Docker나 제한된 환경에서는 아래처럼 실험적 기능을 활성화해야 할 수 있습니다.
nix --extra-experimental-features "nix-command flakes" profile add github:owasp-noir/noir

설치 없이 한 번만 실행해 볼 수도 있습니다.

nix run github:owasp-noir/noir -- -h

직접 바이너리 사용

패키지 매니저가 없다면 GitHub Releases에서 빌드된 바이너리를 받을 수 있습니다. Linux와 macOS용이 제공됩니다.

설치 및 업데이트:

  1. 플랫폼에 맞는 압축 파일(예: noir-linux-x86_64.tar.gz, noir-macos-universal.tar.gz)을 다운로드합니다.

  2. 압축을 해제합니다.

    tar xzf noir-*.tar.gz

  3. PATH에 있는 디렉터리로 옮기거나 기존 바이너리를 덮어씁니다.

    sudo mv noir /usr/local/bin/

  4. 설치를 확인합니다.

    noir --version

Debian 패키지 (.deb)

Debian/Ubuntu 계열이라면 GitHub Releases의 .deb 패키지를 쓸 수 있습니다. dpkg/apt로 다른 시스템 패키지처럼 관리됩니다. amd64와 arm64가 모두 제공됩니다.

설치 및 업데이트:

  1. 최신 버전을 조회하고 다운로드합니다.

    VERSION=$(curl -s https://api.github.com/repos/owasp-noir/noir/releases/latest | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/')
wget "https://github.com/owasp-noir/noir/releases/download/v${VERSION}/noir_${VERSION}_amd64.deb"

  2. 패키지를 설치하거나 업그레이드합니다.

    sudo dpkg -i "noir_${VERSION}_amd64.deb"

  3. 의존성이 누락됐다면 아래 명령으로 해결합니다.

    sudo apt-get -f install

  4. 설치를 확인합니다.

    noir --version

Arch Linux (AUR)

Noir는 AUR에 공식 등록되어 있습니다.

설치 및 업데이트:

yay -S noir

RPM 패키지 (.rpm)

Fedora, RHEL, CentOS, openSUSE 등 RPM 기반 배포판은 GitHub Releases의 .rpm 패키지를 사용할 수 있습니다. x86_64와 aarch64가 모두 제공됩니다.

설치:

  1. 최신 버전을 조회하고 다운로드합니다.

    VERSION=$(curl -s https://api.github.com/repos/owasp-noir/noir/releases/latest | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/')
wget "https://github.com/owasp-noir/noir/releases/download/v${VERSION}/noir-${VERSION}.x86_64.rpm"

  2. 설치합니다.

    sudo rpm -i "noir-${VERSION}.x86_64.rpm"

    또는 dnf로 설치합니다.

    sudo dnf install "./noir-${VERSION}.x86_64.rpm"

업데이트:

  1. 설치 단계에 안내된 대로 최신 버전을 다운로드합니다.

  2. 업그레이드합니다.

    sudo rpm -U "noir-${VERSION}.x86_64.rpm"

    또는 dnf로 업그레이드합니다.

    sudo dnf upgrade "./noir-${VERSION}.x86_64.rpm"

  3. 설치를 확인합니다.

    noir --version

Alpine 패키지 (.apk)

Alpine Linux 사용자는 GitHub Releases의 .apk 패키지를 사용할 수 있습니다. x86_64와 aarch64가 모두 제공됩니다.

설치 및 업데이트:

  1. 최신 버전을 조회하고 다운로드합니다.

    VERSION=$(curl -s https://api.github.com/repos/owasp-noir/noir/releases/latest | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/')
wget "https://github.com/owasp-noir/noir/releases/download/v${VERSION}/noir-${VERSION}-x86_64.apk"

  2. 설치 및 업그레이드합니다.

    sudo apk add --upgrade --allow-untrusted "noir-${VERSION}-x86_64.apk"

  3. 설치를 확인합니다.

    noir --version

소스에서 빌드

직접 빌드하거나, 프로젝트에 기여하고 싶을 때 사용합니다.

[Crystal](https://crystal-lang.org/install/) 프로그래밍 언어가 필요합니다.

설치:

  1. 저장소 클론:

    git clone https://github.com/owasp-noir/noir
cd noir

  2. 종속성 설치:

    shards install

  3. 빌드:

    shards build --release

    빌드된 바이너리는 ./bin/noir에 위치합니다.

업데이트:

  1. 최신 변경사항 가져오기:

    git pull

  2. 의존성 설치 및 재빌드:

    shards install
shards build --release

설치 확인

어떤 방법을 선택했든, 아래 명령으로 설치를 확인합니다.

noir --version

버전 번호가 표시되면 준비 완료입니다.

다음: 첫 번째 스캔

Esc