설치
macOS, Windows 및 Linux에 QubKey 데스크탑을 설치하세요. 확장 및 동기화에 필요합니다.
QubKey는 생태계의 핵심을 형성하는 네이티브 데스크탑 애플리케이션입니다. 운영 체제에 맞는 설치 프로그램을 다운로드하고 아래 단계를 따르십시오.
QubKey 에코시스템에는 데스크톱 앱(필수 – 금고, 암호화, 관리) 및 브라우저 확장 프로그램(선택 사항 – 기본 메시징을 통한 자동 채우기)이 포함되어 있습니다. 자신의 장치 전반에 걸친 선택적 동기화는 로컬 우선 모델(클라우드 폴더, .rkvey 파일의 수동 복사본)을 보완할 수 있습니다. 데스크톱 앱을 먼저 설치해야 합니다. 확장 프로그램은 이에 따라 달라집니다.
설치 순서
QubKey 활동 앱
기본 앱을 먼저 설치하세요. .rkvey 문서, 모든 문서(Argon2id, AEAD) 및 비밀 관리를 관리합니다. 그것 밖에는 확장이 작동하지 않습니다.
브라우저 확장 (선택사항)
데스크톱 앱이 설치되고 Vault가 생성되면 브라우저 확장 프로그램 페이지(OS와 일치하는 macOS 또는 Windows 패키지)에서 Chrome 또는 Firefox 확장 프로그램을 다운로드하고 기본적으로을 구성한 다음 확장 프로그램을 연결하세요.
선택적 동기화 (선택 사항)
내장 장치 캠프(QubKey 클라우드 또는 자체 서버, 설정에서 활성화) 또는 플러그인된 .rkvey 파일(클라우드 폴더, USB 드라이브)의 매뉴얼 복사/동기화.
시스템 요구사항
Operating system
macOS(Apple Silicon) 및 Windows 10/11(NSIS/MSI)을 다운로드할 수 있습니다. Linux 개발이 진행 중입니다. 릴리스 노트와 사이트 다운로드 페이지를 참조하세요.
RAM
4GB 최소 — 8GB 권장. Argon2id는 잠금 해제당 64MB를 사용합니다. RAM이 부족하면 저장소 열기 속도가 느려질 수 있습니다.
Disk space
애플리케이션용 200MB
WebView
WebView2(Windows) 또는 WebKit — Tauri를 통해 macOS/Linux에 번들로 제공됨
다운로드
macOS
Apple Silicon(arm64) .dmg — Mac App Store 외부. 다운로드 페이지에서 SHA-256 해시를 확인하세요.
윈도우
Windows 10/11(x64 또는 x86)용 NSIS/MSI 설치 프로그램 - 사용 가능한 패키지는 전용 페이지를 참조하세요.
리눅스
활발하게 개발 중입니다. 아직 Linux 다운로드가 게시되지 않았습니다.
플랫폼 설치
macOS 페이지에서 Apple Silicon(arm64) .dmg을 다운로드하세요.
게시된 SHA-256 SSD를 확인하고 .dmg을 포함하는 QubKey를 /Applications로 드래그합니다.
처음 실행 시: 마우스 오른쪽 버튼 클릭 → Gatekeeper에 경고가 표시됩니다(Mac App Store 외부 앱)
macOS에서 메시지가 표시되면 디스크 및 문서 폴더에 액세스 권한을 부여하세요.
사용 가능한 NSIS/MSI 설치 프로그램(x64 또는 x86)은 Windows 페이지에서 확인하세요.
설치 프로그램을 두 번 클릭하고 마법사의 지시를 따릅니다(설치 폴더 선택).
WebView2 설치(Tauri UI에 필요)
시작 메뉴에서 QubKey를 실행합니다. Windows에서 메시지 표시 파일에 액세스 권한을 부여합니다.
ㅇ
Linux 버전은 현재 개발 중입니다. AppImage, .deb 또는 .rpm 패키지는 아직 사이트에 제공되지 않습니다. 공지사항을 다운로드하여 추가하세요.
무결성 검증
설치 후
문제 해결
Missing WebView2 (Windows)
Tauri는 UI를 표시하려면 WebView2가 필요합니다. 설치 프로그램에서 제공하지 않는 경우 microsoft.com/edge/webview2에서 다운로드하세요.
Gatekeeper blocks (macOS)
공증되지 않은 빌드의 경우: 마우스 오른쪽 버튼을 클릭하고 → 열기를 클릭하세요. 또는: xattr -cr /Applications/QubKey.app를 사용하여 격리를 제거합니다.
Missing dependencies (Linux)
Tauri에는 webkit2gtk가 필요합니다. 데비안/우분투: sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1