PearPass Mobile：端到端加密密码管理器

项目简介

PearPass Mobile 是 PearPass 的移动端应用，一个开源、隐私优先的密码与身份管理器。它把密码、信用卡、安全笔记和自定义字段加密后保存在你的设备本地，让你完全掌控自己的敏感信息。

与依赖中心化服务器的传统密码管理器不同，PearPass 构建在 Pear Runtime 之上，通过点对点技术在你的设备之间直接同步凭据，无需经过第三方服务器，数据始终私密、安全并掌握在自己手中。

⚠️ 注意：PearPass 目前暂停了活跃开发，在另行通知前请谨慎使用。

主要功能

• 静态加密存储：密码、信用卡、安全笔记和自定义字段在写入磁盘前即完成加密。
• 生物识别解锁：使用指纹或面容识别解锁保险库。
• 跨设备同步：设备之间直接同步凭据，不依赖中心服务器。
• 离线访问：没有网络连接时也可以随时访问保险库。
• 密码健康分析：评估密码强度，识别弱密码。
• 随机密码生成器：生成高强度、唯一密码。
• 简洁易用界面：为移动场景设计的清晰界面，方便随时管理凭据。
• 可选本地日志：可在「设置 → 诊断 → Enable logs」开启，日志写入应用缓存目录，仅用于排查问题。

安装与使用

环境要求

• Node.js：所需版本见仓库的 .nvmrc，可用以下命令确认：

node --version

安装步骤

# 1. 克隆仓库
git clone [email protected]:tetherto/pearpass-app-mobile.git

# 2. 进入目录
cd pearpass-app-mobile

# 3. 安装依赖
npm install

# 4. 生成翻译键
npm run lingui:extract
npm run lingui:compile

# 5. 生成 worklet 打包文件
npm run bundle-bare

# 6. 生成原生 iOS 与 Android 目录
npx expo prebuild --clean

构建与启动

先执行构建，构建命令会产出 iOS、iOS 扩展与 Android 的打包文件，并运行自定义 prebuild：

# 构建应用
npm run build

# 在目标平台启动
npm run ios      # iOS
npm run android  # Android

Prebuild 说明

仓库由 Expo 管理，ios/ 和 android/ 目录不被 Git 跟踪，由 prebuild 动态生成，所有原生配置由 plugins/ 目录中的 Expo 插件管理。

标准（Play / 普通）Android prebuild：

npm run bundle-bare
npx expo prebuild --platform android --clean

F-Droid Android prebuild：

npm run bundle-bare
PEARPASS_DISTRIBUTION=fdroid npx expo prebuild --platform android --clean

更多细节见仓库中的 docs/fdroid/build.md 与 docs/fdroid/version-check.md。

测试

npm test   # Jest 单元测试

端到端测试使用 WebdriverIO + Appium，在 Android 与 iOS 上运行，并可选 BrowserStack 执行与 Qase 测试管理，完整说明见 e2e/SETUP_AND_RUN_GUIDE.md。

技术栈

React Native、Expo、React、React Navigation、Lingui、Redux。

使用文档

设置、保险库管理、跨设备同步、浏览器扩展等功能的逐步指南，请访问官方文档：docs.pass.pears.com。

注意事项

• 项目当前已暂停活跃开发，请谨慎用于重要数据。
• 日志默认关闭。开启后，JS 端的 main.log 不做脱敏处理，请勿把敏感信息传给 logger.*；Bare worker 的 core-logs.txt 会在写入前对已知敏感字段（密码、密钥、令牌等）做脱敏。
• 关于错误上报：公开版本与自行构建的版本不会向任何地方发送数据，Sentry 仅在我们的 nightly 分发渠道启用，用于预发布阶段的崩溃捕获。
• 本项目采用 Apache License 2.0 许可。

相关项目

项目	说明
pearpass-app-desktop	PearPass 桌面端应用
pearpass-lib-vault	保险库管理库
pearpass-lib-vault-core	PearPass 保险库的 Bare worker 与客户端
pearpass-lib-ui-react-native-components	React Native UI 组件库
pearpass-lib-ui-react-components	React UI 组件库

---

本作品整理自 GitHub 开源项目 tetherto/pearpass-app-mobile，原作者 @tetherto。中文介绍由 AI 根据项目 README 整理，以原仓库为准。