はじめに

インストール

QubKey デスクトップを macOS、Windows、Linux にインストールします。拡張と同期に必要です。

QubKey は、エコシステムの中核を形成する ネイティブ デスクトップ アプリケーションです。オペレーティング システム用のインストーラーをダウンロードし、以下の手順に従います。

QubKey エコシステムには、デスクトップ アプリ (必須 - ボールト、暗号化、管理) と ブラウザ拡張機能 (オプション - ネイティブ メッセージングによる自動入力) が含まれています。自分のデバイス間での オプションの同期 は、ローカル ファースト モデル (クラウド フォルダー、.rkvey ファイルの手動コピー) を補完できます。デスクトップ アプリを最初にインストールする必要があります。拡張機能はそれに依存します。

インストール順序

QubKey デスクトップ アプリ

これは、.rkvey ボールト、すべての暗号化 (Argon2id、AEAD)、およびシークレット管理を管理します。これがなければ拡張機能は機能しません。

ブラウザ拡張機能 (オプション)

デスクトップアプリがインストールされ、コンテナーが作成されたら、ブラウザ拡張機能ページ (OS に一致する macOS または Windows パッケージ) から Chrome または Firefox 拡張機能をダウンロードし、ネイティブ メッセージングを構成して、拡張機能を接続します。

オプションの同期 (オプション)

組み込み マルチデバイス同期 (QubKey クラウドまたはセルフホスト サーバー、設定で有効)、または暗号化された .rkvey ファイルの手動コピー/同期 (クラウド固定、USB ドライブ)。

システム要件

Operating system

macOS (Apple Silicon) および Windows 10/11 (NSIS/MSI) をダウンロードできます。 Linux は現在開発中です。リリース ノートとサイトのダウンロード ページを参照してください。

RAM

4 GB 最小 — 8 GB を推奨。 Argon2id はロック解除ごとに 64 MB を使用します。 RAM が不十分だと、ボールトを開くのが遅くなる可能性があります。

Disk space

アプリケーション用に 200 MB

WebView

WebView2 (Windows) または WebKit — Tauri 経由で macOS/Linux にバンドルされています

ダウンロード

プラットフォームのインストール

Apple Silicon (arm64) .dmgmacOS ページ からダウンロードします。

公開された SHA-256 フィンガープリントを確認し、.dmg を開き、QubKey を /Applications にします。

初回起動時: 右クリック → Gatekeeper に警告が表示された場合は開く (Mac App Store 以外のアプリ)

macOS のプロンプトが表示された場合は、ディスクとドキュメントへのアクセスが許可されます。

利用可能な NSIS/MSI インストーラー (x64 または x86) については、Windows ページ を確認してください。

インストーラーをダブルクリックし、ウィザードに従います (インストールフォルダーを選択します)。

プロンプトが表示されたら、WebView2 のインストールを受け入れます (Tauri UI に必要)

[スタート] メニューから QubKey を起動します - Windows のプロンプトが表示された場合はファイルへのアクセスを許可します

Linux

Linux バージョンは現在開発中です。AppImage、.deb、または .rpm パッケージはまだサイトで提供されていません。発表については、ダウンロードページに従ってください。

整合性の検証

バイナリの整合性

インストールする前に必ず設定または SHA256 ハッシュを確認してください。これにより、ビルドとマシン (サプライチェーン) の間でバイナリが改ざんされないことが保証されます。

shasum -a 256 QubKey_2.0.0_aarch64.dmg

ダウンロードページ または リリースノート (ビルドごとのテーブル) のハッシュと比較します。

インストール後

トラブルシューティング

Missing WebView2 (Windows)

Tauri では UI を表示するために WebView2 が必要です。インストーラーが提供していない場合は、microsoft.com/edge/webview2 からダウンロードします。

Gatekeeper blocks (macOS)

公証されていないビルドの場合: 右クリック → 開く。または、xattr -cr /Applications/QubKey.app を使用して隔離を解除します。

Missing dependencies (Linux)

Tauri には webkit2gtk が必要です。 Debian/Ubuntu: sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1