
YARA 기반 파일 스캐너, 격리, 시스템 클리너, nmap 플러그인, 그리고 사용자 정의 도구를 위한 플러그인 SDK를 갖춘 Linux용 모듈식 Rust 보안 도구 상자 및 백신.
Linux용 모듈식 Rust 기반 보안 툴박스 및 백신.
Griffon은 Linux용으로 빠르고 안전하며 사용하기 쉬운 백신 및 보안 툴박스입니다. 다음 형태로 제공됩니다:
griffon-cli),내장 플러그인에는 YARA 기반 스캐너(격리 및 규칙 업데이트 포함)와 시스템 정리 도구(캐시, 로그, 패키지, 대용량 파일, Docker)가 포함되어 있습니다.
[!WARNING] Griffon은 출시 전 단계의 학술 프로젝트입니다. 전문적인 감사를 받지 않았습니다 — SECURITY.md를 참조하세요.
Griffon은 보안 및 시스템 유지 관리 도구 세트를 제공하며, 자체 플러그인을 통해 기능을 유연하게 확장할 수 있습니다.
시스템의 위협을 검사하거나, 디스크를 정리하거나, 자체 보안 및 시스템 유틸리티를 구축하려는 경우, Griffon은 필요에 맞게 조정할 수 있는 모듈식 기반을 제공합니다.
지원 시스템: Ubuntu 22.04+, Debian 12+, Fedora 36+ (x86_64) 및 파생 배포판 (Linux Mint 21+, Pop!_OS 22.04+…).
1. 다운로드 및 설치: 릴리스 페이지에서 최신 .deb (Debian/Ubuntu) 또는 .rpm (Fedora)을 다운로드하여 설치하세요. 파일 이름 앞의 ./가 필요합니다:
# Debian / Ubuntu
sudo apt update
sudo apt install ./griffon-*.deb
# Fedora
sudo dnf install ./griffon-*.rpm
설치는 griffon-daemon systemd 서비스를 활성화하고 시작하며, GUI와 CLI가 sudo 없이 데몬과 통신할 수 있도록 사용자를 griffon 그룹에 추가합니다.
2. 로그아웃 후 다시 로그인하거나 터미널에서 newgrp griffon을 실행하여 그룹 변경 사항을 적용하세요. 이 단계는 필수입니다.
3. 정상 작동 여부 확인:
systemctl status griffon-daemon # should say "active (running)"
id | grep griffon # your user must be in the griffon group
griffon-cli
그런 다음 애플리케이션 메뉴에서 Griffon을 실행하거나 griffon-gui를 실행하세요.
| 문제 | 해결 방법 |
|---|---|
CLI/GUI가 데몬에 연결할 때 permission denied 발생 | 아직 로그아웃 후 다시 로그인하지 않은 상태입니다. root로 설치한 경우(sudo 없이), 사용자를 수동으로 추가하세요: sudo usermod -aG griffon $USER, 그런 다음 로그아웃 후 다시 로그인하세요. |
| 데몬이 실행 중이 아님 | sudo systemctl restart griffon-daemon을 실행하고, journalctl -u griffon-daemon -b로 로그를 확인하세요 |
apt에서 의존성을 설치할 수 없다고 표시됨 | sudo apt update를 실행한 후 다시 설치하세요. |
제거하려면: sudo apt remove griffon 또는 sudo dnf remove griffon.
설치된 Griffon과 소스에서 실행하는 Griffon은 서로 다른 설정, 플러그인, 소켓 위치(
/usr/lib/griffon,/etc/griffon,/run/griffonvs. 저장소 폴더)를 사용합니다. 둘 다 가질 수 있지만, 개발용 CLI/GUI는 개발용 데몬과만 통신합니다.
Rust (stable) 및 Cargo
Node.js 및 npm
Tauri의 시스템 의존성:
# Fedora
sudo dnf install @development-tools pkgconf-pkg-config openssl-devel webkit2gtk4.1-devel javascriptcoregtk4.1-devel
# Debian / Ubuntu
sudo apt install build-essential pkg-config libssl-dev libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev
다른 배포판의 경우 Tauri 사전 요구 사항 가이드를 참조하세요.
Docker (.deb / .rpm 패키지를 빌드할 때만 필요)
저장소 루트에서:
just setup-gui # install the GUI's npm dependencies
cargo build # build the whole workspace (daemon, CLI, GUI, plugins)
just update-plugins # copy the scanner and cleaner plugins into .config/griffon/
그런 다음 각 컴포넌트를 자체 터미널에서 실행하되, 데몬부터 시작하십시오:
just run-daemon # start the daemon (creates ./griffon.sock)
just run-gui # start the desktop app in dev mode
just run-cli # start the CLI
플러그인을 변경할 때마다 cargo build && just update-plugins를 다시 실행하세요.
| 명령어 | 설명 |
|---|---|
just --list | 사용 가능한 모든 단축 명령 목록 표시 |
just setup-dev-env | git pre-commit 훅 활성화 (fmt + clippy) |
just lint / just lint-fix | 포맷팅 및 Clippy 린트 검사 / 수정 |
cargo test | 테스트 실행 |
cargo build --release | 릴리스 모드로 워크스페이스 빌드 |
just build-gui | GUI 바이너리 빌드 (릴리스, 설치 프로그램 번들 제외) |
just build-deb | Docker에서 .deb 및 .rpm 패키지 빌드, dist/에 출력 |
CI는 cargo fmt --all --check와 cargo clippy --workspace --all-targets -- -D warnings를 실행합니다. 풀 리퀘스트를 열기 전에 이를 실행하세요.
griffon/
├── cli/ # griffon-cli: interactive command-line client
├── daemon/
│ ├── daemon_core/ # griffon-daemon: socket server, dispatcher, notifications
│ ├── daemon_runner/ # griffon-daemon-runner: isolated process that hosts a plugin
│ ├── plugin_manager/ # loads, enables/disables and talks to plugins
│ └── griffon-daemon.service # systemd unit (packaged install)
├── gui/ # desktop app (React + Vite frontend, Tauri v2 in src-tauri/)
├── plugin-installer/ # privileged helper used by the GUI to install plugins
├── plugins/
│ ├── griffon_scanner/ # YARA + hash based scanner, quarantine, rule updater
│ ├── griffon_cleaner/ # system cleaner
│ ├── griffon_nmap/ # network scan (nmap)
│ ├── docker_helper/ # Docker helper plugin
│ └── plugin_template/ # starter template for new plugins
├── shared/
│ ├── ipc_protocol/ # IPC messages between daemon, runner, GUI and CLI
│ ├── logger/ # shared logging
│ ├── plugin_interface/ # stable ABI contract between the host and plugins
│ └── plugin_sdk/ # SDK every plugin is written with
├── assets/ # logo and README screenshots
├── bench/ # benchmark VM (Vagrant) and datasets
├── scripts/ # packaging scripts (post-install, pre-remove)
├── nfpm.yaml # .deb / .rpm package definition
└── justfile # dev shortcuts