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

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

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

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
도구/GitHubGitHub/zeroecco/holos
Cloud Infrastructure SecurityGeneral Purpose UtilitiesScripting & AutomationSecurity VirtualizationDevSecOpsHardware Security
GitHubzeroecco/holos

holos

YAML compose 파일을 사용하는 선언적 KVM/QEMU VM 오케스트레이션 도구입니다. cloud-init, SSH, PCI 패스스루, 이미지 검증을 통해 libvirt나 XML 없이 멀티 VM 스택을 관리합니다.

저장소 보기
14457118일 전Kitploit 검토 완료
공유
holos

KVM을 위한 Docker compose. 하나의 YAML 파일에서 멀티 VM 스택을 정의합니다. libvirt도, XML도, 분산 제어 플레인도 없습니다.

웹사이트 및 문서: https://zeroecco.github.io/holos/

기본 단위는 컨테이너가 아니라 VM입니다. 모든 워크로드 인스턴스는 자체 커널 경계, qcow2 오버레이, cloud-init 시드, 그리고 생성된 SSH 접근 권한을 갖습니다.

여기서 시작하기

/dev/kvm, QEMU, cloud-init 시드 빌더가 있는 Linux 호스트에서 VM을 실행하세요. 호스트 요구 사항을 참조하세요. macOS 빌드는 작성, 이미지 다운로드, 검증을 지원하지만 KVM VM을 실행할 수는 없습니다.

설치

미리 빌드된 바이너리는 모든 GitHub 릴리스에 첨부되어 있습니다:

이 예제는 Linux x86-64 빌드를 설치합니다. 출처 검증을 위해 curl, tar, sha256sum, 그리고 GitHub CLI(gh)를 사용합니다. 다른 플랫폼의 경우 릴리스 페이지에서 일치하는 아카이브를 선택하세요.

