Olares 助记词备份完全指南:保护 Olares ID 与保险库数据的唯一凭证

原创2026-10-15 09:00:361,455 阅读
文章标签:云原生后端运维

Olares 助记词备份完全指南:保护 Olares ID 与保险库数据的唯一凭证

助记词是由 12 个英文单词组成的随机词序列,是恢复 Olares ID 的唯一方式,也是去中心化身份体系中最关键的私密凭证。本文基于 LarePass 官方文档与 Terminus 仓库源码,系统讲解助记词的生成原理、本地密码设置、查看与离线备份的完整操作步骤,以及丢失助记词后的风险应对与常见问题排查,帮助你在设备丢失或更换设备时安全恢复 Olares 账号访问权限。

助记词是什么:12 个单词背后的身份密码

在 Olares 的去中心化体系里,助记词(Mnemonic)由 12 个单词组成,它是恢复 Olares ID 的唯一方式。如果你的设备丢失,或需要在其他设备上导入 Olares 账号,都必须通过助记词重新获得 Olares 的访问权限。

从仓库源码看,这 12 个单词遵循 BIP39 标准生成,并直接参与身份的密钥派生。cli/pkg/wizard/did_key_utils.go 中的 GenerateMnemonic() 使用 bip39.NewEntropy(128) 生成 128 位随机熵,再通过 bip39.NewMnemonic(entropy) 编码为 12 个单词:

// GenerateMnemonic generates new BIP39 mnemonic
func GenerateMnemonic() string {
	// Generate 128 bits of entropy for 12-word mnemonic
	entropy, err := bip39.NewEntropy(128)
	if err != nil {
		panic(fmt.Sprintf("Failed to generate entropy for mnemonic: %v", err))
	}

	mnemonic, err := bip39.NewMnemonic(entropy)
	if err != nil {
		panic(fmt.Sprintf("Failed to generate mnemonic from entropy: %v", err))
	}

	return mnemonic
}

助记词并非只是一个登录口令,它承担着两层关键职能:

  1. 派生数字身份(DID):同一文件中的 NewHDWalletFromMnemonic 通过 bip39.NewSeed(mnemonic, passphrase) 生成种子,再按 Ed25519 曲线派生公私钥,最终形成 did:key:z... 格式的去中心化标识符(见 createDIDFromPublicKey 与 GetPrivateJWKTrustWalletCore)。也就是说,Olares ID 对应的数字身份本质上是「从助记词确定性派生」出来的,只要助记词不变,身份就不变。
  2. 作为账户主密码:在 cli/pkg/wizard/auth.go 的 UserBindTerminus 流程中,SignupParams.MasterPassword 直接取用助记词本身(MasterPassword: mnemonic),后续所有加密数据都以此为基础进行保护。

:::warning 安全保管助记词 在去中心化系统中,你需要对自己的安全负责。请妥善保管并确保助记词的私密性,切勿与任何人分享。这是恢复 Olares 账号的唯一方式。 :::

正因如此,助记词一旦泄露或被遗忘,损失将是不可逆的。下文将逐步说明如何在 LarePass 中安全地完成首次备份。

备份前置:设置本地密码

首次导出或备份助记词时,系统可能会提示你为 LarePass 设置本地密码。该密码仅用于解锁当前设备上的 LarePass 服务,与 Olares ID 本身无关。

设置本地密码

设置完成后,你可以选择开启生物识别解锁功能,通过面部识别或指纹实现更安全、便捷的访问。

:::info

  • 同一设备上的所有 Olares ID 共用一个 LarePass 本地密码。
  • 不同设备上安装的 LarePass 应用的本地密码相互独立,单独存储。 :::

从源码实现看,这个本地密码实际上是访问助记词等敏感信息前的「第一道门」。在 apps/packages/app/src/components/common/TerminusExportMnemonicRoot.vue 中,点击导出助记词后首先调用 userStore.unlockFirst() 执行解锁校验,若尚未设置密码则触发 busEmit('configPassword') 引导用户配置密码;在桌面端的 apps/packages/app/src/pages/Electron/SettingsPage/DesktopMnemonics.vue 中,查看助记词同样需要先通过 unlockFirst() 解锁,再经登录对话框(DialogLogin)确认身份后才会展示助记词明文。这意味着本地密码是助记词在设备端的第一层访问控制。

在加密层面,cli/pkg/wizard/types.go 中的 Account 结构体表明账户数据使用 AES-GCM(256 位密钥、128 位 Tag)加密,而本地密码通过 PBKDF2(SHA-256、10 万次迭代)派生出解密密钥:

// EncryptionParams represents AES encryption parameters
type EncryptionParams struct {
	Algorithm      string `json:"algorithm"`      // "AES-GCM"
	TagSize        int    `json:"tagSize"`        // 128
	KeySize        int    `json:"keySize"`        // 256
	IV             string `json:"iv"`             // Base64 encoded initialization vector
	AdditionalData string `json:"additionalData"` // Base64 encoded additional data
	Version        string `json:"version"`        // "3.0.14"
}

// KeyParams represents PBKDF2 key derivation parameters
type KeyParams struct {
	Algorithm  string `json:"algorithm"`  // "PBKDF2"
	Hash       string `json:"hash"`       // "SHA-256"
	KeySize    int    `json:"keySize"`    // 256
	Iterations int    `json:"iterations"` // 100000
	Salt       string `json:"salt"`       // Base64 encoded salt
	Version    string `json:"version"`    // "3.0.14"
}

了解这些参数有助于理解本地密码的安全性:即使设备上的加密数据被取出,攻击者仍需暴力破解 PBKDF2 派生的密钥,10 万次迭代显著提高了破解成本。

查看并备份助记词

设置好本地密码后,就可以按照以下步骤在 LarePass 中查看并备份助记词:

  1. 打开 LarePass 应用,进入设置 > LarePass 设置 > 安全页面。
  2. 点击助记词。
  3. 阅读丢失助记词的风险提示,点击开始。
  4. 点击查看 12 个助记词,并输入本地密码进行身份验证。
  5. 安全记录助记词并将其存放在安全的地方。
  6. 点击下一步。

:::warning 离线备份助记词 虽然点击复制可以将助记词保存到剪贴板,但这存在安全风险。为了最大程度保障安全,我们强烈建议离线备份助记词。 :::

  1. 按正确顺序排列助记词以验证备份。
  2. 点击完成。如果排列正确,即表示你已成功备份助记词。

备份助记词

备份验证环节为什么重要

最后一步「按正确顺序排列助记词」并非形式主义,而是对备份完整性的硬校验。LarePass 前端组件 apps/packages/app/src/components/common/TerminusMnemonicsComponent.vue 展示了这一交互的实现细节:

  • 每个助记词输入框在失焦时都会调用 walletService.walletCore.Mnemonic.isValidWord(text) 校验单词是否属于 BIP39 词表,拼写错误会立即标记为错误状态;
  • 粘贴场景下,代码要求剪贴板文本按空格拆分后的单词数量必须与助记词长度一致(text.split(' ').length === mnemonicsLength.value)才会写入输入框;
  • 备份模式下输入框为只读(backupReadonly),用户只能按顺序逐项核对,无法自由修改。

这套交互确保「写下来的 12 个单词」与「实际派生身份的 12 个单词」完全一致——任何一位拼错、顺序颠倒的单词都会在验证环节被拦截,从而避免「自认为备份成功、实际无法恢复」的隐患。

为什么强烈建议离线备份

点击复制虽然能把助记词放入剪贴板,但剪贴板内容可能被其他应用读取、被云同步机制上传、或因系统截图/录屏被意外记录。离线备份(手写记录并存放于保险箱等物理安全位置)从物理层面切断了数字窃取路径,是目前最稳妥的备份方式。

常见问题

如果我丢失了助记词会怎样?

丢失助记词将导致严重后果:

  • 你将失去数字身份(DID)和 Olares ID 的所有权。
  • 无法访问存储在保险库中的数据。

由于 Olares ID 及保险库的加密密钥均由助记词确定性派生(见上文 did_key_utils.go 的实现),助记词丢失意味着没有任何「找回」通道——这正是去中心化系统「自我托管、自我负责」的特性。

为防止这种情况,我们强烈建议采取以下预防措施:

  • 离线备份:将 12 个助记词写下来并安全保管,比如存放在保险箱中。
  • 多设备备份:使用 LarePass 的保险库功能加密保存助记词在多个设备上。只有当所有这些设备都丢失时,你才会失去助记词。

我已经激活了 Olares,为什么在 LarePass 中查看助记词时提示密码错误?

如果遇到密码错误,可能是因为你还没有设置本地密码。打开 LarePass 应用,进入设置 > LarePass 设置 > 安全,设置本地密码后再尝试备份。

结合上文源码可知,「查看助记词」的前置条件是 unlockFirst() 解锁成功:若从未设置过本地密码,系统会走 configPassword 流程而非直接放行,此时若输入了不存在的密码自然会报错。请先完成本地密码的初始化,再返回助记词页面进行查看与备份。

助记词的其他关键用途与关联操作

备份完成后,助记词还会在以下场景持续发挥作用,建议一并了解:

  • 跨设备导入账户:在新设备或其他 LarePass 客户端(移动端、桌面端、Chrome 扩展)上使用已有 Olares ID 时,需要通过 12 个助记词导入账户。完整的导入步骤见在 LarePass 中管理账户,该文档也特别提示:导入 Olares ID 需要对应的 12 个助记词,如果尚未获取,请先按本文完成备份。
  • 删除账户前的强制要求:LarePass 规定,未备份助记词的账户无法删除。这是因为删除账户是不可逆操作,系统强制要求你先持有可恢复凭证,避免「删库又丢钥匙」的双重损失。
  • 恢复与重置:在账户恢复(AuthPurposeRecover)等认证场景中,助记词同样是核心凭证。相关认证类型与目的定义可参见 cli/pkg/wizard/types.go 中的 AuthType、AuthPurpose 枚举。

总结:一份值得反复核对的安全清单

结合 LarePass 官方文档与仓库源码,备份助记词的最佳实践可以浓缩为以下清单:

  1. 先设本地密码:首次备份前,在 LarePass 设置 > LarePass 设置 > 安全中完成本地密码初始化,可选的生物识别解锁可进一步提升体验与安全;
  2. 全程私密:查看助记词时确保周围无人、无摄像头,避免任何形式的截屏与录屏;
  3. 离线优先:手写 12 个单词并按顺序记录,存放于保险箱等物理安全位置;不要依赖剪贴板、云笔记或聊天软件保存;
  4. 顺序正确:利用 LarePass 的排列验证环节逐词核对,确认单词拼写与先后顺序均正确;
  5. 冗余备份:条件允许时,利用 LarePass 保险库功能在多个设备上加密保存助记词,抵御单点丢失;
  6. 定期自查:更换设备、重装系统前后,确认助记词备份仍然可用(例如在其他设备上尝试导入)。

助记词是你进入 Olares 去中心化世界的「唯一钥匙」:它在 BIP39 标准下生成、在 Ed25519 密钥派生中定义你的数字身份、在 AES-GCM 加密体系中保护你的保险库数据。请务必按照本文步骤完成一次完整、可验证的离线备份,并在日常使用中始终将其视为最高等级的机密。

登录后查看全文
Terminus