Hulios

강화된 범용 Linux 비가시성 및 Onion 시스템

Hulios는 eBPF 기반의 투명한 Linux용 Tor VPN 게이트웨이입니다. 내장된 Arti(Tor 클라이언트) 인스턴스와 로컬 Hickory 기반 DNS 리졸버를 통해 TCP 소켓과 DNS 쿼리를 리디렉션하여 아웃바운드 네트워크 트래픽을 보호합니다. cgroup 후크와 정책 라우팅을 통해 커널 소켓 수준에서 작동하므로, 런타임 resolv.conf 구성을 수정하거나 외부 방화벽 데몬에 의존하지 않고도 강력한 누출 방지 경계를 구현합니다.

🔒 보안 아키텍처

Hulios는 엄격한 권한 분리 런타임 모델을 구현합니다:

• 권한 분리: 엔트리 포인트 수퍼바이저는 eBPF 프로그램을 후킹하고 정책 라우팅 테이블을 구축하기 위해 호스트 루트 권한으로 실행된 후, 즉시 권한이 없는 워커 자식 프로세스를 생성합니다.
• 샌드박스 격리: 워커 프로세스는 nobody로 권한을 낮추고 제한적인 seccomp 시스템 콜 필터를 사용하여 격리됩니다.
• Fail-Secure Kill-Switch: 출력 트래픽 라우팅은 커널 정책 테이블(table 100)과 기본 블랙홀로 고정됩니다. 데몬이 크래시하거나 강제 종료(SIGKILL)되는 경우 블랙홀은 계속 활성 상태로 유지되어, 수동 복구가 시작될 때까지 발신 트래픽을 차단하여 IP 누출을 방지합니다.
• Raw 소켓 차단기: LSM eBPF 후크는 애플리케이션이 표준 IP 라우팅 규칙을 우회하지 못하도록 raw AF_PACKET 소켓 생성을 전역적으로 차단합니다.

📋 요구 사항

• Linux 커널: 버전 5.10 이상.
• 커널 설정: CONFIG_BPF_SYSCALL, CONFIG_BPF_LSM, CONFIG_CGROUPS_V2가 활성화되어 있어야 합니다.
• 빌드 의존성: clang 및 libelf(컴파일 타임 eBPF 컴파일에 필요).

검증된 플랫폼

Arch Linux 및 **Debian 13 (Bookworm)**에서 테스트 및 검증되었습니다.

⚙️ 빌드 및 설치

📦 Arch Linux (AUR)

Hulios는 Arch User Repository에서 hulios-git으로 제공됩니다:

# Using paru
paru -S hulios-git

# Using yay
yay -S hulios-git

🛠️ 소스에서 빌드

1. 빌드 의존성 설치

• Arch Linux:
  root@kitploit:~

  sudo pacman -S clang libelf zlib sqlite
  

• Debian/Ubuntu:
  root@kitploit:~

  sudo apt install -y clang libelf-dev zlib1g-dev libsqlite3-dev
  

2. 소스에서 컴파일

Rust 컴파일러가 설치되어 있는지 확인하세요(툴체인 선택 및 타깃 요구 사항은 rust-toolchain.toml에서 자동으로 관리됩니다):

git clone https://github.com/ghaziwali/Hulios.git
cd Hulios
cargo build --release

컴파일된 바이너리는 target/release/hulios에 위치합니다.

🚀 사용 가이드

커널 인터페이스 또는 정책 라우팅과 상호작용하는 모든 명령에는 상승된 권한이 필요합니다:

# View global help and available commands
./target/release/hulios --help

# View help for a specific command (e.g. start)
./target/release/hulios start --help

# Start Hulios in foreground TUI mode
sudo ./target/release/hulios start

# Check current running state and Tor bootstrap progress
./target/release/hulios status

# Verify network namespace integrity and check for leaks
sudo ./target/release/hulios diagnose

# Revert system network settings and recover from unclean shutdowns
sudo ./target/release/hulios recover

# Stop Hulios and restore standard internet routing
sudo ./target/release/hulios stop

⚙️ 구성

Hulios는 첫 실행 시 /etc/hulios/config.toml에 기본적이고 자체 문서화된 템플릿 파일을 자동으로 생성합니다(이미 존재하지 않는 경우). 생성된 파일을 열어 변수를 사용자 정의합니다(예: 선호하는 Tor 출구 노드, DNS 리디렉션, 사용자 지정 SOCKS 포트 또는 엄격한 잠금 모드).

💖 기부

Hulios가 유용하다고 생각하고 지속적인 보안 개발 및 연구를 지원하고 싶다면 기부는 큰 도움이 됩니다:

• Bitcoin (BTC): bc1q0gllvd7fe2y48emjd4shf42ul3cl4pgda5zpqz
• USDT (TRON / TRC20): TQWUmTATa8sDntobTNGkLmbgmHVS9iWCRx
• USDC (Ethereum / ERC20): 0x16aFd1De7889071194A026D79393eb3CE659181e

⚠️ 면책 조항

Hulios가 네트워크 전송 계층(3계층)을 보호한다고 해서 완전한 익명성이 보장되는 것은 아닙니다.

• 책임 없음 / 오용: 본 소프트웨어는 명시적이거나 묵시적인 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다. 개발자는 데이터 유출, 개인정보 침해, 법적 결과, 시스템 불안정 또는 HULIOS의 사용, 오용, 불법 적용으로 인해 발생하는 손해에 대해 어떠한 책임도 지지 않습니다.
• 애플리케이션 핑거프린팅: Hulios는 애플리케이션 수준의 추적기, 쿠키 또는 브라우저 핑거프린팅 구성을 제거하지 않습니다. 웹 브라우징의 경우 Hulios SOCKS 인터페이스를 통해 라우팅되도록 구성된 공식 Tor Browser를 사용하는 것이 좋습니다.
• 호스트 침해: 공격자가 루트 액세스 권한을 획득하면 eBPF 프로그램을 언로드하고 라우팅 테이블을 변경할 수 있으므로 Hulios는 시스템을 보호할 수 없습니다.
• Tor 네트워크 제한 사항: 트래픽은 Tor 네트워크의 보안에 영향을 받으며, 진입 노드와 출구 노드를 모두 제어하는 주체에 의한 잠재적 상관관계 공격도 포함됩니다.