(
set -e
TAG=v0.7.1
ASSET=holos_${TAG#v}_Linux_x86_64.tar.gz
BASE=https://github.com/zeroecco/holos/releases/download/$TAG
curl -fLO $BASE/$ASSET
curl -fLO $BASE/checksums.txt
grep " $ASSET$" checksums.txt | sha256sum -c -
gh attestation verify $ASSET --repo zeroecco/holos
sudo tar -xz -C /usr/local/bin -f $ASSET holos
holos version
holos doctor
)

릴리스 페이지에는 SHA-256 체크섬과 서명된 출처(provenance)를 위한 GitHub 아티팩트 증명(attestation)이 포함되어 있습니다. 프로덕션 호스트에 바이너리를 설치하기 전에 두 가지 모두를 검증하십시오.

또는 Go 1.26이 설치된 이 저장소의 체크아웃에서 소스로부터 빌드할 수 있습니다:

go build -o bin/holos ./cmd/holos
export PATH="$PWD/bin:$PATH"
holos doctor

VM 하나 사용해 보기

아래의 모든 명령이 작성된 그대로 동작하도록 고정된 이름을 사용하세요:

holos run --name try-holos alpine
holos exec -w 5m try-holos

이제 게스트에 있습니다. cat /etc/os-release를 실행한 다음, exit를 실행하여 호스트로 돌아갑니다. 호스트에서:

holos stop try-holos    # keep the guest disk
holos start try-holos
holos exec try-holos

게스트를 다시 종료한 다음, 일회용 VM을 제거합니다:

holos down try-holos   # deletes its guest disk

웹 서비스 실행

빈 디렉터리를 만들고 다음 내용을 holos.yaml로 저장하세요:

name: hello

services:
  web:
    image: ubuntu:noble
    ports:
      - "8080:80"
    cloud_init:
      packages: [nginx]
      write_files:
        - path: /var/www/html/index.html
          content: "hello from holos\n"
      runcmd:
        - systemctl restart nginx

해당 디렉터리에서:

holos up
holos exec -w 5m web -- sudo cloud-init status --wait
curl --fail localhost:8080

hello from holos가 표시되어야 합니다. 대기가 중요합니다. up은 VM을 시작하지만, nginx는 첫 부팅 중에 설치됩니다. 프로비저닝이 실패하면 holos logs web을 확인하세요.

일상적인 사용

프로젝트 디렉터리 안에서:

holos exec web       # guest shell; exit returns to the host
holos logs web      # boot and provisioning logs
holos stop web      # keep its disk
holos start web
holos up --dry-run  # preview changes after editing holos.yaml
holos help exec     # syntax and options

서비스에 여러 레플리카가 있는 경우 web-0과 같은 인스턴스 이름을 사용하세요. VM을 교체하거나 제거하는 변경에는 holos up --recreate가 필요합니다. 교체 시 해당 VM의 루트 디스크가 삭제되므로 먼저 미리보기를 확인하세요. 명명된 볼륨은 유지됩니다. 이전 릴리스에서 생성된 프로젝트를 업데이트하기 전에 업데이트 가이드를 참조하세요.

이 일회용 스택 사용을 마쳤으면:

holos down hello

stop은 인스턴스 디스크를 보존합니다. down은 디스크를 삭제하며, 명명된 볼륨은 명시적으로 제거할 때까지 유지됩니다. 스냅샷, 볼륨, 이미지 잠금, systemd 설정에 대해서는 CLI 가이드를 참조하세요.

문서

  • 웹사이트: 랜딩 페이지 및 렌더링된 문서.
  • CLI 가이드: 임시 VM, exec, systemd 설치, virsh 가져오기, doctor.
  • Compose 파일: 서비스, 볼륨, 헬스체크, 네트워킹, PCI 패스스루, Dockerfile 프로비저닝, 기본값.
  • JSON 스키마: holos.yaml에 대한 에디터 자동 완성 및 유효성 검사.
  • 예제: README 형식의 설명이 포함된 실행 가능한 스택 및 템플릿 스택.
  • 누락된 기능: holos의 단일 호스트 KVM compose 목표에 부합하는 우선순위가 지정된 격차.
  • 개발: 빌드, 테스트, 호스트 요구 사항, 릴리스 프로세스.
  • 보안 정책: 지원 버전 및 비공개 제보.
  • 위협 모델 / 하드닝: 이미지 검증, 상태 권한, 잠금, 운영 지침.
  • 기여: 빌드, 테스트, 스타일, PR 규칙.

호스트 요구 사항

  • /dev/kvm이 있는 Linux
  • qemu-system-x86_64
  • qemu-img
  • cloud-localds, genisoimage, mkisofs, xorriso 중 하나
  • UEFI 또는 PCI 패스스루를 위한 OVMF / edk2-ovmf 펌웨어
  • holos exec 및 헬스체크를 위한 ssh

호스트를 확인하려면 holos doctor를 실행하세요.

문제 해결

/dev/kvm을 열 때 권한 거부

id -nG와 ls -l /dev/kvm을 확인하세요. 장치가 kvm 그룹에 속한 호스트에서는 sudo usermod -aG kvm "$USER"로 사용자를 추가한 뒤 로그아웃하고 다시 연결하세요. 기존 셸은 이전 그룹 멤버십을 유지합니다. 새 세션에서 holos doctor를 다시 실행하세요.

첫 부팅 시 SSH 연결이 재설정됨

kex_exchange_identification: read: Connection reset by peer는 보통 cloud-init이 아직 호스트 키를 재생성하고 sshd를 재시작하는 중임을 의미합니다. holos exec는 기본적으로 최대 60초까지 대기하지만, 첫 부팅이 매우 느린 경우 한 번 더 재시도하거나 holos exec -w 5m <project>를 사용해야 할 수 있습니다.

콘솔에 Login incorrect가 표시됨

시리얼 콘솔이 cloud-init이 사용자를 생성하기 전에 자동 로그인을 시도할 수 있습니다. 콘솔 로그에 cloud-init ... finished가 표시될 때까지 기다린 후 holos exec를 사용하세요. 클라우드 이미지는 일반적으로 콘솔 비밀번호와 함께 제공되지 않으며, holos는 비밀번호를 추가하지 않습니다.

macOS에서 up 실패

KVM은 Linux 커널 기능입니다. macOS 바이너리는 작성 및 오프라인 명령에 유용하지만, holos up과 holos run은 Linux KVM 호스트에서 실행해야 합니다.

비목표

holos는 Kubernetes가 아닙니다. 멀티 호스트 클러스터링, 라이브 마이그레이션, 서비스 메시, 오버레이 네트워크, 스케줄러, CRD, 컨트롤 플레인 쿼럼을 해결하려고 시도하지 않습니다.

목표는 Kubernetes의 운영 형태를 도입하지 않고도 단일 호스트 스택에서 KVM을 사용할 수 있게 만드는 것입니다.

라이선스

Apache License, Version 2.0에 따라 라이선스가 부여됩니다. 저작자 표시는 NOTICE를 참조하세요.

도구 다운로드

인기

모두 보기 →

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

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →