Install

安装 Oak Keyring 预览版。

Oak Keyring 是一个隐私优先、本地优先的密码管理器,提供键盘驱动的终端界面。Homebrew 是当前预览版推荐的 macOS 安装路径。

推荐

Homebrew tap

常规 macOS 安装建议使用 OpenKeyring Homebrew tap。如果你的 Homebrew 环境要求 trusted taps,请在安装前 trust Oak Keyring formula。

brew tap openkeyring/oak-keyring # 如果启用了 HOMEBREW_REQUIRE_TAP_TRUST: brew trust --formula openkeyring/oak-keyring/ok brew install ok ok --version

如果你的 Homebrew 配置不要求 tap trust,可以跳过 trust 这一行,tap 之后直接安装。

Alternative

npm package

npm 渠道适合希望通过 Node 包管理器使用 Oak Keyring bundled binary 的用户。

npm install -g @openkeyring/ok ok --version

它仍然遵循同样的预览边界:当前 packaged binaries 仅面向 macOS Apple Silicon 和 Intel。

Manual

GitHub Release 二进制

如果你希望直接下载,或自己检查 checksums,可以使用 GitHub Release assets。请按你的 Mac 选择 Apple Silicon 或 Intel 产物。

open https://github.com/OpenKeyring/oak-keyring/releases/tag/v0.8.0-preview.1 ok --version

这些构建是 unsigned 且未 notarized。macOS Gatekeeper 可能要求你在 System Settings 中批准,或通过系统的 Open 确认流程继续。

Developer

从源码构建

源码构建适合开发或源码审查。当前构建会把用于同步的 Google OAuth2 配置编译进二进制;如果需要测试 Google Drive 同步,请在构建前显式配置 OAuth2 值。

git clone https://github.com/OpenKeyring/oak-keyring.git cd oak-keyring cp .env.example .env # 编辑 .env,设置 OAK_GOOGLE_CLIENT_ID 和 OAK_GOOGLE_CLIENT_SECRET。 cargo build --release ./target/release/ok --version

如果只是做不触发同步的开发检查,placeholder OAuth values 足以满足 build script。源码构建不会把预览版变成稳定公开发布,也不代表已经完成面向生产密码管理工作流的审计。