빠른 시작

스캔하고, 이해하고, 적용하고, 복구하기. 여기서는 명령줄로 전체 흐름을 따라가지만, 원한다면 TUI와 웹 대시보드도 정확히 같은 엔진으로 동작합니다.

1. 로컬에서 스캔하기

스캔을 실행하기만 하면 됩니다 — hostveil은 SSH와 방화벽 점검이 root 소유 파일을 읽을 수 있도록 sudo로 자동으로 권한을 상승시킵니다. sudo hostveil과 동일한 sudo 비밀번호 프롬프트가 표시됩니다:

hostveil scan

0–100 사이의 단일 보안 점수와 심각도순으로 정렬된 발견 항목 목록을 받게 됩니다. 도구가 없는 영역(Docker 없음, Trivy 없음)은 건너뛰어지고 점수가 재정규화됩니다 — 깨끗한 호스트는 속 빈 100점이 아니라 Clean으로 표시됩니다.

팁

대화형 터미널에서는 인자 없이 hostveil을 실행하면 대신 TUI가 열립니다. 파이프되거나 리디렉션된 경우에는 스캔 결과를 출력합니다 — 스크립트에서 유용합니다.

-v를 추가하면 각 발견 항목의 쉬운 말 설명과 수정 안내를 바로 볼 수 있습니다:

hostveil scan -v

또는 ID로 하나의 발견 항목을 자세히 살펴볼 수 있습니다(예: ssh.rootlogin):

hostveil explain ssh.rootlogin

내 방식으로 된 second opinion이 필요하신가요? --ai를 추가하면 로컬 모델의 조언성 설명을 받을 수 있습니다 — AI 설명을 참고하세요. 모든 발견 항목 ID와 그 의미는 점검 항목에 정리되어 있습니다.

수정은 항상 무엇이든 건드리기 전에 정확한 변경 내용을 먼저 보여 주고 원본을 백업합니다. 하나의 발견 항목을 미리 보고 적용하려면:

hostveil fix ssh.rootlogin

또는 명백히 안전한(Auto-fix) 수정을 한 번에 모두 적용할 수도 있습니다 — Review와 Manual 발견 항목은 직접 결정하도록 남겨집니다:

hostveil fix --all

Auto-fix·Review·Manual이 어떻게 다른지는 수정 및 롤백을 참고하세요.

적용된 모든 수정은 체크포인트가 됩니다. 목록을 확인한 뒤 ID로 하나를 되돌리세요:

hostveil history
hostveil rollback <checkpoint-id>

롤백은 백업된 파일을 바이트 단위 그대로 복원합니다. 모든 인터페이스가 하나의 공유 엔진을 거치므로, TUI나 웹 대시보드에서 적용한 수정도 여기서 되돌릴 수 있습니다.