Sliver C2 프레임워크를 위한 크로스 플랫폼 Electron GUI로, 세션 및 비콘 대시보드, 페이로드 생성, 리스너, loot, 클라우드 배포 관리를 제공합니다.
Sliver GUI는 Sliver를 위한 크로스 플랫폼 Electron 데스크톱 애플리케이션입니다. 백엔드 연결, 실시간 상태 보기, 전용 워크스페이스, 그리고 네이티브 Sliver 콘솔을 HeroUI, HeroUI Pro, Font Awesome으로 구축된 React 인터페이스에 결합합니다.
GUI는 모든 업스트림 명령이나 옵션을 구현하지는 않습니다. 운영자 연결은 mTLS를 사용하며, WireGuard 운영자 구성은 인식되지만 연결할 수 없습니다. 추적되는 범위는 운영자 패리티 보고서를, 특정 경계는 아래의 기능 문서를 참조하세요.
npm run setup:rdp는 고정된 Rust 1.94.1 툴체인과 플랫폼 타깃을 설치합니다.지원되는 버전과 고정된 종속성은 package.json 및 package-lock.json에 기록되어 있습니다. 애플리케이션 코드는 엄격한 TypeScript를 사용하며, 빌드 헬퍼는 Node.js ES 모듈을 사용합니다.
npm ci --strict-allow-scripts
npx heroui-pro login
npx heroui-pro install --yes
npm run setup:rdp
npm run dev
초기 워크스테이션 설정에는 HeroUI 로그인/설치 단계가 필요하지만,
설치를 위해 HEROUI_AUTH_TOKEN이 이미 구성되어 있다면 건너뛸 수 있습니다.
자격 증명은 추적되는 파일에 두지 마십시오.
npm run dev는 프로덕션 콘텐츠 보안 정책을 사용하여
sliver://app/index.html에서 정적 애플리케이션을 빌드하고 실행합니다.
또한 고정된 IronRDP 포크에서 호스트 RDP 헬퍼를 빌드합니다. 일반적인
TypeScript 빌드와 단위 테스트는 Rust 컴파일이 필요하지 않습니다.
소스 변경 후에는 명령을 재시작하십시오. 이 워크플로는 HMR을 사용하지 않습니다.
TypeScript 클라이언트는 고정된 sliver-script npm 패키지에서 설치됩니다.
인접한 클라이언트 체크아웃은 필요하지 않습니다. 일반적인 애플리케이션 개발에는
Sliver 소스 체크아웃이 필요하지 않지만, 네이티브 콘솔을 빌드할 때는 필요합니다.
기본 Sliver 클라이언트 루트는 ~/.sliver-client이며, SLIVER_CLIENT_ROOT_DIR로
다른 루트를 선택할 수 있습니다. Overview 그래프 옵션을 포함한 애플리케이션
환경설정은 해당 루트 아래의 gui/application-settings.json에 저장되고, 워크스페이스
확대/축소는 gui/workspace-zoom.json에, 텍스트 편집기 환경설정은
gui/text-editor-settings.json에 저장됩니다. GUI는 configs/에서 기존
운영자 구성을 검색하고, 유효한 구성이 그곳에 저장되면 열린 선택기를
업데이트합니다. Import를 통해 선택한 구성은 gui/operator-configs.json에
비공개 파일 참조로 저장됩니다. Import와 Forget은 소스 구성을 복사하거나
삭제하지 않습니다.
원격 데스크톱 프로필과 엔드포인트 인증서 핀은 gui/rdp.json에 있습니다.
비밀번호는 기본적으로 생략되며, 앱 종료 시까지 보관하거나 운영 체제의 보안
저장소로 암호화할 수 있습니다. Linux가 암호화되지 않은 키 저장소를 선택하면
영구 비밀번호를 사용할 수 없습니다. 클립보드 전송은 명시적이며 텍스트로
제한됩니다. RDP 탭을 닫으면 원격 Windows 계정에서 로그오프하지 않고 연결이
끊깁니다.
Settings → General → Appearance → Disable window transparency는 앱 전체에서 네이티브 창 유리를 즉시 끕니다. 이 스위치는 기본적으로 꺼져 있으므로 지원되는 곳에서는 투명도가 활성화된 상태로 유지됩니다. 다른 애플리케이션 환경설정과 함께 저장되며 터미널 투명도보다 우선합니다.
Ghostty 호환 터미널 색상은 Settings → Terminal에서 구성하고
gui/ghostty/config에 저장됩니다. 사용자 지정 테마는 gui/ghostty/themes/에
두며, 설치된 네이티브 Ghostty 테마는 자동으로 검색됩니다. 구성 공유, Monaco
편집기, 플랫폼 투명도 지원 및 런타임 제한에 대해서는
터미널 모양 및 Ghostty 테마를 참조하십시오.
| 명령 | 용도 |
|---|---|
npm run typecheck | main/preload 및 renderer TypeScript 프로젝트를 검사합니다. |
npm test | Vitest 단위 및 컴포넌트 테스트를 실행합니다. |
npm run test:watch | Vitest를 대화형으로 실행합니다. |
npm run test:e2e:electron | renderer, preload, IPC를 통해 Electron을 빌드하고 테스트합니다. |
npm run protocol:check | 고정된 클라이언트, 업스트림 기준선 및 패리티 아티팩트를 검증합니다. |
npm run build | 타입 검사를 수행하고 dist/에 애플리케이션 출력을 빌드합니다. |
npm run build:console | 고정된 네이티브 Sliver 콘솔을 빌드합니다. |
npm run build:rdp:host | 이 머신용 RDP 헬퍼를 빌드하고 검증합니다. |
npm run build:rdp | 두 macOS 슬라이스를 포함한 RDP 패키징 대상을 빌드합니다. |
npm run test:rdp:native | Rust 런타임 테스트를 실행합니다. |
npm run package | release/ 아래에 압축 해제된 애플리케이션을 생성합니다. |
npm run dist | release/ 아래에 플랫폼 설치 프로그램을 생성합니다. |
npm run test:e2e:packaged | 기존 압축 해제된 애플리케이션을 로컬 픽스처에 대해 검증하고 테스트합니다. |
단위 및 컴포넌트 테스트는 소스 파일 옆에 있으며, Electron 시나리오는
src/e2e/에 있습니다. 실제 서버 테스트는 구성된 일회용 인프라가 필요한
별도의 옵트인 검사입니다. 픽스처 테스트는 라이브 서버 또는 설치된 패키지
호환성을 입증하지 않습니다.
프로토콜 검사는 Go를 사용하며 고정된 업스트림 소스를 임시 디렉터리로 가져옵니다. 출처 검사와 명시적으로 선택한 로컬 베이스라인 사용에 대해서는 프로토콜 문서를 참조하십시오.
콘솔 및 배포 빌드에는 Go 1.27.1과
콘솔 출처에 기록된 커밋 및 트리에 있는
정상 상태의 Sliver 체크아웃이 필요합니다. 이를 sliver/에 배치하거나
SLIVER_SOURCE_DIR을 설정하십시오. 콘솔 빌드는 소스를 검증하며,
해당 체크아웃을 가져오거나 수정하지 않습니다.
빌드는 자동 Go 툴체인 전환을 비활성화합니다. 필요한 Go 바이너리를
PATH에 두거나 SLIVER_GO_BINARY를 절대 경로로 설정하십시오. 유니버설 macOS 콘솔
빌드에는 macOS와 /usr/bin/lipo가 필요합니다.
npm run package와 npm run dist는 패키징 전에 네이티브 런타임, 콘솔, 라이선스
인벤토리를 준비합니다. dist/, release/, native/sliver-console/, .e2e-dist/
아래의 생성된 출력은 Git에서 무시됩니다.
native/rdp/bin/ 아래의 생성된 RDP 실행 파일, 출처 정보, Cargo 라이선스 인벤토리도
무시됩니다. 헬퍼 소스와 lockfile은 추적됩니다.
CI 패키징 매트릭스는 다음과 같습니다:
| 플랫폼 | 패키지 | 자동 업데이트 |
|---|---|---|
| macOS 유니버설 | DMG 및 ZIP | 설치된 앱이 ZIP 업데이트를 다운로드합니다. |
| Windows x64 | NSIS 설치 프로그램 및 포터블 EXE | NSIS 설치만 해당; 포터블 빌드는 수동으로 업데이트합니다. |
| Linux x64 | AppImage 및 DEB | AppImage만 해당; DEB 패키지는 수동으로 업데이트합니다. |
지원되는 패키지는 GitHub Releases를 확인하고, 백그라운드에서 업데이트를 다운로드하며, Restart to update 또는 정상적인 애플리케이션 종료 시 설치하도록 구성됩니다. 안정 빌드는 사전 릴리스 업데이트를 허용하지 않습니다. 애플리케이션에 GitHub 토큰이 내장되지 않습니다.
최초 v0.0.1 릴리스는 영구적인 자체 서명 코드 서명 인증서를 사용합니다.
macOS Check for Updates는 첫 업데이트 확인 전에 네이티브 인증서 신뢰 대화상자를
제공하며, 앱은 먼저 Gatekeeper를 통해 실행이 허용되어야 합니다. Windows 설치는
대상 머신에서 공개 서명 인증서를 신뢰해야 합니다. 신뢰 부트스트랩, 공개 지문,
릴리스 키 정책에 대해서는 자체 서명 설치 및 업데이트를
참조하십시오.
빌드 대상과 최소 런타임 인증은 별개입니다. 런타임 요구 사항, 인증 상태, 서명/업데이트 정책에 대해서는 플랫폼 지원 ADR을 참조하십시오.
Electron 메인 프로세스는 백엔드 클라이언트, 운영자 구성 비밀, 네이티브 프로세스, 파일시스템 접근을 소유합니다. 샌드박스 처리된 렌더러는 범위가 좁고 타입이 지정된 preload API를 사용하며, IPC는 호출 문서와 소유 윈도우를 검증합니다.
프로덕션 CSP는 인라인 스크립트와 렌더러 네트워크 연결을 차단하면서
번들 워커와 로컬 WebAssembly 런타임은 허용합니다. 애플리케이션 문서는
sliver://app을 통해 제공되며, 외부 문서와 클라우드 로그인은 시스템 브라우저에서
열립니다. 파괴적 작업은 메인 프로세스 검증과 검토 흐름을 유지합니다. 개발을 위해
이러한 경계를 약화시키지 마십시오.