企业官网建设流程全解析

• 云原生
• 后端
• 运维

本文以 Olares 系统应用 Vault（LarePass 密码管理器的核心组件）为基础操作手册，讲解如何设置本地密码与助记词保护、创建和导入 Vault 项目、利用标签/收藏/筛选组织敏感数据，并结合开源仓库中的 SDK 与前端源码印证项目类型模板、字段类型定义、导入格式支持与同步机制，帮助你把密码、OTP、数字身份等机密数据高效且安全地管理起来。

了解 Vault 组件

Vault 是 Olares 中的密码管理器，用于安全存储和管理私钥与密码、数字身份（DIDs）、Olares ID、一次性密码（OTP）等敏感数据。其关键特性包括：端到端加密、私有与共享 Vault 并存、跨设备同步、自动填充登录凭据，以及 2FA 双因素认证支持。服务端组件运行在 Olares 上，负责同步单个用户的多个客户端设备（Olares 系统应用、LarePass 桌面端与移动端）；数据在传输与存储过程中使用私钥加密。

Vault 类型

Olares 为用户提供两种主要类型的 Vault：

• 主 Vault（我的 Vault）：账户激活时自动创建，作为用户的私人 Vault，使用用户助记词加密以确保最大安全性。
• 共享 Vault（Team Vault）：Olares 内的协作 Vault，支持团队成员或家庭之间安全共享信息。

团队 Vault 的创建、权限分配与删除流程可参考 共享 Vault 项目：所有集群管理员和成员会自动加入 Vault 的My Team团队，所有者可为成员设置**读/写（Editable）或只读（ReadOnly）**权限。

Vault 项目结构

Vault 项目是存储敏感信息的独立安全容器。每个 Vault 项目包含以下组成部分：

• 名称：便于识别的标题。
• 标签：用于组织和快速筛选。
• 字段：存储不同类型信息的数据区域。
• 历史记录：记录项目修改信息。
• 附件：添加相关文件。
• 过期时间：为时间敏感的信息设置过期日期。

从源码结构看，这些能力对应前端项目详情页的实现：编辑、附件与历史记录入口集中在 ItemView.vue 中，历史记录单独由 HistoryEntryDialog.vue 对话框承载，Vault 为每个项目保留多达 10 条修改记录，超过限制时删除较旧的记录。

项目类型

目前，Vault 支持以下 9 种项目类型：网站/应用、计算机、信用卡、银行账户、Wi-Fi 密码、护照、验证器、文档、自定义。

这些类型并非只是界面标签，SDK 中为每种类型预定义了字段模板。在 item.ts 中可以确认各类型的内建字段，例如：

字段类型

字段是 Vault 项目的核心组件。SDK 中 FieldType 枚举 定义了完整的字段类型清单，与文档中列举的存储数据类型一一对应：

• 用户名（username）
• 密码（password）
• 助记词（mnemonic）
• 电子邮件地址（email）
• URL（url）
• 日期和月份（date/month）
• 信用卡号（credit）
• 电话号码（phone）
• PIN（pin）
• 明文（text）
• 一次性密码（totp，另含note多行备注字段）

每个字段类型在 FIELD_DEFS 中带有完整元数据：pattern（内容校验正则）、mask（显示时是否打码）、multiline（是否支持多行）、icon（展示图标）、format（格式化显示）以及transform（复制/自动填充前的值转换，例如 TOTP 字段会实时计算出码值）。这套元数据机制保证了密码类字段默认掩码显示、URL 类字段可自动跳转等体验。

使用本地密码保护 Vault

首次在 Olares 中使用 Vault 时，系统会提示你设置本地密码。此密码不应与你的 Olares 登录密码相同。

1. 为 Vault 设置本地密码。
2. 使用助记词短语导入已与 Olares 服务器关联的 Olares ID。

如果你不知道助记词短语的位置，请参阅 备份助记词短语。

从实现上看，Vault 应用启动时会加载钱包服务并以 Olares ID 推导 SSI 环境，见 VaultApplication；多设备同步则依赖与 Olares 上 vault 模块服务的 WSS 长连接，连接地址由 getWSConnectUrl 通过getModuleSever('vault', 'wss:', '/ws')动态解析——这正是“服务器组件运行在 Olares 上，同步单个用户多个客户端”这一描述的代码依据。

管理 Vault 项目

从一开始就使用描述性名称和相关标签来组织 Vault 项目。随着项目数量增加，这种做法会越来越有价值。

添加

Olares 系统应用：

1. 打开Vault，在右上角点击add（+）按钮。
2. 选择一种类型（例如网站/应用），点击创建。

3. 填写必填字段，例如项目名称、用户名、密码和 URL。

4. 点击保存创建新的 Vault 项目。

