설치 및 환경 구성 가이드

프로덕션 배포, 하드웨어 의존성 및 단말기 환경 프로비저닝 (AMEVA-Sentinel)

Release: v2.3.0

핵심 가치 제안 (Why It Matters)

내 웹사이트를 해커와 매크로 봇으로부터 안전하게 지켜주는 똑똑한 경비원을 단 1초 만에 설치합니다.

1. 표준 패키지 매니저 설치

공식 배포 레지스트리 엔드포인트를 통해 직접 설치할 수 있습니다:

# Node.js 공식 패키지 매니저 (TypeScript / 브라우저 & 백엔드 SDK)
npm install @ameva/sentinel

# Python 공식 패키지 매니저 (FastAPI / Flask / Django 미들웨어)
pip install ameva-sentinel

2. 필수 시스템 패키지 의존성

안드로이드 Bionic libc 및 POSIX 툴체인 연결을 위해 사전에 설치되어야 하는 시스템 패키지 목록입니다:

패키지명	엔지니어링 도입 목적 (한 줄 명확한 사유)
`nodejs`	Sentinel 텔레메트리 스캐너 및 CLI 실행 런타임
`openssl`	결정론적 HMAC-SHA256 인증 토큰 생성 암호화 라이브러리
`libuv`	비동기 논블로킹 이벤트 루프 드라이버

3. install.sh 원클릭 자동 프로비저닝

단말기 SoC 아키텍처를 자동 감지하고 최적 NEON/Vulkan 커널을 한 번에 컴파일 및 검증하려면 아래 명령어를 실행하세요:

curl -fsSL https://raw.githubusercontent.com/uno-km/ameva-sentinel/main/install.sh | bash

4. 패키지 단독 설치 vs 풀스택 자동화 설치 비교

설치 경로	런타임 실행 특성	제약사항 및 폴백 메커니즘
패키지 매니저 단독 설치	고수준 언어 바인딩 및 기본 CPU 추론 코어 위주 로딩.	시스템 C++ 런타임 및 GPU 가속 드라이버가 수동 구성되어야 합니다.
자동화 풀 패키지 설치	Vulkan SPIR-V 셰이더 컴파일, 제로카피 IPC 셋업 및 실리콘 벤치마크 검증 완료.	지연시간 최소화가 필요한 실제 프로덕션 워크로드에 적극 권장됩니다.

5. 선택적 빌드 및 런타임 플래그 파라미터

옵션 파라미터	아키텍처 동작 및 하드웨어 효과
`--sample-rate=<0.0-1.0>`	클라이언트 요청 텔레메트리 샘플링 비율
`--hmac-secret=`	로컬 무결성 서명에 사용되는 비밀 암호화 키
`--strict-entropy`	인터랙션 이벤트에 대한 엄격한 Shannon 엔트로피 임계치 적용