LarePass 桌面端/移动端：

1. 在设备上打开LarePass，导航到应用中的Vault页面。
2. 点击右上角的add（+）按钮。
3. 选择一种类型（例如网站/应用），点击创建。
4. 填写必填字段，例如项目名称、用户名、密码和 URL。
5. 点击保存创建新的 Vault 项目。

导入

你可以从其他主流密码应用（如 1Password 和 Bitwarden）导入密码项目，前端文件选择器支持的导入格式为text/plain、.csv、.pls、.set、.pbes2、.1pux、.json，对应 VaultFileImportComponent.vue 中的accept属性。

导入仅支持在 LarePass 桌面版客户端完成。

操作步骤：

1. 打开 LarePass，点击主界面左上角头像区域。
2. 导航至设置>导入。
3. 选择待导入文件，如bitwarden_export.json。
4. 选择导入目标 Vault。默认为My Vault，也可以选择你创建的团队共享 Vault。
5. 点击确认完成导入。

此时可以去目标 Vault 空间里查看导入的项目。这些项目会自动带上导入文件名的标签，方便查找和管理。

从源码结构看，SDK 的 import.ts 中supportedFormats实际覆盖的解析器比文件格式列表更宽，包括：CSV（通用列映射）、Padlock (v2) 旧格式、LastPass、PBES2 加密容器（Encrypted Container，即.pbes2）、1Password（.1pux，由专门的 1pux-parser.ts 解析）、Bitwarden（JSON）、Dashlane（CSV）、KeePass（CSV）、NordPass（CSV）、iCloud（CSV）、Chrome（CSV）与 Firefox（CSV）。.pls（LastPass 加密 CSV）与.set等格式会走 CSV 分支并要求提供密码进行解密。也就是说，只要导出文件来自上述任一产品，基本都能被识别。

编辑

如需完整编辑功能，请使用 Olares 的 Vault 应用或 LarePass 的移动或桌面版本。

在编辑模式下，你可以：

• 更新必填字段。
• 为项目添加标签以便组织和筛选。
• 设置过期时间。
• 添加文件附件（每个文件不得超过 1 MB）。
• 查看并恢复历史记录。Vault 为每个项目保留多达 10 条记录，超过限制时会删除较旧的记录。

编辑 Vault 项目：

1. 在 Vault 中选择需要编辑的项目。
2. 在项目的详情窗口或页面中，点击右上角的edit_note（铅笔）图标进入编辑模式。
3. 对项目详情进行必要的修改。
4. 点击保存。

关于附件大小，需要说明一个仓库内的事实差异：本手册给出的限制是“每个文件不得超过 1 MB”，而前端附件上传校验 ItemView.vue 中_addFileAttachment的判断是file.size > 5 * 1024 * 1024时提示“仅支持最大 5M 的文件”。可以推断不同客户端/版本执行的上限存在差异，实际操作请以所用客户端的实际提示为准。

收藏 Vault 项目

重要项目可以标记为收藏，便于快速访问。

Olares 系统应用：

1. 在 Vault 中，点击项目，右侧打开其详情窗口。
2. 点击右上角的star_border（星形）图标将该项目标记为收藏。

LarePass 桌面端/移动端：

1. 在设备上打开 LarePass，导航到应用中的Vault页面。
2. 点击项目以进入其详情页面。
3. 点击右上角的star_border（星形）图标将该项目标记为收藏。

筛选与搜索 Vault 项目

你可以使用快速筛选或搜索框找到所需的 Vault 项目。

快速筛选

• 按主 Vault 和共享 Vault：选择我的 Vault或团队 Vault快速找到项目。
• 按标签：点击标签名称轻松定位已标记的 Vault 项目（导入的项目会自动带上源文件名标签，可借此快速找回某次导入的全部条目）。
• 按收藏：点击收藏列出所有收藏项目。
• 按最近使用：点击最近使用显示你的最近项目。
• 按附件：点击附件显示所有带有附件的项目。

关键词搜索

点击search（放大镜）图标，使用关键词直接搜索目标项目。

延伸阅读

• 共享 Vault 项目：管理团队 Vault 和共享项目，设置成员读/写权限。
• 使用 LarePass 自动填充：在多设备间自动填充登录信息。
• 设置两步验证码：生成并存储 2FA 验证码，配合本文的“验证器”项目类型使用。
• 备份助记词短语：保管好主 Vault 的解密密钥。
• 源码入口：项目类型模板与字段定义见 apps/packages/sdk/src/core/item.ts，多格式导入解析见 apps/packages/sdk/src/import.ts，Vault 应用启动与多端同步见 apps/packages/app/src/application/vault.ts。

• 云原生
• 后端
• 运维