# 关于

> 个人精力有限，部分细节内容可能不会随官方同步更新！

***

这里是对 Bitwarden 官方 [Bitwarden Help Center](https://bitwarden.com/help/) 的简体中文翻译，同时参考了 Github 上的 [bitwarden / help](https://github.com/bitwarden/help) 存储库（已停止更新）内容。

译者：[@wcjxixi](mailto:wcjxixi@gmail.com)

致谢 [Google Translate](https://translate.google.com/) 以及 [DeepL](https://www.deepl.com/)！

{% hint style="warning" %}
个人能力有限，具体请以官方 [Bitwarden Help Center](https://bitwarden.com/help/) 页面为准。使用本内容所产生的一切后果，与 @wcjxixi 无关。Use at your own risk！！！
{% endhint %}

{% hint style="info" %}
**备注：**标题前有 \* 的表示官方曾经有但现已移除的页面和/或分类，我将其保留仅作为参考之用。
{% endhint %}

## Bitwarden 介绍 <a href="#about-bitwarden" id="about-bitwarden"></a>

Bitwarden 是一个开源的密码管理系统，您可以使用 Bitwarden 官方提供的云服务，也可以将 Bitwarden 安装和托管在自己的服务器上。

个人账户的免费版不限制使用时间、不限制密码条目数、不限制设备数量、不限制文件夹数量、支持常见的验证器 App（如 [Authy](https://authy.com/)、[Microsoft Authenticator](https://www.microsoft.com/en-us/account/authenticator)、[Google Authenticator](https://github.com/google/google-authenticator)），完全可以满足大部分个人的日常使用需求。

需要使用高级功能（如 TOTP、文件附件等），可以选择个人账户的高级版，或者使用组织账户。

{% hint style="success" icon="lightbulb" %}
从 [2025.12.2](https://help.ppgg.in/pages/-MNXLa0A2fbW2RZGFkwT#id-2025.12.2) 开始，高级版订阅和付费版组织的初始存储空间由 1 GB 提高为 5 GB。
{% endhint %}

## 个人账户比较 <a href="#compare-individual-plans" id="compare-individual-plans"></a>

<table data-search="true"><thead><tr><th>功能</th><th>免费版</th><th>高级版</th></tr></thead><tbody><tr><td>价格</td><td>免费</td><td>$19.80/年<sup><mark style="color:red;"><strong>a</strong></mark></sup></td></tr><tr><td>安装所有平台程序</td><td>支持</td><td>支持</td></tr><tr><td>无限制同步所有设备</td><td>支持</td><td>支持</td></tr><tr><td>项目数量</td><td>无限制</td><td>无限制</td></tr><tr><td>文件夹数量</td><td>无限制</td><td>无限制</td></tr><tr><td>密码生成器</td><td>支持</td><td>支持</td></tr><tr><td>初始存储空间</td><td>无</td><td>5 GB</td></tr><tr><td>附加存储</td><td>不支持</td><td>$4.00/GB/年</td></tr><tr><td>两步登录类型</td><td>验证器 App + 电子邮箱 + FIDO2 WebAuthn</td><td>免费版 + YubiKey + Duo</td></tr><tr><td>内置 TOTP 功能</td><td>不支持</td><td>支持</td></tr><tr><td>Bitwarden Send</td><td>文本</td><td>文本 + 文件</td></tr><tr><td>紧急访问</td><td>不支持</td><td>支持</td></tr><tr><td>数据泄漏报告</td><td>支持</td><td>支持</td></tr><tr><td>健康报告</td><td>不支持</td><td>支持</td></tr><tr><td>本地托管</td><td>支持</td><td>支持</td></tr><tr><td>免费试用</td><td>-</td><td>不支持</td></tr><tr><td>付款周期</td><td>-</td><td>年付</td></tr></tbody></table>

<sup><mark style="color:red;">**a**<mark style="color:red;"></sup> - 2023 年 11 月 06 日提价为 $19.80/年，老用户续费价格维持为 $10.00/年。2026 年起，老用户续费价格提价为 $19.80/年（有一次性的 25% 忠诚度折扣，折后 $14.85/年）。

## 组织账户比较 <a href="#compare-organization-plans" id="compare-organization-plans"></a>

Bitwarden 还提供组织版账户（用于密码共享等），分别为针对个人使用的免费版、家庭版，针对商业使用的团队版和企业版。

{% tabs %}
{% tab title="2020-08-31 之前" %}

<table data-search="true"><thead><tr><th>功能</th><th>免费版</th><th>家庭版</th><th>团队版</th><th>企业版</th></tr></thead><tbody><tr><td>初始价格</td><td>免费</td><td>$1.00/月</td><td>$5.00/用户/月</td><td>$3.00/用户/月</td></tr><tr><td>初始用户数</td><td>2</td><td>5</td><td>5</td><td>1</td></tr><tr><td>附加用户</td><td>不支持</td><td>不支持</td><td>$2.00/用户/月</td><td>$3.00/用户/月</td></tr><tr><td>最大用户数</td><td>2</td><td>5</td><td>无限制</td><td>无限制</td></tr><tr><td>共享条目数</td><td>无限制</td><td>无限制</td><td>无限制</td><td>无限制</td></tr><tr><td>集合数量</td><td>2</td><td>无限制</td><td>无限制</td><td>无限制</td></tr><tr><td>初始存储空间</td><td>无</td><td>1 GB</td><td>1 GB</td><td>1 GB</td></tr><tr><td>附加存储</td><td>不支持</td><td>$0.33/GB/月</td><td>$0.33/GB/月</td><td>$0.33/GB/月</td></tr><tr><td>群组控制</td><td>不支持</td><td>不支持</td><td>不支持</td><td>支持</td></tr><tr><td>企业策略</td><td>不支持</td><td>不支持</td><td>不支持</td><td>支持</td></tr><tr><td>审核日志</td><td>不支持</td><td>不支持</td><td>不支持</td><td>支持</td></tr><tr><td>目录同步</td><td>不支持</td><td>不支持</td><td>不支持</td><td>支持</td></tr><tr><td>高级功能</td><td>无</td><td>无</td><td>无</td><td>有</td></tr><tr><td>高级功能购买</td><td>不支持</td><td>$3.33/月</td><td>不支持</td><td>-</td></tr><tr><td>本地托管</td><td>不支持</td><td>支持</td><td>不支持</td><td>支持</td></tr><tr><td>7 天免费试用</td><td>-</td><td>支持</td><td>支持</td><td>支持</td></tr><tr><td>付款周期</td><td>-</td><td>年付</td><td>年付/月付</td><td>年付/月付</td></tr></tbody></table>
{% endtab %}

{% tab title="2020-08-31 之后" %}

<table data-search="true"><thead><tr><th>功能</th><th>免费版</th><th>家庭版</th><th>团队版</th><th>企业版</th></tr></thead><tbody><tr><td>初始价格</td><td>免费</td><td>$3.99/月</td><td>$4.00/用户/月<sup><mark style="color:red;"><strong>a</strong></mark></sup></td><td>$6.00/用户/月<sup><mark style="color:red;"><strong>a</strong></mark></sup></td></tr><tr><td>初始用户数</td><td>2</td><td>6</td><td>1</td><td>1</td></tr><tr><td>附加用户</td><td>不支持</td><td>不支持</td><td>$4.00/用户/月<sup><mark style="color:red;"><strong>a</strong></mark></sup></td><td>$6.00/用户/月<sup><mark style="color:red;"><strong>a</strong></mark></sup></td></tr><tr><td>最大用户数</td><td>2</td><td>6</td><td>无限制</td><td>无限制</td></tr><tr><td>共享条目数</td><td>无限制</td><td>无限制</td><td>无限制</td><td>无限制</td></tr><tr><td>集合数量</td><td>2</td><td>无限制</td><td>无限制</td><td>无限制</td></tr><tr><td>初始存储空间</td><td>无</td><td>5 GB</td><td>5 GB</td><td>5 GB</td></tr><tr><td>附加存储</td><td>不支持</td><td>$0.33/GB/月</td><td>$0.33/GB/月</td><td>$0.33/GB/月</td></tr><tr><td>Bitwarden Send</td><td>文本</td><td>文本 + 文件</td><td>文本 + 文件</td><td>文本 + 文件</td></tr><tr><td>群组控制</td><td>不支持</td><td>不支持</td><td>支持</td><td>支持</td></tr><tr><td>企业策略</td><td>不支持</td><td>不支持</td><td>不支持</td><td>支持</td></tr><tr><td>审核日志</td><td>不支持</td><td>不支持</td><td>支持</td><td>支持</td></tr><tr><td>目录同步</td><td>不支持</td><td>不支持</td><td>支持</td><td>支持</td></tr><tr><td>SSO 登录</td><td>不支持</td><td>不支持</td><td>不支持</td><td>支持</td></tr><tr><td>高级功能</td><td>无</td><td>有</td><td>有</td><td>有</td></tr><tr><td>高级功能购买</td><td>不支持</td><td>-</td><td>-</td><td>-</td></tr><tr><td>本地托管</td><td>不支持</td><td>支持</td><td>不支持</td><td>支持</td></tr><tr><td>7 天免费试用</td><td>-</td><td>支持</td><td>支持</td><td>支持</td></tr><tr><td>付款周期</td><td>-</td><td>年付</td><td>年付/月付</td><td>年付/月付</td></tr></tbody></table>

<sup><mark style="color:red;">**a**<mark style="color:red;"></sup> - 按年付款折算的价格（按月付款折算则分别为团队版 $5.00/用户/月、企业版 $7.00/用户/月）
{% endtab %}
{% endtabs %}

部分功能解释：

* **文件夹**：Bitwarden 里面的文件夹可以理解为「分类」，您可以把任何类型（登录、支付卡、身份或安全笔记）的项目放到某个「文件夹」中。
* **内置 TOTP**：相当于内置了一个类似 [Authy](https://authy.com/) 这样的两步验证管理工具，这样就不需要再单独安装两步验证 App 了，并且支持在自动填充登录后将 TOTP 自动复制到剪贴板。
* **两步登录类型**：这里的两步登录类型是针对登录 Bitwarden 的两步登录，与 Bitwarden 之外的其他网站或 App 的两步登录没关系。

## 价格和账单 <a href="#price-and-billing" id="price-and-billing"></a>

1. 免费试用付费版组织订阅：必须先订阅才能试用（订阅时需要输入付款信息），7 天免费试用期结束时，才会从您的付款方式中扣款。**记得在 7 天免费试用期内主动取消订阅**。
2. 支持订阅开始日期 30 天内无条件退款（需要给 [Bitwarden 支持](https://bitwarden.com/contact/)发邮件）。

### 组织价格比较 <a href="#compare-price" id="compare-price"></a>

{% tabs %}
{% tab title="2020-08-31 之前" %}

| 项目           | 家庭版（仅年付）   | 团队版年付      | 企业版年付      | 团队版月付      | 企业版月付      |
| ------------ | ---------- | ---------- | ---------- | ---------- | ---------- |
| 初始价格         | $1.00/月    | $5.00/月    | $3.00/用户/月 | $8.00/月    | $4.00/用户/月 |
| 附加用户         | 不支持        | $2.00/用户/月 | $3.00/用户/月 | $2.50/用户/月 | $4.00/用户/月 |
| 附加存储         | $0.33/GB/月 | $0.33/GB/月 | $0.33/GB/月 | $0.50/GB/月 | $0.50/GB/月 |
| 高级功能         | $3.33/月    | 需个人购买      | 需个人购买      | 需个人购买      | 需个人购买      |
| {% endtab %} |            |            |            |            |            |

{% tab title="2020-08-31 之后" %}

| 项目            | 家庭版（仅年付）   | 团队版年付      | 企业版年付      | 团队版月付      | 企业版月付      |
| ------------- | ---------- | ---------- | ---------- | ---------- | ---------- |
| 初始价格          | $3.99/月    | $4.00/用户/月 | $6.00/用户/月 | $5.00/用户/月 | $7.00/用户/月 |
| 附加用户          | 不支持        | $4.00/用户/月 | $6.00/用户/月 | $5.00/用户/月 | $7.00/用户/月 |
| 附加存储          | $0.33/GB/月 | $0.33/GB/月 | $0.33/GB/月 | $0.50/GB/月 | $0.50/GB/月 |
| 高级功能          | 已包含        | 已包含        | 已包含        | 已包含        | 已包含        |
| {% endtab %}  |            |            |            |            |            |
| {% endtabs %} |            |            |            |            |            |

### 账单示例 <a href="#example-billing" id="example-billing"></a>

Bitwarden Inc. 与 Stripe 合作，提供安全的账单和支付处理服务。[在线账单示例](https://pay.stripe.com/invoice/acct_19smIXIGBnsLynRr/invst_Gxl9wk8thL7uIP8FnEWcpplsD0MsFKd)或本地账单示例。

{% file src="/files/-M46c1eljU0oXNQcrR0K" %}


# 首页

{% embed url="<https://status.bitwarden.com/>" %}
云服务器状态
{% endembed %}

***

{% hint style="info" %}
**对于自托管用户：**

2022 年 11 月 16 日之后，Bitwarden 客户端 App 将仅支持运行 1.46.0 及更高版本的自托管服务器。请[更新您的服务器](/docs/self-hosting/update-a-server)以确保兼容性。点击[这里](/docs/miscellaneous/november-deprecation-notice)了解更多。
{% endhint %}

### 应用程序入门... <a href="#app-quickstart" id="app-quickstart"></a>

<table data-column-title-hidden data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">网页端</td><td><a href="/docs/password-manager/getting-started/getting-started-webvault">Password Manager 网页 App</a></td></tr><tr><td align="center">浏览器</td><td><a href="/docs/password-manager/getting-started/getting-started-browserext">Password Manager 浏览器扩展</a></td></tr><tr><td align="center">移动端</td><td><a href="/docs/password-manager/getting-started/getting-started-mobile">Password Manager 移动 App</a></td></tr><tr><td align="center">桌面端</td><td><a href="/docs/password-manager/getting-started/getting-started-desktop">Password Manager 桌面 App</a></td></tr><tr><td align="center">CLI</td><td><a href="/docs/password-manager/developer-tools/cli/password-manager-cli">Password Manager CLI</a></td></tr></tbody></table>

### 角色入门... <a href="#role-quickstart" id="role-quickstart"></a>

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">个人用户</td><td><a href="/courses/password-manager/personal/individual/individual">个人</a></td></tr><tr><td align="center">管理员</td><td><a href="/courses/password-manager/business/enterprise-plan/enterprise-admin">企业管理员</a></td></tr><tr><td align="center">团队成员</td><td><a href="/courses/password-manager/business/teams-plan/team-member">团队成员</a></td></tr><tr><td align="center">经销商或 MSP</td><td><a href="/courses/password-manager/partners/reseller">经销商</a></td></tr></tbody></table>

### Secrets Manager 快速入门... <a href="#secrets-manager-quickstart" id="secrets-manager-quickstart"></a>

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">快速入门</td><td><a href="/docs/secrets-manager/get-started/secrets-manager-quick-start">Secrets Manager 快速入门</a></td></tr><tr><td align="center">对于开发人员</td><td><a href="/docs/secrets-manager/get-started/developer-quick-start">开发人员快速入门</a></td></tr></tbody></table>

{% hint style="success" %}
找不到您需要的吗？[联系支持](https://bitwarden.com/contact/)获取帮助。
{% endhint %}

### 现场演示和点播演示 <a href="#demo" id="demo"></a>

立即预订业务演示和问答，或观看点播演示。

* [现场演示注册 >](https://bitwarden.com/weekly/)
* [点播观看 >](https://bitwarden.com/resources/videos/enterprise-demo/)


# 发行记录

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/releasenotes/)
{% endhint %}

## 概览 <a href="#overview" id="overview"></a>

本文档中标注的版本代表 Bitwarden 服务器的版本。在同一时间段内发布的客户端应用程序（浏览器扩展、移动 App、桌面 App 和 CLI）将列出其各自的版本号，该版本号可能与关联的服务器版本号不同。了解更多有关 [Bitwarden 软件发布支持](/docs/security/software-development/software-release-support)的信息。

### 客户端 App 和自托管服务器 <a href="#client-apps-and-self-hosted-servers" id="client-apps-and-self-hosted-servers"></a>

客户端应用程序和自托管服务器会在服务器发布后几天内发布，以确保稳定性。通过 App 商店分发的 App 需经过分发商的额外审批流程。因此，**客户端应用程序和自托管服务器通常会在本页面发布公告后，陆续获得新功能**。

### 渐进式功能推出 <a href="#progressive-feature-rollout" id="progressive-feature-rollout"></a>

某些功能会随着时间的推移逐步向用户推出。采用这种方式推出的功能，可能会先向部分用户开放，随后再向其他用户开放。

{% hint style="info" %}
标有 <i class="fa-star">:star:</i>**星形图标**的是渐进式推出的功能。
{% endhint %}

### GitHub 链接 <a href="#links-to-github" id="links-to-github"></a>

Bitwarden 认为源代码透明是像我们这样的安全解决方案的一个绝对要求。访问以下链接在 GitHub 中查看完整、详细的发行记录：

* [Server Releases](https://github.com/bitwarden/server/releases)
* [Web Releases](https://github.com/bitwarden/clients/releases)
* [Desktop Releases](https://github.com/bitwarden/clients/releases)
* [Browser Extension Releases](https://github.com/bitwarden/clients/releases)
* [Android Releases](https://github.com/bitwarden/android/releases)
* [iOS Releases](https://github.com/bitwarden/ios/releases)
* [CLI Releases](https://github.com/bitwarden/clients/releases)
* [Directory Connector Releases](https://github.com/bitwarden/directory-connector/releases)

## 发行公告

## 2026.8.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.8.1、移动端 2026.8.1）*

### Password Manager

* <i class="fa-star">:star:</i>**网页 App 快速复制**：新的设置会在您将鼠标悬停在网页 App 中的密码库项目上时显示复制快捷按钮，从而加快[复制项目的凭据](/docs/password-manager/your-vault/vault-items/vault-items#copy-item-credentials)的速度。
* <i class="fa-star">:star:</i>**「新增」按钮重命名为「添加」或「创建」**：现在，「新增」按钮在大多数位置下更名为 <i class="fa-plus">:plus:</i>**添加**，包括[添加新的密码库项目](/docs/password-manager/your-vault/vault-items/vault-items#add-items)时，以及在配置 [Send](/docs/password-manager/bitwarden-send/create-a-send#create-a-send) 时更名为 <i class="fa-plus">:plus:</i>**创建**。此更新仅为界面美观性更改，功能未做任何更改。

### Admin Console

* <i class="fa-star">:star:</i>**生成组织邀请链接**：企业版组织现在可以生成可共享的链接来[邀请成员](/docs/admin-console/manage-members/user-management#invite)。通过组织首选的通信渠道共享链接，并将其限制为特定的电子邮箱域名，以控制谁可以使用该链接。您可以随时轮换链接以使之前的链接失效，或将其停用以阻止新成员加入。

## 2026.8.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.8.0、浏览器扩展 2026.8.0、桌面端 2026.8.0、移动端 2026.8.0、CLI 2026.8.0）*

### Password Manager

* <i class="fa-star">:star:</i>**桌面端操作栏**：Bitwarden 桌面 App 中添加了新的批量操作栏。使用该操作栏，可以执行诸如[共享项目](/docs/password-manager/organization-members/sharing)到[集合](/docs/admin-console/manage-shared-items/collections/about-collections)或[文件夹](/docs/password-manager/your-vault/vault-navigation/folders)、以及[归档](/docs/password-manager/your-vault/vault-items/vault-items#archive)密码库项目等操作。
* <i class="fa-star">:star:</i>**移动 App 的填充辅助**：激活[填充辅助](/docs/password-manager/autofill/more-autofill-options/fill-assist)功能，可在 Bitwarden 精选的、已知会经常导致自动填充问题的网站上提高自动填充的准确性。
* **iOS 现已支持设备列表**：iOS 现已支持[设备列表](/docs/password-manager/your-vault/security-tools/manage-devices)功能，用于显示您账户曾经登录过的设备。
* **从 Delinea 导入**：您现在可以从 Delinea 导入 `.csv` 和 `.xml` 文件，以将数据快速传输到 Bitwarden。

{% hint style="info" %}
从 Delinea Secret Server 导入机密时，任何带有关联 URL 的项目都将自动归类为「登录」项目类型。所有其他导入的数据将归类为带有自定义字段的「安全笔记」项目类型来容纳您的数据。
{% endhint %}

### Admin Console

* <i class="fa-star">:star:</i>**管理 Send 策略**：组织现在可以使用 Admin Console 中的**管理 Send** 策略来控制所有与 Send 相关的功能。此新的[策略](/docs/admin-console/oversight-visibility/enterprise-policies)取代了之前的一系列独立的 Send 策略。
* **通用 HEC 集成**：Bitwarden 团队版和企业版组织现在可以与任何 HTTP 事件收集器兼容平台集成，以实现安全信息和事件管理 (SIEM)。设置 [HEC 集成](/docs/admin-console/oversight-visibility/siem-integrations/generic-hec-integration)。
* <i class="fa-star">:star:</i>**更改成员的电子邮箱和名称**：管理员现在可以直接从 Admin Console [更新成员的账户电子邮箱地址和名称](/docs/admin-console/manage-members/change-members-account-email-and-name)。这仅适用于没有主密码的已声明的账户，例如使用 Key Connector 或受信任设备的账户。拥有主密码的用户仍然可以自助更新其电子邮箱地址。

### 自托管 <a href="#self-host" id="self-host"></a>

* **Helm Chart 身份证书密码轮换**：使用 2.0.0 版本或更早版本首次部署 Helm Chart 的自托管客户可能需要轮换其服务器的身份证书密码。了解[是否需要轮换证书密码](/docs/self-hosting/deploy-and-configure/helm/rotate-identity-certificate-helm)，如果需要，[如何轮换证书密码](/docs/self-hosting/deploy-and-configure/helm/rotate-identity-certificate-helm#rotate-your-certificate-password)。

## 2026.7.2

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.7.2、移动端 2026.7.1）*

此版本提供日常维护和后端改进。

## 2026.7.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.7.0、浏览器扩展 2026.7.0、桌面端 2026.7.0、移动端 2026.7.0、CLI 2026.7.0）*

### Password Manager

* <i class="fa-star">:star:</i>**密码库项目操作栏**：网页 App 和 Admin Console 中添加了新的批量操作栏。使用该操作栏，可以执行诸如[共享项目](/docs/password-manager/organization-members/sharing)到集合或[文件夹](/docs/password-manager/your-vault/vault-navigation/folders)、以及[归档](/docs/password-manager/your-vault/vault-items/vault-items#archive)密码库项目等操作。
* <i class="fa-star">:star:</i>**从扩展保存和填充**：在浏览器扩展中，内嵌菜单现在可以更轻松地[同时保存和自动填充新凭据](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#shi-yong-nei-qian-zi-dong-tian-chong-chuang-jian-zhang-hu)。
* **Android 支持 CXP**：使用 Android 10+，您可以在 Bitwarden 与任何支持 [FIDO 凭据交换协议](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)的 Android App 之间[直接导入](/docs/password-manager/import-and-export/import-data#yi-dong-duan)或[直接导出](/docs/password-manager/import-and-export/export-vault-data#yi-dong-duan)数据。
* <i class="fa-star">:star:</i>**扩展安装过时提示将 Bitwarden 设置为默认**：安装浏览器扩展时，它现在将提示您[将 Bitwarden 设置为浏览器的默认密码管理器](/docs/password-manager/autofill/troubleshoot-autofill/disable-a-browsers-built-in-password-manager)。
* <i class="fa-star">:star:</i>**Keeper 直接导入器**：使用[新的直接导入选项](/docs/password-manager/import-and-export/import-guides/import-from-keeper#import-directly-from-keeper)，无需下载导出文件，即可直接从 Keeper Password Manager 传输数据，。
* **KeePass KDBX 导入器**：您现在可以将受密码或密钥文件加密保护的 [KeePass Password Manager  KDBX 文件直接导入](/docs/password-manager/import-and-export/import-guides/cong-keepass-dao-ru) Bitwarden。此前，KeePass 数据只能使用未加密的 CSV 或 XML 文件导入。
* **SSH 代理更新**：此次发布包含对 SSH 代理的可靠性和性能的更新。在以下文章中了解有关 SSH 代理的更多信息：
  * [关于 SSH](/docs/password-manager/developer-tools/ssh/about-ssh)：SSH 密钥的概念概述以及 SSH 代理的工作原理。
  * [SSH 代理](/docs/password-manager/developer-tools/ssh/ssh-agent)：在不同场景中设置和使用 SSH 代理的分步指南。
* **桌面 App 托盘行为更新**：控制托盘或菜单栏行为设置和最小化设置现已合并为简化的「[保持 Bitwarden 在后台运行](/docs/password-manager/your-vault/app-settings)」设置。
* **禁用自动更新变量重命名**：用于[阻止 Bitwarden 桌面 App 自动更新](/docs/password-manager/more/password-manager-faqs#q-can-i-turn-off-automatic-updates-for-bitwarden)的环境变量已被重命名。
* **简化了扩展的生物识别**：为浏览器扩展启用生物识别变得更加简单。使用生物识别仍然需要运行桌面 App，但是，您将不再需要启用**允许浏览器集成**选项来执行此操作。了解更多有关[生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)的信息。

### Admin Console

* <i class="fa-star">:star:</i>**密码库横幅企业策略**：管理员现在可以在成员的密码库顶部显示[自定义横幅](/docs/admin-console/oversight-visibility/enterprise-policies#vault-banner)，例如服务公告或公司提醒事项。
* <i class="fa-star">:star:</i>**Send 事件日志**：现在，创建、编辑、删除和访问 [Send](/docs/password-manager/bitwarden-send/about-send) 将在 Admin Console 中记录事件。

### 自托管 <a href="#self-host" id="self-host"></a>

* **更改数据库备份文件名为本地时间**：在 `mssql.override.env` 文件中添加了一个变量，以将备份文件名中的时间戳表示为[本地时间（而不是默认的 UTC）](/docs/self-hosting/backup-server-data#docker)。

## 2026.6.2

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.6.4、移动端 2026.6.1）*

此版本提供日常维护和后端改进。

## 2026.6.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.6.2、浏览器扩展 2026.6.0、桌面端 2026.6.0、移动端 2026.6.0、CLI 2026.6.0）*

### Password Manager

* <i class="fa-star">:star:</i>**浏览器扩展的填充辅助**：激活[填充辅助](/docs/password-manager/autofill/more-autofill-options/fill-assist)功能，可在 Bitwarden 精选的、已知会经常导致自动填充问题的网站上提高自动填充的准确性。
* **Linux 上的生物识别简化**：设置 [Linux 上的生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#linux)以解锁 Bitwarden 桌面 App 时，不再需要机密服务守护进程。
* <i class="fa-star">:star:</i>**桌面 App 的设置 UI 更新**：桌面 App 的设置对话框已更新。了解更多有关[桌面 App](/docs/password-manager/getting-started/getting-started-desktop)。
* **Send 接收者限制**：当创建仅限[特定人员](/docs/password-manager/bitwarden-send/send-privacy#email-verified-recipients)的 Send 时，电子邮箱地址字段现在最多支持 2,500 个字符。
* <i class="fa-star">:star:</i>**风险密码通知 UI 更新**：查看登录中，密码字段下方的[风险密码标签](/docs/password-manager/your-vault/security-tools/change-at-risk-passwords)仍然保留，但之前显示在视图顶部的横幅已被移除。当使用 Access Intelligence [请求密码更改](/docs/admin-console/oversight-visibility/access-intelligence#requesting-password-changes)时，密码库中显示的横幅没有更改。
* **浏览器扩展中的密码库同步 UI 更新**：[同步](/docs/password-manager/your-vault/syncing-your-vault)过程中，**立即同步密码库**文本现在将显示为灰色，并同步完成后将恢复为可点击状态。

### Admin Console

* <i class="fa-star">:star:</i>**现在将对已接受的成员强制实施组织策略**：用户接受组织邀请后，所有已配置的[组织策略](/docs/admin-console/oversight-visibility/enterprise-policies)即应用到他们的账户。

## 2026.6.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Directory Connector 2026.6.0、Web 2026.6.0、移动端 2026.5.1）*

### Password Manager

* <i class="fa-star">:star:</i>**Android 现已支持设备列表**：Android 现已支持[设备列表](/docs/password-manager/your-vault/security-tools/manage-devices)功能，用于显示您账户曾经登录过的设备。

### Directory Connector

最新版本的 Directory Connector 包含了一些现代化的和基础架构的改进，这些改进将影响 App 的安装或更新：

* macOS 版的 Directory Connector **现以原生 ARM64 二进制文件形式分发**，取代了该 App 的 Rosetta 版本。在 macOS 上，Directory Connector 现仅支持 Apple Silicon。
* 如果您同时使用 Directory Connector 桌面 App 和 CLI，则必须更新这两个客户端，然后才能使用其中任何一个的最新版本。
* Keytar 已被特定于操作系统的原生模块所取代。因此，`bwdc` CLI 可执行文件中包含的文件也发生了变化。尽管文件名有所变化，但[设置流程](/docs/admin-console/manage-members/directory-connector/directory-connector-cli)保持不变。

## 2026.5.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.5.0、浏览器扩展 2026.5.0、桌面端 2026.5.0、移动端 2026.5.0、CLI 2026.5.0）*

### Password Manager

* <i class="fa-star">:star:</i>**桌面端现已支持设备列表**：除网页 App 和浏览器扩展外，桌面 App 现已支持[设备列表](/docs/password-manager/your-vault/security-tools/manage-devices)功能，用于显示您账户曾经登录过的设备。
* **Flatpak 和 Snap 现已支持生物识别集成**：Flatpak 和 Snap 发行版现已支持与 Bitwarden 桌面 App 集成使用的[浏览器扩展的生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)。
* <i class="fa-star">:star:</i>**网页 App 快速操作**：在网页 App 中将鼠标悬停于某个项目上，即可通过新增的快速操作按钮打开网站或复制密码库数据。
* &#x20;**Send UI 更新**：在浏览器扩展和网页 App 中选择 [Send](/docs/password-manager/bitwarden-send/about-send) 项目时，现在将显示「查看」界面，而不是直接跳转至「编辑」界面。

### Admin Console

* <i class="fa-star">:star:</i>**Blumira SIEM 集成**：团队版和企业版组织现在可以与 [Blumira 集成](/docs/admin-console/oversight-visibility/siem-integrations/blumira-siem)，以实现安全信息与事件管理 (SIEM)。
* <i class="fa-star">:star:</i>**扩展了账户恢复选项**：账户恢复功能现已支持已撤销的成员，并可[重置两步登录方式](/docs/admin-console/manage-members/account-recovery/recover-a-member-account)。
* **成员被撤销原因**：在**成员** → **已撤销**页面上，每位成员旁边新增了一个工具提示，说明了成员从您的组织中[被撤销](/docs/admin-console/manage-members/revoke-remove/temporarily-revoke-access)的原因。
* **更新了事件日志**：当附件被添加到组织拥有的项目时，Password Manager 现在会使用现有的[为项目创建附件](/docs/admin-console/oversight-visibility/event-logging/event-logs#item-events)事件进行记录。

### 自托管 <a href="#self-host" id="self-host"></a>

* **Helm Chart v2.0**：自托管 Helm Chart 的 2.0 版本将包含两项重大变更：
  * 此版本的 Chart 现在**默认禁用** NGINX `ingress`。Chart 支持使用 Gateway API 作为替代方案。
  * 移除了 `values.yaml` 文件中的 `image.name` 字段。使用 `image.name` 的所有配置都必须更新为使用 `image.repository`。

{% hint style="info" %}
在升级到此版本的 Chart 之前，请审查这些变更，并相应地更新您的配置文件。更多有关设置或迁移到 Gateway API 的信息，请参阅 [Helm 流量路由](/docs/self-hosting/deploy-and-configure/helm/traffic-routing)。
{% endhint %}

## 2026.4.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.4.2、浏览器扩展 2026.4.0、桌面端 2026.4.0、移动端 2026.4.1、CLI 2026.4.0）*

### Password Manager

* <i class="fa-star">:star:</i>**在扩展和桌面端更改主密码**：您现在可以在浏览器扩展和桌面 App 中[更改您的主密码](/docs/account/master-password#change-your-master-password)。为了支持未来的改进，此前允许通过命令行界面 (CLI) 更改主密码的工作流已被移除。
* <i class="fa-star">:star:</i>**桌面端 UI 更新**：桌面 App UI 已更新，视觉效果得到优化。
* <i class="fa-star">:star:</i>**默认点击以自动填充**：在浏览器扩展程序中，您现在只需点击**自动填充建议**中的任意项目，即可插入凭据。此更新移除了**填充**按钮以及**点击自动填充建议中的项目以填充**设置，使界面更加简洁。
* **更新了清除剪贴板的默认设置**：浏览器扩展的[清除剪贴板设置](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#setup-auto-fill)现默认为五分钟，这是一项额外的预防措施，有助于保障您的凭据安全。
* **iOS 现已支持 mTLS**：iOS 和 Android 移动 App 现在支持为要求客户端身份验证的自托管服务器上传 mTLS 证书。在[设置服务器 URL 时](/docs/self-hosting/connect-clients/connect-individual-clients#yi-dong-app)上传您的证书。
* **附件状态加载条**：在桌面 App 和浏览器扩展中上传附件时，将显示上传状态条。
* **Keeper JSON 导入器**：您现在可以使用 JSON 文件[从 Keeper 导入数据](/docs/password-manager/import-and-export/import-guides/import-from-keeper)。

## 2026.4.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.4.0、移动端 2026.4.0）*

### Password Manager

* **Android 预览图片附件**：现在，您可以在 Password Manager Android App 中直接[预览图片附件](/docs/password-manager/your-vault/vault-items/file-attachments#view-an-attachment)，而无需将文件下载到设备。未来版本中，iOS 也将提供预览图片附件功能。

### Admin Console

* **Send 控制企业策略**：「Send 选项」和「禁用 Send」这两个企业策略被合并为新命名的「[Send 控制](/docs/admin-console/oversight-visibility/enterprise-policies#send-controls)」策略。如果之前启用了其中任何一个策略，所选选项将自动转移并保持不变。
* **更新了企业策略页面**：在策略页面中，[企业策略](/docs/admin-console/oversight-visibility/enterprise-policies)现已分为三个类别：「数据控制」、「身份验证」和「密码库管理」。您还可以一目了然地查看哪些策略已启用或已禁用。
* **Access Intelligence 仪表板更新**：在 Access Intelligence「活动」视图中，通过新的图示，可视化[存在风险的应用程序、密码和成员随时间推移的变化趋势](/docs/admin-console/oversight-visibility/access-intelligence#activity)，并与应用程序、密码和成员数量的绝对变化进行比较。

## 2026.3.2

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.3.1、浏览器扩展 2026.3.0、移动端 2026.3.1、桌面端 2026.3.1、CLI 2026.3.0）*

### Password Manager

* <i class="fa-star">:star:</i>**「查看登录」上的自动填充按钮**：在浏览器扩展中，从「[查看登录](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#view-login)」直接自动填充凭据。
* **密码保护的 Send 的生成器选项**：创建密码保护的 [Send](/docs/password-manager/bitwarden-send/about-send) 时，现在可以使用所有密码生成器功能。
* **适用于 Linux 的 Arm64 构建**：Linux 用户现可在 Snapcraft 和 Flathub 上获取 Arm64 桌面版构建。参阅[下载页面](https://bitwarden.com/download/#downloads-desktop-applications)获取更多信息。

### Admin Console

* <i class="fa-star">:star:</i>**自动确认策略**：一个新的策略，允许[自动确认新成员加入组织](/docs/admin-console/manage-members/automatic-confirmation)。使用此策略需要了解其工作原理，并且必须联系 Bitwarden 支持人员在您的组织中激活它。
* <i class="fa-star">:star:</i>**策略名称更新**：「强制组织数据所有权」策略已重命名为「[集中化组织所有权](/docs/admin-console/oversight-visibility/enterprise-policies#centralize-organization-ownership)」。
* <i class="fa-star">:star:</i>**从「我的密码库」转移项目到「我的项目」**：使用「集中化组织所有权」策略的组织现在可以[选择提示](/docs/admin-console/oversight-visibility/enterprise-policies#centralize-organization-ownership)用户使用浏览器扩展[将项目从「我的密码库」转移项目到「我的项目」](/docs/password-manager/organization-members/transfer-ownership)。

## 2026.3.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.3.0、浏览器扩展 2026.3.0、移动端 2026.3.0）*

### Password Manager

* **Bitwarden Send 电子邮箱验证**：电子邮箱验证保护的 Send 现在可在移动客户端使用。了解更多有关 [Bitwarden Send](/docs/password-manager/bitwarden-send/about-send) 的信息。

### Authenticator

* **Android 版会话超时**：现在，您可以设置 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator) Android App 在经过您设定的时间后自动锁定。使用设备选定的解锁方式（如 PIN 码或生物识别）解锁。
* **iOS 版新的 App 图标**：[Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator) iOS App 有一个新的 App 图标。

### Admin Console

* ~~**Access Intelligence UX 改进**：~~[~~Access Intelligence~~](/docs/admin-console/oversight-visibility/access-intelligence) ~~进行了一些改进，包括将「所有应用程序」和「关键应用程序」选项卡合并为一个简洁的「应用程序」选项卡。~~
* <i class="fa-star">:star:</i>**批量邀请改进**：[组织用户邀请流程](/docs/admin-console/manage-members/user-management)中添加了多项改进，例如添加了可视化状态指示器和批量操作警告。

## 2026.2.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.2.1、浏览器扩展 2026.2.0、移动端 2026.2.1、桌面端 2026.2.1、CLI 2026.2.0）*

### Password Manager

* **Bitwarden Send 电子邮箱验证**：当用户创建 Send 时，可以选择使用接收者电子邮箱验证来保护它。了解更多有关 [Bitwarden Send](/docs/password-manager/bitwarden-send/about-send) 的信息。
* **项目归档**：付费订阅的用户现在可以[归档密码库项目](/docs/password-manager/your-vault/vault-items/vault-items#archive)，以将其从搜索和自动填充中排除，而无需将其从密码库中移除。
* ~~**「查看登录」上的自动填充按钮**：直接从浏览器扩展中的~~[~~「查看登录」页面~~](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#view-login)~~自动填充凭据。~~
* **Flatpak 生物识别解锁**：Flatpak 安装的桌面 App 现在支持[生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#linux)。
* **增加最小 KDF 迭代次数**：如果您的 PBKDF2 KDF 迭代次数低于 600,000（自 [2023.2.0 版本](#id-2023.2.0)以来的默认级别），您将被[要求更新此设置](/docs/security/encryption/encryption-key-derivation#low-kdf-iterations)，或者在您下次使用主密码登录或解锁时自动应用此增加的值。

### Admin Console

* **Huntress SIEM 集成**：Bitwarden 团队版和企业版组织现在可以[与 Huntress 集成](/docs/admin-console/oversight-visibility/siem-integrations/huntress-siem)以用于安全信息与事件管理 (SIEM)。

### Secrets Manager

* **Jenkins 集成**：Bitwarden Secrets Manager CLI 现在可用于[将机密注入 Jenkins Pipelines](/docs/secrets-manager/integrations/jenkins-integration)。

## 2026.2.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.2.0、浏览器扩展 2026.1.1、移动端 2026.2.0）*

### Password Manager

* **从 1Password 导入 SSH 密钥**：现在可以使用 1Password 提供的 .1pux 导出格式将 [SSH 密钥](/docs/password-manager/developer-tools/ssh/ssh-agent)直接[导入到 Bitwarden](/docs/password-manager/import-and-export/import-guides/import-data-from-1password)。
* **从 Bitwarden .json 导入通行密钥**：现在可以将 .json 文件中 [Bitwarden 导出](/docs/password-manager/import-and-export/export-vault-data)的[通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)导入到新的 Bitwarden 账户或用作短期备份。

### Admin Console

* **API - 新的成员管理端点**：[公共 API](https://bitwarden.com/help/api/) 现在包括用于[撤销和恢复组织成员的访问权限](/docs/admin-console/manage-members/revoke-remove/temporarily-revoke-access)的端点。

## 2026.1.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.1.1、浏览器扩展 2026.1.0、移动端 2026.1.0、桌面端 2026.1.0、CLI 2026.1.0）*

### Password Manager

* **使用通行密钥解锁**：现在可以[使用通行密钥解锁您的网页 App 或浏览器扩展](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys#set-up-encryption-for-unlock)。这扩展了现有的通行密钥支持的功能，使其不再局限于登录，让您无需输入主密码即可访问您的密码库。
* **桌面 App UI 更新**：桌面 App UI 已更新，后续还将推出更多更新。
* **扩展的新默认宽度**：浏览器扩展具有新的、更宽的默认宽度。您可以[从外观菜单](/docs/password-manager/your-vault/appearance/change-app-appearance#liu-lan-qi-kuo-zhan)中切换回窄版界面或更宽版界面。

{% hint style="info" %}
此版本包含一个 Linux 桌面环境至 Electron 39 的更新。在基于 Fedora 的 Linux 发行版上使用 KDE 的 Bitwarden Flatpak 应用程序的用户在导入 SSH 密钥时可能会遇到剪贴板问题。这是一个已知问题，Bitwarden 正在调查中。
{% endhint %}

### 自托管 <a href="#self-host" id="self-host"></a>

* **增强的错误日志脱敏**：对于无效、过期或颁发者、受众或签名不正确的身份验证令牌而创建的错误日志，现在会脱敏所有个人身份信息 (PII - Personally Identifiable Information) 和身份验证数据。

## 2026.1.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2026.1.0）*

### Password Manager

* **更多 2FA 安全密钥（高级版）**：Bitwarden 高级版用户现在最多可以使用 10 个安全密钥用于[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)，包括[通行密钥](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)。

### Admin Console

* **导出成员列表**：所有组织均可[下载 .csv 格式的成员列表](/docs/admin-console/manage-members/user-management#download-list-of-members)，其中详细记录了成员使用两步登录的时间、是否可以访问 Secrets Manager 等信息。

## 2025.12.2

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.12.2、浏览器扩展 2025.12.1、移动端 2025.12.1、桌面端 2025.12.1、CLI 2025.12.1）*

### Password Manager

{% hint style="info" %}
**桌面 App 公告**

Windows 便携式桌面 App 的一个问题已得到修复，App 更新至此版本后将自动注销用户。重新登录后，Windows 便携式桌面 App 将恢复正常运行。
{% endhint %}

* **订阅存储空间增加**：高级订阅和付费组织现在将提供 5 GB 的[附件](/docs/password-manager/your-vault/vault-items/file-attachments)和 [Send](/docs/password-manager/bitwarden-send/about-send) 存储空间。
* **更新旧版客户端的 PIN 码**：将 Bitwarden 客户端从 2025.9.0 或更早版本更新到此版本后，用户需要重新设置 PIN 码才能继续使用 [PIN 码解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)功能。PIN 码本身的要求未作任何变更。

### Admin Console

* **阻止已声明域名的账户创建策略**：此[新的策略](/docs/admin-console/oversight-visibility/enterprise-policies#block-account-creation-for-claimed-domains)允许管理员阻止使用与您[已声明域名](/docs/admin-console/oversight-visibility/claimed-domains/claimed-domains)匹配的电子邮箱地址的用户在组织外部创建 Bitwarden 账户。
* **优化的批量重新邀请**：Admin Console 批量重新发送组织邀请的功能已从之前的每次操作限制为 500 个邀请，现在支持每次操作最多 8,000 个邀请。
* **会话超时策略**：您现在可以在[会话超时企业策略](/docs/admin-console/oversight-visibility/enterprise-policies#session-timeout)中选择更多选项：系统锁定时、App 重启时和永不超时。选择后，所有这些新的超时选项将应用于所有 Bitwarden 客户端。

## 2025.12.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.12.1）*

### Password Manager

* **导入和导出页面重命名**：为了改善用户体验，网页 App 上的「导入数据」和「导出密码库」页面已简单地重命名为「导入」和「导出」。在未来的版本中，其他客户端中的这些页面也将被重命名。

### Admin Console

* **企业策略名称更新**：「禁用个人密码库导出」策略现在叫做「[禁用导出](/docs/admin-console/oversight-visibility/enterprise-policies#remove-export)」。这只是名称更改，该策略的作用保持不变。

### 自托管 <a href="#self-host" id="self-host"></a>

* **Key Connector 确认**：为了提高安全性，在 [Key Connector 登录过程](/docs/self-hosting/key-connector/about-key-connector#log-in-using-key-connector)中为新用户添加了额外的组织确认对话框。

## 2025.12.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.12.0、浏览器扩展 2025.12.0、移动端 2025.12.0、桌面端 2025.12.0、CLI 2025.12.0）*

### Password Manager

* **密码库健康警报与密码指导**：作为高级版计划的新功能，当 Password Manager 检测到密码弱、重复使用或暴露时，浏览器扩展将[提醒用户更新密码](/docs/password-manager/your-vault/security-tools/change-at-risk-passwords)，并建议用户更新。
* **Chrome 与 Brave 浏览器的直接导入**：通过[直接导入](/docs/password-manager/import-and-export/import-guides/import-data-from-chrome#import-directly-from-browser)功能，您可以将 Chrome 和 Brave 浏览器的数据更快地迁移至 Bitwarden。
* **自动填充和保存 URI**：在浏览器扩展中，**填充 & 保存**选项已合并到常规的**自动填充**选项中。现在，当为某个没有匹配 URI 的项目选择自动填充时，会出现一个[将当前网站的 URI 保存到登录项目中](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill#save-uri-to-existing-login-item)的选项。

### Admin Console

* **阻止已撤销用户的 SSO 登录**：已从组织撤销的用户将无法再使用 SSO 登录其 SSO 链接的账户。

## 2025.11.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.11.2、iOS 端 2025.11.0、Android 端 2025.11.1）*

### Password Manager

* **通行密钥登录**：浏览器扩展和网页 App 现已全面支持[通行密钥](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)登录，让您可以更快更安全地登录 Bitwarden 账户。
* **Android 自动填充更新**：Android 版 Password Manager 现默认采用改进的[自动填充匹配逻辑，适用于 Opera、Edge 和 Samsung Internet](/docs/password-manager/autofill/autofill-from/autofill-from-android#browser-integrations)。此前的版本中该功能称为「兼容模式」选项。

### Admin Console

* **Access Intelligence**：企业组织可使用 [Access Intelligence](/docs/admin-console/oversight-visibility/access-intelligence) 来审查存在风险的凭据，并通知成员[对这些凭据采取相应措施](/docs/password-manager/your-vault/security-tools/change-at-risk-passwords)。
* **策略名称更新**：「为允许的应用自动登录用户」策略已更名为「[使用 SSO 自动登录](/docs/admin-console/oversight-visibility/enterprise-policies#automatic-login-with-sso)」。

### 自托管 <a href="#self-host" id="self-host"></a>

* **Bitwarden Lite 正式发布**：[Bitwarden Lite](/docs/self-hosting/deploy-and-configure/docker/lite-deployment)（以前叫做 Bitwarden Unified）现已正式发布。
* **环境变量更新**：自托管环境变量 `globalSettings__syslog__destination` 已弃用。了解更多有关自托管[环境变量](/docs/self-hosting/deploy-and-configure/configuration-options/environment-variables)的信息。

### 安全 <a href="#security" id="security"></a>

* **变更 KDF 时不会注销**：更改 [KDF 算法](/docs/security/encryption/encryption-key-derivation)将不再使您注销客户端应用程序。

## 2025.11.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.11.0、浏览器扩展 2025.11.0、移动端 2025.11.0、桌面端 2025.11.0、CLI 2025.11.0）*

### Password Manager

* **通行密钥登录支持浏览器扩展**：用户现在可[使用通行密钥](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)登录浏览器扩展。当前支持 Chrome 和基于 Chromium 的浏览器（例如 Edge）。
* **Windows Hello 更新**：Windows 桌面 App 重启后，您现在可以立即使用生物识别解锁密码库，而无需输入主密码或 PIN 码。在 [Windows 桌面 App 中设置生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#set-up-biometrics-for-desktop-app)时，请取消勾选 **App 重启时要求主密码或 PIN 码**选项。
* **网页 App 右键点击**：在网页 App 的密码库视图中，现在可通过右键点击调出与 **≡**&#x9009;项菜单相同的操作菜单。
* **改进的高级订阅注册流程**：希望享受 Bitwarden 付费方案的用户将可以更轻松地升级账户。在网页 App 导航栏中选择**升级您的方案**按钮，即可了解更多信息并选择付费方案。

### Admin Console

* **组织默认 URI 匹配检测**：组织所有者和管理员现在可以为其成员选择[默认的 URI 匹配检测方式](/docs/admin-console/oversight-visibility/enterprise-policies#default-uri-match-detection)。成员仍然可以编辑个人登录项目的 URI 匹配检测方式。
* **我的项目**：启用[强制组织数据所有权](/docs/admin-console/oversight-visibility/enterprise-policies#enforce-organization-data-ownership)策略后，组织默认拥有新成员的项目。受此策略约束的成员现在可以将项目保存到新的「[我的项目](/docs/password-manager/organization-members/my-items)」位置，既能保护成员隐私，又能确保管理员在成员退出组织后可以转移数据。

### 自托管 <a href="#self-host" id="self-host"></a>

{% hint style="info" %}
**Helm Charts 版本控制更新**：对于 Bitwarden 自托管 Helm Charts，CalVer 版本控制方案（2025.8.0）将于 2025 年 11 月 13 日弃用。今后将仅支持和发布 SemVer 版本。
{% endhint %}

* **备份脚本更新**：使用打包的 [backup-db.sh 脚本](/docs/self-hosting/backup-server-data)的 Docker 部署已更新为[简单恢复模式](https://learn.microsoft.com/zh-cn/sql/relational-databases/backup-restore/recovery-models-sql-server?view=sql-server-ver17)，以防止事务日志文件大小不断增加。
* **网页客户端要求 https 配置**：自托管服务器连接现在要求 `https://` 配置。未使用 https\:// 的服务器 URL 将收到错误消息。

## 2025.10.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.10.1 和移动端 2025.10.1）*

### Password Manager

* **Android Chrome 集成版本要求**：如需继续使用 [Android Chrome 浏览器集成](/docs/password-manager/autofill/autofill-from/autofill-from-android#browser-integrations)，请将 Chrome App 升级至至少 135 版本。这是由于 Chrome 和 Bitwarden 自动填充集成流程的结构性变更所致。

### Admin Console

* **Sumo Logic SIEM 集成**：现已推出 [Sumo Logic SIEM](/docs/admin-console/oversight-visibility/siem-integrations/sumo-logic-siem) 新集成方案。该集成可全面覆盖身份验证、组织活动和密码库项目等各类事件。

## 2025.10.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.10.0、浏览器扩展 2025.10.0、移动端 2025.10.0、桌面端 2025.10.0、CLI 2025.10.0）*

### Password Manager

* **Edge、Opera 和 Vivaldi 浏览器的直接导入功能**：通过 Edge、Opera 和 Vivaldi 浏览器的[直接导入](/docs/password-manager/import-and-export/import-guides/import-data-from-chrome#import-directly-from-browser)功能，快速安全地将数据迁移至 Bitwarden。
* **简化了 SSO 用户的登录界面**：采用[要求单点登录策略](/docs/admin-console/oversight-visibility/enterprise-policies#require-single-sign-on-authentication)的组织成员，若他们曾在该设备完成过身份验证，登录界面中其他验证选项将自动灰显。

### Secrets Manager

* **新的事件日志**：当机器账户被创建、删除，或有用户/群组被分配至机器账户，以及用户/群组被从机器账户移除时，Secrets Manager 现在将[记录事件](/docs/admin-console/oversight-visibility/event-logging/event-logs#secrets-manager-events)。

### 自托管 <a href="#self-host" id="self-host"></a>

* **新的环境变量**：提供用于配置刷新令牌处理的新[环境变量](/docs/self-hosting/deploy-and-configure/configuration-options/environment-variables#refresh-token-variables)，允许用户在自托管服务器上设置身份验证令牌的有效期和超时时间。

## 2025.9.2

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.9.1）*

### Admin Console

* **成员邀请主题行更新**：更新了加入组织的邀请的[电子邮件主题行](/docs/security/trusted-communications/emails-from-bitwarden-servers#critical-member-emails)。
* **税务 ID 提醒**：如果您是征收[增值税 (VAT)](/docs/plans-and-pricing/tax-calculation#value-added-tax-vat) 国家的企业主或提供商管理员，并且尚未添加税务 ID，您将在 Admin Console、付款详细信息和提供商门户页面上看到一个横幅。单击**添加税务 ID** 以使用组织的税务 ID 更新账单详细信息。

### Secrets Manager

* **Terraform 提供程序**：Bitwarden Secrets Manager 现在提供 Terraform 提供程序，能够为您的 Terraform 基础架构获取、创建和管理 Secrets Manager 的机密。[了解更多](/docs/secrets-manager/integrations/terraform-provider)有关 Terraform 提供程序的信息。

## Secrets Manager Kubernetes Operator 1.0.0

* **更新到默认的映射机密行为**：Kubernetes Operator 的新默认行为只会同步映射到 `BitwardenSecret` 对象中的机密，除非使用 `onlyMappedSecrets: false` 另作指定。[了解更多](/docs/secrets-manager/integrations/secrets-manager-kubernetes-operator)有关 Secrets Manager Kubernetes Operator 的信息。

## 2025.9.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.9.0、浏览器扩展 2025.9.0、移动端 2025.9.0、桌面端 2025.9.0、CLI 2025.9.0）*

### Password Manager

* **使用浏览器扩展批准设备**：使用浏览器扩展审批新的[受信任设备](/docs/account/log-in-and-unlock/using-single-sign-on/add-a-trusted-device)和[设备登录](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)请求。
* **iOS 26 CXP**：iOS 26 的用户现在可以直接导入或导出 Bitwarden 和任何其他支持 [Fido 凭证交换协议](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)的 iOS App。了解更多有关导入和[导出](/docs/password-manager/import-and-export/export-vault-data)的信息。

### Admin Console

* **集合设置更新**：某些集合管理设置已重新命名，现在打开或关闭时将记录更详细的事件。[了解更多](/docs/admin-console/manage-shared-items/collections/collection-settings)。
* **组织 SSH 密钥**：使用 Bitwarden SSH 代理创建的 SSH 密钥现在可以在组织集合中存储和共享。[了解更多](/docs/password-manager/developer-tools/ssh/ssh-agent)有关 Bitwarden SSH 代理的信息。

## 2025.8.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.8.2、移动 2025.8.1）*

{% hint style="info" %}
**Helm 图表版本更新**：对于 Bitwarden 自托管 Helm 图表，CalVer 版本方案 (2025.8.0) 将于 2025 年 11 月 13 日废弃。在此日期之后，将仅支持和发布 SemVer 版本。

您现在就可以开始使用 SemVer 1.0.0，但请注意，在 2025 年 11 月 13 日之前，您必须在升级时始终指定 `--version <semver-version>`：

```bash
helm upgrade self-host-bsfyr9bpzk bitwarden/self-host --version <semver-version> -n bitwarden
```

{% endhint %}

### Password Manager

* **Android 的支付卡自动填充**：Bitwarden Android App 现在可以自动填充支付卡，例如借记卡或信用卡。[了解更多](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities)。
* **2FA 失败时的电子邮件**：用户现在将收到一封电子邮件，通知他们被两步登录阻止的失败的登录尝试。如果您收到这些电子邮件，请立即将主密码更新为强、唯一且从未使用过的主密码。[了解更多](/docs/security/trusted-communications/emails-from-bitwarden)。

### Secrets Manager

* **新的事件日志**：Secrets Manager 现在会在访问、创建、编辑或删除工程时记录事件日志。[了解更多](/docs/admin-console/oversight-visibility/event-logging/event-logs)。

## 2025.8.2

*（此次所列版本号**仅包含浏览器扩展 & 桌面 App**。下一个包含服务器更新的版本将恢复为典型的版本进程 (2025.8.1)）*

* 为了进一步防范恶意网站，内嵌自动填充菜单现在总是显示在网页其他内容的上方。

## 2025.8.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.8.0、浏览器扩展 2025.8.0、移动端 2025.8.0、桌面端 2025.8.0、CLI 2025.8.0）*

{% hint style="info" %}
为确保与最新的 Bitwarden 版本兼容，请更新您的客户端和自托管服务器。根据 [Bitwarden 软件发布支持](/docs/security/software-development/software-release-support)政策，保持软件为最新版本将有助于保持完全兼容、支持和解锁最新的 Bitwarden 功能。
{% endhint %}

### Admin Console

* **禁用支付卡项目类型策略**：添加了一项企业策略，允许企业组织限制支付卡项目类型的使用。[了解更多](/docs/admin-console/oversight-visibility/enterprise-policies#remove-card-item-type)。

### Password Manager

* **内嵌自动填充密码生成器改进**：内嵌自动填充密码生成器现在可立即将生成的密码保存为新的登录项目。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#inline-auto-fill-menu)有关内嵌自动填充的信息。
* **改进的项目视图**：添加了对查看密码库项目的改进。更新包括在密码库项目顶部显示收藏夹和其他重要信息。[了解更多](/docs/password-manager/your-vault/vault-items/vault-items)有关密码库项目的信息。
* **Android 现在要求使用 HTTPS**：Android Password Manager App 现在要求使用 HTTPS 连接到服务器。这一更改只会影响没有 SSL/TLS 证书的 Bitwarden 服务器自托管用户。[了解更多](/docs/self-hosting/deploy-and-configure/configuration-options/certificate-options)有关证书的信息。
* **生物识别解锁更新**：桌面 App 重新启动后，现在必须首先使用 PIN 或主密码等生物识别以外的方法解锁，然后才能使用生物识别解锁。[了解更多](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)有关生物识别解锁的信息。

## 2025.7.3

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.7.2）*

### Admin Console

* **成员视图性能改进**：优化了成员视图的加载时间，尤其是对于拥有大量成员的组织而言。

### 提供商门户 <a href="#provider-portal" id="provider-portal"></a>

* **计费更新**：尚未在**计费** → **订阅**页面上添加付款方式的提供商应尽快添加一个付款方式。具有未支付账单的提供商现在将在未支付账单到期 30 天后被暂停服务，包括暂停客户组织。对于尚未添加有效付款方式的提供商，添加一个有效付款方式将确保服务的无缝延续。

### 自托管 <a href="#self-host" id="self-host"></a>

* **弃用的日志记录方式**：对于自托管用户，Bitwarden 中与 `syslog` 的直接集成（通过覆盖 `enabledglobalSettings__syslog__destination` 启用）已被弃用，转而与 Docker 的 `syslog` 驱动程序集成。使用弃用方法的用户将收到警告日志，通知他们这一变更。[了解更多](/docs/self-hosting/hosting-faqs#how-do-i-enable-logging-to-syslog)。

## 2025.7.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.7.1、浏览器扩展 2025.7.0、桌面端 2025.7.1、CLI 2025.7.0）*

### Password Manager

* **URI 匹配检测警告更新**：选择使用高级选项**开始于**和**正则表达式**设置 URI 匹配检测的用户将看到一个警告对话，以确认他们了解与这些自动填充选项相关的潜在安全风险。[了解更多](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill#match-detection-options)。
* **针对新用户的屏幕提示 - 浏览器扩展**：为帮助新用户，浏览器扩展中添加了屏幕提示。这些提示将有助于向新用户介绍浏览器扩展的功能和组件。[了解更多](/docs/password-manager/getting-started/getting-started-browserext)。
* **浏览器扩展权限更新**：Firefox 和 Safari 上的浏览器扩展现在需要通知权限才能支持[设备登录](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)。
* **Android 上的 Chromium 集成**：如果您使用 Brave 或 Chrome 浏览器，请切换新的**使用 Brave 自动填充集成**或**使用 Chrome 自动填充集成**选项。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-android)。

### Secrets Manager

* **新的机密事件**：现在会在创建、编辑或删除机密时记录事件日志。[了解更多](/docs/admin-console/oversight-visibility/event-logging/event-logs#secrets-manager-events)。

## 2025.7.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.7.0）*

### Password Manager

* **Password Depot 17 导入**：Password Depot 17 已被添加到可直接导入 Bitwarden Password Manager 的格式列表中。[了解更多](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

### Admin Console

* **策略重命名**：**移除个人密码库**策略已重命名为**执行组织数据所有权**策略。[了解更多](/docs/admin-console/oversight-visibility/enterprise-policies#enforce-organization-data-ownership)。
* **成员权限更新**：拥有**管理账户恢复**权限的组织成员可以重置组织成员的主密码。该权限可与**管理用户**权限分开授予。[了解更多](/docs/admin-console/manage-members/member-roles#permissions)。

## 2025.6.2

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.6.1、浏览器扩展 2025.6.0、桌面端 2025.6.0、CLI 2025.6.0）*

{% hint style="info" %}
**使用旧版加密方案的账户不再受支持**：2017 年之前创建且 2023 年以来未登录过网页 App 的老账户，因使用了旧版加密方案，这些账户将不再受支持。仅两年内无任何使用记录的休眠账户会受到影响。[了解更多](/docs/miscellaneous/legacy-user-support)。
{% endhint %}

{% hint style="danger" %}
**自托管的 Kerberos 身份验证支持通知**：在某些部署模式下，自托管服务器版本 2025.6.0-2025.6.2 对 **Kerberos** 外部数据库身份验证的支持会出现中断，这将在即将发布的自托管版本中得到修复，使用 Kerberos 身份验证的客户应等到下一个版本发布后再升级他们的自托管部署，除非 Bitwarden 支持另有说明。
{% endhint %}

### Password Manager

* **添加和编辑项目时浏览器扩展的持久化**：现在，浏览器扩展对项目数据的更改操作将有最长 2 分钟的缓存周期，即使点击其他区域或最小化扩展窗口也不会丢失更改的数据。
* **浏览器扩展通知重新设计**：浏览器扩展通知有了新的外观和体验。[了解更多](/docs/password-manager/autofill/autofill-from/autosave-from-browser-extensions)。
* **移动版 App 高级故障排除**：在移动 App 中，用户现在可以选择本地临时记录 App 事件，以帮助排除 Bitwarden App 中的意外行为。[了解更多](/docs/password-manager/more/troubleshooting/yu-bitwarden-zhi-chi-yi-qi-pai-chu-yi-dong-duan-gu-zhang)。

### Bitwarden Authenticator

* **使用 Password Manager 同步 TOTP**：用户现在可以选择在 Bitwarden Authenticator 和 Bitwarden Password Manager 之间无缝同步验证码数据。[了解更多](/docs/bitwarden-authenticator/totp-sync)。

### Admin Console

* **成员权限更新**：**管理账户恢复**自定义角色权限将授予重置组织成员主密码的权限。成员界面上的任何其他操作也需要**管理用户**权限。了解更多有关[自定义角色](/docs/admin-console/manage-members/member-roles#custom-role)的信息。

## 2025.6.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.6.0、自托管 2025.6.1）*

### 自托管 <a href="#self-host" id="self-host"></a>

* **Helm 无根容器**：Helm 部署现在可以在无根模式下运行 Bitwarden。[了解更多](/docs/self-hosting/deploy-and-configure/helm/self-host-with-helm#rootless-requirements)。

## 2025.5.3

### 自托管 <a href="#self-host" id="self-host"></a>

* **SQL 版本支持**：2025.5.3 版将是最后一个支持 SQL Server 2019 的 Bitwarden 版本。Bitwarden 完全支持 SQL Server 2022。

## 2025.5.2

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.5.1、浏览器扩展 2025.5.1、桌面端 2025.5.0、iOS 2025.5.0、Android 2025.5.0、CLI 2025.5.0）*

{% hint style="info" %}
Bitwarden 客户端即将迎来重要变更！请注意：若长期未更新，旧版本将无法正常运行（尤其影响 CLI 用户）。为了提升安全性和可维护性，请务必将所有已安装客户端升级至最新版本。
{% endhint %}

### Password Manager

* **更新了通知设计**：浏览器扩展通知已更新为全新的视觉设计。[了解更多](/docs/password-manager/autofill/autofill-from/autosave-from-browser-extensions)。
* **支持从桌面和 CLI 导出附件**：现在可以通过桌面 App 和 CLI 将个人密码库文件附件导出为 `.zip` 压缩包。[了解更多](/docs/password-manager/your-vault/vault-items/file-attachments)。
* **Android 动态颜色支持**：Bitwarden Android App 现在支持根据壁纸自动应用配色方案。[了解更多](/docs/password-manager/your-vault/appearance/change-app-appearance#yi-dong-duan)。
* **SSH 批准设置**：在桌面 App 上，启用了 SSH 代理的用户可使用一项新的设置：可以指定 Bitwarden 何时要求您授权访问存储在密码库中的 SSH 凭据。[了解更多](/docs/password-manager/developer-tools/ssh/ssh-agent)有关 SSH 代理设置的信息。

### Admin Console

* **组织赞助的家庭方案**：组织可以直接为员工个人电子邮箱账户（包括非当前组织成员的员工）发放赞助版家庭方案。[了解更多](/docs/admin-console/manage-members/sponsored-families/sponsored-families-for-non-members)有关赞助版家庭方案的信息。
* **集合权限调整**：「可以编辑」和「可以编辑，隐藏密码」权限现默认允许用户删除集合项目，除非启用了新增的「限制为具有「管理集合」权限的成员可以删项目」选项。[了解更多](/docs/admin-console/manage-shared-items/collections/about-collections#collections-permissions)有关集合权限的信息。
* **新的集合管理设置**：为了增加权限定制，添加了一个新的集合管理设置：「限制为具有「管理集合」权限的成员可以删项目」选项。[了解更多](/docs/admin-console/manage-shared-items/collections/collection-settings)有关集合管理设置的信息。

## 2025.5.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.5.0、浏览器扩展 2025.5.0）*

### Password Manager

* **增强的 PIN 要求**：在浏览器扩展中，用于解锁的 PIN 现在必须至少为 4 个字符。这将在未来的版本中逐步更新到其他客户端。
* **从网页和浏览器导出附件**：在网页 App 和浏览器扩展中，现在可以创建包含文件附件的 `.zip` 导出。这将在未来的版本中逐步添加到其他客户端。[了解更多](/docs/password-manager/your-vault/vault-items/file-attachments)。
* **搜索结果中的嵌套集合**：嵌套集合现在包含在搜索结果中，使查找相关项目变得更容易。[了解更多](/docs/admin-console/manage-shared-items/collections/about-collections)有关集合的信息。

### Admin Console

* **组织功能预览**：团队、家庭和免费组织的 Admin Console 现在将显示更高订阅层级所含功能的预览。

## 2025.4.3

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.4.1、浏览器扩展 2025.4.0、桌面端 2025.4.2、CLI 2025.4.0）*

此次发布包含：

### Password Manager

* **设备批准时浏览器扩展中的持久性**：现在，即使您点击退出或最小化扩展程序窗口以使用网页 App 批准请求，浏览器扩展程序也会等待最多两分钟才能获得批准。
* **桌面端主密码二次验证更新**：当某个项目的主密码二次验证选项处于活动状态时，桌面 App 现在将控制成功验证后的所有字段，而不仅仅是隐藏字段。[了解更多](/docs/password-manager/your-vault/vault-items/vault-items#protect-individual-items)。
* **移动 App 的高级故障排除**：在移动 App 中，打开 Flight Recorder 以本地临时记录 App 事件，以帮助排除 Bitwarden App 中的意外行为。[了解更多](/docs/password-manager/more/troubleshooting/yu-bitwarden-zhi-chi-yi-qi-pai-chu-yi-dong-duan-gu-zhang)。

### Admin Console

* **外部 ID 显示更新**：外部 ID 现在只有在通过 SCIM、Bitwarden Directory Connector 或 API 配置后，才会显示在群组、集合和成员对话框中。了解更多有关 [Directory Connector](/docs/admin-console/manage-members/directory-connector/about-directory-connector) 的信息。
* **成员 SSO 外部 ID**：对于配置为使用 SSO 的成员，成员 SSO 外部 ID 将显示在成员对话框中。

## 2025.4.0

此次发布包含：

### Password Manager

* **Edge 导出 (csv)**：Edge (csv) 导出已添加到可导入 Bitwarden Password Manager 的格式列表中。[了解更多](/docs/password-manager/import-and-export/import-data)。

## 2025.3.3

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.3.1、浏览器扩展 2025.3.2、桌面端 2025.3.2、CLI 2025.3.0）*

此次发布包含：

### Password Manager

* **浏览器扩展筛选器持久性**：为了在浏览器扩展和网页之间导航时获得更好的体验，搜索条件和筛选器现在可持续两分钟，或者直到您更改浏览器扩展中的活动选项卡。
* **浏览器扩展的加载时间**：我们进行了几项改进，以改善浏览器扩展的加载时间。[了解更多](/docs/password-manager/getting-started/getting-started-browserext)有关 Bitwarden 浏览器扩展的信息。
* **重新排序网站 URI**：在网页 App 和浏览器扩展的「编辑登录」视图中，您现在可以使用拖放 (**≡**) 按钮来重新排序网站 URI，以获得更好的视觉组织效果。
* **Linux 桌面支持 FIDO2 两步登录**：Linux 桌面 App 现在支持使用 FIDO2 通行密钥的两步登录。[了解更多](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)。
* **SSH 代理转发**：Bitwarden 桌面 App 上 SSH 代理转发的支持已得到改进。[了解更多](/docs/password-manager/developer-tools/ssh/ssh-agent)有关 Bitwarden SSH 代理的信息。

## 2025.3.0

此次发布包含：

### 我的账户 <a href="#my-account" id="my-account"></a>

* **新设备验证，新账户宽限期**：新创建的账户在创建后的 24 小时内将不受新设备登录保护。[了解更多](/docs/account/log-in-and-unlock/new-device-protection)。

### Password Manager

* **登录请求横幅通知**：设备登录请求现在会在等待批准期间在网页 App 中显示一个横幅通知。[了解更多](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)有关设备登录的信息。

### Admin Console

* **域名验证更名**：面向企业组织的「域名验证」已更名为「声明域名」。[了解更多](/docs/admin-console/oversight-visibility/claimed-domains/claimed-domains)。
* **声明账户**：当企业组织声明一个域名时，具有与此域名匹配的电子邮箱的所有成员账户现在也将被组织声明，允许管理员删除账户。被声明的账户还有一些其他账户操作限制。[了解更多](/docs/admin-console/oversight-visibility/claimed-domains/claimed-accounts)。
* **报告中未分配的项目**：组织拥有的未分配给集合的项目现在会列出互动链接，以便在组织密码库健康状况报告中进一步查看。

### 自托管 <a href="#self-hosting" id="self-hosting"></a>

* **移至 GitHub Container Registry**：容器镜像已从 Docker Hub 移至 GitHub Container Registry。如果您正在使用非 `bitwarden.sh` 或 `bitwarden.ps1` 脚本方法进行部署，请将镜像引用更新为 GitHub Container Registry URL（例如 `ghcr.io/bitwarden/image_name:version`）。

## 2025.2.1

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.2.2、浏览器扩展 2025.2.2、桌面端 2025.2.1、CLI 2025.2.0）*

此次发布包含：

### 我的账户 <a href="#my-account" id="my-account"></a>

* **新设备登录保护**：为确保您的账户安全，Bitwarden 将逐步开始要求未使用两步登录或 SSO 的用户进行额外的验证。[了解更多](/docs/account/log-in-and-unlock/new-device-protection)。
* **恢复密码使用更新**：使用恢复密码时，虽然仍需要您的电子邮箱地址和主密码，但现在将自动登录您的密码库并停用两步登录，而不是仅停用两步登录。[了解更多](/docs/account/two-step-login/recovery-codes#use-your-recovery-code)。
* **适用于 macOS 桌面的 FIDO2 两步登录**：macOS 桌面 App 现在支持使用 FIDO2 通行密钥的两步登录。[了解更多](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)。

### Password Manager

* **「点击以自动填充」设置已移动**：浏览器扩展上的「点击以自动填充」设置已移至**设置** → **外观**选项卡。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#zi-ding-yi-zi-dong-tian-chong-xing-wei)。
* **阻止 iOS 上的重复通行密码**：在 iOS 上无法保存与 Bitwarden 密码库中已存储的现有用户名和服务相匹配的重复通行密钥。现有通行密钥可能会被修改或覆盖。[了解更多](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys#using-passkeys-with-bitwarden)有关创建通行密钥的信息。
* **企业单点登录更新**：在单点登录工作流程的第一步添加了「使用单点登录」按钮，以简化企业单点登录。[了解更多](/docs/account/log-in-and-unlock/using-single-sign-on/using-login-with-sso#login-using-sso)。

### Admin Console

* **「禁用 PIN 码解锁」策略**：企业组织现在可以一个设置策略，禁止成员在客户端 App 中使用 PIN 码解锁。[了解更多](/docs/admin-console/oversight-visibility/enterprise-policies)。
* **策略不合规变更**：以前因不合规而从组织中删移除成员的策略，现在将改为撤销这些成员的访问权限。[了解更多](/docs/admin-console/manage-members/user-management#revoke-access)。
* **适用于设备批准请求的电子邮件通知**：每当组织成员提交可信设备批准请求时，管理员现在都会收到一封电子邮件。[了解更多](/docs/admin-console/login-with-sso/trusted-devices/approve-a-trusted-device)。

### 提供商门户 <a href="#provider-portal" id="provider-portal"></a>

* **将现有组织添加到提供商门户**：如果提供商用户也是组织的所有者，现在可以将现有组织添加到提供商门户。[了解更多](/docs/provider-portal/get-started-with-provider-portal#add-an-existing-organization)。

## 2025.2.0

*（所列版本号为 Bitwarden 服务器的版本号，在此周期中发布的其他版本号还包括 Web 2025.2.1）*

{% hint style="info" %}
为确保账户安全，在即将发布的版本中，**对于没有使用两步登录的用户**，Bitwarden 将对其要求额外的验证。希望避免新设备验证工作流的用户可以：

* 按照[此页面](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)上的任何指南预先设置两步登录。
* 从**设置** → **我的账户** → **危险操作区**界面中退出此功能。

[了解更多](/docs/account/log-in-and-unlock/new-device-protection)。
{% endhint %}

此次发布包含：

### Password Manager

* **提高了导入项目的限制**：提高了 Password Manager 导入项目的数量限制。[了解更多](/docs/password-manager/import-and-export/import-data)。

### Admin Console

* **集合权限更新**：
  * **集合权限名称已更新**：更新了集合权限名称，使其更加清晰明了。[了解更多](/docs/admin-console/manage-members/member-roles#permissions)。
  * **更新「编辑项目、隐藏密码」权限**：为提高安全性，「编辑项目、隐藏密码」权限将不再允许用户将集合中的项目分配到另一个集合。

## 2025.1.2

*（版本号为 Bitwarden 网页 App 的版本号，本周期发布的其他版本号分别为服务器 2025.1.4、桌面端 2025.1.4、浏览器扩展 2025.1.3、CLI 2025.1.3、iOS 2025.1.2 和 Android 2025.1.1）*

此次发布包含：

### Password Manager

* **更改密码库项目所有者**：在网页 App 上，现在您可以直接从编辑窗口通过将其所有者更改为您所属的任何组织来共享密码库项目。[了解更多](/docs/password-manager/organization-members/sharing)。
* **屏蔽浏览器扩展的自动填充**：现在可以专门指示浏览器扩展不允许在某些域名上进行自动填充。[了解更多](/docs/password-manager/autofill/more-autofill-options/blocking-autofill)。
* **移动版 Bitwarden Send 更新**：移动 App 上的 Bitwarden Send 选项已不再支持设置有效期和停用 Send，这与浏览器扩展目前提供的功能一致。在未来的版本中，其他客户端也将停止对这些选项的支持。[了解更多](/docs/password-manager/bitwarden-send/send-lifespan)。

### 方案 & 定价 <a href="#plans-and-pricing" id="plans-and-pricing"></a>

* **重启组织订阅**：已终止或失效的 Bitwarden 订阅现在有 7 天的宽限期，用户可以重新激活订阅。了解更多有关[组织续费](/docs/plans-and-pricing/organization-renewal)的信息。

## 2025.1.1

此次发布包含：

### Password Manager

* **SSH 代理**：Bitwarden 用户现在可以直接使用 Bitwarden Password Manager 安全地存储和生成 SSH 密钥。[了解更多](/docs/password-manager/developer-tools/ssh/ssh-agent)有关 Bitwarden SSH 代理的信息。
* **使用网页设备批准**：使用网页 App 批准新的受信任设备和设备登录请求。[了解更多](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)。
* **更新了桌面端的生成器**：桌面 App 上的密码和用户名生成器的用户界面已更新，以反映其他 Bitwarden App 的最新设计。[了解更多](/docs/password-manager/your-vault/security-tools/generator)。

### Admin Console

* **SSO 外部 ID 被添加到公共 API 响应中**：返回组织成员数据的公共 API 响应现在将在适用时包含其 SSO 外部标识符。[了解更多](https://bitwarden.com/help/api/)。

### 自托管 <a href="#self-hosting" id="self-hosting"></a>

* **旧用户加密密钥迁移**：更新到服务器版本 `2025.1.3` 时，自托管服务器将要求具有现有旧加密密钥的用户（通常是 2021 年之前创建的不经常使用网页 App 的账户）登录网页 App 迁移旧加密密钥。

{% hint style="info" %}
受影响的用户将被注销，并被阻止登录非网页 Bitwarden 客户端，直到他们通过登录 Bitwarden 网页 App 完成迁移。**为确保您的用户不会失去服务，Bitwarden 建议：**

1. 尽快将您的自托管服务器升级到版本 `2025.1.0`。
2. 通知用户应在此更新后登录网页 App ，以确保在被 `2025.1.3` **强制执行之前**迁移现有的旧密钥。
3. 在收到通知后的一段时间内，安排将托管服务器升级到版本 `2025.1.3`，以允许用户迁移现有的旧密钥。
   {% endhint %}

## 2025.1.0

此次发布包含：

### Password Manager

* **更多自动填充自定义选项**：浏览器扩展现在具有更多选项来自定义您的自动填充体验，包括选择项目卡片而不是「**填充**」按钮来自动填充，以及多个快速复制操作。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#zi-ding-yi-zi-dong-tian-chong-xing-wei)。
* **Snap Store 桌面 App 生物识别解锁**：通过 Snap Store 下载的密码管理桌面 App 现在支持生物识别解锁。[了解更多](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#zhuo-mian-duan)。
* **TOTP 代码的内嵌自动填充**：内嵌自动填充菜单现在可用于选择 TOTP 代码。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#use-the-inline-auto-fill-menu)有关内嵌自动填充菜单的信息。
* **iOS 上长按自动填充**：在 iOS 18+ 上长按任何文本字段即可从 Bitwarden 自动填充。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-ios)。
* **新的公共 API 操作**：`/public/organization/subscription` 端点添加了一个 GET 操作。[了解更多](/docs/admin-console/bitwarden-public-api)有关 Bitwarden 公共 API 的信息。

### Admin Console

* **移除免费的 Bitwarden 家庭赞助策略**：该策略允许企业组织阻止用户通过他们的组织兑换赞助的家庭方案。[了解更多](/docs/admin-console/manage-members/sponsored-families/sponsored-families-for-members)。
* **集成页面**：Admin Console 导航菜单中添加了集成页面。集成页面提供了Bitwarden SSO 集成、事件管理等常用的帮助中心链接！

### 提供商门户 <a href="#provider-portal" id="provider-portal"></a>

* **提供商成员不再能导出客户密码库**：为了提高客户组织的安全性和私密性，提供商成员将不再具有导出客户密码库的权限。

## 2024.12.0

{% hint style="info" %}
2025 年，Bitwarden 将开始逐步停止对 FIDO 通用第二因素 (U2F) 密钥的支持，这些密钥可以在网页 App 的**两步登录** → **管理 FIDO2 WebAuthn** 视图中识别为标记为「**迁移自 FIDO**」。如果您目前使用的是已迁移的 U2F 密钥，请移除并重新注册该密钥，以便自动[将其设置为 WebAuthn](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)。
{% endhint %}

此次发布包含：

### Password Manager

* **浏览器扩展和网页 App 用户界面更新**：重新设计了 Bitwarden Password Manager 浏览器扩展的用户界面，同时包含网页 App 用户界面的一些增强的样式更改。[了解更多](https://bitwarden.com/blog/bringing-intuitive-workflows-and-visual-updates-to-the-bitwarden-browser/)。
* **网页 App 视图项目面板**：网页 App 现在将打开项目到「查看」面板，而不是直接打开「编辑」面板。只有拥有项目编辑权限的用户才能使用「编辑」按钮更改密码库项目。[了解更多](/docs/password-manager/your-vault/vault-items/vault-items)。
* **iOS 18.0+ 自动填充 TOTP 代码**：iOS 18.0（或更新版本）上的 Bitwarden 键盘自动填充功能现在可以在登录表单中自动填充 TOTP 代码。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-ios)有关 iOS 自动填充的更多信息。
* **PasswordXP .csv 导入器**：PasswordXP .csv 已被添加到可导入 Bitwarden Password Manager 的格式列表中。[了解更多](/docs/secrets-manager/import-export/import-data)。
* **Netwrix Password Secure .csv 导入器**：Netwrix Password Secure .csv 已被添加到可导入 Bitwarden Password Manager 的格式列表中。[了解更多](/docs/secrets-manager/import-export/import-data)。

### Admin Console

* **适用于团队组织的 SCIM**：团队组织现在可以使用跨域身份管理系统 (SCIM) 自动从源目录配置成员和群组。此前，这仅适用于企业组织。[了解更多](/docs/admin-console/manage-members/scim/about-scim)。

## 2024.11.0

此次发布包含：

### 我的账户 <a href="#my-account" id="my-account"></a>

* **所有客户端注册期间的电子邮箱验证**：使用任何 Bitwarden 客户端创建新 Bitwarden 账户的用户现在将被要求在创建主密码之前验证其电子邮邮箱。[了解更多](/docs/account/create-bitwarden-account)。

### Password Manager

* **内联自动填充菜单密码生成**：现在，在填写账户创建或密码更新字段时，可使用内联自动填写菜单轻松生成密码。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)。
* **支付卡和身份的内联自动填充菜单选项**：您现在可以打开或关闭将支付卡和身份作为建议包含在内联自动填写菜单中的选项。[了解更多](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities#using-the-inline-menu)。
* **iOS 复制和粘贴更新**：Bitwarden iOS 复制和粘贴功能添加了多个更新，以方便使用。
* **改进了非官方服务器的错误处理**：为了帮助使用非官方 Bitwarden 服务器的用户，添加了新的错误消息以帮助识别连接到非官方服务器时的错误。
* **暂时移除桌面 App 上的「允许屏幕捕获」开关**：为改善该功能的使用体验，已暂时移除 macOS 和 Windows 桌面 App 上的该功能。目前，桌面 App 将通过截图和屏幕共享捕获。
* **增加密码短语的最少单词数**：密码短语生成器现在要求生成的密码短语至少包含 6 个单词（移动客户端除外）。[了解更多](/docs/password-manager/your-vault/security-tools/generator#password-types)。

### Admin Console

* **集合管理设置更新**：限制所有者和管理员创建和删除集合的设置已被分离为两个单独的设置，分别用于每种操作。[了解更多](/docs/admin-console/manage-shared-items/collections/collection-settings#collection-management-settings)有关集合管理的信息。
* **删除集合项目需要「可以管理」权限**：现在删除集合项目需要「可以管理」权限。具有「可以编辑」权限的用户不再具有该权限。[了解更多](/docs/admin-console/manage-members/member-roles#permissions)有关成员权限的信息。

## 2024.10.4

此次发布包含：

### Admin Console

* **限制对 `bw list org-members` 命令的访问**：此命令以及 Vault Management API 中的等效端点现在仅限于所有者、管理员和具有「管理用户」权限的自定义用户。

### 提供商门户 <a href="#provider-portal" id="provider-portal"></a>

* **计费系统迁移**：从本月开始，现有的提供商将开始迁移到更新的客户组织计费系统。[了解更多](/docs/provider-portal/provider-billing)。

## 2024.10.2

此次发布包含：

### 我的账户 <a href="#my-account" id="my-account"></a>

* **注册期间的电子邮箱验证**：通过网页 App 创建 Bitwarden 账户的用户现在将被要求在创建主密码之前验证其电子邮箱。[了解更多](/docs/account/create-bitwarden-account)。

### Password Manager

* **使用生物识别解锁 - Linux 浏览器扩展**：Linux 用户现在可以在基于 Chromium 的浏览器上使用 Bitwarden 浏览器扩展的生物识别解锁功能。[了解更多](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#enable-unlock-with-biometrics)。
* **桌面 App 阻止屏幕捕获**：默认情况下，Windows 和 macOS 的桌面 App 现在将阻止屏幕捕获和录制。[了解更多](/docs/password-manager/getting-started/getting-started-desktop#xia-yi-bu)。
* **在桌面端同步锁定的密码库**：即使活动账户被锁定，桌面 App 现在也可以手动同步。[了解更多](/docs/password-manager/your-vault/syncing-your-vault#manual-sync)。

### Admin Console

* **Microsoft Sentinel 集成**：新的本地集成可用于 Microsoft Sentinel 安全信息与事件管理 (SIEM)。该集成提供了跨身份验证、组织活动和密码库项目的全面事件覆盖。[了解更多](/docs/admin-console/oversight-visibility/siem-integrations/microsoft-sentinel-siem)。
* **Ping Identity SCIM 支持**：Bitwarden 组织现已正式支持 Ping Identity 跨域身份管理 (SCIM) 系统。使用 Ping Identity SCIM 集成来自动配置 Bitwarden 组织中的成员和群组。[了解更多](/docs/admin-console/login-with-sso/sso-guides/ping-identity-saml)。
* **UI 改进升级方案**：为简化将您的组织升级到另一个方案的流程，对 UI 进行了改进。[了解更多](/docs/admin-console/organizations-overview#upgrade-an-organization)。
* **为允许的应用程序策略自动登录用户**：这项新策略将允许 IdP 管理员启用非 SSO 应用程序，以便在从其 IdP 面板启动时自动登录用户。[了解更多](/docs/admin-console/oversight-visibility/enterprise-policies#automatically-log-in-users-for-allowed-applications)。

## 2024.9.2

此次发布包含：

### Password Manager

* **现在，网页 App 默认将下载 PDF 附件**：作为项目附件存储的 PDF 将下载到您的设备上进行查看，而不是在新的浏览器选项卡中打开。[了解更多](/docs/password-manager/your-vault/vault-items/file-attachments)。

### Secrets Manager

* **新的机器账户视图**：机器账户有一个新的**配置**选项卡，可以快速查看配置应用程序以使用机器账户时可能需要的信息。[了解更多](/docs/secrets-manager/your-secrets/machine-accounts#configuration-information)。

## 2024.9.1

此次发布包含：

### Password Manager

* **通行密钥的内联自动填充菜单**：使用内联自动填充菜单通过通行密钥进行身份验证。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#use-the-inline-auto-fill-menu)。

### Admin Console

* **成员访问报告**：企业组织可使用成员访问报告来监控组织成员对群组、集合和项目的访问情况。[了解更多](/docs/password-manager/your-vault/security-tools/vault-health-reports#member-access)。
* **移除用户事件的修复**：现在可以正确记录通过公共 API 或 Directory Connector 移除用户的事件。

## 2024.8.2

此次发布包含：

### Password Manager

* **iOS 原生移动 App**：通过 Apple App Store 下载的 Password Manager 移动 App 已升级为原生移动应用程序。[了解更多](/docs/miscellaneous/native-mobile-apps)。
* **用于密码保护导出的密码生成器**：Bitwarden 现在可以为受密码保护的导出生成唯一密码。[了解更多](/docs/password-manager/import-and-export/encrypted-exports#create-an-encrypted-export)有关密码保护导出的更多信息。

### Admin Console

* **Rapid7 SIEM 集成**：Bitwarden 组织现在可以使用 Rapid7 进行安全信息与事件管理 (SIEM)。[了解更多](/docs/admin-console/oversight-visibility/siem-integrations/rapid7-siem)。

## 2024.8.0

{% hint style="info" %}
在**未来的**发布中，通过 Apple App Store 和 Google Play Store 下载的 Password Manager 移动 App 将升级为原生移动 App。[了解更多](/docs/miscellaneous/native-mobile-apps)。
{% endhint %}

此次发布包含：

### Password Manager

* **自动填充支付卡和身份**：现在可以使用其他自动填充方式填充支付卡和身份：
  * 使用键盘快捷键自动填充支付卡和身份。[了解更多](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities#using-keyboard-shortcuts)。
  * 使用内嵌自动填充菜单填充支付卡和身份。[了解更多](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities#using-the-inline-menu)。
* **使用生物识别解锁 Linux 桌面 App**：使用 Polkit 的 Linux 用户现在可以在 Bitwarden 桌面 App 上使用生物识别解锁功能。[了解更多](/docs/password-manager/getting-started/getting-started-desktop#linux)。

### Secrets Manager

* **显示机器账户、工程和机密的总数**：Secrets Manager 导航栏现在将显示您有权访问的机器账户、工程和机密的总数。

### Admin Console

* **更改成员解密选项时的其他支持选项**：如果您的组织从受信任设备 SSO 迁移到主密码解密，系统将在用户下次登录时提示创建主密码，而不是要求管理员事先分配主密码。[了解更多](/docs/admin-console/login-with-sso/trusted-devices/about-trusted-devices#impact-on-master-passwords)。

### 提供商门户 <a href="#provider-portal" id="provider-portal"></a>

* **UI 改进**：「人员」页面已重命名为「成员」页面，提供商门户的配色方案也已更改为以与 Admin Console 匹配。

## 2024.7.3

此次发布包含：

### Secrets Manager

* **新的 Secrets Manager 登录页面**：快速了解有关 Secrets Manager 的更多信息并直接从网页 App 注册该产品。[了解更多](/docs/secrets-manager/get-started/secrets-manager-quick-start)。

### 提供商门户 <a href="#provider-portal" id="provider-portal"></a>

* **限制提供商对密码库项目的访问**：为了提高客户的安全性和隐私性，提供商用户可能不再直接查看、管理或创建客户组织的保管库中的项目。但是，提供商用户可以将库数据直接导入到客户组织。

## 2024.7.2

此次发布包含：

### 提供商门户 <a href="#provider-portal" id="provider-portal"></a>

* **新提供商的合并计费**：在此版本之后加入 Bitwarden 的提供商的计费程序现已简化，并仅通过提供商门户进行管理。现有提供商将在未来版本中迁移到新的计费系统。[了解更多](/docs/provider-portal/provider-portal-overview)。

## 2024.7.1

此次发布包含：

### Password Manager

* **移除通行密钥用户验证**：最近的更新要求在浏览器扩展上使用通行密钥时进行用户验证，该更新已暂时回退。
* **启用了 PRF 的通行密钥将在账户加密密钥轮换后继续有效**：如果用户轮换了他们的账户加密密钥，使用通行密钥登录 Bitwarden 时使用的 PRF 密钥现在继续有效。[了解更多](/docs/security/encryption/encryption-key-rotation#rotate-your-encryption-key)。
* **紧急联系人和提供商的邀请说明**：受信任的紧急联系人和提供商用户在接受邀请后，现在将进入「需要确认」状态，使您的下一步操作更清晰。
* **批量分配项目到集合**：现在，您可以从密码库视图中将项目批量分配到组织的集合中。此功能的前一版本称为「移动到组织」。[了解更多](/docs/password-manager/your-vault/vault-items/vault-items#assign-to-collections)。
* **重命名将项目添加到文件夹**：在密码库视图中，将项目添加到文件夹的选项已从「移动所选」重命名为「添加到文件夹」。[了解更多](/docs/password-manager/your-vault/vault-navigation/folders#move-items-to-a-folder)。
* **弃用桌面 App 设置**：桌面应 App 现在默认可以批准设备登录。[了解更多](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)。
* **改进的 SSO 标识符工作流程**：管理员现在可以分发企业单点登录界面的 URL，并将其 SSO 标识符作为查询参数包含在内，以自动将组织成员重定向到 IdP，从而获得更简化的 SSO 体验。[了解更多](/docs/admin-console/login-with-sso/login-with-sso-faqs#q-do-i-need-to-enter-my-organization-identifier-every-time-i-login)。

### Secrets Manager

* **添加对机密的直接访问权限**：现在可以直接授予人员和机器账户对机密的访问权限，而不需要项目作为中介。[了解更多](/docs/secrets-manager/your-secrets/secrets)。

### 自托管 <a href="#self-hosting" id="self-hosting"></a>

{% hint style="info" %}
用户应在 2024.10.x 版本之前将自托管服务器至少升级到此版本，以确保与使用密码库项目密钥的客户端兼容。
{% endhint %}

* **支持批量设备批准**：自托管 Bitwarden 服务器现在支持用于受信任设备 SSO 的批量设备批准。[了解更多](/docs/admin-console/login-with-sso/trusted-devices/approve-a-trusted-device#bulk-approve-requests)。

### 安全 <a href="#security" id="security"></a>

* **密码库项目秘钥**：添加了额外的加密层，其形式是为每个单独的密码库项目生成新的加密密钥。[了解更多](/docs/security/bitwarden-security-whitepaper#how-vault-data-is-encrypted)。

### 方案 & 定价 <a href="#plans-and-pricing" id="plans-and-pricing"></a>

* **按月计费的组织账单更新**：按月计费的团队和企业组织将看到按比例分配的席位数调整包含在下一次生成的月度账单中，而不是在席位数变化时新生成的账单中。
* **按年计费的组织账单更新**：按年计费的团队和企业组织将看到按比例分配的席位数调整包含在每月一次的调整账单中，而不是在席位数变化立即生成的单独账单中。

## 2024.6.3

此次发布包含：

### Password Manager

* **批量批准可信任设备 SSO**：管理员和所有者现在可以使用[网页 App](/docs/admin-console/login-with-sso/trusted-devices/approve-a-trusted-device#bulk-approve-requests) 或 [CLI](/docs/password-manager/developer-tools/cli/password-manager-cli#device-approval) 批量批准可信设备请求。
* **陈旧的用户加密密钥迁移**：2021 年之前创建的 Bitwarden 账户已将其账户加密密钥迁移到 Bitwarden 的更现代化的用户对称密钥。这些用户将被从非网页 Bitwarden 客户端注销，直到他们通过登录 Bitwarden 网页客户端完成迁移。[了解更多](/docs/security/encryption/encryption-protocols)有关 Bitwarden 加密的信息。

### 自托管 <a href="#self-hosting" id="self-hosting"></a>

* **支持更多集合管理选项**：自托管 Bitwarden 服务器现在支持**所有者和管理员可以管理所有集合和项目**集合管理选项。[了解更多](/docs/admin-console/manage-shared-items/collections/collection-settings)。

## 2024.6.1

此次发布包含：

### Password Manager

* **集合管理更新**：添加了集合管理选项，允许您决定是否自动向管理员和所有者提供对组织中所有集合及其项目的管理权限。[了解更多](/docs/admin-console/manage-shared-items/collections/collection-settings)。

## 2024.6.0

此次发布包含：

### Password Manager

* **通行密钥用户验证**：当使用存储的通行密钥登录时，浏览器扩展现在可能会提示用户使用生物识别、PIN 或主密码进行验证。[了解更多](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys#liu-lan-qi-kuo-zhan)。
* **产品内入门**：Password Manager 的新用户现在将看到一个入门模块，以帮助他们快速开始保护凭据。
* **浏览器扩展设置重组**：使用浏览器扩展上新重组的设置界面可以快速定位和修改浏览器扩展设置。
* **Firefox 扩展在隐私窗口中获得完整功能**：在 Firefox 隐私窗口中使用 Bitwarden 浏览器扩展不再有任何限制。[了解更多](/docs/password-manager/more/more-platforms/use-bitwarden-in-firefoxs-private-mode)。
* **增加产品切换器的位置**：用于在 Password Manager、Admin Console、Secrets Manager 和提供商门户之间切换的产品切换器现在也可以在导航的左下角找到。
* **浏览器扩展和桌面端的密码保护导出**：浏览器扩展和桌面端应用程序现在可以导出受密码保护的加密导出。[了解更多](/docs/password-manager/import-and-export/encrypted-exports#create-an-encrypted-export)。

### Bitwarden Authenticator

* **导入到 Bitwarden Authenticator**：将数据从 Google Authenticator、LastPass Authenticator、Raivo 以及 2FAS 等其他各种身份验证 App 直接导入到 Bitwarden Authenticator。[了解更多](/docs/bitwarden-authenticator/import-and-export)。

### Secrets Manager

* **开始 Secrets Manager 试用**：开始 Secrets Manager 企业版试用，以测试概念验证，并获得对 SSO 和 SCIM 集成、企业策略、自托管、事件日志和优先级支持等企业功能。[立即注册 Secrets Manager 7 天免费试用](https://vault.bitwarden.com/#/register?org=enterprise\&layout=secretsManager)。
* **Secrets Manager Kubernetes Operator (beta)**：使用 Bitwarden Secrets Manager Kubernetes Operator 安全高效地将 Secrets Manager 集成到 Kubernetes 工作流中。[了解更多](/docs/secrets-manager/integrations/secrets-manager-kubernetes-operator)。

### Admin Console

* **集合管理更新**：添加了一个集合管理选项，允许您决定是否自动向管理员和所有者提供对组织中所有集合及其中的项目的管理权限。[了解更多](/docs/admin-console/manage-shared-items/collections/collection-settings)。
* **通过 API 配置自定义用户**：现在可以通过公共 API 配置组织成员的自定义角色权限。[了解更多](https://bitwarden.com/help/api/)。

## 2024.5.0

此次发布包含：

### Password Manager

* **从我的密码库克隆组织项目**：具有「可以管理」权限的用户现在可以从其密码库视图克隆组织所拥有的项目。[了解更多](/docs/password-manager/your-vault/vault-items/vault-items#clone)。
* **浏览器扩展平台升级**：从本周开始，Password Manager 浏览器扩展将开始逐步升级到名为 Manifest V3 的新扩展平台，从 1% 的用户开始，并在整个 5 月份逐步增加。不论是启动此升级或完成升级后，您都无需采取任何行动。

### Admin Console

* **Splunk Cloud 集成**：Bitwarden 事件日志 App 可用于 Splunk Cloud Classic 和 Splunk Cloud Victoria 上的信息和事件管理。[了解更多](/docs/admin-console/oversight-visibility/siem-integrations/splunk-siem)。

### 自托管 <a href="#self-hosting" id="self-hosting"></a>

* **集合管理和弃用经理角色**：自托管服务器现在可以访问集合管理功能，具有「经理」角色的用户将迁移到具有新的「可以管理」权限的「用户」角色。[了解更多](/docs/admin-console/manage-shared-items/collections/collection-settings)。

{% hint style="info" %}
如果是自托管，请在云端组织中设置[集合管理设置](/docs/admin-console/manage-shared-items/collections/collection-settings)，然后[更新自托管服务器的许可证](/docs/self-hosting/licensing-on-premise#update-organization-license)以将这些设置转移到您的自托管组织。
{% endhint %}

## 2024.4.2

此次发布包含：

### Password Manager

* **在移动 App 上使用通行密钥**：Password Manager 移动 App 现在可以使用通行密钥创建和登录。此功能适用于 iOS 系统，Android 系统为测试版。[了解更多](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)。
* **删除已存储的通行密钥**：现在可以使用 Bitwarden 浏览器扩展和桌面 App 删除存储在 Bitwarden 登录项目中的通行密钥。[了解更多](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)。

### Secrets Manager

* **新的集成页面**：通过 Secrets Manager 网页 App 中的新页面快速访问 Secrets Manager 集成。
* **Secrets Manager CLI Docker 映像**：Bitwarden Secrets Manager CLI 现在已作为 Docker 镜像的形式提供。[了解更多](/docs/secrets-manager/developer-tools/secrets-manager-cli)。

## Bitwarden Authenticator

介绍全新的 Bitwarden Authenticator 独立移动 App。使用 Bitwarden Authenticator 生成用于 App 和网站双因素身份验证的验证码。从应用商店下载或[了解更多](/docs/bitwarden-authenticator/bitwarden-authenticator)。

## 2024.4.1

此次发布包含：

### Password Manager

* **删除存储的通行密钥**：现在可以从 Bitwarden 网页 App 的**密码库项目** → **编辑**界面中删除存储在 Bitwarden 登录项目中的通行密钥。[了解更多](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys#delete-vault-item-passkey)。

### Secrets Manager

* **「服务账户」现在为「机器账户」**：服务账户已重命名为机器账户。

## 2024.3.1

{% hint style="success" %}
[最近迁移到新的权限结构](/docs/admin-console/manage-shared-items/collections/collection-settings#collection-management-settings)，为您的组织带来了更大的集合管理灵活性，未分配给[集合](/docs/admin-console/manage-shared-items/collections/about-collections)的密码库项目现在不再显示在您的 Password Manager 的**所有密码库**视图中了。[了解如何访问这些项目](/docs/miscellaneous/unassigned-vault-items-moved-to-admin-console)。
{% endhint %}

此次发布包含：

### Password Manager

* **Bitwarden App 可使用新的语言**：在社区翻译人员的贡献下，Bitwarden App 现在提供了新的语言选项！[点击这里](/docs/password-manager/your-vault/appearance/localization)查看完整的语言列表。[了解更多](https://contributing.bitwarden.com/contributing/#localization-l10n)关于 Bitwarden 本地化的信息。
* **桌面 App 硬件加速**：Bitwarden 桌面 App 现在可以选择打开或关闭硬件加速以优化性能。该设置默认启用。

### Admin Console

* **批量将项目分配到集合**：从 Admin Console 可以将组织项目批量分配到集合。[了解更多](/docs/admin-console/manage-shared-items/collections/about-collections#collections-ji-he-storing-passkeys-cun-chu-mi-ma-vault-administration-import-export-autofill-bitward)。

## 2024.3.0

此次发布包含：

### 自托管 <a href="#self-hosting" id="self-hosting"></a>

* **适用于 Linux 部署的新的日志功能**：使用标准 `bitwarden.sh` shell 脚本的 Linux 部署现在可以使用新选项来下载压缩日志文件（参阅[这里](/docs/self-hosting/deploy-and-configure/docker/linux-standard-deployment#script-commands-reference)）。

## 2024.2.3

此次发布包含：

### Password Manager

* **网页 App 导航更新**：Bitwarden 网页 App 已完全重新设计！我们希望您能喜欢这个新的体验（[了解更多](https://bitwarden.com/blog/bitwarden-design-updating-the-navigation-in-the-web-app/)）。
* **Duo 2FA 登录更新**：Duo 为用户和管理员引入了通用提示。启用该服务的 Duo 管理员会发现 Duo 2FA 登录流程稍微有一些变化（参阅[这里](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-duo)）。

### 自托管 <a href="#self-hosting" id="self-hosting"></a>

* **支持使用通行密钥登录 (Beta)**：自托管 Bitwarden 服务器现在支持使用通行密钥登录功能（参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)）。

## 2024.2.2

此次发布包含：

### Admin Console

* **适用于终端用户的集合管理**：组织现在可以选择允许所有用户创建和管理他们自己的集合。此选项位于 **组织信息**界面，现有组织可选择加入，2024.2.2 之后创建的组织可选择退出（参阅[这里](/docs/admin-console/manage-shared-items/collections/collection-settings)）。
* **弃用经理角色**：开启集合管理后，具有**经理**角色的组织用户将被迁移到**用户**角色，并获得对其分配的集合进行管理的新权限（参阅[这里](/docs/admin-console/manage-members/member-roles)）。

### Secrets Manager

* **Ansible 集成**：使用 Bitwarden Secrets Manager 检索机密并将其注入您的 playbook 剧本中（参阅[这里](/docs/secrets-manager/integrations/ansible)）。

## 2024.2.0

此次发布包含：

### Password Manager

* **浏览器扩展的 TOTP 捕获**：使用 Bitwarden 浏览器扩展扫描网页并保存 TOTP 验证器二维码（参阅[这里](/docs/password-manager/your-vault/security-tools/totp#scan-a-qr-code)）。
* **增加导入项目数量上限**：Bitwarden Password Manager 的导入相对之前，现在可以包含大约两倍的数据量（参阅[这里](/docs/password-manager/import-and-export/import-data)）。

### Admin Console

* **组织唯一的 SP 实体 ID**：使用 SSO SAML 的组织现在可以升级其实体 ID，升级后的实体 ID 对于其组织来说是唯一的。这样做需要在 IdP 上重新配置（参阅[这里](/docs/admin-console/login-with-sso/sso-guides/generic-saml)）。

### 方案 & 定价 <a href="#plans-and-pricing" id="plans-and-pricing"></a>

* **自动税率计算**：用于订阅的税率现在将由我们的支付分包商根据地理位置自动计算。Bitwarden 收取的小计将保持不变，但您可能会注意到您的含税月度账单将有所变化。

## 2024.1.2

此次发布包含：

### Password Manager

* **适用于自托管的通行密钥存储**：现在可以将通行密钥存储在自托管的 Bitwarden 服务器中（参阅[这里](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)）。

### Admin Console

* **通过公共 API 获得更多集合权限**：现在，您可以使用公共 API 向用户隐藏任意集合的密码（参阅[这里](https://bitwarden.com/help/api/)）。

## 2024.1.0

此次发布包含：

### 我的账户 <a href="#my-account" id="my-account"></a>

* **使用通行密钥登录 (Beta)**：通行密钥可以作为使用主密码和电子邮件的替代方法来登录 Bitwarden 网页 App （参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)）。

### Password Manager

* **浏览器扩展程序的账户切换**：使用 Bitwarden 浏览器扩展程序时，最多可登录 5 个账户并在这些账户之间无缝切换（参阅[这里](/docs/account/log-in-and-unlock/account-switching)）。

### Admin Console

* **通过公共 API 配置订阅**：使用新的公共 API 端点来配置订阅信息，例如席位数、最大自动扩展和存储（参阅[这里](https://bitwarden.com/help/api/)）。
* **更多组织升级路径**：更多 Bitwarden 组织现在可以升级到不同的订阅，而无需联系支持人员。

## 使用 Helm GA 自托管 <a href="#self-host-with-helm-ga" id="self-host-with-helm-ga"></a>

Bitwarden 现在可以使用 Helm Chart 在 Kubernetes 部署中自托管（参阅[这里](/docs/self-hosting/deploy-and-configure/helm/self-host-with-helm)）。

## 2023.12.1

此次发布包含：

### Password Manager

* **自动填充菜单**：通过打开新的内联自动填充菜单，在浏览网页时自动填充凭据（参阅[这里](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#inline-auto-fill-menu)）。

## 2023.12.0

此次发布包含：

### Password Manager

* **关闭使用通行密钥提示的选项**：您现在可以选择浏览器扩展是否要求保存和使用通行密钥（参阅[这里](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys#turn-off-passkey-prompt)）。
* **移动设备上的 ForwardEmail 支持**：移动 App 上的用户名生成器的转发电子邮件别名提供程序现在支持 ForwardEmail（参阅[这里](/docs/password-manager/your-vault/security-tools/generator#generate-a-username)）。
* **密码库健康报告更新**：组织成员现在可以在个人密码库健康报告中看到自己拥有**可编辑**权限的组织拥有的项目。

### Admin Console

* **Elastic 集成**：Bitwarden 组织现在可以使用 Elastic 进行安全信息与事件管理 (SIEM)（参阅[这里](/docs/admin-console/oversight-visibility/siem-integrations/elastic-siem)）。
* **CLI 事件日志**：从网页 App 查看的事件日志现在会指明哪些事件是由 Bitwarden CLI 记录的。

## 2023.10.0

此次发布包含：

### Password Manager

* **保存通行密钥到您的密码库**：现在可以将通行密钥存储在您的 Bitwarden 密码库中了！使用 Bitwarden 浏览器扩展存储并使用通行密钥登录（参阅[这里](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)）。
* **LastPass 直接导入器**：使用浏览器扩展或桌面 App 将数据从 LastPass 直接导入到 Bitwarden（参阅[这里](/docs/password-manager/import-and-export/import-guides/import-data-from-lastpass#import-to-bitwarden)）。
* **从浏览器扩展和桌面 App 导入**：现在可以从浏览器扩展和桌面 App 将数据导入到 Bitwarden，包括如果您是使用 LastPass SSO 的团队成员（参阅[这里](/docs/password-manager/import-and-export/import-data)）。
* **移动端设置重组**：移动 App 上的「设置」选项卡已重新组织为更直观的类别。
* **支持自托管别名提供程序**：Password Manager 客户端上的用户名生成器现在可以连接到自托管 Addy.io 和 SimpleLogin 实例（参阅[这里](/docs/password-manager/your-vault/security-tools/generator#simplelogin)）。
* **通过上下文菜单自动填充支付卡和身份**：现在可以使用浏览器扩展的上下文菜单自动填充支付卡和身份（参阅[这里](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities#using-the-context-menu)）。

### Secrets Manager

* **支持自托管**：企业组织现在可以自行托管 Secrets Manager（参阅[这里](/docs/secrets-manager/get-started/manage-your-organization#zi-tuo-guan)）。
* **全新的事件日志视图**：现在可以直接从服务账户视图访问服务账户事件日志（参阅[这里](/docs/secrets-manager/your-secrets/machine-accounts#service-account-events)）。

## 2023.9.0

此次发布包含：

* **FIDO2 WebAuthn 现已成为免费的两步登录选项**：用于两步登录的 FIDO2 WebAuthn 方法已扩展到免费账户。现在，所有 Bitwarden 用户都可以使用兼容的 FIDO2 WebAuthn 凭证（如那些与硬件安全钥匙绑定的设备）来提高登录的安全性（参阅[这里](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)）。
* **组织成员电子邮件验证**：当组织成员[接受加入邀请](/docs/admin-console/manage-members/user-management#accept)时，或如果他们是使用[域验证](/docs/admin-console/oversight-visibility/claimed-domains/claimed-domains)的组织成员，他们的电子邮件将自动通过验证。
* **导出更新**：密码库数据的 JSON 导出现在将包括适用项目的密码历史记录（参阅[这里](/docs/password-manager/import-and-export/export-vault-data)）。
* **CLI 密码生成器选项**：使用 CLI 生成密码时增加了自定义密码复杂度的选项标志（参阅[这里](/docs/password-manager/your-vault/security-tools/generator#cli)）。
* **ProtonPass JSON 导入器**：ProtonPass JSON 已添加到可用于直接导入 Bitwarden Password Manager 的格式列表中（参阅[这里](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)）。
* **桌面 App 主题更新**：桌面 App 的暗色主题已更新！

## 2023.8.2

此次发布包含：

* **受信任设备 SSO**：受信任设备 SSO 允许用户使用 SSO 进行身份验证，以及使用存储的加密密钥解密其密码库，而无需输入主密码（参阅[这里](/docs/admin-console/login-with-sso/trusted-devices/about-trusted-devices)）。
* **经理集合访问权限**：为了降低对非必要数据的可见性，经理现在只能查看分配给他们的集合。

## 2023.8.0

此次发布包含：

* **Secrets Manager - 全面上市**：Bitwarden Secrets Manager 现已全面上市，使开发人员、DevOps 和网络安全团队能够大规模集中存储、管理、自动化和部署机密。了解有关 [Secrets Manager 方案](/docs/plans-and-pricing/secrets-manager/secrets-manager-plans)和[注册](/docs/plans-and-pricing/secrets-manager/sign-up-for-secrets-manager)的更多信息。
* **导入到文件夹或集合**：从**工具** → **导入数据**界面，将数据直接导入到现有文件夹，或者如果您是组织成员，将数据直接导入到集合。

## 2023.7.1

此次发布包含：

* **Secrets Manager - CLI 更新**：添加了用于编辑和创建工程和机密的新命令，并且 CLI 使用的语法已重新构建（参阅[这里](/docs/secrets-manager/developer-tools/secrets-manager-cli)）。
* **EU（欧盟）云**：带有密码库数据存储的 Bitwarden 云服务器现已在欧盟提供（参阅[这里](/docs/security/server-geographies)）。

## 2023.7.0

此次发布包含：

* **用于自托管的设备登录**：连接到自托管服务器的 Bitwarden 应用程序现在可以通过向已注册设备发送身份验证请求来登录，而不是使用主密码（参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)）。
* **Forward Email 别名集成**：将 Bitwarden 用户名生成器连接到 [Forward Email](https://forwardemail.net/)，以便轻松创建电子邮件别名（参阅[这里](/docs/password-manager/your-vault/security-tools/generator#username-types)）。
* **浏览器扩展 TOTP 自动填充**：浏览器扩展现在将自动填充 TOTP 代码，除非您使用了在页面加载时自动填充功能（参阅[这里](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#totp-auto-fill)）。
* **在 \<textarea> 中使用自动填充**：Bitwarden App 现在可以将凭据自动填充到 HTML 的 `<textarea>` 元素中。
* **从密码库页面创建文件夹和集合**：现在可以从主**密码库**页面使用**新建**按钮创建文件夹和集合。

### Secrets Manager Beta

此次发布包含：

* **Secrets Manager - 服务账户写入权限**：现在服务账户可以被授予对工程和机密的写入权限（参阅[这里](/docs/secrets-manager/your-secrets/machine-accounts)）。
* **Secrets Manager - 批量用户管理**：现在可以将组织成员批量添加到 Secrets Manager（参阅[这里](/docs/secrets-manager/get-started/secrets-manager-quick-start#give-members-access)）。

{% hint style="success" %}
服务账户的写​​入访问权限的充分利用取决于即将发布的 [CLI](/docs/secrets-manager/developer-tools/secrets-manager-cli) 版本。目前，这只是在 UI 中提供了此选项。请继续关注[发行说明](/docs/release-notes)以获取更多信息。
{% endhint %}

## 2023.5.0

{% hint style="danger" %}
从 **2023.5.0** 版本开始，Password Manager 桌面 App 将不再支持 Windows 8.1 及更早版本或 Windows Server 2012 及更早版本。

这些操作系统的用户可以在[此处](https://github.com/bitwarden/clients/releases)下载 2023.4.0 桌面 App，并且必须禁用自动更新（在[此处](/docs/password-manager/more/password-manager-faqs#q-can-i-turn-off-automatic-updates-for-bitwarden)了解更多信息）。我们建议升级到受支持的操作系统，因为 Bitwarden 云服务器不能保证长期支持旧的客户端版本，并且将来可能会给您带来安全风险。
{% endhint %}

此次发布包含：

* **环境选择器**：改进了将 Bitwarden App 连接到自托管服务器的工作流程。参阅[这里](/docs/self-hosting/connect-clients/connect-individual-clients)。
* **Password Manager - 改进了德语 HTML 的自动填充**：德语 HTML 字段现在可用于自动填充。参阅[这里](https://github.com/bitwarden/clients/pull/4210)。
* **Secrets Manager - 在机密创建期间创建工程**：您现在可以在机密创建菜单中创建新的工程。参阅[这里](/docs/secrets-manager/your-secrets/secrets)。
* **自托管 - 阐明有关服务器许可证的措辞**：有 60 天的宽限期来上传新许可证以替换过期的许可证。参阅[这里](/docs/self-hosting/licensing-on-premise#update-organization-license)。
* **低 KDF 警告**：当用户的 KDF 迭代次数低于行业建议值（目前为 600,000 次迭代）时，网页 App 中将出现一个新的警告。参阅[这里](/docs/security/encryption/encryption-key-derivation#low-kdf-iterations)。

### Secrets Manager Beta

此次发布包含：

* **Secrets Manager - 在创建机密期间创建工程**：您现在可以在机密创建菜单中创建新的工程。参阅[这里](/docs/secrets-manager/your-secrets/secrets)。

## 2023.4.0

此次发布包含：

* **Splunk 集成**：Bitwarden 组织现在可以使用自托管的 Splunk Enterprise 进行安全信息与事件管理 (SIEM)。在[此处](/docs/admin-console/oversight-visibility/siem-integrations/splunk-siem)了解如何开始使用 Splunk。
* **改进的经销商计费**：Bitwarden 经销商现在是唯一有权查看其客户组织的计费、订阅或付款信息的实体。参阅[这里](/docs/plans-and-pricing/bitwarden-resellers)。
* **主密码要求策略更新**：如果启用，主密码要求策略现在可以设置为提示现有的不合规用户更新他们的主密码。参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies#master-password-requirements)。
* **密码库超时策略更新**：密码库超时策略现在提供了指定密码库超时动作的选项。参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies#vault-timeout)。
* **桌面端 - 新的生物识别选项**：您现在可以选择是在 App 启动时要求主密码还是在打开时允许生物识别。参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)。
* **桌面端 - Windows Hello 安全改进**：解决了与 Windows Hello 和 Windows Credential Manager 相关的漏洞。作为一项附加措施，我们建议使用新选项以在 App 启动时要求输入主密码。参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)。
* **浏览器扩展 - 改进的表单检测**：改进了表单检测的逻辑，并针对浏览器扩展的通知栏解决了错误报告。有关技术细节，请参阅[这里](https://github.com/bitwarden/clients/pull/4798)。

## 2023.3.0

此次发布包含：

* **域验证**：组织可以验证域（例如 `mycompany.com`）的所有权，允许用户在使用 SSO 登录时跳过组织标识符步骤。参阅[这里](/docs/admin-console/oversight-visibility/claimed-domains/claimed-domains)。
* **浏览器扩展 - 改进的自动填充安全性**：浏览器扩展现在不允许在页面加载时自动填充不受信任的 iframe。浏览器扩展还会在手动自动填充、使用上下文菜单或使用键盘快捷键时警告用户有关不受信任的 iframe，并在自动填充 HTTP 站点时警告用户，该站点需要基于该项目的已保存 URI 的 HTTPS。参阅[这里](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)。
* **主密码安全性检查**：用户现在可以在创建账户或在网页密码库上更改主密码时通过 Have I Been Pwned 检查已知的数据泄露，以查找他们预期的主密码。参阅[这里](/docs/password-manager/your-vault/security-tools/vault-health-reports#data-breach-report-individual-vaults-only)。
* **主密码长度要求**：现在主密码的长度必须至少为 12 个字符。此规则将对新的 Bitwarden 账户和[更改主密码](/docs/account/master-password#change-your-master-password)的任何用户强制执行。
* **激活自动填充策略**：对于企业组织，激活自动填充策略将自动为组织的新成员和现有成员打开页面加载时的自动填充。参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies#activate-auto-fill)。
* **浏览器扩展 - 改进的通知栏**：用于将未检测到的项目添加到您的密码库的通知栏现在为遵守删除单个密码库策略的用户提供了更直观的工作流程。参阅[这里](/docs/password-manager/getting-started/getting-started-browserext#auto-save-a-login)。
* **iOS - 选择 Bitwarden 获取验证码**：iOS 16+ 用户现在可以将 Bitwarden 设置为直接从相机 App 扫描代码时用于存储验证码的默认应用程序。参阅[这里](/docs/password-manager/your-vault/security-tools/totp#bitwarden-authenticator-on-ios)。
* **移动端 - 在 App 内更改语言**：不同于在设备操作系统上设置语言，用户可以在 Bitwarden 移动 App 中更改语言。参阅[这里](/docs/password-manager/your-vault/appearance/localization#change-app-language)。

### Secrets Manager Beta

Bitwarden Secrets Manager 现在作为公开测试版提供。参阅[此处](/docs/secrets-manager/secrets-manager-overview)了解如何开始。

## 2023.2.0

此次发布包含：

{% hint style="info" %}
**自托管公告**

在此版本中，我们已迁移到新的 [SQL 客户端](https://devblogs.microsoft.com/dotnet/introducing-the-new-microsoftdatasqlclient/)，该客户端需要一个有效的证书或在 `global.override.env` 中设置的[连接字符串](/docs/self-hosting/deploy-and-configure/configuration-options/environment-variables#included-variables)中存在 `TrustServerCertificate=True`。请在更新您的服务器之前检查这些。
{% endhint %}

* **Argon2**：您现在可以从**账户设置** → **安全** → **密钥**页面将用于派生账户主密钥的算法更改为 Argon2id。参阅[这里](/docs/security/encryption/encryption-key-derivation)。

{% hint style="info" %}
**2023-02-14**：2023.2.0 及以后版本的 Bitwarden 客户端支持 Argon2，通过网页密码库切换到 Argon2 可能意味着其他客户端在更新之前无法加载您的密码库。通常在发布后一周内更新这些客户端。
{% endhint %}

* **增加了 PBKDF2 的默认 KDF 迭代**：按照 [OWASP](https://zh.wikipedia.org/zh-cn/OWASP) 的建议，新的 Bitwarden 账户将为 PBKDF2 使用 600,000 次 KDF 迭代。现有的账户可以手动增加此数值。参阅[这里](/docs/security/encryption/encryption-protocols#changing-kdf-iterations)。
* **主密码安全检查**：在移动 App、浏览器扩展和桌面 App 上创建账户的新用户现在可以通过 HIBP 检查已知的数据泄露，以了解他们的潜在主密码。这将在以后的版本中被带到网页密码库。参阅[这里](/docs/password-manager/your-vault/security-tools/vault-health-reports#data-breach-report-individual-vaults-only)。
* **组织密码库更新**：作为改进网页密码库 UI 的持续努力的一部分，一些组织管理功能进行了重新设计，例如用于项目和集合管理的合并**密码库**视图，以及专用的**成员**和**群组**视图。
* **在其他客户端上使用设备登录**：现在可以在其他客户端上使用设备登录。登录请求现在也可以从浏览器扩展、桌面 App 和移动 App 发起，现在也可以从桌面 App 获得批准。参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)。
* **自托管组织的自动许可证同步**：自托管组织可以启用自动许可证同步，以便自动更新计费和订阅更改，而不必手动重新上传许可证。参阅[这里](/docs/self-hosting/licensing-on-premise#update-a-renewed-organization-license)。
* **用于 Bitwarden Unified 的 SQLite 数据库选项**：SQLite 现在是 Bitwarden Unified 自托管部署的可用数据库选项。参阅[这里](/docs/self-hosting/deploy-and-configure/docker/lite-deployment)。
* **更新了自托管安装程序 URL**：用于下载自托管服务器安装程序的 URL 已更改。Linux 参阅[这里](/docs/self-hosting/deploy-and-configure/docker/linux-standard-deployment#install-bitwarden)，Windows 参阅[这里](/docs/self-hosting/deploy-and-configure/docker/windows-standard-deployment#install-bitwarden)。
* **Psono 导入器 (json)**：新的导入选项可用于 Psono (json) 导出。参阅[这里](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

## 2023.1.0

此次发布包含：

* **Apple Watch 上的 Bitwarden**：Bitwarden 添加了 Apple Watch 支持，以提供访问 TOTP 登录代码的附加选项。参阅[这里](/docs/password-manager/more/more-platforms/apple-watch-totp)。
* **新的环境变量**：一个用于为所有者和管理员强制执行要求 SSO 身份验证策略的环境变量现在可用于自托管服务器。参阅[这里](/docs/self-hosting/deploy-and-configure/configuration-options/environment-variables#optional-variables)。
* **Bitwarden Unified - 支持自定义数据库端口**：Unified 部署现在支持使用新的环境变量在自定义端口上运行数据库。参阅[这里](/docs/self-hosting/deploy-and-configure/docker/lite-deployment#environment-variables)。
* **Passsky 导入器 (json)**：新的导入选项可用于未加密的 Passsky (json) 导出。参阅[这里](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。
* **自定义头像颜色**：从网页密码库的**账户设置** → **我的账户**页面更改您的头像颜色。

## 2022.12.0

此次发布包含：

* **浏览器扩展 - 主题通知栏**：主题通知栏已添加到 Bitwarden 浏览器扩展中以匹配流行的颜色主题。
* **浏览器扩展 - UI 更新**：已对 Bitwarden 浏览器扩展进行了 UI 更新。
* **Apple Watch 上的 Bitwarden (Beta)**：Apple Watch 上的 Bitwarden 将以测试版形式提供给通过 TestFlight 注册的用户，并将提供访问 TOTP 登录代码的附加选项。在[这里](/docs/password-manager/more/more-platforms/apple-watch-totp)了解更多。

### Bitwarden Unified 自托管部署 (Beta) <a href="#bitwarden-unified-self-host-deployment-beta" id="bitwarden-unified-self-host-deployment-beta"></a>

Bitwarden 很高兴地宣布推出为自托管用户提供一个新的选项的测试版本。对于希望在自己的服务器上控制和部署 Bitwarden 的用户，Bitwarden Unified 部署是轻量和灵活的选择。有关测试版的更多信息，请参阅[这里](/docs/self-hosting/deploy-and-configure/docker/lite-deployment)。

## 2022.11.2

此次发布包含：

* **设备登录**：通过向您已注册的移动设备发送身份验证请求而不是使用您的主密码来登录网页密码库（参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)）。

## 2022.11.0

{% hint style="info" %}
此次发布不包括对浏览器扩展的更新，该扩展将保留在版本 2022.10.1。
{% endhint %}

此次发布包含：

* **组织密码库更新**：作为改进网页密码库 UI 的持续努力的一部分，某些组织管理功能已被移动，例如转移到专用的**计费**和**报告**选项卡中。
* **登录流程更新**：为了适应新的登录选项，登录流程已分为两个界面。
* **SCIM 更新**：SCIM 触发的事件现在将被记录为 `SCIM` 而不是 `Unkown`，并且 SCIM API 密钥现在默认会被混淆。
* **从 iOS 应用扩展生成用户名和密码**：现在可以从 iOS App 扩展「即时」生成用户名和密码，在使用浏览器等 App 时可从「共享」菜单访问。
* **用于移动设备的新主题**：流行的 Solarized Dark 主题已引入移动设备。
* **Directory Connector - 用于 Google Workspace 的群组筛选器查询**：查询参数可被用于 Google Workspace 的群组筛选器中（参阅[这里](/docs/admin-console/manage-members/directory-connector/sync-with-google-workspace#specify-sync-filters)）。
* **性能优化**：我们改进了网页密码库的加载时间和访问具有数千个密码库项目的账户时的体验。

## 2022.10.0

此次发布包含：

* **受密码保护的加密导出**：加密的 `.json` 导出现在可以使用您选择的密码进行加密。密码保护的导出可以导入任何 Bitwarden 账户（参阅[这里](/docs/password-manager/import-and-export/encrypted-exports)）。
* **移动端用户名生成器**：用户名生成器现在可用于 Bitwarden 移动端 App（参阅[这里](/docs/password-manager/your-vault/security-tools/generator#generate-a-username)）。
* **DuckDuckGo 电子邮件别名集成**：将 Bitwarden 用户名生成器连接到 DuckDuckGo，以便轻松创建电子邮件别名（参阅[这里](/docs/password-manager/your-vault/security-tools/generator#username-types)）。
* **DuckDuckGo macOS 浏览器集成**：我们与 DuckDuckGo 合作创建了与他们[即将推出的 macOS 浏览器](https://spreadprivacy.com/introducing-duckduckgo-for-mac/)的集成！请继续关注他们何时启动此功能的更多信息。
* **SCIM 更新**：被撤销的用户将不再占据您组织中的许可席位（参阅[这里](/docs/admin-console/manage-members/scim/about-scim#revoking-and-restoring-access)）。

## 2022.9.0

此次发布包含：

* **Fastmail 电子邮件别名集成**：将 Bitwarden 用户名生成器连接到 Fastmail，以方便创建其电子邮件别名（参阅[这里](/docs/password-manager/your-vault/security-tools/generator#username-types)）。
* **提供商门户更新**：提供商门户主界面现在具有每一个客户组织的一目了然的席位和方案报告。
* **组织密码库导出事件**：当所有者或管理员执行密码库导出时，该操作现在将记录在组织的事件日志中（参阅[这里](/docs/admin-console/oversight-visibility/event-logging/event-logs#organization-events)）。
* **浏览器扩展 - 支持预配置环境 URL**：自托管客户现在可以为浏览器扩展预配置环境 URL，通过使用端点管理来部署您的配置，从而简化最终用户的部署（参阅[这里](broken://pages/-MdSA_S_8LzDH82OrFhT#liu-lan-qi-kuo-zhan)）。
* **移动端 - 更新至 Bitwarden Authenticator**：移动 App 现在有一个验证码界面，可让您快速轻松地访问您的所有 TOTP（参阅[这里](/docs/password-manager/your-vault/security-tools/totp#viewing-totp-codes)）。我们还改进了通过移动 App 将 TOTP 代码添加到密码库项目的过程（参阅[这里](/docs/password-manager/your-vault/security-tools/totp#scan-a-qr-code)）。
* **CLI - `serve` 来源保护**：`serve` 命令现在将默认阻止任何使用 `Origin` 标头发出的请求（参阅[这里](/docs/password-manager/developer-tools/cli/password-manager-cli#serve)）。

## 2022.8.1

此次发布包含：

* **用于企业组织的 SCIM**：企业组织现在可以使用跨域身份管理系统 (SCIM) 从源目录自动配置成员和群组（参阅[这里](/docs/admin-console/manage-members/scim/about-scim)）。
* **用于登录尝试失败的 hCaptcha**：如果我们检测到连续 9 次失败的登录尝试，现在您将收到一封电子邮件并需要完成 hCaptcha 验证。

## 2022.8.0

此次发布包含：

* **用户撤销**：组织现在可以在不完全移除用户的情况下暂时撤销用户对组织的访问权限（参阅[这里](/docs/admin-console/manage-members/user-management#revoke-access)）。
* **企业策略更新**：企业策略名称和描述已更新，以更好地描述它们对您的组织的影响（参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies)）。
* **设置和首选项更新**：一些 App 设置和首选项的名称和描述已更新，更加直观。

## 2022.6.0

此次发布包含关键功能和可用性改进，使 Bitwarden 在旅途中更加出色：

* **自动填充期间的账户切换 (iOS)**：在自动填充期间通过点击头像按钮快速切换到另一个账户，现在可在 Android 和 iOS 上使用（参阅[这里](/docs/password-manager/autofill/autofill-from/autofill-from-ios)）。
* **移动端的密码库筛选器**：在移动 App 上，您现在可以按密码库筛选项目。
* **组织成员高级状态**：组织成员现在可以在收到邀请后立即使用高级功能，例如高级 2FA 方式，而无需确认。
* **可访问性改进**：此版本包括一些更改，这些更改将通过辅助技术提高 Bitwarden 的性能，包括具有 [hCaptcha 无障碍访问](https://dashboard.hcaptcha.com/signup?type=accessibility)的用户能够使用其无障碍 Cookie 跳过 hCaptcha 挑战（现在可用于桌面和移动 App）。

## 2022.5.0

{% hint style="info" %}
**我们启用了新的版本编号！**

随着我们进入接近每月一次的发布周期，为了更容易跟踪许多 Bitwarden App 的版本，我们已经采用了一个新的版本编号系统，此版本编号系统将**由所有客户端共用**。此次发布是 `2022.5.0`，因为它是 2022 年 (`2022.`) 5 月 (`.5.`) 的基础发布 (`.0`)。
{% endhint %}

此次发布包含：

* **网页密码库 UI 更新**：网页密码库已收到设计方面的更新，包括改进的个人和组织密码库项目筛选。这是一个由多个部分组成的项目的第一阶段，此项目将同时更新个人用户和组织的网页密码库。
* **用于自托管企业组织的家庭赞助**：现在可以为自托管的企业组织成员发放家庭组织赞助（参阅[这里](/docs/self-hosting/deploy-and-configure/optional-features/self-hosting-families-sponsorships)）。
* **用户名生成器 - 转发的电子邮件别名类型**：将用户名生成器与 SimpleLogin、AnonAddy 或 Firefox Relay 集成，以自动同时创建用户名和相应的电子邮件别名（参阅[这里](/docs/password-manager/your-vault/security-tools/generator#username-types)）。
* **项目链接**：复制一个项目的 URL 时，将作为直接链接提供给组织成员或在文档中使用（参阅[这里](/docs/admin-console/manage-shared-items/link-to-an-item)）。
* **自动填写期间的账户切换**：在 Android 系统中，通过点击头像气泡，以在自动填写过程中快速切换到另一个账户（参阅[这里](/docs/password-manager/autofill/autofill-from/autofill-from-android#auto-fill-while-account-switching)）。
* **客户组织计费的变化**：从这个发布版本开始，只有[提供商](/docs/provider-portal/get-started-with-provider-portal)用户可以查看[客户组织](/docs/provider-portal/get-started-with-provider-portal#client-organizations)的计费信息。

## 2022-04-26 <a href="#id-2022-04-26" id="id-2022-04-26"></a>

桌面端 1.33.0，浏览器扩展 1.58.0，移动端 2.18.0，CLI 1.22.0，Directory Connector 2.10.1

{% hint style="info" %}
**支持性公告**

在此版本中，从 App Store 下载的 macOS 桌面 App 要求 macOS Mojave (10.14) 或更高版本。从 [bitwarden.com/download](https://bitwarden.com/download/) 和 Github 获得的 `.dmg` 安装程序不受此限制。
{% endhint %}

* **用于浏览器和桌面端的生成器**：使用基于电子邮件的约定（如附加寻址）或使用随机单词为新凭据生成用户名（参阅[这里](/docs/password-manager/your-vault/security-tools/generator)）。
* **CLI - 新的 `serve` 选项**：使用 `--hostname` 选项将您的 API 网页服务器安全地绑定到主机（参阅[这里](/docs/password-manager/developer-tools/cli/password-manager-cli#serve)）。

## 2022-04-19

服务器 1.48.0，Web 2.28.0

此此最新的发布包含社区要求的功能以及更新网页密码库 UI 的多部分工作的开始。客户端 App（浏览器扩展、移动、桌面和 CLI）的更新将在后续版本中发布：

* **用于网页密码库的用户名生成器**：使用基于电子邮件的约定（如附加寻址）或使用随机单词为新凭据生成用户名。后续版本将包括用于浏览器扩展和桌面 App 的用户名生成器（参阅[这里](/docs/password-manager/your-vault/security-tools/generator)）。
* **网页密码库 - 报告页面**：我们更新了报告页面的位置和风格，以便更轻松地查找报告结果并对其采取行动（参阅[这里](/docs/password-manager/your-vault/security-tools/vault-health-reports)）。
* **macOS 和 Safari 导入器的改进**：我们修复了一些导致 macOS 和 Safari 导入器无法正确导入 URL 和备注的问题。
* **可访问性改进**：此版本包括一些通过屏幕阅读器等辅助技术提高 Bitwarden 性能的更改。

## 2022-03-22

浏览器扩展 1.57.0，移动端 2.17.0

继上周的发布之后，针对移动 App 和浏览器扩展发布了以下内容：

* **移动端添加账户切换功能**：在 Android 和 iOS 上使用 Bitwarden 时，最多可登录 5 个账户并在它们之间无缝切换（参阅[这里](/docs/account/log-in-and-unlock/account-switching)）。
* **支持 Firefox 隐私模式**：此版本包含对 Firefox 隐私窗口更强大的支持（参阅[这里](/docs/password-manager/more/more-platforms/use-bitwarden-in-firefoxs-private-mode)）。

## 2022-03-15 <a href="#id-2021-10-26" id="id-2021-10-26"></a>

服务器 1.47.0、Web 2.27.0，桌面端 1.32.0，CLI 1.22.0，Directory Connector 2.9.11

此最新版本侧重于对单个应用程序的改进，以便您可以完全按照自己的需要使用 Bitwarden。移动 App 和浏览器扩展的更新将在后续版本中发布：

* **来自 CLI 的密码库管理 API**：使用全新的 CLI 命令 `serve`，您可以对一整套密码库管理端点进行 API 调用（参阅[这里](/docs/password-manager/developer-tools/cli/password-manager-cli#serve)）。
* **CLI 导出命令的更改**：`export` 不再要求主密码，您现在可以使用 `--password` 参数为加密导出设置自定义加密/解密密码（参阅[这里](/docs/password-manager/developer-tools/cli/password-manager-cli#export)）。
* **新的导入器**：我们为 Dashlane `.csv` 文件和 1Password .`1pux` 文件（要求 1Password v8.5+）增加了自定义导入器。
* **Myki 导入器的改进**：参阅[这里](https://github.com/bitwarden/jslib/pull/707)。
* **弃用工件绑定**：出于安全考虑，已删除 SAML SSO 配置的工件绑定（参阅[这里](https://github.com/bitwarden/server/pull/1885)）。
* **支持 Docker Compose v2**

## 2022-02-08 <a href="#id-2021-10-26" id="id-2021-10-26"></a>

服务器 1.46.0、Web 2.26.0，桌面端 1.31.0，浏览器扩展 1.56.0，移动端 2.16.0，CLI 1.21.0，Directory Connector 2.9.9

2022 年初始，Bitwarden 很高兴地发布以下内容：

* **桌面端账户切换**：在 Bitwarden 桌面 App 中一次性登录最多 5 个账户。此功能在 Bitwarden App 中分阶段推出，很快将适用于更多其他 App（参阅[这里](/docs/account/log-in-and-unlock/account-switching)）。
* **iOS 上的 Send**：现在可以直接从 iOS 的共享菜单分享 Bitwarden Send（参阅[这里](/docs/password-manager/bitwarden-send/create-a-send)）。
* **从移动端删除账户**：您现在可以从移动 App 中删除您的 Bitwarden 账户（参阅[这里](/docs/plans-and-pricing/delete-an-account-or-organization)），但您为什么要这样做？
* **新的图标**：我们使用全新的图标更新了所有 Bitwarden App 的外观和体验。尽情欣赏！
* **Directory Connector - Azure AD 同步性能**：针对 Azure Active Directory 的 Directory Connector 同步，性能已得到提升。与 Azure AD 同步的组织*将不再*需要更改其同步配置。
* **后端改进**：我们一直在努力改进 Bitwarden 平台的总体性能和稳定性，这将在未来推出一些很棒的新功能。

## 2012-12-07 <a href="#id-2021-10-26" id="id-2021-10-26"></a>

服务器 1.45.0、Web 2.25.0，桌面端 1.30.0，浏览器扩展 1.55.0，移动端 2.15.0，CLI 1.20.0

Bitwarden 很自豪地宣布在 12 月的版本中增加了新的企业功能，为企业方案增加了灵活性和价值。

* &#x20;[**Key Connector**](/docs/self-hosting/key-connector/about-key-connector)：(*仅适用于自托管组织*）当使用带有客户管理加密的 SSO 登录时，作为使用主密码解密密码库的一个替代方案，自托管 Key Connector 应用程序向 Bitwarden 客户端提供加密密钥（参阅[这里](/docs/self-hosting/key-connector/about-key-connector)）。
* **用于企业的家庭**：(*目前仅适用于云托管组织，未来版本的自托管*）从这个版本开始，企业组织的成员可以兑换一个与最多 5 个朋友或家庭成员共享的免费 [Bitwarden 家庭组织](/docs/plans-and-pricing/password-manager/about-bitwarden-plans#families-organizations)。家庭组织包括所有 6 个用户的所有高级功能和无限制的安全数据共享（参阅[这里](/docs/admin-console/manage-members/sponsored-families/sponsored-families-for-members)）。
* **MacOS 和 Safari 导入器**：我们为从 Safari 和 macOS 导出的密码增加了一个自定义导入器（详情见[这里](/docs/password-manager/import-and-export/import-guides/import-data-from-macos-and-safari)）。
* **新的自定义字段类型**：链接型自定义字段可用于解决您的浏览器扩展在自动填写特定网站的用户名和密码时遇到的问题，方法是将用户名和密码链接到定制的表单元素（参阅[此处](/docs/password-manager/autofill/more-autofill-options/auto-fill-custom-fields#using-linked-custom-fields)）。
* **浏览器扩展 - 自动填充时解锁密码库**：当您尝试在密码库被锁定时使用上下文菜单或键盘快捷键进行自动填充，现在将提示您解锁密码库，并在解锁后自动填写您的凭证。

## 2021-10-26 <a href="#id-2021-10-26" id="id-2021-10-26"></a>

服务器 1.44.0，Web 2.24.0，桌面端 1.29.0，浏览器扩展 1.54.0，移动端 2.14.0，CLI 1.19.0

很高兴 Bitwarden 团队发布了一系列新功能和更新，以继续我们让个人和企业的密码管理变得简单易用的使命：

{% hint style="info" %}
**弃用公告**：业务门户已弃用。企业组织可以通过组织**管理**选项卡配置[策略](/docs/admin-console/oversight-visibility/enterprise-policies)和 [SSO 登录](/docs/admin-console/login-with-sso/about-sso)。
{% endhint %}

* **密码库超时策略**：密码库超时策略将为您组织的所有成员应用最长的密码库超时持续时间（参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies#vault-timeout)）。
* **禁用个人密码库导出策略**：禁用个人密码库导出策略将禁止您组织的非所有者/非管理员成员导出私人密码库数据（参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies#disable-personal-vault-export)）。
* **自动扩展组织席位**：团队和企业组织将在邀请新用户时自动扩展用户席位。组织可以设置扩展限制，以防止席位数量超过指定的数量（参阅[这里](/docs/admin-console/manage-members/user-management)）。
* **自定义密码库超时**：您现在可以为密码库超时指定自定义时间范围（小时和分钟）（参阅[这里](/docs/account/log-in-and-unlock/vault-timeout-options#vault-timeout)）。
* **自定义角色 - 改进的集合权限**：自定义角色的集合管理权限已扩展为包括对用户是否可以创建、编辑或删除已分配的集合或所有集合的精细控制（参阅[这里](/docs/account/log-in-and-unlock/vault-timeout-options#vault-timeout)）。
* **管理员密码重置 - 重置后更新密码**：管理员重置的密码现在必须由他们所属的用户在登录 Bitwarden 时立即更新（参阅[这里](/docs/admin-console/manage-members/account-recovery/about-account-recovery#after-a-password-reset)）。
* **浏览器扩展 - 自动填充 Span 元素**：浏览器扩展现在可以在 HTML `<span>` 元素的 innerText 中自动填充[自定义字段](/docs/password-manager/your-vault/vault-items/custom-fields)（参阅[这里](/docs/password-manager/autofill/more-autofill-options/auto-fill-custom-fields#html-span-elements)）。
* &#x20;**浏览器扩展 - 自动生物识别提示**：浏览器扩展现在可以在打开时自动提示您生物识别输入。您可以从 **⚙️设置**菜单切换此行为（参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)）。
* **网页密码库 - 黑暗模式**：网页密码库现在拥有黑暗模式（参阅[这里](/docs/password-manager/your-vault/appearance/change-app-appearance)）。
* **CLI - `generate` 密码短语选项**：`bw generate --passphrase` 命令现在包含 `--capitalize` 和 `--includeNumber` 选项（参阅[这里](/docs/password-manager/developer-tools/cli/password-manager-cli#generate)）。

## 2021-09-21

服务器 1.43.0，Web 2.23.0，桌面端 1.28.3，浏览器扩展 1.53.0，移动端 2.13.0，CLI 1.18.1

Bitwarden 的最新版本侧重于对现有功能进行经常性的改进：

* **移动设备上的 FIDO2 WebAuthn**：iOS 和 Android 现在支持通过 FIDO2 WebAuthn 进行两步登录（参阅[这里](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)）。
* **管理员密码重置 - 自动注册改进**：自动注册策略选项现在会阻止用户撤销管理员密码重置（参阅[这里](/docs/admin-console/manage-members/account-recovery/about-account-recovery#automatic-enrollment)）。
* **浏览器扩展 - 从保存栏中选择文件夹**：您现在可以直接从浏览器扩展的保存提示中选择要将项目保存到哪个[文件夹](/docs/password-manager/your-vault/vault-navigation/folders)（参阅[这里](/docs/password-manager/getting-started/getting-started-browserext#add-a-login)）。
* **浏览器扩展 - 上下文菜单项目自定义字段**：您现在可以直接从浏览器扩展的上下文菜单中复制 HTML 元素名称，以便轻松创建自定义字段（参阅[这里](/docs/password-manager/your-vault/vault-items/custom-fields#custom-field-names)）。
* **网页密码库 - 策略位置更改**：现在只能从组织的**管理 → 策略**界面配置[企业策略](/docs/admin-console/oversight-visibility/enterprise-policies)，而不能从业务门户配置。
* **CAPTCHA 验证**：从这个版本开始，我们将开启 [hCaptcha](https://www.hcaptcha.com/about) 验证以防止诸如撞库之类的机器人攻击。请注意，CLI 中的挑战与其他客户端应用程序中的挑战不同（有关 CLI 的详细信息，请参阅[此处](/docs/password-manager/developer-tools/cli/cli-authentication-challenges)）。

## 2021-08-18 <a href="#id-2021-06-29" id="id-2021-06-29"></a>

{% hint style="success" %}
有兴趣成为提供商吗？首先，我们要求：

* 您的企业有一个活跃的企业组织。
* 您的企业有一个客户准备在您的提供商下入职。

如果您还没有准备好开始成为提供商，Bitwarden 团队希望支持您作为一个经销商或客户的 Bitwarden 之旅。

[联系我们](https://bitwarden.com/contact)
{% endhint %}

Bitwarden 的最新版本专注于使托管服务提供商 (MSP) 能够支持其客户的密码管理需求：

* **提供商门户**：提供商门户网站允许托管服务提供商 (MSP) 和经销商代表客户创建和管理组织。使用该门户，提供商可以无缝地支持多个客户的凭证管理（参阅[这里](/docs/provider-portal/get-started-with-provider-portal)）。
* **共享用词的变化**：我们将**共享**按钮更新为**移动到组织**，以明确共享项目是由组织所拥有的。此外，我们还将「已共享项目」的指示符号 (<i class="fa-share-nodes">:share-nodes:</i>) 更改为与集合的指示符号 (<i class="fa-album-collection">:album-collection:</i>) 保持一致。
* **CLI `move` 命令**：为了与上述条目保持一致，CLI 的 `share` 命令已被更改为 `move`（参阅[这里](/docs/password-manager/developer-tools/cli/password-manager-cli#move)）。

## 2021-06-29 <a href="#id-2021-06-29" id="id-2021-06-29"></a>

Bitwarden 团队很高兴地宣布推出管理员密码重置功能，这是一项最新功能，旨在帮助需要大规模地确保密码安全的企业。此次发布包括：

* **管理员密码重置**：企业组织可以注册管理员密码重置功能，以允许指定的管理员重置组织用户的主密码（参阅[这里](/docs/admin-console/manage-members/account-recovery/about-account-recovery)）。
* **主密码二次验证**：使用新的主密码二次验证选项，要求验证您的主密码才能查看被用户指定的敏感密码库项目。（参阅[这里](/docs/password-manager/your-vault/vault-items/vault-items#protect-individual-items)）。
* **批量用户管理**：组织所有者和管理员现在可以从组织中批量重新发送邀请、确认已接受的用户以及移除用户（参阅[这里](/docs/admin-console/manage-members/user-management#onboard-users)）。
* **事件日志导出**：直接从网页密码库导出事件日志（参阅[这里](/docs/admin-console/oversight-visibility/event-logging/event-logs#export-events)）。
* **Directory Connector API 密钥认证**：从此版本开始，Directory Connector 的用户将需要使用[组织 API 密钥](/docs/admin-console/bitwarden-public-api#authentication)才能登录。
* **Directory Connector 同步限制增加**：Directory Connector 现在可以同步无限数量的用户或群组，之前的限制被设置为 2000。要同步 2000 以上的用户或群组，请切换到新的同步选项（参阅[这里](/docs/admin-console/manage-members/directory-connector/sync-options-and-filters#large-syncs)）。
* **页面加载时自动填充功能的增强**：浏览器扩展的页面加载时自动填充功能已升级，可以更灵活地满足用户的独特需求（参阅[这里](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#on-page-load)）。
* **更多 CLI 选项**：我们添加了一些新的 CLI 选项，包括轻松检索密码库项目的备注 (`bw get notes <id>`) 和设置 Send 的最大访问计数的功能 (`bw send create --maxAccessCount <#>`)。
* **Web 开发人员自动填充排除**：网页开发贡献者现在可以通过向 `<input>` 元素添加 `data-bwignore` 属性（例如 `data-bwignore="true"`）来阻止浏览器扩展自动填充给定的表单元素。

## 2021-05-11 <a href="#id-2021-05-11" id="id-2021-05-11"></a>

很高兴 Bitwarden 团队发布了一系列新功能和更新，以继续我们让个人和企业的密码管理变得简单易用的使命：

* **Send 隐私 & 安全选项**：使用新的 Send 隐私选项以对接收者隐藏您的电子邮件地址（参阅[这里](/docs/password-manager/bitwarden-send/send-privacy#hide-email)）。为了防止滥用，文件 Send 现在将需要一个经过验证的电子邮件地址。此外，企业组织可以实施一条新的策略来设置隐藏电子邮件选项的可用性（参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies#send-options)）。
* **FIDO 更新 & 扩展支持**：我们的 FIDO 实施已经从 FIDO U2F 升级为 FIDO2 WebAuthn，但现有的 FIDO U2F 密钥将保留其完整性。对 FIDO 的支持已经扩展到更多的浏览器扩展和 Windows 桌面应用程序（参阅[这里](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)）。
* **用于密钥的自定义字段**：自定义字段的值已经升级到支持多达 5000 个字符，允许存储像 RSA 4096 位 SSH 密钥这样的密钥（参阅[这里](/docs/password-manager/your-vault/vault-items/custom-fields#custom-fields-for-keys)）。
* **文件大小增加**：现在可以创建最大 500 MB 的文件附件或文件 Send。由于设备限制，移动 App 仍采用旧的 100 MB 限制。
* **禁用浏览器扩展计数器**：使用 **⚙️设置 → 选项**菜单中的新开关来禁用浏览器扩展的角标计数器（参阅[这里](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)）。
* **Safari 的生物识别**：Safari 网页扩展现在包含对 Safari 14+ 生物识别解锁的支持（参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)）。
* **搜索国际化**：现在可以使用 1 个字符搜索密码库，改善了使用 1 个字符单词的语言（如简体中文和繁体中文）的使用体验。
* **弱密码报告排序**：弱密码报告现在按照密码弱性的严重程度来排序（参阅[这里](/docs/password-manager/your-vault/security-tools/vault-health-reports#weak-passwords-report)）。

{% hint style="warning" %}
由于附件升级，通过最新的客户端上传的附件无法在旧版本的客户端上打开。如果您发现您无法访问最近创建的附件，请将您的客户端升级到最新版本（**提示**：云网页密码库总是为最新版本）。

**冻结的或旧版的客户端**，包括 Safari 13（或更早）macOS 桌面 App 和 App 扩展，将不支持访问这些附件。
{% endhint %}

{% hint style="info" %}
自从 2020 年实施软删除以来，我们一直在耐心地对待回收站。**从 2021 年 5 月 15 日开始**，我们将激活夜间作业，该作业将永久删除您的回收站中已存在 30 天或更长时间的项目。

在 2021 年 5 月 15 日之前，我们建议您在回收站中进行挖掘，以寻找您可能想要恢复的任何内容！
{% endhint %}

## 2021-03-11 <a href="#id-2021-03-11" id="id-2021-03-11"></a>

Bitwarden 自豪地宣布我们发布了 Bitwarden Send，一个用于短暂共享的端到端加密解决方案。此次发布包括：

* **Bitwarden Send**：Bitwarden Send 是一个用于短暂共享的端到端加密解决方案。在我们的网站和帮助中心有很多关于 Send 的资料，但您可以从[这里](/docs/password-manager/bitwarden-send/about-send)开始。
* **FIDO U2F 支持 Edge**：FIDO U2F 方式的两步登录现在可以用于微软 Edge 中的网页密码库和浏览器扩展（参阅[这里](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)）。
* **浏览器扩展中的域名排除**：Bitwarden 浏览器扩展现在可以对其明确不提供记住密码的域名进行配置（参阅[这里](/docs/password-manager/autofill/more-autofill-options/exclude-domains)）。
* **改进的导入错误消息**：最近有很多人迁移到 Bitwarden，所以我们清理了一个导入错误的消息，以帮助您更快地解决问题（参阅[这里](/docs/password-manager/import-and-export/import-data#length-related-import-errors)）。
* **Safari 网页扩展移植**：我们的 Safari App 扩展已经正式移植到 Safari 14 以上版本的网页扩展中使用。由于 Safari 的变化，网页扩展的使用现在仅限于那些通过 Mac App Store 下载获取的 App（参阅[这里](/docs/password-manager/more/more-platforms/safari-web-extension)）。

## 2021-01-19 发行后的更新 <a href="#id-2021-01-19-post-release-update" id="id-2021-01-19-post-release-update"></a>

{% hint style="info" %}
如果您拥有最新版 (2021-01-19) 的桌面 App，则浏览器扩展的生物识别解锁**仅适用于基于 Chromium 的浏览器**（比如 Chrome、Edge）上安装的 v1.48.0 版本的浏览器扩展。

当您的浏览器扩展更新到这个版本时，您可能会被要求接受一个新的权限，以便 Bitwarden `Communicate with cooperating native applications（与本机应用程序通信）`。这个权限是安全的，也是**可选的**，它允许浏览器扩展与 Bitwarden 桌面 App 进行通信，而这是启用生物识别解锁所必需的（参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#browser-extensions)）。拒绝此权限也将允许您使用 v1.48.0 扩展，只是不带生物识别解锁功能。

**生物识别解锁当前不适用于：**

* 版本低于 87 的 Firefox 浏览器扩展
* Microsoft App Store 桌面 App（从 [bitwarden.com/download](https://bitwarden.com/download) 获取的侧面加载的 Windows 桌面 App 可以正常工作）
* 侧面加载的 macOS 桌面 App（App Store 桌面 App 可以正常工作）

Bitwarden 团队正在调查这些问题，并将随着情况的进展提供更新。
{% endhint %}

## 2021-01-19

自 2021 年的第一个主要版本以来，Bitwarden 团队合并了多项重大改进，以满足所有用户的关键需求，其中包括：

* **紧急访问**：Bitwarden 新增的紧急访问功能使用户可以指定和管理受信任的紧急联系人，紧急联系人可以在零知识/零信任环境中请求访问其密码库（参阅[这里](/docs/account/emergency-access/about-emergency-access)）。
* **加密导出**：个人用户和组织现在可以将密码库数据导出到加密的 `.json` 文件中（参阅[这里](/docs/password-manager/import-and-export/encrypted-exports)）。
* **新的角色**：现在可以使用自定义角色来对用户权限进行粒度控制（参阅[这里](/docs/admin-console/manage-members/member-roles#custom-role)）。
* **新的企业策略**：现在，企业组织可以使用个人所有权策略（参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies#personal-ownership)）。
* **浏览器扩展的生物识别解锁**：通过与本机桌面应用程序的集成，您现在可以使用生物识别输入来解锁基于 Chromium 的浏览器扩展（参阅[这里](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#browser-extensions)）。

## 2020-11-12

最新版本的 Bitwarden 为所有客户端应用程序添加了与 SSO 相关的增强功能，包括：

* **新的企业策略**：单一组织和单点登录 (SSO) 认证策略现在可供企业组织使用（参阅[这里](/docs/admin-console/oversight-visibility/enterprise-policies)）。
* **用于 CLI 的 API 密钥**：使用从您的网页密码库中新获得的 API 密钥来验证进入 Bitwarden CLI（参阅[这里](/docs/password-manager/developer-tools/cli/personal-api-key)）。
* **SSO 入职改进**：我们对用户通过 SSO 入职的方式进行了一些改进，以预防潜在的安全风险（参阅[这里](https://github.com/bitwarden/server/pull/945)）。
* **GDPR 确认**：从现在开始，Bitwarden 的新用户在注册时将被要求确认隐私政策。
* **Android 11 内嵌自动填充**：对于使用 Android 11+ 的设备，启用自动填充服务将为也支持[此功能](https://developer.android.com/guide/topics/text/ime-autofill#workflow)的 IME 显示内嵌建议（参阅[这里](https://github.com/bitwarden/mobile/pull/1145)）。

## 2020-09-30

最新版本的 Bitwarden 为所有客户端应用程序以及网页密码库业务门户增加了备受期待的 **SSO 登录**功能。阅读这篇[博客文章](https://bitwarden.com/blog/post/bitwarden-launches-sso-authentication/)了解关于 SSO 登录的更多信息，同时也可参考我们的[文档](/docs/admin-console/login-with-sso)。

## 2020 早期发布 <a href="#early-2020-releases" id="early-2020-releases"></a>

2020 年 03 月至 09 月期间发布了以下项目：

* [企业策略](/docs/admin-console/oversight-visibility/enterprise-policies)
* [密码库超时选项](/docs/account/log-in-and-unlock/vault-timeout-options)
* [回收站功能](/docs/password-manager/your-vault/vault-items/vault-items#delete-a-vault-item)
* [密码查看权限 - ](/docs/admin-console/manage-members/member-roles#granular-access-control)[隐藏密码](/docs/admin-console/manage-members/member-roles#granular-access-control)
* [桌面版应用程序的触控 ID/Windows Hello](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#desktop-applications)


# 账户访问


# 创建 Bitwarden 账户

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/create-bitwarden-account/)
{% endhint %}

我们很高兴能成为您安全信息管理之旅的一部分！要创建 Bitwarden 账户，请转到我们的[注册页面](https://bitwarden.com/go/start-free/)或在我们的主页上选择 **Get Started Free**。输入您的**电子邮箱**地址并选择您的首选服务器位置：**bitwarden.com**（美国）或 **bitwarden.eu**（欧盟）：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4eNMfYMnwsCtN9UsYextW1/a7a8993752b25c8112600b6bccfda06b/Create_account.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>创建账户并选择服务器位置</p></figcaption></figure></div>

选择**注册**或**继续**。Bitwarden 将通过电子邮件向您发送验证链接。要完成新账户的创建：

1. 在收到的电子邮件中，选择**验证电子邮箱**。
2. 请输入一个易记且强大的新**主密码** 。
3. （可选）为确保密码强度，请选择**检查密码的已知数据泄露情况**（[了解更多](/docs/password-manager/your-vault/security-tools/vault-health-reports#exposed-passwords-report)）。
4. 选择**创建账户**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2pST1WXY0Xk7GQ4GpwzELn/258a7524e9ecbfe25d2b3a4e455257c0/Set_master_password.png?w=1328&#x26;fm=avif" alt="设置主密码"><figcaption><p>设置主密码</p></figcaption></figure></div>

{% hint style="info" %}
如果您的账户是旧账户，您可能需要主动验证您的电子邮箱！请登录[网页密码库](https://vault.bitwarden.com/)然后选择**验证电子邮箱**。如果您的账户电子邮箱未验证，则无法创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
{% endhint %}

## 通过组织邀请创建账户 <a href="#create-an-account-from-an-organization-invite" id="create-an-account-from-an-organization-invite"></a>

雇主或家庭成员等组织可以邀请用户注册 Bitwarden。如果您已被邀请加入某个组织，请检查您的电子邮箱是否收到来自 Bitwarden 的加入组织的邀请。在邀请过期之前打开电子邮件，然后选择**立即加入组织**。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3rZSnNkT3NPYThquuWqpeb/95516ccdedbb99931be5ee4d207fe2d8/image5.png?w=619&#x26;fm=avif" alt=""><figcaption><p>点击电子邮件链接后，系统会提示受邀用户接受组织邀请</p></figcaption></figure></div>

## 下一步 <a href="#next-steps" id="next-steps"></a>

现在您已经创建了您的账户，我们建议：

* [网页 App 使用入门](/docs/password-manager/getting-started/getting-started-webvault)
* [在其他设备上安装 Bitwarden](https://bitwarden.com/download/)


# 选择服务器

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/choose-my-server/)
{% endhint %}

Bitwarden Cloud 可在全球范围内访问，在**美国** (US) 和**欧盟** (EU) 地区提供数据存储。

{% hint style="success" icon="lightbulb" %}
Bitwarden 的数据区域是相互独立的，您的账户或组织仅存在于其最初创建的区域，这意味着：

* 如果您的账户是在 US 服务器上创建的，则无法登录 EU 服务器，反之亦然。尝试登录将导致系统识别为输入错误的主密码。
* 在两个服务器上创建账户不会导致数据在两个服务器之间同步。如果您使用多个 Bitwarden App 并发现数据不匹配，请检查它们是否登录到同一服务器。
* 一个服务器上的账户无法加入另一个服务器上的组织。
* 账户创建后无法变更服务器。要从 US 服务器切换到 EU 服务器（或反之），您必须在目标服务器上创建一个新的账户。创建新账户后，您可以[将现有密码库数据导出](/docs/password-manager/import-and-export/export-vault-data)到新账户。
  {% endhint %}

要选择登录到或创建账户到哪个服务器，请在登录或注册界面使用**服务器**或**正登录到**下拉菜单：

{% tabs %}
{% tab title="网页 App" %}

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/30W3B0aJy0dzO0pKTaBr7h/ed4fa669856dc3b13dbd80a1e0b237b5/2024-12-04_10-09-00.png" alt=""><figcaption><p>网页 App 上的区域选择器</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4Kas8J6TjKZWMdaTo7pZMX/7d33be1c411bcf7eaf0816842beb824b/2025-02-18_14-09-00.png" alt=""><figcaption><p>浏览器扩展上的区域选择器</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动 App" %}

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/753jtQ6dg9u6Rln2A7TF4R/01b3d12d193d8f00432b925c29999d91/2025-02-18_14-18-33.png" alt=""><figcaption><p>移动 App 上的区域选择器</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面 App" %}

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3FlU02971dqGGkp86WJJc5/e5c40a136a11ee48c5e74a068bda2405/2026-04-23_09-17-05.png?w=958&#x26;fm=avif" alt=""><figcaption><p>桌面 App 上的区域选择器</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}


# 主密码

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/master-password/)
{% endhint %}

您的主密码是访问密码库的主要方式。请务必确保您的主密码：

* **易记**：Bitwarden 的员工以及 Bitwarden 系统对您的主密码一无所知、没有办法找回或重置您的主密码。**千万不要忘记您的主密码！**
* **强大**：更长、更复杂、更不常见的密码是保护账户的最佳方式。Bitwarden 提供了一个免费的[密码强度测试工具](https://bitwarden.com/password-strength/)，可以测试您正在考虑的一些易记密码的强度。

[2023.3.0 版本](/docs/release-notes)发布后，主密码要求必须至少包含 12 个字符。

{% hint style="success" icon="lightbulb" %}
担心忘记您的主密码吗？这里有一些建议：

* **设置主密码提示**。如果您需要提醒，可以在登录界面请求主密码提示电子邮件。确保使用只有您自己能理解的提示。
* **指定一个**[**信任的紧急联系人**](/docs/account/emergency-access/about-emergency-access)。具有高级访问权限的用户可以在紧急情况下授予账户访问权限给朋友或家庭成员。
  {% endhint %}

## 更改主密码 <a href="#change-your-master-password" id="change-your-master-password"></a>

您可以从网页 App、浏览器扩展或桌面 App 更改您的主密码。您需要知道您当前的主密码才能进行此操作：

{% tabs %}
{% tab title="网页 App" %}
在网页 App 中：

1、从导航栏选择**设置** → **安全**。

2、选择**主密码**选项卡：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2Svv0PwlH9i7SSK73dlv9A/e451afb190346e492110a7bf1bd3a518/Master_password_settings.png?w=1200&#x26;fm=avif" alt=""><figcaption><p>在网页 App 上更改主密码</p></figcaption></figure></div>

3、输入您的**当前主密码**。

4、输入并确认您的**新主密码**。

5、（可选） **输入主密码提示** ，它用于帮助您回忆密码。提示会在收到请求后发送到账户持有人的电子邮箱。

6、（可选） 如果您想在提交主密码之前通过 [HIBP](https://haveibeenpwned.com/) 检查您的主密码，请选中**检查密码的已知数据泄露情况**以运行[数据泄露报告](/docs/password-manager/your-vault/security-tools/vault-health-reports#data-breach-individual-vaults-only)。这会将您的主密码的哈希值将发送到 HIBP，并将其与存储的暴露哈希值进行比较。Bitwarden 绝不会暴露您的主密码本身。

{% hint style="danger" %}
除非您完全了解其后果和所需的后续步骤，否则请不要选中**轮换账户加密密钥**复选框。[了解更多](/docs/security/encryption/encryption-key-rotation)。
{% endhint %}

7、选择**更改主密码**按钮。

更改主密码将会自动注销网页密码库会话。其他已登录的 App 可能保持活动状态长达一小时，但最终也会要求您使用新的主密码重新登录。
{% endtab %}

{% tab title="浏览器扩展" %}
在浏览器扩展中：

1、打开**设置**选项卡，然后选择**账户安全**。

2、滚动到**其他选项**部分，然后选择**更改主密码**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/13NQDBUne0d99ssQlhxnTy/5320be0c494c351f808db48db48105ba/2026-04-21_09-58-31.png?w=800&#x26;fm=avif" alt=""><figcaption><p>在浏览器扩展上更改主密码</p></figcaption></figure></div>

3、输入您的**当前主密码**。

4、输入并确认您的**新主密码**。

5、（可选） **输入主密码提示** ，它用于帮助您回忆密码。提示会在收到请求后发送到账户持有人的电子邮箱。

6、（可选） 如果您想在提交主密码之前通过 [HIBP](https://haveibeenpwned.com/) 检查您的主密码，请选中**检查密码的已知数据泄露情况**以运行[数据泄露报告](/docs/password-manager/your-vault/security-tools/vault-health-reports#data-breach-individual-vaults-only)。这会将您的主密码的哈希值将发送到 HIBP，并将其与存储的暴露哈希值进行比较。Bitwarden 绝不会暴露您的主密码本身。

7、选择**更改主密码**按钮。

更改主密码将会自动注销网页密码库会话。其他已登录的 App 可能保持活动状态长达一小时，但最终也会要求您使用新的主密码重新登录。
{% endtab %}

{% tab title="桌面 App" %}
在桌面 App 中：

1、从菜单栏中选择**账户** → **更改主密码**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5X1HjOgjvRg0ewMD30zYaY/4d9dfb5f92429b3b42d5111e0b759ca5/2026-04-21_09-00-24.png?w=800&#x26;fm=avif" alt=""><figcaption><p>在桌面 App 上更改主密码</p></figcaption></figure></div>

2、输入您的**当前主密码**。

3、输入并确认您的**新主密码**。

4、（可选） **输入主密码提示** ，它用于帮助您回忆密码。提示会在收到请求后发送到账户持有人的电子邮箱。

5、（可选） 如果您想在提交主密码之前通过 [HIBP](https://haveibeenpwned.com/) 检查您的主密码，请选中**检查密码的已知数据泄露情况**以运行[数据泄露报告](/docs/password-manager/your-vault/security-tools/vault-health-reports#data-breach-individual-vaults-only)。这会将您的主密码的哈希值将发送到 HIBP，并将其与存储的暴露哈希值进行比较。Bitwarden 绝不会暴露您的主密码本身。

6、选择**更改主密码**按钮。

更改主密码将会自动注销网页密码库会话。其他已登录的 App 可能保持活动状态长达一小时，但最终也会要求您使用新的主密码重新登录。
{% endtab %}
{% endtabs %}

## 我忘记了主密码 <a href="#i-forgot-my-master-password" id="i-forgot-my-master-password"></a>

了解如果您[忘记了主密码](/docs/account/i-forgot-my-master-password)该怎么做。

## 附加登录选项 <a href="#additional-login-options" id="additional-login-options"></a>

您的主密码是设置 Bitwarden 账户的必要条件。根据您或您的组织与 Bitwarden 交互的方式，可以使用其他选项来访问您的 Bitwarden 账户。

| 方式                                                                                                                                                                                        | 描述                                                                  |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| [使用设备登录](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)                                                                                                   | 设备登录是一种利用受信任的辅助设备向 Bitwarden 发送身份验证请求的选项。                           |
| [使用 SSO 登录](/docs/admin-console/login-with-sso/about-sso)                                                                                                                                 | Bitwarden 用户如果属于使用单点登录 (SSO) 的组织，可以利用现有的身份提供程序进行登录，该提供程序将对用户进行身份验证。 |
| [使用通行密钥登录](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)                                                                                               | 通行密钥可用作使用主密码和电子邮件登录 Bitwarden 的替代方式，并且某些通行密钥还可用于密码库加密和解密。           |
| [使用生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)和[使用 PIN 码解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin) | 生物识别或 PIN 解锁并不是一种替代登录方法，但是，它允许您使用系统生物识别或 PIN 而不是主密码来访问已锁定的账户。       |

## 下一步 <a href="#next-steps" id="next-steps"></a>

现在您已经创建了**易记**且**强大**的主密码，我们建议：

* [通过两步登录进一步保护您的密码库](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)
* [启用紧急访问](/docs/account/emergency-access/about-emergency-access)（需要高级版）


# 忘记主密码

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/forgot-master-password/)
{% endhint %}

Bitwarden 采用零知识加密技术，这意味着 **Bitwarden 无法访问、获取或重置您的主密码**。但是，您可以采取一些措施来尝试重新获取对您的账户的访问权限：

## 检查服务器地理位置 <a href="#check-server-geography" id="check-server-geography"></a>

当您尝试登录时，请检查是否[选择了正确的服务器](/docs/security/server-geographies#choose-your-cloud-server)。Bitwarden 数据区域是独立的，您的账户只存在于最初创建它的区域中。在尝试以下步骤之前，选择您的服务器是必要的。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3H5fN6yR90aKaTg7gaCruo/020b9ca668f037ed1e6450309b4041b4/2025-11-24_15-26-15.png?w=234&#x26;fm=avif" alt=""><figcaption><p>服务器地理位置</p></figcaption></figure></div>

## 使用其他 Bitwarden App 或设备 <a href="#use-a-different-bitwarden-app-or-device" id="use-a-different-bitwarden-app-or-device"></a>

尝试从其他设备或 Bitwarden App（例如移动 App 或浏览器扩展）登录。

接下来，检查您是否登录了另一个 Bitwarden App。如果您在该设备上设置了 [PIN 码](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)或[生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)：

1. 使用之前设置的 PIN 码或生物识别解锁您的密码库。
2. 将密码库项目复制并粘贴到 [.csv 文件](/docs/password-manager/import-and-export/condition-bitwarden-import#condition-a-csv)中。
3. 创建一个新的 Bitwarden 账户然后[导入复制了数据的 .csv](/docs/password-manager/import-and-export/import-data)。

## 查看主密码提示 <a href="#review-master-password-hint" id="review-master-password-hint"></a>

通过访问 [https://vault.bitwarden.com/#/hint](https://vault.bitwarden.com/#/hinthttps://vault.bitwarden.com/#/hint) 或 [https://vault.bitwarden.eu/#/hint](https://vault.bitwarden.eu/#/hinthttps://vault.bitwarden.eu/#/hint) 获取主密码提示。如果您设置了提示，提示将通过电子邮件发送到您的收件箱。如果您没有设置提示，则会收到一封报告此情况的电子邮件。

## 使用紧急访问 <a href="#use-emergency-access" id="use-emergency-access"></a>

如果您启用了[紧急访问](/docs/account/emergency-access/about-emergency-access)，请联系您信任的紧急联系人以重新获得对您的密码库的读取或接管访问权限。

## 联系管理员恢复账户 <a href="#contact-administrator-for-account-recovery" id="contact-administrator-for-account-recovery"></a>

如果您的组织启用了[账户恢复](/docs/admin-console/manage-members/account-recovery/about-account-recovery)功能，请联系管理员重置您的主密码。

## 使用已知设备登录 <a href="#log-in-with-known-device" id="log-in-with-known-device"></a>

如果您使用的浏览器已设置为已知设备（即已通过[使用设备登录](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)注册过），请从网页 App 中选择使用设备登录，您可以使用其他应用程序批准该请求。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7owqaTEe9Bo05wfLRZPhn8/38f1d0334964bb3d98a430b80b9d6b95/2025-09-09_10-03-52.png?w=692&#x26;fm=avif" alt=""><figcaption><p>使用设备登录</p></figcaption></figure></div>

## 使用通行密钥登录 <a href="#log-in-with-passkey" id="log-in-with-passkey"></a>

如果您的 Bitwarden 账户已经注册了启用加密 (PRF) 的[通行密钥登录](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)，您可以使用该通行密钥登录。

## 如果这些选项均无法让您访问您的账户 <a href="#if-none-of-these-options-grant-you-access-to-your-account" id="if-none-of-these-options-grant-you-access-to-your-account"></a>

我们建议您仔细检查所有设备和浏览器，查看是否有任何已登录的 Bitwarden 会话。

如果以上方法均无法让您访问您的账户，Bitwarden 将无法恢复该账户及其数据。您需要[删除现有账户](/docs/plans-and-pricing/delete-an-account-or-organization#wu-xu-deng-lu)然后创建一个新账户。如果您删除的 Bitwarden 账户包含高级订阅，请[联系我们](https://bitwarden.com/contact/)，我们将把您现有的订阅应用到新账户中。

{% hint style="warning" %}
删除您的账户将删除其中存储的所有个人所有的项目，包括所有已保存的附件。

删除您的账户前，请检查您是否已登录任何 Bitwarden 移动 App、浏览器扩展或桌面 App。如果有，请手动整理您的数据，以便将其重新添加回新的账户中。
{% endhint %}

## 下一步 <a href="#next-steps" id="next-steps"></a>

* 如果您创建了一个新账户，Bitwarden 建议使用[安全准备工具包](https://bitwarden.com/resources/bitwarden-security-readiness-kit/)来为忘记主密码等事件做好准备。
* 如果您删除了与高级订阅相关联的 Bitwarden 账户，请[联系我们](https://bitwarden.com/contact/)，我们会将您现有的订阅重新应用到新的账户中。


# 无法访问两步登录

{% hint style="success" %}
对应的[官方文档地址](https://help.bitwarden.com/article/lost-two-step-device/)
{% endhint %}

[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)可以保护您的账户，但丢失身份验证设备（例如带有验证器 App 的手机或已链接的电子邮箱收件箱）可能会将您锁定在 Bitwarden 密码库之外。如果您丢失了两步身份验证方式，恢复选项将受到限制。重新获得访问权限很大程度上取决于您或您的公司管理员之前是否为这种潜在情况做好了准备。

## 可能的恢复方法 <a href="#possible-recovery-methods" id="possible-recovery-methods"></a>

尝试以下选项，看看您是否可以重置两步登录方式或在创建新账户之前[导出您的密码库](/docs/password-manager/import-and-export/export-vault-data)。

### 备用两步登录方式 <a href="#alternate-two-step-login-method" id="alternate-two-step-login-method"></a>

如果您设置了多种两步登录方式，请尝试另一种。在登录界面上时，选择**使用其他两步登录方式**。

### 账户恢复 <a href="#account-recovery" id="account-recovery"></a>

如果您是使用[账户恢复](/docs/admin-console/manage-members/account-recovery/about-account-recovery)的组织的成员，并且您已[注册](/docs/admin-console/manage-members/account-recovery/account-recovery-enrollment#self-enroll-in-account-recovery)账户恢复，则管理员可以重置您的 Bitwarden 账户的两步登录。

### 恢复代码 <a href="#recovery-code" id="recovery-code"></a>

如果您在被锁定之前保存了恢复代码，则可以[使用恢复代码](/docs/account/two-step-login/recovery-codes#use-your-recovery-code)访问您的账户。当您设置任何两步登录方式时，都会生成恢复代码，并且您必须主动将代码保存在密码库外部可以找到的位置。Bitwarden 无法代表您获取恢复代码。

当您从账户的安全设置中获取恢复代码时，恢复代码如下所示：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/64piqJsX7vN25To16iRFIp/09e977fae9485c0764f832c6bb4b4b04/2024-12-02_11-24-35.png?w=529&#x26;fm=avif" alt=""><figcaption><p>示例恢复代码</p></figcaption></figure></div>

{% hint style="info" %}
恢复代码不会禁用用于组织的 Duo。如果您被组织 Duo 提示锁定在密码库之外，请联系您公司的 Duo 管理员，以获得绕过此提示的帮助。

如果您不确定 Duo 提示是个人设置的还是组织设置的，请尝试选择**使用其他两步登录方式**。
{% endhint %}

### 信任的紧急联系人 <a href="#trusted-emergency-contact" id="trusted-emergency-contact"></a>

如果您指定了具有接管访问权限的[已信任的紧急联系人](/docs/account/emergency-access/about-emergency-access)，请请求他们[发起紧急访问](/docs/account/emergency-access/about-emergency-access#use-emergency-access)。在为该紧急联系人设置的**等待时间**过后，所有两步登录方式将被停用，并且紧急联系人可以更改主密码。

### Duo 绕行代码 <a href="#duo-bypass-code" id="duo-bypass-code"></a>

如果您的 Bitwarden 账户已连接到 Duo，请请求您公司的 Duo 管理员生成[绕行代码](https://duo.com/docs/administration-users#generating-a-bypass-code)。此临时代码将验证您的 Duo 凭据，以便您登录 Bitwarden。

### 其他设备或 Bitwarden App <a href="#other-device-or-bitwarden-app" id="other-device-or-bitwarden-app"></a>

检查您的所有设备，看看您是否已登录到任何 Bitwarden 客户端，例如移动 App、浏览器扩展或桌面 App。

* 如果您已登录网页 App，请获取然后[使用您的恢复代码](/docs/account/two-step-login/recovery-codes#use-your-recovery-code)来断开所有两步登录方式。
* 如果您已登录到任何其他 Bitwarden App，请[导出您的密码库](/docs/password-manager/import-and-export/export-vault-data)，创建一个新的账户，然后在其中[导入您的数据](/docs/password-manager/import-and-export/import-data)。确认您的数据已正确导入后，请注销旧账户并考虑将其[删除](/docs/plans-and-pricing/delete-an-account-or-organization)。

## 当恢复方式不起作用时 <a href="#when-recovery-methods-dont-work" id="when-recovery-methods-dont-work"></a>

我们建议仔细检查您的所有设备和浏览器中是否有任何已登录的 Bitwarden 会话。如果您找到了，这就是您[导出密码库数据](/docs/password-manager/import-and-export/export-vault-data)的最后机会。

如果这些选项均无法让你获取对您的账户的访问权限，那么 Bitwarden 也无法恢复该账户或其数据。您需要[删除您的账户](/docs/plans-and-pricing/delete-an-account-or-organization#wu-xu-deng-lu)并然后创建一个新账户。如果您删除了具有高级版订阅的 Bitwarden 账户，请[联系我们](https://bitwarden.com/contact/)，我们将把您现有的订阅应用到您的新账户中。


# 登录 & 解锁


# 理解登录与解锁

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/understand-log-in-vs-unlock/)
{% endhint %}

Bitwarden 使用两种不同的流程来保护您的密码库，同时又不牺牲便利性：登录您的 Bitwarden 账户和解锁您的密码库。这种分离机制确保 Bitwarden [绝不会存储未经加密的数据](/docs/security/data/encrypted-data)在其服务器上。**当您的密码库既未解锁也未登录时**，您的密码库数据只以[加密形式](/docs/security/encryption/encryption-protocols)存在于服务器上。

## 登录 <a href="#logging-in" id="logging-in"></a>

**登录到** Bitwarden 可以获取已加密的密码库数据，并在本地设备上进行解密。在实践中，这意味着两件事：

* 登录始终需要使用您的主密码、[已批准的设备](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)或[已创建的通行密钥](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)，以获取解密密码库数据所需的[账户加密密钥](/docs/security/encryption/encryption-key-rotation)。在此阶段也需要使用[任何已启用的两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。
* 登录始终需要连接到互联网（或者，如果是自托管，则需要连接到服务器），才能将加密的。库下载到磁盘然后，密码库将在您设备的内存中解密。。

## 解锁 <a href="#unlocking" id="unlocking"></a>

只有在您已登录的情况下才能**解锁**您的密码库。 这就意味着，根据上述章节，您的设备在磁盘上存储了**已加密**的密码库数据。在实践中，这意味着两件事：

* 您并不一定需要主密码。虽然主密码可以用来解锁密码库，但 PIN 码和生物识别等其他方式也可以用来解锁密码库。

{% hint style="info" %}
当您设置 PIN 码或生物识别时，从 PIN 码或生物识别因素中派生的新加密密钥将用于加密[账户加密密钥](/docs/security/encryption/encryption-key-rotation)，您登录后即可访问该密钥，并将其存储在磁盘<mark style="color:red;">**ª**</mark>。

**解锁**密码库会使用 PIN 码或生物识别密钥解密内存中的账户加密密钥。解密后的账户加密密钥将用于解密内存中的所有密码库数据。

**锁定**密码库会导致删除所有已解密的密码库数据，包括已解密的账户加密密钥。

<mark style="color:orange;">**ª**</mark> - 如果使用**重启时使用主密码锁定**选项，此密钥只会存储在内存中，而不会存储在磁盘上。
{% endhint %}

* 您不需要连接到互联网（或者，如果是自托管，则不需要连接到服务器）。


# 自动注销或锁定

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/vault-timeout/)
{% endhint %}

会话超时选项决定了在指定的闲置时间后，Password Manager 密码库是否会自动注销或锁定。配置密码库超时设置时，您可以设置[超时时间](#session-timeout)和[超时动作](#session-timeout-action)。

要设置超时行为：

{% tabs %}
{% tab title="网页 App" %}
导航至**设置** → **安全**以选择您的会话超时时间和会话超时动作。
{% endtab %}

{% tab title="浏览器扩展" %}
导航至**设置** → **账户安全**以选择您的会话超时时间和会话超时动作。
{% endtab %}

{% tab title="移动端" %}
导航至**设置** → **账户安全**以选择您的会话超时时间和会话超时动作。
{% endtab %}

{% tab title="桌面端" %}

* 在 macOS 上，导航至 **Bitwarden** → **设置**以选择您的会话超时时间和会话超时动作。
* 在 Windows 或 Linux 上，导航至**文件** → **设置**以选择您的会话超时时间和会话超时动作。

{% hint style="info" %}
关闭桌面 App 将导致密码库锁定或注销，具体取决于您选择的超时动作。
{% endhint %}
{% endtab %}
{% endtabs %}

{% hint style="success" icon="lightbulb" %}
如果您在 Bitwarden App 中[登录了多个账户](/docs/account/log-in-and-unlock/account-switching)，超时时间和超时动作是根据每个账户分别设置的。
{% endhint %}

## 会话超时时间 <a href="#session-timeout" id="session-timeout"></a>

会话超时时间（也称为密码库超时）决定了 Bitwarden 在超时之前的非活动状态的时长。「不活动」是由与 Bitwarden 交互后的时间确定的，而不是系统空闲时间。

超时选项因 App 而异。如果您发现超时选项少于预期，并且您隶属于企业组织，则可能是企业组织启用了[会话超时策略](/docs/admin-console/oversight-visibility/enterprise-policies#session-timeout)。

{% tabs %}
{% tab title="网页 App" %}
选择 Bitwarden 会话何时超时：

* **经过的时间**：在您选择的时间间隔之后，例如 **5 分钟**或 **1 小时**
* **浏览器刷新时**：当您刷新打开 Bitwarden 的浏览器窗口时
* **自定义**：在输入的**小时**数量和**分钟**数量之后

{% hint style="info" %}
由于网页 App 和浏览器扩展基于您的网页浏览器，因此需要考虑特殊的「超时」情况：

* **如果您刷新浏览器** (`CMD/CTRL + R`)，您的网页 App 将被锁定。刷新不会影响浏览器扩展。
* **如果您关闭浏览器标签页**，您将从网页 App 中注销。关闭单个标签页不会影响浏览器扩展。
* **如果您关闭浏览器窗口**，您将从网页 App 中注销，以及您的浏览器扩展将超时。
  * 默认情况下，浏览器扩展将要求您使用主密码登录或解锁，而不管您选择了哪种密码库超时动作。
  * 要在关闭浏览器窗口后改为使用 PIN 码解锁，请在[设置 PIN 码](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)时取消选中**浏览器重启时使用主密码锁定**选项。
    {% endhint %}
    {% endtab %}

{% tab title="浏览器扩展" %}
选择 Bitwarden 会话何时超时。可用的选项可能因浏览器而异，可能包括：

* **立即**：当用户停止与 Bitwarden 交互时
* **经过的时间**：在您选择的时间间隔之后，例如 **5 分钟**或 **1 小时**
* **系统锁定时**：当您的设备锁定或屏幕保护程序激活时
* **浏览器重启时**：当您首次打开或重启打开 Bitwarden 的浏览器时

{% hint style="info" %}
某些浏览器将以不同方式对待“浏览器重新启动”选项：

* 在 Chromebook 上，无法完全关闭或重新启动浏览器。因此，使用**浏览器重启时**选项只会在您重新启动设备时才会锁定扩展程序。

* 在通过 snap 安装的 Firefox 浏览器中，关闭应用程序不会停止所有进程。因此，使用**浏览器重启时**选项只会在您重新启动设备时才会锁定扩展程序。

* 对于 Microsoft Edge 用户，关闭浏览器时不会重新启动浏览器。为了使 Bitwarden 密码库在浏览器重启时超时，必须禁用 Microsoft Edge 的两个设置：
  1. **启动增强**
  2. **在 Microsoft Edge 关闭后继续运行后台扩展和应用程序**
     {% endhint %}

* **从不**：您的会话不会超时

{% hint style="warning" %}
**从不**超时选项会将未加密的加密密钥存储在您的设备上，这可能会影响安全性。为了确保您的数据安全，我们强烈建议您选择其他选项。
{% endhint %}

* **自定义**：在输入的**小时**数量和**分钟**数量之后

浏览器扩展在弹出时不会遵守您选择的超时设置。

{% hint style="info" %}
由于网页 App 和浏览器扩展基于您的网页浏览器，因此需要考虑特殊的「超时」情况：

* **如果您刷新浏览器** (`CMD/CTRL + R`)，您的网页 App 将被锁定。刷新不会影响浏览器扩展。
* **如果您关闭浏览器标签页**，您将从网页 App 中注销。关闭单个选项卡不会影响浏览器扩展。
* **如果您关闭浏览器窗口**，您将从网页 App 中注销，以及您的浏览器扩展将超时。
  * 默认情况下，浏览器扩展将要求您使用主密码登录或解锁，而不管您选择了哪种密码库超时动作。
  * 要在关闭浏览器窗口后改为使用 PIN 码解锁，请在[设置 PIN 码](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)时取消选中**浏览器重启时使用主密码锁定**选项。
    {% endhint %}
    {% endtab %}

{% tab title="移动端" %}
选择 Bitwarden 会话何时超时：

* **立即**：当用户停止与 Bitwarden 交互时
* **经过的时间**：在您选择的时间间隔之后，例如 **5 分钟**或 **1 小时**
* **App 重启时**：当您首次打开或重新启动 Bitwarden App 时
* **从不**：您的会话不会超时

{% hint style="warning" %}
**从不**超时选项会将未加密的加密密钥存储在您的设备上，这可能会影响安全性。为了确保您的数据安全，我们强烈建议您选择其他选项。
{% endhint %}

* **自定义**：在输入的**小时**数量和**分钟**数量之后
  {% endtab %}

{% tab title="桌面端" %}
选择 Bitwarden 会话何时超时：

* **经过的时间**：在您选择的时间间隔之后，例如 **5 分钟**或 **1 小时**
* **系统空闲时**：当您的设备在设定的时间内处于非活动状态但尚未进入睡眠模式时
* **系统睡眠时**：当您的设备进入睡眠状态时
* **系统锁定时**：当您的设备锁定或屏幕保护程序激活时
* **重启时**：当您的设备首次打开或重新启动时
* **从不**：您的会话不会超时

{% hint style="warning" %}
**从不**超时选项会将未加密的加密密钥存储在您的设备上，这可能会影响安全性。为了确保您的数据安全，我们强烈建议您选择其他选项。
{% endhint %}

* **自定义**：在输入的**小时**数量和**分钟**数量之后
  {% endtab %}
  {% endtabs %}

## 会话超时动作 <a href="#session-timeout-action" id="session-timeout-action"></a>

此选项决定了 Bitwarden 在达到[会话超时](#vault-timeout)[时间](#vault-timeout)后将执行的操作。选项包括：

* **锁定**（默认）\
  密码库锁定时将在设备上保留密码库数据，因此可以离线解锁您的密码库。您只需要输入[主密码](/docs/account/master-password)或 PIN 码，或使用[生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)，但不需要使用任何有效的两步登录方式。
* **注销**\
  注销密码库时将完全从设备中删除所有密码库数据。重新登录将需要重新验证您的身份，因此登录只能在在线时完成。您需要输入您的[主密码](/docs/account/master-password)和任何有效的[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)方式。

### 受信任设备 <a href="#trusted-devices" id="trusted-devices"></a>

如果您使用[受信任设备](/docs/admin-console/login-with-sso/trusted-devices/about-trusted-devices)，则必须启用[生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)或 [PIN 码](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)才能解锁您的密码库。如果未启用生物识别或 PIN 码，会话超时将始终为注销而不是锁定。

使用受信设备解锁和登录**始终**需要互联网连接。


# 新设备登录保护

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/new-device-verification/)
{% endhint %}

{% hint style="info" %}
~~从 **2025 年 05 月 28 日**开始，所有 Bitwarden 客户端将受到新设备登录保护。为确保无缝的登录体验，请更新您的 Bitwarden 客户端，因为非常旧的版本可能不支持此功能。~~
{% endhint %}

> **\[译者注]**：如果您的 Bitwarden 账户对应的电子邮箱已不存在或您无法访问，导致您无法获取验证码，您可以[联系 Bitwarden 客服支持](https://bitwarden.com/contact/)说明情况，并提供一个您可以访问的电子邮箱，他们会对您的 Bitwarden 账户临时免除新设备登录保护 (NDLP - New Device Login Protection)。注意豁免期只有 24 小时！

为确保您的账户安全，Bitwarden 将对**未使用**[**两步登录**](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)**的用户**要求额外的验证。**当从一个以前未登录过的设备登录时**，在您输入 Bitwarden 主密码后，系统会提示您输入发送到您账户电子邮箱的一次性验证码，以完成登录过程。例如，如果您登录的是以前使用过的移动 App 或浏览器扩展，则不会收到此提示。

{% hint style="info" icon="lightbulb" %}
验证电子邮件能够送达您的收件箱非常重要。如果您启用了垃圾邮件过滤功能，请检查您的收件箱设置，确保这些电子邮件在接收时不会被直接丢弃。
{% endhint %}

除非频繁登录新的设备，否则大多数用户不会收到此提示。只有新设备或清除浏览器 cookie 后才需要进行此验证。

如果您经常访问电子邮箱，获取此验证码应该很简单。如果您不想依赖您的 Bitwarden 账户电子邮箱进行验证，您可以通过[验证器 App](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-authenticator)、[硬件钥匙](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-yubikey)或不同的[电子邮箱](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-email)来[设置两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。

## FAQ

### 何时会发生？ <a href="#when-will-this-happen" id="when-will-this-happen"></a>

从 **2025 年 03 月 04 日**开始，新设备登录时将会提示进行新的验证。这一变更最初将反应在网页 App 中，在用户更新到最新的发布版本将后扩展到其他 Bitwarden App 中。

### Bitwarden 为什么要实施这一举措？ <a href="#why-is-bitwarden-implementing-this" id="why-is-bitwarden-implementing-this"></a>

Bitwarden 正在实施这一变更，以增强未激活[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)功能的用户的安全性。如果有人获取了您的密码，在没有二次验证（发送到您邮箱的验证码）的情况下，他们仍然无法登录您的账户。这个额外的层级有助于保护您的数据不受黑客攻击，因为黑客通常会利用弱密码或暴露的密码来获得未经授权的访问。

### 我何时会收到此验证提示？ <a href="#when-will-i-get-prompted-for-this-verification" id="when-will-i-get-prompted-for-this-verification"></a>

只有在使用新的设备登录时，您才会收到此验证提示。如果您登录的是以前使用过的设备，则您不会收到此提示。

### 什么设备才会被视为新的设备？ <a href="#what-is-considered-a-new-device" id="what-is-considered-a-new-device"></a>

新设备是指以前没有用来登录过您的 Bitwarden 账户的任何设备。这可能包括您从未登录过的新手机、平板、计算机或浏览器扩展。当您从新设备登录时，系统会要求您通过发送到您电子邮箱的一次性代码验证您的身份。

会触发新设备的其他情况包括：

* 卸载并重新安装移动 App、桌面 App 或浏览器扩展将触发新设备。
* 清除浏览器 cookie 将为网页 App 触发新设备，但不会为浏览器扩展触发新设备。
* 在虚拟桌面基础架构 (VDI) 中使用浏览器扩展，在每次会话后会重置用户配置文件存储。在这种情况下，[本地存储](/docs/security/data/data-storage#on-your-local-machine)不会被保留。

### 我的电子邮箱凭据保存在 Bitwarden 中。我会被锁定在 Bitwarden 之外吗？ <a href="#my-email-credentials-are-saved-in-bitwarden.-will-i-be-locked-out-of-bitwarden" id="my-email-credentials-are-saved-in-bitwarden.-will-i-be-locked-out-of-bitwarden"></a>

对于未启用两步登录的用户，仅在新设备上会要求电子邮箱验证码。在之前已登录过的设备上，您不会收到此提示，您可以像往常一样使用您的账户电子邮箱和主密码登录。

如果您登录到新设备，您的 Bitwarden 账户电子邮箱将收到一个一次性验证码。如果您可以访问您的电子邮箱（例如，在手机上已持久登录的电子邮箱），然后您就可以获取一次性验证码来登录了。登录到新设备后，系统不会再提示您输入验证码。

如果您经常使用保存在 Bitwarden 中的凭据登录电子邮箱，或者不希望依赖电子邮箱进行验证，您应该设置独立于 Bitwarden 账户电子邮箱的[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。这包括验证器 App、安全密钥或使用不同电子邮箱的基于电子邮箱的两步登录。激活任何 2FA 方法都将使用户退出基于电子邮箱的新设备验证。已激活 2FA 的用户还应将其 Bitwarden [恢复代码](/docs/account/two-step-login/recovery-codes)保存在安全的地方。

### 哪些人会被排除在基于账户电子邮箱的新设备验证之外？ <a href="#who-is-excluded-from-this-account-email-based-new-device-verification" id="who-is-excluded-from-this-account-email-based-new-device-verification"></a>

以下类别的登录将被排除在外：

* 已经设置了[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)的用户将被排除在外。
* 已经使用了 SSO、通行密钥或 API 密钥登录的用户将被排除在外。
* 自托管用户将被排除在外。
* 从以前登录过的设备登录的用户将被排除在外。
* 从**设置** → **我的账户**界面选择了**停用新设备登录保护**的用户将被排除在外（**不建议**）。

### 我的组织使用 SSO，我的用户是否必须完成新设备验证吗？ <a href="#my-organization-users-sso-do-my-users-have-to-complete-new-device-verification" id="my-organization-users-sso-do-my-users-have-to-complete-new-device-verification"></a>

不需要。使用 SSO 登录的用户不会被要求在新设备上验证登录。但是，如果用户未启用两步登录，不通过 SSO 而是使用用户名和密码登录，则他们会被要求验证新设备。

### 我不想与 Bitwarden 分享我的真实电子邮箱，我该如何设置我的账户？ <a href="#i-do-not-want-to-share-my-real-email-with-bitwarden-how-can-i-set-up-my-account" id="i-do-not-want-to-share-my-real-email-with-bitwarden-how-can-i-set-up-my-account"></a>

希望保持匿名的用户有多种选择：

* 使用非电子邮箱方式的[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)选项，包括验证器 App、安全密钥或使用不同电子邮箱的基于电子邮箱的两步登录。
* 使用电子邮箱别名转发服务。
* 自托管 Bitwarden。

Bitwarden 鼓励用户拥有一个有效的电子邮箱，因为 Bitwarden 会发送诸如登录尝试失败等重要的安全警报。

### 如果我在新设备上使用 2FA 恢复代码（因为我丢失了 2FA 访问权限），我是否仍然需要接受新设备验证？ <a href="#if-i-use-the-2fa-recovery-code-on-a-new-device-because-ive-lost-my-2fa-access-will-i-still-be-subjec" id="if-i-use-the-2fa-recovery-code-on-a-new-device-because-ive-lost-my-2fa-access-will-i-still-be-subjec"></a>

Bitwarden 正在更新恢复代码流程，以便当您提交密码和恢复代码时，您将登录到网页 App 并进入 2FA 设置页面。如果您担心被锁定，应避免在隐身浏览器或具有不可靠的网络连接的设备上执行此流程，以确保您可以在登录会话中完成所有必要的设置步骤。

### 我想选择退出！有什么选项吗？ <a href="#i-want-to-opt-out-is-there-an-option-to" id="i-want-to-opt-out-is-there-an-option-to"></a>

这是为未启用两步登录的用户增加的额外安全措施。未启用两步登录的用户更容易受到攻击者的未经授权的访问，因为即使密码强度高且唯一，也可能通过多种方式被泄露。例如，常见的方式包括：

* **钓鱼攻击**：网络犯罪分子使用欺骗性电子邮件或网站诱骗您泄露密码。
* **社会工程攻击**：攻击者可能通过电话、短信或其他方式试图操纵或欺骗您泄露您的密码。
* **暴力破解攻击**：攻击者使用自动化工具反复尝试猜测密码。
* **键盘记录或恶意软件**：如果您的设备感染了恶意软件或键盘记录器，攻击者可能会在您不知情的情况下记录您的每一次按键，包括您的密码。

通过新设备验证，即使您的密码通过上述某种方式泄露，攻击者仍然需要获取第二个验证因素（即您电子邮箱中的一次性代码）。这大大降低了未经授权访问的可能性。

新设备验证的设计比传统的两步登录更少干扰。它仅适用于从未使用过的设备或客户端登录时，因此大多数用户不会遇到这一额外步骤，因为他们通常会在日常设备上登录。验证过程使用您的电子邮箱（许多人会在手机或电脑上保持邮箱登录状态），因此获取代码既快速又简单。

具有以下情况的用户可能会遇到一些挑战：

* 未启用两步登录。
* 将电子邮箱密码存储在 Bitwarden 中。
* 频繁卸载并重新安装 Bitwarden。
* 在所有地方都注销了其电子邮箱。

只有同时满足上述所有条件的用户才会受到此安全更新的影响。如果用户确实被锁定账户，可以联系 Bitwarden 的客户支持团队。

如果用户不希望使用新设备验证，强烈建议启用其他两步登录方式（验证器 App、硬件密钥或不同的电子邮箱）之一来保护您的账户。

如果用户不希望使用新设备验证，也不想设置其他两步登录方式，并且不希望账户有任何安全保护，可以通过导航到**设置** → **我的账户**页面然后滚动到**危险操作区**部分选择**停用新设备登录保护**。我们必须强调，**强烈不建议这样做**，因为这会使您的账户容易受到各种攻击。


# 登录到多个账户

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/account-switching/)
{% endhint %}

您知道吗？您可以在 Bitwarden 浏览器扩展、桌面 App 和移动 App 中同时登录**最多 5 个** Bitwarden 账户。使用账户切换功能，在个人账户和工作账户等 Bitwarden 账户之间无缝切换。

{% tabs %}
{% tab title="移动端" %}
要登录更多账户，请从顶部菜单栏中选择当前已登录的账户，然后选择 <i class="fa-plus">:plus:</i>**添加账户**。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/56xAZhiS6wZqKktMlFwbVn/9af5d0ce782af44fc48ebfd8057ddc4c/2025-01-21_14-58-15.png?w=713&#x26;fm=avif" alt=""><figcaption><p>移动端账户切换</p></figcaption></figure></div>

选择 <i class="fa-plus">:plus:</i>**添加账户**将带您进入登录界面：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/112EwzW6sPKPGu65R8rKHc/679b2686d9b67e5ccb37a2ebf56ea062/2025-01-21_15-04-00.png?w=710&#x26;fm=avif" alt=""><figcaption><p>移动端登录</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
如果您在多台服务器上拥有账户，例如，如果自托管 Bitwarden 的雇主向您发放了[家庭组织赞助](/docs/admin-console/manage-members/sponsored-families/sponsored-families-for-members)，请使用登录界面上的**服务器选择器下拉菜单**，选择**自托管**菜单，将**服务器 URL** 更改为账户的 URL。

<img src="https://bitwarden.com/assets/1Bc4QseUed27nuuhbeD7WR/e5dbca7997cb8efe1ebbff001813354e/2026-01-28_09-16-56.png?w=1001&#x26;fm=avif" alt="" data-size="original">

在此示例中，您的工作账户可能使用诸如 `https://your.company.bitwarden.com`，而您的家庭组织账户可能使用 `https://vault.bitwarden.com`。
{% endhint %}

登录第二个账户后，您可以从同一菜单中快速切换它们，该菜单还将显示每个账户的密码库的当前状态（已锁定或已解锁）。如果您注销其中一个账户，它将从列表中移除，除非[密码库超时](/docs/account/log-in-and-unlock/vault-timeout-options)设置为注销。

{% hint style="info" %}
大多数密码库操作，包括添加新项目或文件夹、同步、自动填充以及[密码库超时](/docs/account/log-in-and-unlock/vault-timeout-options)和解锁（[PIN 码](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin) 或[生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)）等设置仅适用于活动账户，您可以通过 App 顶部菜单栏中显示的图标来确定活动账户。

但某些选项，例如[主题](/docs/password-manager/your-vault/appearance/change-app-appearance)，则适用于所有账户。
{% endhint %}

## 自动填充 <a href="#auto-fill" id="auto-fill"></a>

如果您正使用账户切换，您的移动 App 将默认自动填充当前活动账户账户的凭据，但是，您可以在自动填充期间从一个账户切换到另一个账户。
{% endtab %}

{% tab title="桌面端" %}
要登录更多账户，请从桌面 App 的右上角选择当前已登录的账户，然后选择 <i class="fa-plus">:plus:</i>**添加账户**。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7fpUmakpNIByzoWQa1cU8L/bd9e35756805bba8bd35bc43c7630aaf/2026-04-23_09-27-28.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 账户切换</p></figcaption></figure></div>

选择 <i class="fa-plus">:plus:</i>**添加账户**将带您进入登录界面：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6Dvz7SzKBp90RDcROWgBhW/2407b5d1399cc1b8d0780b31dcbd95ee/2026-04-23_09-29-54.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 账户切换</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
如果您在多台服务器上拥有账户，例如，如果自托管 Bitwarden 的雇主向您发放了[家庭组织赞助](/docs/admin-console/manage-members/sponsored-families/sponsored-families-for-members)，请使用登录界面上的**服务器选择器下拉菜单**，选择**自托管**菜单，将**服务器 URL** 更改为账户的 URL。

<img src="https://bitwarden.com/assets/1Bc4QseUed27nuuhbeD7WR/e5dbca7997cb8efe1ebbff001813354e/2026-01-28_09-16-56.png?w=1001&#x26;fm=avif" alt="" data-size="original">

在此示例中，您的工作账户可能使用诸如 `https://your.company.bitwarden.com`，而您的家庭组织账户可能使用 `https://vault.bitwarden.com`。
{% endhint %}

登录第二个账户后，您可以从同一菜单中快速切换它们，该菜单还将显示每个账户的密码库的当前状态（已锁定或已解锁）。如果您注销其中一个账户，它将从列表中移除。

{% hint style="info" %}
大多数密码库操作，包括添加新项目或文件夹、同步、搜索以及[密码库超时](/docs/account/log-in-and-unlock/vault-timeout-options)和解锁（[PIN 码](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin) 或[生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)）等设置仅适用于活动账户，您可以通过显示在 App 右上角中的电子邮件来确定活动账户。

但某些**偏好设置**，则适用于**所有账户**：

<img src="https://bitwarden.com/assets/4tZUuuDPHnHQh5RNihx0TB/e20745ac076e7274ec0652692159c4e1/2026-04-23_09-34-58.png?w=800&#x26;fm=avif" alt="" data-size="original">
{% endhint %}
{% endtab %}

{% tab title="浏览器扩展" %}
要登录更多账户，请从顶部菜单栏中选择当前已登录的账户：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7xbbMZ89zcTHz6ee0cA1MK/8d8972a6b995b3fd7367f248c9c60d69/screenshot_3.png?w=440&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展账户切换</p></figcaption></figure></div>

选择账户图标后，从账户切换菜单中选择 <i class="fa-plus">:plus:</i>**添加账户**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/343trVk3zLCF7Z12uA5wjO/ac2f56fc907372335f30d1dbf68116a1/screenshot_4.png?w=438&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展添加账户</p></figcaption></figure></div>

登录第二个账户后，您可以从同一菜单中快速切换它们，该菜单还将显示每个账户的密码库的当前状态（已锁定或已解锁）。如果您注销其中一个账户，它将从列表中移除。

## 自动填充 <a href="#auto-fill" id="auto-fill"></a>

如果您正使用账户切换，浏览器扩展将默认自动填充当前活动账户账户的凭据。
{% endtab %}
{% endtabs %}

{% hint style="info" %}
登录多个账户不会在账户之间转移项目。如果您想将保存的项目从一个 Bitwarden 账户移动到另一个账户，请[导入您的数据](/docs/password-manager/import-and-export/import-data)。
{% endhint %}


# 使用单点登录


# 使用 SSO 登录

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/using-sso/)
{% endhint %}

如果您是某个企业版组织的成员，您可能会被[要求](/docs/admin-console/oversight-visibility/enterprise-policies#require-single-sign-on-authentication)或被允许使用单点登录登录到 Bitwarden，类似于登录其他工作相关的应用程序的方式：

1、打开 Bitwarden App，输入您的电子邮箱地址，然后选择**使用单点登录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3XPDLW9GBkA4TIk1j6EAXq/37d89e28b4d913e7a5031ff1c06fc783/2025-10-13_10-39-36.png?w=938&#x26;fm=avif" alt=""><figcaption><p>使用单点登录按钮</p></figcaption></figure></div>

2、您的组织**可能**会要求您输入 **SSO 标识符**。若看到以下界面，请输入您组织的 SSO 标识符；若不清楚该信息，请联系经理或管理员协助获取。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5sNF8v7r2HsyLQm8gd6xBC/ac61e5e2bb0c733b3498536be584db9a/2025-10-13_10-46-01.png?w=958&#x26;fm=avif" alt=""><figcaption><p>SSO 标识符界面</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
**组织成员**：请将 URL 中包含标识符的页面（例如 `https://vault.bitwarden.com/#/sso?my-identifier`）添加为书签，这样您就不必在每次登录时输入它了。

**组织管理员**：如果您的成员拥有与域名匹配的电子邮箱地址，设置[声明域名](/docs/admin-console/oversight-visibility/claimed-domains/claimed-domains)将自动跳过此步骤。
{% endhint %}

3、当您被重定向至 IdP（例如 Microsoft Azure、Duo 或 OneLogin）后，请输入您的 SSO 凭据进行登录，操作方式与其他应用程序相同。通常，在此阶段，您的 IdP 会要求您完成 2FA。

4、后续操作取决于您的组织选择的[解密选项](/docs/admin-console/login-with-sso/sso-decryption-options)：

{% tabs %}
{% tab title="主密码" %}
输入您的主密码，或者，如果您的账户是新账户，请创建[主密码](/docs/account/master-password)以完成登录：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/TJ0nUZ4zs7l38aOQz5WLl/6b95624ef2271198f6fc6447b77d63c1/2025-10-13_12-57-15.png?w=958&#x26;fm=avif" alt=""><figcaption><p>使用主密码解密</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
**为什么仍然需要主密码？**

所有密码库数据，包括[由您组织共享](/docs/password-manager/organization-members/sharing)的凭据，Bitwarden **仅**以加密形式保存他们。这意味着为了使用任何这些凭据，**您**需要一种方法来解密该数据。我们不能。

您的主密码是该解密密钥的来源。即使您使用 SSO 向 Bitwarden 进行身份验证（证明您的身份），您仍然必须使用该解密密钥（在这种情况下是您的主密码）来解密密码库数据。
{% endhint %}
{% endtab %}

{% tab title="设备批准" %}
选择一个[与您登录的设备建立信任](/docs/account/log-in-and-unlock/using-single-sign-on/add-a-trusted-device)的选项，以完成登录：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1zrsBanU5CNhFnDHAXazwP/c94f8bfb5066cb79381676570bd87aa1/2025-10-13_13-06-26.png?w=958&#x26;fm=avif" alt=""><figcaption><p>建立信任的选项</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
如果这是您第一次登录，您将被允许自动将此 App 指定为受信任设备，而不是被要求使用上述方法之一：

<img src="https://bitwarden.com/assets/6iahsCNPUcIT51P2oZIUQ1/f6dbb4364d96d80c69c3ec84176e7971/2025-10-13_13-03-59.png?w=958&#x26;fm=avif" alt="" data-size="original">
{% endhint %}
{% endtab %}

{% tab title="Key Connector" %}
如果您的组织使用 Key Connector，将要求您验证其是否已连接到正确的组织：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/fTrb2sTLVMdjtlpf2yNGD/59e7c37be145ef6525128f73864e3aee/2025-12-17_13-45-48.png?w=424&#x26;fm=avif" alt=""><figcaption><p>验证组织 Key Connector</p></figcaption></figure></div>

如果您的账户是在实施 Key Connector 之前创建的，则可能需要输入主密码。这样做将从您的账户中移除主密码。

{% hint style="info" %}
我们鼓励您阅读有关 Key Connector 的信息，以了解从您的账户中[移除主密码的影响](/docs/self-hosting/key-connector/about-key-connector#impact-on-master-passwords)。
{% endhint %}
{% endtab %}
{% endtabs %}

5、最后，可能会要求您使用[您在 Bitwarden 中设置的选项](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)完成两步登录。如果您的 IdP 要求，您通常不需要使用 Bitwarden 两步登录（**步骤 3**）。

{% hint style="warning" %}
**如果您是首次加入组织**，则无需完成**步骤 5**，并且在管理员确认您的成员身份之前，您将无法访问组织数据。
{% endhint %}


# 添加受信任设备

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/add-a-trusted-device/)
{% endhint %}

当您成为某个组织的成员时，您首次登录的设备将自动被注册为受信任设备。注册成功后，您只需完成公司既定的单点登录流程，即可登录 Bitwarden 并解密您的密码库数据。

{% hint style="success" icon="lightbulb" %}
当您登录设备时，设备将默认受到信任。强烈建议您在登录公共或共享设备时取消选中**记住此设备**选项。
{% endhint %}

当您登录新设备时，您需要批准或信任该设备。有几种方法可以做到这一点：

* **从其他设备批准**：如果您已在另一台设备上登录 Bitwarden，您可以从那里批准新设备：

{% tabs %}
{% tab title="移动 App" %}
要使用移动 App 批准请求：

1、在移动 App 中，导航至**设置** → **账户安全** → **待处理的登录请求**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1ZB3Pc8T0mlP96W3IZefrR/a22c8efe63a88941bad11a278b1d113d/2025-09-09_09-39-13.png?w=1193&#x26;fm=avif" alt=""><figcaption><p>移动端上待处理的登录请求</p></figcaption></figure></div>

2、定位并点击待处理的设备请求。

3、验证指纹短语然后选择**确认访问**：

<div align="center" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6xeP36n7g2dbwLI9YWjNg4/2aa9fdc96e765e963ee07f38ad0b6c06/2025-09-09_09-39-44.png?w=1192&#x26;fm=avif" alt=""><figcaption><p>在移动端上批准登录</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
要使用浏览器扩展批准请求：

1、在浏览器扩展中，等待接收到设备批准请求或导航至**设置** → **账户安全** → **设备**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6OZfQt2jDDqa9F0MaUdBUq/1460f0ec04c63ab55da1f5eaf37ca469/2025-09-09_09-49-23.png?w=1190&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展上的设备视图</p></figcaption></figure></div>

2、在**设备**选项卡上，定位并选择待处理的设备请求：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/64f1jZ30In2BbWDEUZVtxO/9de965d59fedca2bad4e325f4181f69a/2025-09-09_09-49-42.png?w=1187&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展上的设备列表</p></figcaption></figure></div>

3、验证指纹短语然后选择**确认访问**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2LFY10MMpI9G0ZcojcXveg/0a891ec5fa8f6052e5804841e7ec7724/2025-09-09_09-48-55.png?w=1193&#x26;fm=avif" alt=""><figcaption><p>在浏览器扩展上批准设备</p></figcaption></figure></div>
{% endtab %}

{% tab title="网页 App" %}
要使用网页 App 批准请求：

{% hint style="info" %}
当请求批准登录浏览器扩展时，即使您单击退出或最小化扩展窗口，该扩展也会等待最多两分钟以获得批准，以便使用网页 App 批准请求。
{% endhint %}

1、在网页 App 中，选择横幅通知中的**审查登录请求**链接或导航至**设置** → **安全** → **设备**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1K9FeC1OVOwyu0T8DMiwOp/cc88b5f47f0f243f5a655e77086871c9/2025-12-31_11-10-23.png?w=1200&#x26;fm=avif" alt=""><figcaption><p>在网页 App 上批准请求</p></figcaption></figure></div>

2、在**设备**选项卡上，定位并选择待处理的设备请求：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7GLmOwtReFuUD3uxPQ0LB8/ed5dbce83b2c428b9c2369270be1d959/2025-12-31_11-08-26.png?w=1200&#x26;fm=avif" alt=""><figcaption><p>网页 App 上的设备列表</p></figcaption></figure></div>

3、验证指纹短语然后选择**确认访问**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6s6Hdn9L1EyeRfBsmOcfgX/f6a13a34fdc59f815f7e4d51e981af47/2025-12-31_11-08-37.png?w=1200&#x26;fm=avif" alt=""><figcaption><p>使用网页 App 确认访问</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面 App" %}
要使用桌面 App 批准请求：

1、在桌面 App 中，等待接收到设备批准请求：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5cpkevhyuiSg82yfopvmc1/916f1988e815f23d871bc56effbc1247/2026-05-28_14-05-19.png?w=800&#x26;fm=avif" alt=""><figcaption><p>在桌面 App 上批准</p></figcaption></figure></div>

2、验证指纹短语然后选择**确认访问**。
{% endtab %}
{% endtabs %}

* **使用主密码批准**：如果您是管理员或所有者，或者在受信任设备 SSO 实施之前加入了您的组织，因此仍然拥有与您的账户关联的主密码，则可以输入主密码来批准设备。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5IMJBQOrklcOuLVEpaR6gX/60ead8f10e34f7acd2467eaaa34ff93d/2025-06-16_15-22-15.png?w=642&#x26;fm=avif" alt=""><figcaption><p>请求管理员批准</p></figcaption></figure></div>

* **请求管理员批准**：您可以向组织内的管理员和所有者发送设备批准请求以供批准。您必须[注册账户恢复](/docs/admin-console/manage-members/account-recovery/account-recovery-enrollment#self-enroll-in-account-recovery)才能请求管理员批准，不过您在加入组织时可能已[自动注册](/docs/admin-console/manage-members/account-recovery/account-recovery-enrollment#automatic-enrollment)。在许多情况下，这将是您唯一可用的选择（[了解更多](/docs/admin-console/login-with-sso/trusted-devices/approve-a-trusted-device)）。

{% hint style="info" %}
如果您使用此选项，（当设备请求获得批准后）您将收到一封电子邮件，通知您可以继续在该设备登录。您必须在 12 小时内登录新设备，否则批准将失效。
{% endhint %}

新设备成为受信任设备后，您只需完成公司既定的单点登录流程，即可登录 Bitwarden 并解密您的密码库数据。

## 添加您的第一台受信任设备 <a href="#adding-your-first-trusted-device" id="adding-your-first-trusted-device"></a>

对于通过[使用 SSO 登录](/docs/admin-console/login-with-sso/about-sso)即时 (JIT) 配置而被邀请的用户，用于访问 Bitwarden 的初始客户端将成为他们的第一台受信任设备。如果访问的初始客户端是 Bitwarden 桌面 App 或移动 App，则该设备可用于批准其他设备。

要使桌面 App 或移动 App 成为第一个受信任设备，用户不应使用组织邀请链接，而是打开桌面 App 或移动 App，选择**企业单点登录**选项，以开始 JIT 流程。

> **\[译者注]**：**JIT**：Just-In-Time，指的是「即时配置」或「按需配置」，是一种用户管理和资源配置的方式。Bitwarden 使用这种方式简化了管理流程并提升了安全性。

## 移除受信任设备 <a href="#remove-a-trusted-device" id="remove-a-trusted-device"></a>

设备将保持信任状态，直到：

* 应用程序或扩展被卸载。
* 网页浏览器的内存被清除（仅限网页 App）。

## 故障排除 <a href="#troubleshooting" id="troubleshooting"></a>

如果您在建立设备信任时遇到问题：

* 在 Chrome 上，检查是否已开启**允许网站将数据保存在设备上**（**设置** → **隐私与安全** → **网站设置** → **更多内容设置** → **设备端网站数据** → **允许网站将数据保存在设备上**）。


# 链接 SSO

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/link-sso/)
{% endhint %}

通常情况下，只有在您使用**已有的 Bitwarden 账户**加入组织时，或组织未强制[要求使用 SSO](/docs/admin-console/oversight-visibility/enterprise-policies#require-single-sign-on-authentication) 时，才需要链接 SSO。要链接到 SSO：

1、打开网页 App，点击您的组织旁的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**选项**菜单。

2、从下拉菜单中，选择 <i class="fa-link">:link:</i>**链接 SSO**。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/cv0DGhcgyEbQEn4MvdJp5/fefb4158c09be8cf9804ed5579c2d7dc/Screenshot_2024-02-26_at_2.07.03_PM.png?w=1331&#x26;fm=avif" alt=""><figcaption><p>连接 SSO</p></figcaption></figure></div>

链接完成后，您即可以[使用 SSO 登录到账户](/docs/account/log-in-and-unlock/using-single-sign-on/using-login-with-sso)了。

{% hint style="info" %}
链接后，您可以从同一菜单**取消链接 SSO**。此功能主要适用于以下场景：您的身份提供程序 (IdP)（例如 Google、Azure) 或 Bitwarden 中的电子邮件地址发生更改，导致 SSO 失效时；或者 IdP 身份链接到了错误的 Bitwarden 账户时，需先断开现有链接才能建立正确的链接。
{% endhint %}


# 更多登录 & 解锁选项


# 使用设备登录

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/log-in-with-device/)
{% endhint %}

设置使用设备登录，以便更快、更方便地访问 Bitwarden。这种登录方式称为无密码身份验证，无需在每次登录时输入主密码。使用**设备登录**，每次在一台设备上登录 Bitwarden 时，您都选择使用已登录的其他 Bitwarden App 来批准身份验证请求，而无需输入主密码。

[了解我们的零知识加密实施方案](#how-it-works)。

## 准备使用设备登录 <a href="#prepare-to-log-in-with-a-device" id="prepare-to-log-in-with-a-device"></a>

要设置设备登录：

* 至少正常登录一次发起 App（网页 App、浏览器扩展、桌面 App 或移动 App），以便 Bitwarden 可以识别您的设备。

{% hint style="info" %}
使用隐身模式或隐私浏览会阻止 Bitwarden 注册您的浏览器，因此您将无法在隐私浏览器窗口中使用设备登录。
{% endhint %}

* 在用于批准的 App （网页 App、浏览器扩展、移动 App 或桌面 App）上拥有认可的账户。要认可该账户，您必须随时已成功登录到该设备。

{% hint style="info" %}
作为企业组织的成员，您需要遵守[要求 SSO 策略](/docs/admin-console/oversight-visibility/enterprise-policies#require-single-sign-on-authentication)，如果您无法使用**设备登录**选项，则需要改用 [SSO 登录](/docs/account/log-in-and-unlock/using-single-sign-on/using-login-with-sso#login-using-sso)。
{% endhint %}

## 使用设备登录 <a href="#logging-in-with-a-device" id="logging-in-with-a-device"></a>

在发起 App 的登录界面，输入您的电子邮箱地址并选择**继续**。然后，选择**使用设备登录**选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7owqaTEe9Bo05wfLRZPhn8/38f1d0334964bb3d98a430b80b9d6b95/2025-09-09_10-03-52.png?w=692&#x26;fm=avif" alt=""><figcaption><p>使用设备登录</p></figcaption></figure></div>

### 批准登录请求 <a href="#approve-a-log-in-request" id="approve-a-log-in-request"></a>

使用**设备登录**会将身份验证请求发送到您当前已登录的 Bitwarden App 以用于批准。

{% tabs %}
{% tab title="移动 App" %}
要使用移动 App 批准请求：

1、在移动 App 中，导航至**设置** → **账户安全** → **待处理的登录请求**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1ZB3Pc8T0mlP96W3IZefrR/a22c8efe63a88941bad11a278b1d113d/2025-09-09_09-39-13.png?w=1193&#x26;fm=avif" alt=""><figcaption><p>移动端上待处理的登录请求</p></figcaption></figure></div>

2、定位并点击待处理的设备请求。

3、验证指纹短语然后选择**确认访问**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6xeP36n7g2dbwLI9YWjNg4/2aa9fdc96e765e963ee07f38ad0b6c06/2025-09-09_09-39-44.png?w=1192&#x26;fm=avif" alt=""><figcaption><p>移动端上批准登录</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
要使用浏览器扩展批准请求：

1、在浏览器扩展中，等待接收到设备批准请求或导航至**设置** → **账户安全** → **设备**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6OZfQt2jDDqa9F0MaUdBUq/1460f0ec04c63ab55da1f5eaf37ca469/2025-09-09_09-49-23.png?w=1190&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展上的设备视图</p></figcaption></figure></div>

2、在**设备**选项卡上，定位并选择待处理的设备请求：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/64f1jZ30In2BbWDEUZVtxO/9de965d59fedca2bad4e325f4181f69a/2025-09-09_09-49-42.png?w=1187&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展上的列表</p></figcaption></figure></div>

3、验证指纹短语然后选择**确认访问**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2LFY10MMpI9G0ZcojcXveg/0a891ec5fa8f6052e5804841e7ec7724/2025-09-09_09-48-55.png?w=1193&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展上批准设备</p></figcaption></figure></div>
{% endtab %}

{% tab title="网页 App" %}
要使用网页 App 批准请求：

{% hint style="info" %}
当请求批准登录浏览器扩展程序时，即使您单击退出或最小化扩展程序窗口，该扩展程序也会等待最多两分钟以获得批准，以便使用网页 App 批准请求。
{% endhint %}

1、在网页 App 中，选择横幅通知中的**审查登录请求**链接或导航至**设置** → **安全** → **设备**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1K9FeC1OVOwyu0T8DMiwOp/cc88b5f47f0f243f5a655e77086871c9/2025-12-31_11-10-23.png?w=1219&#x26;fm=avif" alt=""><figcaption><p>在网页 App 上批准请求</p></figcaption></figure></div>

2、在**设备**选项卡上，定位并选择待处理的设备请求：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7GLmOwtReFuUD3uxPQ0LB8/ed5dbce83b2c428b9c2369270be1d959/2025-12-31_11-08-26.png?w=1219&#x26;fm=avif" alt=""><figcaption><p>网页 App 上的设备列表</p></figcaption></figure></div>

3、验证指纹短语然后选择**确认访问**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6s6Hdn9L1EyeRfBsmOcfgX/f6a13a34fdc59f815f7e4d51e981af47/2025-12-31_11-08-37.png?w=1219&#x26;fm=avif" alt=""><figcaption><p>使用网页 App 确认访问</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面 App" %}
要使用桌面 App 批准请求：

1、在桌面 App 中，等待接收到设备批准请求：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5cpkevhyuiSg82yfopvmc1/916f1988e815f23d871bc56effbc1247/2026-05-28_14-05-19.png?w=800&#x26;fm=avif" alt=""><figcaption><p>在桌面 App 上批准</p></figcaption></figure></div>

2、验证指纹短语然后选择**确认访问**。
{% endtab %}
{% endtabs %}

请注意，这是一个独特的指纹，与您的[账户指纹短语](/docs/security/encryption/account-fingerprint-phrase)不一样。

如果请求未被批准或被拒绝，则请求将在 15 分钟后过期。如果您没有收到登录请求，请尝试刷新网页 App 或从移动 App [手动同步您的密码库](/docs/password-manager/your-vault/syncing-your-vault)。

{% hint style="info" %}
如果您使用**设备登录**选项，您仍然需要使用任何当前有效的[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。
{% endhint %}

## 工作原理 <a href="#how-it-works" id="how-it-works"></a>

当发起设备登录时：

1. 发起客户端向 Bitwarden 数据库中的身份验证请求表发送一个请求，其中包括账户电子邮箱地址、唯一的**身份验证请求公钥**<mark style="color:red;">**ª**</mark> 和访问代码。已注册的设备，即已登录并在 Bitwarden 数据库中存储了[特定于设备的 GUID](/docs/security/data/administrative-data) 的客户端，将收到此请求。
2. 请求获得批准后，批准客户端使用此请求中包含的**身份验证请求公钥**对账户的**用户加密密钥**进行加密。
3. 批准客户端然后将**用户加密密钥**发送到身份验证请求记录，并将此请求标记为已完成。
4. 发起客户端请求已加密的**用户加密密钥**。
5. 然后，发起客户端使用**身份验证请求私钥**在**本地**解密**用户加密密钥**。
6. 然后，发起客户端使用访问代码通过 Bitwarden Identity 服务对用户进行身份验证。
7. 然后，发起客户端可以获取用户的密码库数据并使用**用户加密密钥**对其进行解密。

<mark style="color:red;">**ª**</mark> - **身份验证请求公钥和私钥**是为每一个无密码登录请求生成的唯一密钥，其存在时间与请求的存在时间相同。如果请求未被批准或被拒绝，请求将过期并定期清除。


# 使用通行密钥登录 & 解锁

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/login-with-passkeys/)
{% endhint %}

{% hint style="info" %}
Bitwarden 提供三种通行密钥功能：

* 从您的 Bitwarden 密码库为其他服务[保存和自动填充通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)。
* 使用[通行密钥登录和解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)您的 Bitwarden 账户。<mark style="color:red;">**ª**</mark>
* 使用[通行密钥 2FA](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)保护您的 Bitwarden 账户。<mark style="color:red;">**ª**</mark>

<mark style="color:red;">**ª**</mark> - 某些身份验证器，尤其是 Windows Hello，不允许您使用通行密钥同时进行登录和 2FA。
{% endhint %}

通行密钥为您的 Bitwarden 账户提供安全身份验证。使用它们登录，并通过[支持 PRF 的设置](#unlock-vault-requirements)自动[解锁您的密码库](/docs/account/log-in-and-unlock/understand-log-in-vs-unlock)，而无需输入主密码。通行密钥绕过两步登录，为传统的基于密码的身份验证提供了简化的替代方案。

## 要求 <a href="#requirements" id="requirements"></a>

目前，这些 Bitwarden App 支持使用通行密钥登录和解锁您的 Bitwarden 账户：

* 基于 Chromium 的浏览器中的浏览器扩展
* 网页 App

{% hint style="info" %}
在 macOS 上，创建和使用支持 PRF 的通行密钥来解锁您的密码库需要基于 Chromium 的浏览器。
{% endhint %}

用于登录 Bitwarden 的通行密钥需要用户验证，例如生物识别或安全密钥来验证和使用您的通行密钥。

### 解锁密码库要求 <a href="#unlock-vault-requirements" id="unlock-vault-requirements"></a>

要使用通行密钥解密并解锁您的密码库，您需要为该通行密钥[设置加密](#set-up-encryption-for-unlock)。您的浏览器（例如 Google Chrome）和身份验证器（例如 YubiKey 5）都必须同时[支持 PRF](https://bitwarden.com/blog/prf-webauthn-and-its-role-in-passkeys/) 才能使用此解锁方式。如果其中任何一个不支持 PRF，您需要使用其他解锁方式，例如您的主密码或 PIN 码。

**​​PRF 功能因设备和环境而异**。例如，Google Chrome 支持 PRF，但 Chrome 配置文件不支持。YubiKey 5 是一款支持 PRF 的身份验证器。此外，已知 Windows 10 与支持 PRF 的通行密钥存在兼容性问题。

### 通行密钥限制 <a href="#passkey-restrictions" id="passkey-restrictions"></a>

如果您所在的组织使用了[要求 SSO](/docs/admin-console/oversight-visibility/enterprise-policies#require-single-sign-on-authentication) 策略、使用[受信任设备 SSO](/docs/admin-console/login-with-sso/trusted-devices/about-trusted-devices) 或 [Key Connector](/docs/self-hosting/key-connector/about-key-connector)，则无法在 Bitwarden 中使用通行密钥。

Bitwarden 不会提示或允许您保存用于登录任何 Bitwarden 账户的通行密钥。这避免了需要访问您的密码库才能登录到同一个密码库的循环问题。

## 管理通行密钥 <a href="#manage-passkeys" id="manage-passkeys"></a>

使用网页 App 创建、更新和删除用于访问您的 Bitwarden 账户的通行密钥。

### 创建通行密钥 <a href="#create-a-passkey" id="create-a-passkey"></a>

您最多可以添加 5 个通行密钥到您的 Bitwarden 账户。要创建用于登录 Bitwarden 的通行密钥：

1、在网页 App 中，转到**设置** → **安全**。

2、选择**主密码**。

3、在**使用通行密钥登录**部分，选择**启用**，或者如果您已经设置了通行密钥，则选择**新增通行密钥**。系统将提示您输入主密码。

4、按照浏览器的提示创建 FIDO2 通行密钥。您可以使用生物识别等因素或通过创建 PIN 码来完成用户验证。

{% hint style="success" %}
您可能需要取消浏览器希望您使用的默认验证器，例如，如果您想在 macOS 设备上使用硬件安全钥匙，它会优先使用 Touch ID。
{% endhint %}

5、输入您的通行密钥的**名称**。

6、（可选）如果您的[浏览器和身份验证器支持 PRF](#unlock-vault-requirements)，则**用于密码库加密**设置默认会被选中。这允许使用您的通行密钥解密和解锁您的密码库。如果不想将通行密钥用于密码库解锁，请取消选中此选项：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2gsO1o5tDU7s7LXvcpaL7w/56a8a797155760fe6fbd1d2e2d92b59b/2025-12-31_11-19-58.png?w=999&#x26;fm=avif" alt=""><figcaption><p>使用通行密钥用于密码库加密</p></figcaption></figure></div>

7、选择**启用**。

### 设置加密用于解锁 <a href="#set-up-encryption-for-unlock" id="set-up-encryption-for-unlock"></a>

如果您的[浏览器和身份验证器支持 PRF](#unlock-vault-requirements)，您可以使用通行密钥解密和解锁您的密码库。有两种方法可以做到这一点：

* 创建通行密钥时，请选中**用于密码库加密**设置（[步骤 6](#create-a-passkey)）。
* 对于现有的通行密钥，请转至**设置** → **安全** → **主密码**，然后选择通行密钥旁边的**设置加密**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/TpXTFNlF2hzRaUaLmxAXr/6710e5ab7c98efcb11547dc6038fdf7d/Passkeys_list.png?w=832&#x26;fm=avif" alt=""><figcaption><p>通行密钥列表</p></figcaption></figure></div>

您的通行密钥列表显示了每个通行密钥的加密状态：**已用于加密**、支持但未激活（**设置加密**）或**不支持加密**。

### 移除通行密钥 <a href="#remove-a-passkey" id="remove-a-passkey"></a>

要从 Bitwarden 账户中删除通行密钥，请转到**设置** → **安全** → **主密码**，然后选择通行密钥旁边的**移除**。这将断开通行密钥与 Bitwarden 的连接，但私钥仍将保留在您的 FIDO2 身份验证器中。

### 丢失或删除了通行密钥 <a href="#lost-or-deleted-passkey" id="lost-or-deleted-passkey"></a>

如果您丢失或删除了通行密钥（例如安全密钥、Windows Hello 或 Apple 密码中的通行密钥），则无法再使用该通行密钥访问您的密码库。在这种情况下，您需要使用主密码才能解锁密码库，因此主密码必须足够复杂且易于记忆。建议您创建并妥善保管一个[安全应急包](https://bitwarden.com/resources/bitwarden-security-readiness-kit/)，以便即使丢失了通行密钥，也能访问您的关键的账户信息。

## 使用通行密钥登录和解锁 <a href="#log-in-and-unlock-with-your-passkey" id="log-in-and-unlock-with-your-passkey"></a>

创建了通行密钥后，您就可以将其使用于 Bitwarden 网页 App 和基于 Chromium 的浏览器扩展了。对于 macOS 上支持 PRF 的通行密钥，您需要使用基于 Chromium 的浏览器来访问网页 App。

{% hint style="info" %}
如果您要登录 **Linux** 上的浏览​​器扩展，则需要先弹出该扩展，然后再尝试使用通行密钥登录或解锁：

<img src="https://bitwarden.com/assets/1cbJy0jLBmSQmRumvYzVwp/a9e43f4c154686249056924eb3e56323/pop_out_screenshot.png?w=407&#x26;fm=avif" alt="" data-size="original">
{% endhint %}

要使用通行密钥登录和解锁您的密码库：

1. 在 Bitwarden 登录界面，在通常输入电子邮箱地址的地方，选择**使用通行密钥登录**。
2. 按照浏览器的提示读取通行密钥，这将使用 Bitwarden 验证您的身份。
3. 接下来的操作取决于您的通行密钥是否已[设置为用于密码库加密](#set-up-encryption-for-unlock)：
   * 如果您的通行密钥已设置为用于密码库加密，则操作就完成了！通行密钥将用于解密并解锁您的密码库。
   * 如果您的通行密钥未设置为用于密码库加密，请输入您的主密码然后选择**解锁**，或使用您之前已配置的其他解锁方式。

如果您已登录，想要解锁密码库，请在密码库锁定界面选择**使用通行密钥解锁**。按照浏览器提示读取通行密钥。这将解锁您的账户并打开您的密码库。

## 工作原理 <a href="#how-it-works" id="how-it-works"></a>

使用通行密钥登录的机制取决于您的通行密钥是否[设置为用于加密](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys#set-up-encryption)。

{% tabs %}
{% tab title="加密的通行密钥" %}

### 创建通行密钥 <a href="#create-a-passkey" id="create-a-passkey"></a>

当与 PRF 兼容的通行密钥被注册用于登录 Bitwarden 并且加密启用时：

1. 通过 WebAuthn API，验证器生成一个**通行密钥公钥和私钥对**。根据定义，该密钥对构成了您的通行密钥。
2. 通过 WebAuthn API PRF 扩展，验证器生成一个 **PRF 对称密钥**。该密钥源自于您的通行密钥的特有的**内部机密**和 Bitwarden 提供的**盐化**。
3. Bitwarden 客户端生成一个 **PRF 公钥和私钥对**。PRF 公钥对您的**账户加密密钥**进行加密，您的客户端可以通过登录和解锁来访问该密钥，然后将生成的 **PRF 加密的账户加密密钥**发送到服务器。
4. 使用 **PRF 对称密钥**对 **PRF 私钥**进行加密（参见第 2 步），然后将得到的 **PRF 加密的私钥**发送到服务器。
5. 您的客户端将数据发送到 Bitwarden 服务器，以用于为您的账户创建一个新的通行密钥凭据记录。如果您的通行密钥凭据被注册为支持密码库加密和解密，此记录将包含：
   * 通行密钥名称
   * 通行密钥公钥
   * PRF 公钥
   * PRF 加密的账户加密密钥
   * PRF 加密的私钥

完成身份验证所必需的通行密钥私钥只会以加密格式保留在客户端中。

### 使用通行密钥登录 <a href="#log-in-with-your-passkey" id="log-in-with-your-passkey"></a>

当使用通行密钥登录，特别是解密您的密码库数据时：

1. 使用 WebAuthn API 公钥加密技术，您的身份验证请求将被断言和确认。
2. 您的 **PRF 加密的账户加密密钥**和 **PRF 加密的私钥**将从服务器发送到您的客户端。
3. 使用 Bitwarden 提供的相同**盐化**和您的通行密钥特有的**内部机密**，**PRF 对称密钥**在本地被重新创建。
4. **PRF 对称密钥**用于解密您的 **PRF 加密的私钥**，从而生成您的 **PRF 私钥**。
5. **PRF 私钥**用于解密您的 **PRF 加密的账户加密密钥**，从而得到您的**账户加密密钥**。您的账户加密密钥用于解密您的密码库数据。

如果您已经登录，随后使用通行密钥解锁您的密码库，由于您的加密密钥在登录时就已存在于您的设备上，因此将跳过身份验证和密钥获取步骤。
{% endtab %}

{% tab title="未加密的通行密钥" %}

### 创建通行密钥 <a href="#create-a-passkey" id="create-a-passkey"></a>

当通行密钥被注册用于登录 Bitwarden 并且加密保持停用时：

1. 创建**通行密钥公钥和私钥对**。根据定义，该密钥对构成了您的通行密钥。
2. 您的客户端将数据发送到 Bitwarden 服务器，以用于为您的账户创建一个新的通行密钥凭据记录。如果您的通行密钥凭据未被注册为支持密码库加密和解密，此记录将包括：
   * 通行密钥名称
   * 通行密钥公钥

完成身份验证所需的通行密钥私钥只会以加密格式保留在客户端中。

### 使用通行密钥登录 <a href="#log-in-with-your-passkey" id="log-in-with-your-passkey"></a>

当使用通行密钥登录时，您的身份验证请求将使用 WebAuthn API 公钥加密技术进行断言和确认。然后，您需要使用主密码解密您的密码库。
{% endtab %}
{% endtabs %}


# 使用生物识别解锁

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/biometrics/)
{% endhint %}

在桌面 App、浏览器扩展和移动 App 中，可以使用生物识别快速安全地访问您的密码库。使用标准方式（例如[主密码](/docs/account/master-password)或[受信任设备](/docs/account/log-in-and-unlock/using-single-sign-on/add-a-trusted-device)）登录后，然后使用生物识别[解锁您的密码库](/docs/account/log-in-and-unlock/understand-log-in-vs-unlock)。

生物识别功能是设备和/或操作系统内置安全性的一部分。Bitwarden 利用本地 API 来执行这种验证，因此 **Bitwarden 永远不会收到您的生物识别数据**。

{% hint style="success" icon="lightbulb" %}
安全设置是按账户设置的。要为[多个账户](/docs/account/log-in-and-unlock/account-switching)（例如个人和组织账户）启用生物识别解锁，请对每个账户重复这些步骤。
{% endhint %}

## 为桌面 App 设置生物识别 <a href="#set-up-biometrics-for-desktop-app" id="set-up-biometrics-for-desktop-app"></a>

要在桌面 App 中设置生物识别：

{% tabs %}
{% tab title="Windows" %}
使用 PIN 码、面部识别或符合 [Windows Hello 生物识别要求](https://docs.microsoft.com/zh-cn/windows-hardware/design/device-experiences/windows-hello-biometric-requirements)的其他硬件，通过 [Windows Hello](https://support.microsoft.com/zh-cn/help/4028017/windows-learn-about-windows-hello-and-set-it-up) 为 Windows 设置生物识别解锁。从 [Bitwarden 下载](https://bitwarden.com/download/#downloads-desktop)安装的 Windows 桌面 App 支持此选项。如果桌面 App 是从 Microsoft Store 安装的，则生物识别功能将无法使用。

要启用生物识别解锁：

1、在您的设备系统设置中[启用 Windows Hello](https://support.microsoft.com/zh-cn/windows/%E9%85%8D%E7%BD%AE-windows-hello-dae28983-8242-bb2a-d3d1-87c9d265a5f0)。

{% hint style="info" %}
如果您无法在设备设置中启用 Windows Hello，请安装 [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170)。
{% endhint %}

2、从 [Bitwarden Downloads](https://bitwarden.com/download/#downloads-desktop) 下载 Bitwarden 桌面 App（若尚未安装）。从 Microsoft Store 安装的 Bitwarden 桌面 App 不支持生物识别解锁。

3、打开 Bitwarden 桌面 App，然后转到**文件** → **设置** 。

4、在**安全**下，选中**使用 Windows Hello 解锁** 。

5、（可选）如果您希望在桌面 App 重启时使用生物识别解锁密码库，请取消选中 **App 重启时要求主密码或 PIN 码**。系统将在弹出窗口中提示您确认您的生物识别信息。如果此设置保持选中状态，则每次桌面 App 重启时，您都需要输入主密码或 PIN 码。
{% endtab %}

{% tab title="macOS" %}
通过[触控 ID](https://support.apple.com/zh-cn/guide/mac-help/mchl16fbf90a/mac) 为 macOS 设置生物识别解锁。从 [Mac App Store](https://apps.apple.com/us/app/bitwarden/id1352778147?l=zh-Hans-CN\&mt=12) 安装的 macOS 桌面 App 支持此选项，从 [Bitwarden 下载](https://bitwarden.com/download/#downloads-desktop)安装的则不支持。

要启用生物识别解锁：

1、在设备系统设置中[启用触控 ID](https://support.apple.com/zh-cn/guide/mac-help/mchl16fbf90a/mac)。

2、从 [Mac App Store](https://apps.apple.com/us/app/bitwarden/id1352778147?l=zh-Hans-CN\&mt=12) 下载 Bitwarden 桌面 App（若尚未安装）。从 [Bitwarden 下载](https://bitwarden.com/download/#downloads-desktop)安装的 Bitwarden 桌面 App 不支持生物识别解锁。

3、打开 Bitwarden 桌面 App，进入 **Bitwarden** → **设置**。

4、在**安全**下，选中**使用触控 ID 解锁**，然后在出现提示时确认更新。

5、（可选）选中 **App 启动时要求触控 ID**，以在桌面 App 首次打开时跳过初始解锁界面，直接使用触控 ID 解锁。
{% endtab %}

{% tab title="Linux" %}
当您的系统具有 polkit 代理和机密服务守护程序（例如 GNOME Keyring）时，Linux 中支持生物识别解锁 Bitwarden 桌面 App。[Bitwarden 桌面 App](https://bitwarden.com/download/#downloads-desktop) 的所有可用的 Linux 版本都支持生物识别解锁。

{% hint style="info" %}
我们建议安装 Bitwarden 桌面 App 的 `Snap` 或 `Flatpak` 版本，因为它们完全支持生物识别解锁以及自动更新。

同时，两者也都支持与 Bitwarden 浏览器扩展的生物识别集成：

* **Flatpak：**&#x652F;持与沙盒以及非沙盒浏览器扩展的生物识别集成。
* **Snap：**&#x652F;持与非沙盒浏览器扩展的生物识别集成。

了解更多有关[桌面 App 功能支持](/docs/password-manager/more/troubleshooting/desktop-app-feature-support)的信息。
{% endhint %}

### AppImage、Snap、.deb 和 .rpm <a href="#appimage-snap-deb-and-rpm" id="appimage-snap-deb-and-rpm"></a>

要启用生物识别解锁：

1、在您的计算机上启用系统身份验证。

2、打开 Bitwarden 桌面 App 然后转到**文件** → **设置**。

3、在**安全**下，选中**使用系统身份验证解锁**，然后在出现提示时确认更新。

{% hint style="info" %}
为 Linux 桌面 App 配置生物识别后，您仍然需要使用主密码或 PIN 码登录。登录后，使用生物识别解锁您的密码库。
{% endhint %}

### Flatpak

要启用生物识别解锁：

1、将[这个策略](https://github.com/bitwarden/clients/blob/main/apps/desktop/resources/com.bitwarden.desktop.policy)复制到您机器上的 `/usr/share/polkit-1/actions/com.Bitwarden.policy` 中，例如：

```bash
sudo wget -O /usr/share/polkit-1/actions/com.bitwarden.Bitwarden.policy https://raw.githubusercontent.com/bitwarden/clients/main/apps/desktop/resources/com.bitwarden.desktop.policy
```

2、更改已下载文件的所有权：

```bash
sudo chown root:root /usr/share/polkit-1/actions/com.bitwarden.Bitwarden.policy
```

3、更改此文件的安全上下文：

```bash
sudo chcon system_u:object_r:usr_t:s0
```

4、在您的机器上启用系统身份验证。

5、打开 Bitwarden 桌面 App，转到**文件** → **设置**。

6、在**安全**下，选中**使用系统身份验证解锁**，然后在出现提示时确认更新。

{% hint style="info" %}
为 Linux 桌面 App 配置生物识别后，您仍然需要使用主密码或 PIN 码登录。登录后，使用生物识别解锁您的密码库。
{% endhint %}
{% endtab %}
{% endtabs %}

## 为浏览器扩展设置生物识别 <a href="#set-up-biometrics-for-browser-extension" id="set-up-biometrics-for-browser-extension"></a>

这些浏览器支持使用生物识别解锁密码库的功能：

* 基于 Chromium 的浏览器，包括 Chrome、Edge、Opera 和 Brave
* Firefox 87+（不支持 Firefox ESR）
* Safari 14+

要在浏览器扩展上设置生物识别：

{% tabs %}
{% tab title="Chromium-based & FireFox" %}
为浏览器扩展启用生物识别包含两个步骤：

### 在桌面 App 启用生物识别 <a href="#enable-biometrics-on-the-desktop-app" id="enable-biometrics-on-the-desktop-app"></a>

要启用桌面 App 的生物识别：

1、在 Bitwarden 桌面 App [设置生物识别解锁](#set-up-biometrics-for-desktop-app)。

### 激活扩展生物识别 <a href="#activate-extension-biometrics" id="activate-extension-biometrics"></a>

{% hint style="info" %}
某些浏览器，特别是 Edge 和 Brave 等基于 Chrome 和 Chromium 的浏览器，可能需要额外的权限才能使生物识别正常工作：

1. 使用网页浏览器地址栏，导航至扩展管理器（例如 `chrome://extensions 或 Brave://extensions`）。
2. 打开此页面上的 Bitwarden 条目然后打开**允许访问文件 URL**。
   {% endhint %}

接下来，保持 Bitwarden 桌面 App 登录状态，然后打开 Bitwarden 浏览器扩展。要为浏览器扩展启用生物识别解锁：

1、选择 <i class="fa-gears">:gears:</i>**设置**图标。

2、选择**账户安全**。

3、选中**使用生物识别解锁**。

4、您可能会看到一条提示，询问是否允许Bitwarden「与协作的原生应用程序通信」。选择**允许**。

{% hint style="info" %}
浏览器扩展需要此权限才能使用生物识别解锁。如果您拒绝，您可以继续使用浏览器扩展程序，但生物识别解锁将不起作用。
{% endhint %}

5、（可选）选中**启动时要求生物识别**，以在浏览器扩展首次打开时跳过初始解锁界面，直接使用生物识别。
{% endtab %}

{% tab title="Safari" %}
要启用生物识别解锁：

1. 选择 **⚙️设置**图标。
2. 选择**账户安全**。
3. 如果出现确认窗口，请输入设备的密码并点击**始终允许**。
4. 选中**使用生物识别解锁**。
5. 出现提示时，输入您的触控 ID。
6. （可选）选中**启动时要求生物识别**，以便在浏览器扩展首次打开时使用生物识别，跳过初始解锁界面。

{% hint style="success" %}
要在每次激活桌面 App 和浏览器扩展之间的集成时要求指纹验证：

1. 打开桌面 App 并转到 **Bitwarden** → **设置**。
2. 选中**要求浏览器集成验证**。
3. 在浏览器扩展中启用生物识别解锁时，您将被要求在设置过程中输入您的指纹。
   {% endhint %}
   {% endtab %}
   {% endtabs %}

## 为移动 App 设置生物识别 <a href="#set-up-biometrics-for-mobile" id="set-up-biometrics-for-mobile"></a>

生物识别解锁支持 iOS 上的[触控 ID](https://support.apple.com/zh-cn/HT201371) 和[面容 ID](https://support.apple.com/zh-cn/HT208109) 以及 Android（Google Play 或 FDroid）上的[指纹解锁](https://support.google.com/nexus/answer/6285273?hl=zh-Hans)或[面部解锁](https://support.google.com/pixelphone/answer/9517039?hl=zh-Hans)。

{% hint style="info" %}
在 Android 上，Bitwarden 要求您的生物识别因素为 [Class 3](https://source.android.com/docs/security/features/biometric?hl=zh-cn)。指纹阅读器通常为 Class 3，但面部识别系统的类别根据设备制造商和型号而有所不同。
{% endhint %}

要为您的移动设备设置生物识别解锁：

1、在设备的系统设置（例如 iOS 的**设置** App）中，启用生物识别方式。

2、打开 Bitwarden App 然后点击 <i class="fa-gears">:gears:</i>**设置**图标。

3、点击**账户安全**。

4、点击**使用面容 ID 解锁**或**使用生物识别解锁**（可用的功能取决于您设备的硬件功能以及您之前在设备的系统设置中启用的功能）。

5、出现提示时输入您的生物识别信息，例如您的面部或指纹。成功设置生物识别解锁后，切换按钮将被填充。

## 使用生物识别解锁 <a href="#use-unlock-with-biometrics" id="use-unlock-with-biometrics"></a>

{% tabs %}
{% tab title="Windows & Linux 桌面端" %}
要使用 Windows 或 Linux 桌面 App 访问您的密码库：

1、使用主密码或 PIN 码登录。

2、选择**使用 Windows Hello 解锁**或**使用系统身份验证解锁**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7n73BtZuBKI2lrmTMGJUqk/cf42eacad0651a4cf1b12ba786a2f362/Windows_Hello.png?w=400&#x26;fm=avif" alt=""><figcaption><p>使用 Windows Hello 解锁</p></figcaption></figure></div>

3、输入您配置的生物识别信息。

{% hint style="info" %}
当您首次打开或重新启动 Windows 和 Linux 桌面 App 时，生物识别选项将显示为灰色。请使用标准方式（例如主密码或 PIN 码）解锁密码库。首次登录并解锁后，您可以使用生物识别来解锁您的密码库。
{% endhint %}
{% endtab %}

{% tab title="macOS 桌面端" %}
如果您在设置过程中选中了 **App 启动时要求触控 ID**，您将被立即提示输入触控 ID。

如果您在设置过程中未选中 **App 启动时要求触控 ID**：

1、使用主密码或 PIN 码登录。

2、选择**使用触控 ID 解锁**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2c5pB6gzPsvqDA46W2cODn/46c5bad230d8a5deb7f31e2861bdae0d/Unlock_with_Touch_ID.png?w=400&#x26;fm=avif" alt=""><figcaption><p>使用触控 ID 解锁</p></figcaption></figure></div>

3、输入您的触控 ID。
{% endtab %}

{% tab title="浏览器扩展" %}
要使用浏览器扩展访问您的密码库：

1、登录 Bitwarden 桌面 App 并解锁您的密码库。

2、保持桌面 App 仍在后台运行，打开 Bitwarden 浏览器扩展。

3、（可选）如果您之前在桌面 App 中启用了**要求浏览器集成验证**，请在出现提示时输入您的指纹。

4、基于在桌面 App 设置期间是否中选中了**启动时要求生物识别**：

* 如果选中了此设置，系统会立即提示您输入生物识别信息。
* 如果**未选中**此设置，请选择**使用生物识别解锁**然后输入您配置的生物识别信息：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4UeYGO9saN15Jg3xLQmv5y/bfdb5e552b33009d219b1c1b7accd26b/Unlock_with_Biometrics_Browser.png?w=400&#x26;fm=avif" alt=""><figcaption><p>浏览器使用生物识别解锁</p></figcaption></figure></div>

{% hint style="info" %}
如果出现「操作被桌面应用程序取消」错误，请确认：

* 您的桌面 App 是兼容的，例如是从 Mac App Store 安装的。
* 桌面 App 已打开并且您已登录。
* 在浏览器扩展中启用生物识别之前，您的桌面 App 已设置了生物识别。
* 如果您使用的是 macOS，如果您的用户名太长导致目录路径（例如 `/Users/your_username/Library/...` ）超过 104 个字符，请缩短您的用户名。
  {% endhint %}
  {% endtab %}

{% tab title="移动端" %}
当 Bitwarden 移动 App 首次打开时，请在出现提示时输入您的指纹或面容 ID。
{% endtab %}
{% endtabs %}

## 故障排除 <a href="#troubleshooting" id="troubleshooting"></a>

如果出现「生物识别解锁已禁用，等待验证您的主密码」错误：

1. 在 Bitwarden 中临时停用自动填充功能。
2. 按照上述步骤在 Bitwarden 中设置生物识别。
3. 在 Bitwarden 中重新启用自动填充功能。


# 使用 PIN 码解锁

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/unlock-with-pin/)
{% endhint %}

{% hint style="info" %}
如果您是企业版组织的成员，某个[策略](/docs/admin-console/oversight-visibility/enterprise-policies#remove-unlock-with-pin)可能会禁止您设置为使用 PIN 码解锁。
{% endhint %}

Bitwarden Password Manager 移动 App、浏览器扩展和桌面 App 可以使用 PIN 码解锁。重要的是，**解锁**与**登录** Password Manager 是有区别的。

登录时，您仍需要使用指定的登录方式（例如[主密码](/docs/account/master-password)或[受信任设备](/docs/account/log-in-and-unlock/using-single-sign-on/add-a-trusted-device)）和任何有效的[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。登录后，您可以自由使用 PIN 码来解锁 App。更多信息，请参阅[理解登录 & 解锁](/docs/account/log-in-and-unlock/understand-log-in-vs-unlock)一文。

## 设置 PIN 码 <a href="#set-up-a-pin" id="set-up-a-pin"></a>

完成以下步骤即可使用 PIN 码解锁您的账户。如果您登录了多个账户，则需要为每个账户进行设置：

{% hint style="warning" %}
使用 PIN 码会降低保护应用程序的本地密码库数据库的加密的级别。如果您担心设备的本地数据会受到攻击，您可能需要重新考虑使用 PIN 码的便利性。
{% endhint %}

{% tabs %}
{% tab title="浏览器扩展" %}
要为浏览器扩展设置 PIN 码：

1、打开**设置**标签，选择**账户安全**菜单，然后打开**使用 PIN 码解锁**选项：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6EAFlGeRk9LfFh1GWgowor/0ea284d711e099cf04402ca06869d12a/2025-08-13_10-48-58.png?w=955&#x26;fm=avif" alt=""><figcaption><p>切换使用 PIN 码解锁</p></figcaption></figure></div>

2、出现提示时，在**设置 PIN 码**弹出窗口中输入您要使用的 PIN 码。PIN 码可以是任意字符（a-z、0-9、$、# 等）的组合。

{% hint style="success" icon="lightbulb" %}
创建强 PIN 码：

* 如果您与他人共享您的设备，请避免使用容易猜到的数字，例如出生日期。
* 要求至少 4 个字符，但建议使用超过最低要求的字符数。
  {% endhint %}

3、默认选中的**浏览器重启时要求主密码**选项将要求在浏览器重新启动时输入主密码而不是 PIN 码。如果您希望能够在浏览器重新启动时使用 PIN 码解锁，请取消选中此选项。

{% hint style="info" %}
当如果您停用了此选项，Bitwarden 应用程序在进入锁定状态时可能无法完全清除应用程序内存中的敏感数据。如果您担心设备的本地内存受到盗用，您应该保持此选项处于启用状态。
{% endhint %}

{% hint style="warning" %}
使用 PIN 码时，您将在 **5** 次尝试输入 PIN 码失败后自动注销。
{% endhint %}
{% endtab %}

{% tab title="移动端" %}
要为移动 App 设置 PIN 码：

1、在您的 Bitwarden App 中，打开**设置**选项卡，选择**账户安全**菜单，然后点击**使用 PIN 码解锁**选项：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7s8JhXJwhOYgmDCuwqEcvd/1451d2e61244617f768f70474ff236a8/2025-01-21_15-07-55.png?w=715&#x26;fm=avif" alt=""><figcaption><p>移动端使用 PIN 码解锁</p></figcaption></figure></div>

2、出现提示时，在弹出窗口中输入您要使用的 PIN 码。PIN 码可以是任意字符（a-z、0-9、$、# 等）的组合。

{% hint style="success" icon="lightbulb" %}
**创建强 PIN 码**：

* 如果您与他人共享您的设备，请避免使用容易猜到的数字，例如出生日期。
* 要求至少 4 个字符，但建议使用超过最低要求的字符数。
  {% endhint %}

3、当询问您是否需要在 App 重新启动时使用生物识别或主密码解锁时：

* 如果您希望在 Password Manager 从关闭状态启动时要求非 PIN 码解锁方式，请选择**是**。
* 如果您希望在 Password Manager 从关闭状态启动时能够使用您的 PIN 码，请选择**否**。

{% hint style="warning" %}
使用 PIN 码时，您将在 **5** 次尝试输入 PIN 码失败后自动注销。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
要为桌面 App 设置 PIN 码：

1、打开您的**设置**（WIndows 上为**文件** → **设置**，macOS 上为 **Bitwarden** → **设置**），然后滚动到**安全**部分。

2、打开**使用 PIN 码解锁**选项：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/78q1ueLazPoYxUVCqPDjCC/ed73cc20db1533f3901d49349cebdbde/2026-04-23_09-37-30.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面端使用 PIN 码解锁</p></figcaption></figure></div>

3、出现提示时，在弹出窗口中输入您要使用的 PIN 码。PIN 码可以是任意字符（a-z、0-9、$、# 等）的组合。

{% hint style="success" icon="lightbulb" %}
**创建强 PIN 码**：

* 如果您与他人共享您的设备，请避免使用容易猜到的数字，例如出生日期。
* 要求至少 4 个字符，但建议使用超过最低要求的字符数。
  {% endhint %}

4、默认选中的**重启时使用主密码锁定**选项将要求在您的 App 重新启动时输入主密码而不是 PIN 码。如果您希望能够在 App 重新启动时使用 PIN 码解锁，请取消选中此选项。

{% hint style="info" %}
当如果您停用了此选项，Bitwarden 应用程序在进入锁定状态时可能无法完全清除应用程序内存中的敏感数据。如果您担心设备的本地内存受到盗用，您应该保持此选项处于启用状态。
{% endhint %}

{% hint style="warning" %}
使用 PIN 码时，您将在 **5** 次尝试输入 PIN 码失败后自动注销。
{% endhint %}
{% endtab %}
{% endtabs %}

### &#x20;修改 PIN 码 <a href="#change-a-pin" id="change-a-pin"></a>

您可以随时通过关闭然后重新打开**使用 PIN 码解锁**选项来更改 PIN 码。请注意，执行此操作要求 Password Manager 已解锁。

### 注销后的 PIN 码 <a href="#pins-after-a-logout" id="pins-after-a-logout"></a>

当您在上述任何 Password Manager App 上注销账户时，您配置的 PIN 码和相关设置将被自动擦除。您可以在登录后重新激活 PIN 码解锁。


# 两步登录


# 为什么要使用两步登录？

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/bitwarden-field-guide-two-step-login/)
{% endhint %}

两步登录（也称为双重身份验证或 2FA）是网站和 App 常用的一种安全技术，用于保护您的敏感数据。使用两步登录的网站会要求您在输入用户名和密码之外，还要输入一个额外的「令牌」（也称为验证码或一次性密码 (OTP)）来验证您的身份，该令牌通常从不同的设备上获取。

如果没有辅助设备令牌的物理访问权限，恶意行为者即使知道了您的用户名和密码，他们也无法访问网站：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6E6lpxB8UfXU7V6YcW40S3/b89a863ed448d1b90e42ac6c25140edd/fg-1.png?w=960&#x26;fm=avif" alt=""><figcaption><p>基本的两步登录流程</p></figcaption></figure></div>

通常，拥有敏感数据（例如您的网上银行账户）的网站或 App 会尝试在登录界面之外通过以下方式验证您的身份：

* 将包含令牌的 SMS / 文本信息发送到移动设备上。
* 要求提供由移动设备上的验证器 App（例如 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator)）生成的令牌。
* 从物理安全钥匙（例如 YubiKey）中查找令牌。

## 我该如何使用两步登录？ <a href="#how-should-i-use-two-step-login" id="how-should-i-use-two-step-login"></a>

安全性通常需要在保护和便利之间进行权衡，因此最终取决于您！通常，使用两步登录的两个最重要的用途：

**1、**[**保护 Bitwarden** ](/docs/account/two-step-login/field-guide-for-two-step-login#securing-bitwarden)

通过在每次登录 Bitwarden 时除了输入主密码外，还要求一个附加步骤，来保护所有密码库数据。

**2、**[**保护重要的网站**](/docs/account/two-step-login/field-guide-for-two-step-login#securing-important-websites)

通过在登录时要求使用临时一次性密码 (TOTP) 来保护单个网站。您可以使用 Bitwarden 存储和生成 TOTP。

## 保护 Bitwarden <a href="#securing-bitwarden" id="securing-bitwarden"></a>

由于您的密码管理器存储了您的所有登录信息，我们强烈建议您使用两步登录来保护它。这样做可以保护您的所有登录信息，以防止恶意行为者访问您的密码库，即使他们获取了您的主密码。

启用两步登录将要求您在每次登录时，除了输入您的主密码外，还要完成一个附加步骤。解锁密码库时您无需完成附加步骤，仅登录时需要。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1fc7ZMSHr1grocnEitdwua/1fbdceda08b4a6c59b17a96b366ffacd/fg-2.png?w=960&#x26;fm=avif" alt=""><figcaption><p>两步登录访问 Bitwarden</p></figcaption></figure></div>

Bitwarden 为免费版账户提供了多种两步登录方式，包括：

* FIDO（任何经过 FIDO2 WebAuthn 认证的钥匙）
* 验证器 App（如 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator)）
* 电子邮箱

对于高级版用户，Bitwarden 还提供了多种高级的两步登录方式：

* Duo Security 的 Duo Push、短信、电话和安全钥匙
* YubiKey（任何 4/5 系列设备或 YubiKey NEO/NFC）

使用我们的**设置指南**，[了解有关选项的更多信息](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)，或获取设置任何方式的帮助。

{% hint style="info" %}
由于 SIM 劫持等漏洞，Bitwarden 不支持 SMS 2FA。我们不建议对其他账户使用 SMS 2FA，除非它是唯一可用的方式。建议使用任何双因素而不是不使用，但多数替代方案比 SMS 2FA 更安全。
{% endhint %}

## 保护重要的网站 <a href="#securing-important-websites" id="securing-important-websites"></a>

Bitwarden 可能不是您使用的唯一一个具有两步登录选项的网站或 App，两步登录选项对于存储敏感信息（例如，信用卡或银行账号）的网站特别有用。大多数网站的两步登录选项都位于**设置**、**安全**或**隐私**菜单中。

激活两步登录时，通常会打开一个二维码，比如 Reddit 的这个：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4ddS2XK3JVWe1uG9OCiXwB/d199bbf12b390ac32ec2a6737ded4a20/reddit-2fa-setup.png?w=600&#x26;fm=avif" alt=""><figcaption><p>2FA 二维码</p></figcaption></figure></div>

使用验证器 App 扫描这个代码后，就能使 App 生成轮换的 6 位数令牌，您可以用此令牌来验证您的身份，比如这个由 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator) 生成的令牌：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/kBDOyVjNB2DiINm7FHk0r/13b3f7bceb014df08b84246256451322/IMG_5440.png?w=1242&#x26;fm=avif" alt=""><figcaption><p>TOTP 令牌</p></figcaption></figure></div>

### 使用 Bitwarden Authenticator <a href="#use-bitwarden-authenticator" id="use-bitwarden-authenticator"></a>

Bitwarden Authenticator 是一款移动身份验证 App，您可以使用它在使用双重身份验证 (2FA) 的网站和 App 上验证您的身份。Bitwarden Authenticator 可以从 iOS App Store 和 Google Play Store 下载。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5WsEwCqHd3BmAKTGdhXpQZ/bc84335eeb3655916781b1dd7cd4f4f1/fg-5.png?w=960&#x26;fm=avif" alt=""><figcaption><p>使用 Bitwarden Authenticator 进行两步登录</p></figcaption></figure></div>

有关使用 Bitwarden Authenticator 的帮助，请参阅[这篇文章](/docs/bitwarden-authenticator/bitwarden-authenticator)。

### 使用集成身份验证 <a href="#use-integrated-authentication" id="use-integrated-authentication"></a>

作为替代方案，Bitwarden Password Manager 为高版用户，包括付费版组织（家庭版、团队版或企业版）的成员，提供了一个内置的身份验证器。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4XRROCzbnmkN2EM9iO7MLX/3cf42adb04c450c833cd7d8aad836665/fg-3.png?w=960&#x26;fm=avif" alt=""><figcaption><p>使用 Bitwarden 进行两步登录</p></figcaption></figure></div>

有关使用集成身份验证的帮助，请参阅[这篇文章](/docs/password-manager/your-vault/security-tools/totp)。

### 什么时候我应该使用独立的 App 而不是集成的身份验证器？

只有独立 App 允许您为自己的 Bitwarden 账户设置 2FA，但您可以使用其中任何一款 App 为您的所有其他账户存储和生成验证码。目前只有集成的身份验证器允许您在团队成员之间共享生成的令牌。它们可以一起使用，也可以分开使用，这取决于您的安全偏好。

## 2FA 安全密钥和通行密钥 <a href="#id-2fa-security-keys-and-passkeys" id="id-2fa-security-keys-and-passkeys"></a>

FIDO2 安全密钥是一种流行且安全的选项，用于将 2FA 添加到您的 Bitwarden 账户。如果您还不熟悉 FIDO2 安全密钥，请[访问 FIDO 联盟网站](https://fidoalliance.org/fido2/)，了解有关 FIDO2 的更多信息。

YubiKey 设备是一种与 FIDO 身份验证协议配合使用的安全密钥，并且可以有多种用例。其中两种用途是作为 2FA 安全钥匙或[通行密钥](https://bitwarden.com/blog/what-are-passkeys-and-passkey-login/)。

* **2FA 安全密钥**：使用 YubiKey 作为 2FA 安全密钥将充当身份验证过程中的附加设备。这将伴随另一种主要的身份验证方法（例如主密码）。YubiKey 安全密钥必须物理插入才能提供身份验证凭据。
* **通行密钥**：通行密钥是一对加密密钥或公私加密密钥，用于验证登录。使用单一通行密钥，可以替代创建用户名、密码并向账户添加 2FA。在创建通行密钥期间，YubiKey 能够作为通行密钥生成器来创建通行密钥登录所需的公钥和私钥。在[此处](https://www.yubico.com/resources/glossary/what-is-a-passkey/)了解有关更多使用 YubiKey 作为通行密钥的信息。

对于 Bitwarden，YubiKey 设备等安全密钥的主要用途是提供 2FA 身份验证。

## 下一步 <a href="#next-steps" id="next-steps"></a>

现在您已经是两步登录的专家了，我们建议你：

* [设置两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)
* [获取高级版以使用高级两步登录方式](https://vault.bitwarden.com/#/?premium=purchase)
* [设置 Bitwarden authenticator](/docs/password-manager/your-vault/security-tools/totp)
* [为团队和企业设置两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods#two-step-login-for-teams-and-enterprise)


# 设置两步登录


# 两步登录方式

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/setup-two-step-login/)
{% endhint %}

{% hint style="success" icon="lightbulb" %}
**2025 年 03 月 04 日**：为提高账户安全性，Bitwarden 将开始要求**未使用两步登录的用户**在[从新设备登录账户或清除浏览器 cookie 后](/docs/account/log-in-and-unlock/new-device-protection)进行额外的验证。您可能已收到了提示此变化的相关电子邮件和产品通知。

输入 Bitwarden 主密码后，系统会提示您输入发送到您账户电子邮箱的一次性验证码。或者，您可以：

* 按照本页面上的任一指南设置两步登录。
* 从**设置** → **我的账户**页面的**危险区域**部分，选择退出该功能（**停用新设备登录保护**）。
  {% endhint %}

使用两步登录（也称为双重身份验证或 2FA）可以在有人获取了您的主密码时保护你的 Bitwarden 密码库。它的工作原理是在您登录时要求从另一个来源进行身份验证。如果您不熟悉 2FA 的基础知识，请查看我们的[现场指南](/docs/account/two-step-login/field-guide-for-two-step-login)。

{% embed url="<https://vimeo.com/1060246387?fe=cm&fl=pl>" %}

默认启用基于电子邮箱的两步登录。探索其他方式，例如验证器 App 和硬件密钥，以找到最适合您的方式。

在[此处](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)了解更多有关两步登录选项多信息。

* **00:40**：使用电子邮箱设置两步登录
* **00:57**：使用验证器 App 设置两步登录
* **01:25**：使用通行密钥设置两步登录
* **01:54**：使用 Yubico OTP 设置两步登录
* **02:14**：使用 Duo 设置两步登录
* **02:27**：获取您的恢复代码
* **03:00**：使用多种方式

有许多不同的方式可用于两步登录。您可以根据自己的喜好使用多种方式。重要的是，任何形式的两步登录都需要激活，才能确保您的账户受到保护。

## 适用于个人的两步登录 <a href="#two-step-login-for-individuals" id="two-step-login-for-individuals"></a>

任何人都可以通过访问网页 App，然后选择**设置** → **安全** → **两步登录**，以在他们的个人账户上设置两步登录。请至少设置以下一种两步登录方式。每一种方式都有设置说明：

| 方式                                                                                          | 设置说明                                                                                       | 订阅要求  |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ----- |
| FIDO2 WebAuthn 凭据（如 YubiKey 和 Google Titan 等硬件密钥）                                           | [设置说明](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)          | 所有人免费 |
| 验证器 App（如 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator)） | [设置说明](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-authenticator) | 所有人免费 |
| 电子邮箱                                                                                        | [设置说明](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-email)         | 所有人免费 |
| Duo Security 的 Duo Push、短信、电话和安全密钥                                                          | [设置说明](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-duo)           | 要求高级版 |
| YubiKey OTP（任何 4/5 系列设备或 YubiKey NEO/NFC）                                                   | [设置说明](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-yubikey)       | 要求高级版 |

## 适用于团队版和企业版的两步登录 <a href="#two-step-login-for-teams-and-enterprise" id="two-step-login-for-teams-and-enterprise"></a>

尽管每个用户可以使用上面图示中的方式在其账户上激活两步登录，但团队版和企业版组织还有其他选项：

| 方式                                 | 设置说明                                                                             | 订阅要求      |
| ---------------------------------- | -------------------------------------------------------------------------------- | --------- |
| Duo Security 的 Duo Push、短信、电话和安全密钥 | [设置说明](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-duo) | 要求团队版或企业版 |

此外，企业版组织可以通过[策略](/docs/admin-console/oversight-visibility/enterprise-policies#require-two-step-login)要求两步登录，并且当使用单点登录 (SSO) 时，可以使用您的身份提供程序在 Bitwarden 外部实现相同的保护。

## 使用多种方式 <a href="#using-multiple-methods" id="using-multiple-methods"></a>

您可以选择启用多种两步登录方式。当您使用多种已启用的方式登录 Bitwarden 时，将按照以下优先顺序提示您使用最高优先级的两步登录方式：

1. Duo（组织）
2. FIDO2 WebAuthn
3. YubiKey
4. Duo（个人）
5. 验证器 App
6. 电子邮箱

{% hint style="warning" %}
如果您[使用 SSO 登录](/docs/account/log-in-and-unlock/using-single-sign-on/using-login-with-sso)，则不建议使用电子邮箱方式的两步登录，因为使用多种方式会导致错误。可以考虑改为使用[免费的验证器方式的两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-authenticator)。
{% endhint %}

不过，任何方式都可以使用。通过选择**使用其他两步登录方式**按钮，以使用较低优先级的方式进行验证：

{% tabs %}
{% tab title="网页 App" %}

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6pZaDONKwdhsCVDxz4fEoP/16a2053bf3a08a0449a0db1410fa752d/2025-02-28_08-56-53.png?w=654&#x26;fm=avif" alt=""><figcaption><p>使用其他两步登录方式</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/X0JAzFLcwRr4smlsMYCf7/0aa1f3c0cf56dd8e062e1e89fd99e43d/2025-03-17_10-55-29.png?w=999&#x26;fm=avif" alt=""><figcaption><p>使用其他两步登录方式</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2iyAQzp5BrmXPbIqKp9aB5/6b7bc9726ade6a5ef79cf4877e5c30ec/2025-03-18_09-30-31.png?w=710&#x26;fm=avif" alt=""><figcaption><p>使用其他两步登录方式</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/36novNT7xJ8ZJSoG66MQXg/636ac40e844fb7b32c37ffeac8932b36/2026-04-23_09-47-21.png?w=800&#x26;fm=avif" alt=""><figcaption><p>使用其他两步登录方式</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}


# 两步登录 - 验证器

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/setup-two-step-login-authenticator/)
{% endhint %}

第三方验证器 App（例如独立的 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator)）方式的两步登录对于所有 Bitwarden 用户是免费的。

{% hint style="info" %}
某些验证器 App 不会自动备份您的 2FA 令牌以方便迁移到新的移动设备。在这些情况下，您应该手动保存每个令牌的身份验证器恢复代码。有关安全存储和使用恢复代码的更多信息，请参阅[恢复代码](/docs/account/two-step-login/recovery-codes)。

其他 App 如 Authy 等，支持跨设备备份和同步。在这些情况下，请务必设置一个强大的备份密码并将其记录在您的 Bitwarden 密码库中。
{% endhint %}

## 设置验证器 <a href="#setup-an-authenticator" id="setup-an-authenticator"></a>

要启用验证器 App 方式的两步登录：

{% hint style="warning" %}
**丢失对两步登录设备的访问会永久性将您锁定在您的密码库之外**，除非您将您的两步登录恢复代码写下并将其保存在安全的地方，或拥有已启用并可用的备用两步登录方式。

启用任何方式之后，应立即通过**两步登录**界面[获取您的恢复代码](/docs/account/two-step-login/recovery-codes)。此外，用户还可以创建 Bitwarden [导出](/docs/password-manager/import-and-export/export-vault-data)来备份密码库数据。
{% endhint %}

1、登录到 Bitwarden 网页 App。

2、从导航选择**设置** → **安全** → **两步登录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2IjxRoQwl1powHRhah6Bq/39067a5fe6c53732054f323e4afb431b/Screenshot_2025-12-31_at_1.52.00%C3%A2__PM.png?w=1259&#x26;fm=avif" alt=""><figcaption><p>两步登录设置</p></figcaption></figure></div>

3、定位到**验证器 App** 方式然后选择同一行的**管理**。将提示您输入您的主密码以继续。

4、使用所选的验证器 App 扫描二维码或手动输入密钥。

如果您的移动设备上还没有验证器 App，请下载诸如 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator) 等 App，然后扫描二维码。

5、扫描后，您的验证器 App 将返回一个 6 位数的验证码。将此代码输入您的网页密码库对话框然后选择**启用**按钮。

一个绿色的 `已启用` 消息表明验证器方式的两步登录已被启用。

6、选择**关闭**按钮，然后确认**验证器 App** 选项现在已被启用（通过一个绿色勾号 <i class="fa-check">:check:</i>指示）。

{% hint style="info" %}
我们建议在继续测试两步登录之前，将活动的网页密码库选项卡保持为打开状态，以防配置错误。确认其正常工作后，请注销所有的 Bitwarden App，以要求每个 App 使用两步登录。您最终会被自动注销。
{% endhint %}

### 在多个设备或验证器上设置 <a href="#setup-on-multiple-devices-or-authenticators" id="setup-on-multiple-devices-or-authenticators"></a>

Bitwarden 两步登录可以在多个兼容设备上运行。要在其他设备上添加 2FA，请按照上述步骤，用其他设备扫描二维码或手动输入二维码密钥，以在其他设备上启用 2FA。也可以在一台设备上为多个验证器设置两步登录。

## 使用验证器 <a href="#use-an-authenticator" id="use-an-authenticator"></a>

以下内容假设**验证器 App** 是您[已启用的最高优先级方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods#using-multiple-methods)。完成以下步骤，以使用验证器访问您的密码库：

1、在任一个 Bitwarden App 上输入您的电子邮箱地址和主密码以登录您的密码库。\
将提示您输入来自您的验证器 App 的 6 位数验证码。

2、打开您的验证器 App，然后找到用于您的 Bitwarden 密码库的 6 位数验证码。在密码库登录界面输入此代码。通常，验证码每 30 秒会更新一次。

{% hint style="success" icon="lightbulb" %}
勾选**记住我**复选框，以让 Bitwarden 在接下来的 30 天内可以识别您的设备。选择此选项意味着在此期间您不会被要求完成两步登录步骤。
{% endhint %}

3、选择**继续**以完成登录。

登录后，您将不会被要求完成第二步的两步登录步骤即可**解锁**您的密码库。有关配置注销和锁定行为的帮助，请参阅[密码库超时选项](/docs/account/log-in-and-unlock/vault-timeout-options)。


# 两步登录 - 电子邮箱

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/setup-two-step-login-email/)
{% endhint %}

电子邮箱方式的两步登录对于所有 Bitwarden 用户是免费的。

{% hint style="warning" %}
如果您[使用 SSO 登录](/docs/account/log-in-and-unlock/using-single-sign-on/using-login-with-sso)，则不建议使用电子邮箱方式的两步登录，因为使用多个方式会导致错误。可以考虑改为使用[免费的验证器方式的两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-authenticator)。
{% endhint %}

## 设置电子邮箱验证 <a href="#setup-email-verification" id="setup-email-verification"></a>

要启用电子邮箱方式的两步登录：

{% hint style="warning" %}
**丢失对两步登录设备的访问会永久性将您锁定在您的密码库之外**，除非您将您的两步登录恢复代码写下并将其保存在安全的地方，或拥有已启用并可用的备用两步登录方式。

启用任何方式之后，应立即通过**两步登录**界面[获取您的恢复代码](/docs/account/two-step-login/recovery-codes)。此外，用户还可以创建 Bitwarden [导出](/docs/password-manager/import-and-export/export-vault-data)来备份密码库数据。
{% endhint %}

1、登录到 Bitwarden 网页 App。

2、从导航选择**设置** → **安全** → **两步登录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2IjxRoQwl1powHRhah6Bq/39067a5fe6c53732054f323e4afb431b/Screenshot_2025-12-31_at_1.52.00%C3%A2__PM.png?w=1259&#x26;fm=avif" alt=""><figcaption><p>两步登录设置</p></figcaption></figure></div>

3、定位到**电子邮箱**方式然后选择**管理**。将提示您输入您的主密码以继续。

4、输入您用于接收验证码的电子邮箱地址，然后点击**发送电子邮件**按钮。

{% hint style="success" icon="lightbulb" %}
如果您有多个电子邮箱地址，用于两步登录的地址不一定要使用与注册 Bitwarden 时使用的地址相同。
{% endhint %}

5、检查您的收件箱接收到的 6 位数验证码，将此代码填入网页密码库的对话框中并选择**启用**按钮。

一个绿色的 `已启用` 消息表明电子邮箱方式的两步登录已被启用。

6、选择**关闭**按钮，然后确认**电子邮箱**选项现在已被启用（通过一个绿色勾号 (<i class="fa-check">:check:</i>) 指示）。

{% hint style="info" %}
我们建议在继续测试两步登录之前，将活动的网页密码库选项卡保持为打开状态，以防配置错误。确认其正常工作后，请注销所有的 Bitwarden App，以要求每个 App 使用两步登录。您最终会被自动注销。
{% endhint %}

## 使用电子邮箱验证 <a href="#use-email-verification" id="use-email-verification"></a>

以下内容假设**电子邮箱**是您[已启用的最高优先级方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods#using-multiple-methods)。完成以下步骤，以使用两步登录访问您的密码库：

1、在任一个 Bitwarden App 上输入您的电子邮箱地址和主密码以登录您的密码库。\
将提示您输入发送到您配置的电子邮箱的 6 位数验证码。

2、检查您的收件箱接收到的 6 位数验证码。在**验证您的身份**界面上输入此代码：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/ewFBMVRtmfZ3fsEC7LZmG/fcda3ce63380357797c2d41987854318/2026-01-12_15-08-12.png?w=754&#x26;fm=avif" alt=""><figcaption><p>验证您的身份</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
勾选**记住我**复选框，以让 Bitwarden 在接下来的 30 天内可以识别您的设备。选择此选项意味着在此期间您不会被要求完成两步登录步骤。
{% endhint %}

3、选择**继续**以完成登录。

登录后，您将不会被要求完成第二步的两步登录步骤即可**解锁**您的密码库。有关配置注销和锁定行为的帮助，请参阅[密码库超时选项](/docs/account/log-in-and-unlock/vault-timeout-options)。


# 两步登录 - Duo

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/setup-two-step-login-duo/)
{% endhint %}

使用 Duo 的两步登录在[可用的两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)中是比较特别的，因为它可以为具有高级版成员资格的个人账户启用，或通过[团队版和企业版组织](/docs/admin-console/organizations-overview)为整个组织启用。

## 设置 Duo <a href="#setup-duo" id="setup-duo"></a>

本文涵盖适用于**个人用户**、**组织用户**和**组织管理员**的 Duo 设置：

{% hint style="info" %}
Duo 为应用程序用户引入了[通用提示](https://duo.com/docs/universal-prompt-update-guide)。此时，Duo 管理员必须从其 Duo 管理面板激活该设置。Bitwarden 文档体现了激活通用提示的登录过程，2024 年 3 月 30 日后，这已经成为 Duo 的默认行为。
{% endhint %}

{% tabs %}
{% tab title="个人用户" %}

### 获取 Duo 密钥 <a href="#retrieve-duo-keys" id="retrieve-duo-keys"></a>

您需要有一个 Duo 账户才能获取 Bitwarden 所需的一些信息以完成设置。[免费注册](https://signup.duo.com/)，或登录到现有的 [Duo Admin Panel](https://admin.duosecurity.com/login)。要配置 Duo：

1、在左侧菜单中，导航至 **Applications**。

2、选择 **Add an Application** 按钮。

3、在应用程序目录中查找或搜索 **Bitwarden**，确保选择标记为 **2FA** 和 **Partner** 的应用程序，然后选择 **Add** 按钮。您将被重定向到 Bitwarden 应用程序页面：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/35CpllTrg8k1IIQrL4Jf5m/d62f04d003eb8e6f6d7ef1da2a9f7e9b/2024-03-01_11-42-32.png?w=1100&#x26;fm=avif" alt=""><figcaption><p>Bitwarden 应用程序 Duo</p></figcaption></figure></div>

4、记录下 **Integration key**、**Secret key** 和 **API hostname**。当您在 Bitwarden 中设置 Duo 时，您需要参考这些值。

5、将 **User access** 切换为 **Enable for all users**。

### 在 Bitwarden 中设置 Duo <a href="#setup-duo-in-bitwarden" id="setup-duo-in-bitwarden"></a>

{% hint style="warning" %}
**丢失对两步登录设备的访问会永久性将您锁定在您的密码库之外**，除非您将您的两步登录恢复代码写下并将其保存在安全的地方，或拥有已启用并可用的备用两步登录方式。

启用任何方式之后，应立即通过**两步登录**界面[获取您的恢复代码](/docs/account/two-step-login/recovery-codes)。此外，用户还可以创建 Bitwarden [导出](/docs/password-manager/import-and-export/export-vault-data)来备份密码库数据。
{% endhint %}

要为个人用户启用 Duo 方式的两步登录：

1、登录到 Bitwarden 网页 App。

2、从导航选择**设置** → **安全** → **两步登录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2IjxRoQwl1powHRhah6Bq/39067a5fe6c53732054f323e4afb431b/Screenshot_2025-12-31_at_1.52.00%C3%A2__PM.png?w=1259&#x26;fm=avif" alt=""><figcaption><p>两步登录设置</p></figcaption></figure></div>

3、定位到 **Duo** 选项然后选择**管理**。将提示您输入您的主密码以继续。

4、输入从 Duo Admin Portal 中获取到的以下值（参考此选项卡中的上面部分）：

* **Integration Key** 输入到 **Client ID** 字段
* **Secret Key** 输入到 **Client Secret** 字段
* 输入 **API Hostname**

5、选择**启用**按钮。

一个绿色的 `已启用` 消息将出现，表明已为您的密码库启用了 Duo。选择**关闭**按钮然后查看 **Duo** 选项上有一个绿色的勾号 (<i class="fa-check">:check:</i>) 以再次检查。

我们建议在继续测试两步登录之前，将活动的网页密码库选项卡保持为打开状态，以防配置错误。确认其正常工作后，请注销所有的 Bitwarden App，以要求每个 App 使用两步登录。您最终会被自动注销。

{% hint style="info" %}
在网闸 (Air-gapped) 网络上运行的自托管实例可能需要额外的设置才能保持与 Duo 的服务器通信。
{% endhint %}

> **\[译者注]**：[网闸](https://zh.wikipedia.org/wiki/%E7%BD%91%E9%97%B8) (air-gapped) 网络，也叫物理隔离的网络。是指与外部网络（如互联网或其他外部系统）完全隔离的计算机网络。这种隔离通过物理或逻辑手段实现，确保网络无法与外部环境进行数据交换，从而增强安全性。

### 注册设备 <a href="#register-a-device" id="register-a-device"></a>

设置好 Duo 后，打开网页密码库。如果 Duo 是您[已启用的最高优先级方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods#using-multiple-methods)，下次登录时，您将被提示**启动 Duo**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/44SjeVrDTuQPz52cBxGhCX/d8cf66018741b808349e6afbd7f0769b/2025-04-08_14-15-16.png?w=649&#x26;fm=avif" alt=""><figcaption><p>启动 Duo</p></figcaption></figure></div>

您将被要求注册一个两步登录设备，请按照屏幕提示将辅助设备配置为使用 Duo（例如，要注册何种设备类型，以及是发送短信还是推送通知）。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5Mm1G5tjfPmzs5V8obaxl1/8e2a79bbf29d5017147953bddb9e10a2/2025-04-08_14-15-43.png?w=506&#x26;fm=avif" alt=""><figcaption><p>Duo 2FA 设置</p></figcaption></figure></div>

如果您尚未下载 Duo 移动 App，建议您下载：

* [下载 iOS 版](https://itunes.apple.com/us/app/duo-mobile/id422663827?mt=8)
* [下载 Android 版](https://play.google.com/store/apps/details?id=com.duosecurity.duomobile)
  {% endtab %}

{% tab title="组织用户" %}

### 注册设备 <a href="#register-a-device" id="register-a-device"></a>

您的组织管理员设置了 Duo 后，下次登录时，您将被提示**启动 Duo**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/44SjeVrDTuQPz52cBxGhCX/d8cf66018741b808349e6afbd7f0769b/2025-04-08_14-15-16.png?w=649&#x26;fm=avif" alt=""><figcaption><p>启动 Duo</p></figcaption></figure></div>

您将被要求注册一个两步登录设备，请按照屏幕提示将辅助设备配置为使用 Duo（例如，要注册何种设备类型，以及是发送短信还是推送通知）。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5Mm1G5tjfPmzs5V8obaxl1/8e2a79bbf29d5017147953bddb9e10a2/2025-04-08_14-15-43.png?w=506&#x26;fm=avif" alt=""><figcaption><p>Duo 2FA 设置</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
如果 Duo 没有提示您注册设备，请尝试使用隐身或隐私浏览窗口登录。
{% endhint %}

如果您尚未下载 Duo 移动 App，建议您下载：

* [下载 iOS 版](https://itunes.apple.com/us/app/duo-mobile/id422663827?mt=8)
* [下载 Android 版](https://play.google.com/store/apps/details?id=com.duosecurity.duomobile)
  {% endtab %}

{% tab title="组织管理员" %}
为组织启用 Duo 后，所有已注册的成员在他们下次登录密码库时将被提示注册一个设备以用于 Duo 方式的两步登录。

{% hint style="info" %}
Bitwarden 将仅识别具有电子邮箱地址用户名的用户。没有电子邮箱地址作为主要用户名的 Duo 用户将需要设置一个。请参考 [Duo 用户名别名配置指南](https://help.duo.com/s/article/aliases-guide?language=en_US)以获取更多信息和说明。
{% endhint %}

### 获取 Duo 密钥 <a href="#retrieve-duo-keys" id="retrieve-duo-keys"></a>

您需要有一个 Duo 账户才能获取 Bitwarden 所需的一些信息以完成设置。[免费注册](https://signup.duo.com/)，或登录到现有的 [Duo Admin Panel](https://admin.duosecurity.com/login)。要配置 Duo：

1、在左侧菜单中，导航至 **Applications**。

2、选择 **Add an Application** 按钮。

3、在应用程序目录中查找或搜索 **Bitwarden**，确保选择标记为 **2FA** 和 **Partner** 的应用程序，然后选择 **Add** 按钮。您将被重定向到 Bitwarden 应用程序页面：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/35CpllTrg8k1IIQrL4Jf5m/d62f04d003eb8e6f6d7ef1da2a9f7e9b/2024-03-01_11-42-32.png?w=1100&#x26;fm=avif" alt=""><figcaption><p>Bitwarden 应用程序 Duo</p></figcaption></figure></div>

4、记录下 **Integration key**、**Secret key** 和 **API hostname**。当您在 Bitwarden 中设置 Duo 时，您需要参考这些值。

5、将 **User access** 切换为 **Enable for all users**。

{% hint style="info" %}
为所有成员启用了 Duo 的组织不应使用[要求两步登录](/docs/admin-console/oversight-visibility/enterprise-policies#require-two-step-login)策略。组织 Duo 由提供商强制执行，无法满足策略的两步登录要求。
{% endhint %}

### 在 Bitwarden 中设置 Duo <a href="#setup-duo-in-bitwarden" id="setup-duo-in-bitwarden"></a>

{% hint style="warning" %}
初始化配置和设置 Duo 后，在从 Duo 管理面板进行任何进一步的应用程序配置更改之前，为组织禁用它**非常重要**。要进行配置更改：在 Bitwarden 中禁用 Duo，在 Duo 管理面板中进行必要的更改，然后在 Bitwarden 中重新启用 Duo。

这是因为 Duo for organizations 目前不支持[恢复代码](/docs/account/two-step-login/recovery-codes)。相反，您将需要依靠 Duo 管理面板来绕过无法访问 Duo 的成员的两步登录。在 Duo 处于活动状态时从 Duo 管理面板更改应用程序配置可能会失去绕过您或您组织的成员的两步登录的能力。为了降低这种风险，我们建议每个成员启用单独的两步登录方式。
{% endhint %}

您必须是[组织所有者](/docs/admin-console/manage-members/member-roles)才能为您的组织设置 Duo。要为您的组织启用 Duo 方式的两步登录：

1、登录到 Bitwarden 网页 App。

2、使用产品切换器打开管理控制台：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2uxBDdQa6lu0IgIEfcwMPP/e3de3361749b6496155e25edcfdcf08b/2024-12-02_11-19-56.png?w=1013&#x26;fm=avif" alt=""><figcaption><p>产品切换器</p></figcaption></figure></div>

3、从导航栏选择**设置** → **两步登录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4RhAdJgvxpRiLtv0P0XrWT/d8a4e561a5293febfbdefe121dd656ab/2024-12-02_11-21-42.png?w=1014&#x26;fm=avif" alt=""><figcaption><p>管理用于组织的 Duo</p></figcaption></figure></div>

4、定位到 **Duo（组织）** 选项然后选择**管理**按钮。

5、将提示您输入主密码以继续。

6、输入从 Duo Admin Portal 中获得的以下值：

* **Integration Key** 输入到 **Client ID** 字段
* **Secret Key** 输入到 **Client Secret** 字段
* 输入 **API Hostname**

7、选择**启用**按钮。

一个绿色的 `已启用` 消息将出现，表明已为您的密码库启用了 Duo。选择**关闭**按钮然后查看 **Duo** 选项上有一个绿色的勾号 (<i class="fa-check">:check:</i>) 以再次检查。

{% hint style="info" %}
在网闸 (Air-gapped) 网络上运行的自托管实例可能需要额外的设置才能保持与 Duo 的服务器通信。
{% endhint %}

> **\[译者注]**：[网闸](https://zh.wikipedia.org/wiki/%E7%BD%91%E9%97%B8) (air-gapped) 网络，也叫物理隔离的网络。是指与外部网络（如互联网或其他外部系统）完全隔离的计算机网络。这种隔离通过物理或逻辑手段实现，确保网络无法与外部环境进行数据交换，从而增强安全性。

### 注册设备 <a href="#register-a-device" id="register-a-device"></a>

设置好 Duo 后，在下次登录时，您和您的组织成员将被提示**启动 Duo**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/44SjeVrDTuQPz52cBxGhCX/d8cf66018741b808349e6afbd7f0769b/2025-04-08_14-15-16.png?w=649&#x26;fm=avif" alt=""><figcaption><p>启动 Duo</p></figcaption></figure></div>

您将被要求注册一个两步登录设备，请按照屏幕提示将辅助设备配置为使用 Duo（例如，要注册何种设备类型，以及是发送短信还是推送通知）。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5Mm1G5tjfPmzs5V8obaxl1/8e2a79bbf29d5017147953bddb9e10a2/2025-04-08_14-15-43.png?w=506&#x26;fm=avif" alt=""><figcaption><p>Duo 2FA 设置</p></figcaption></figure></div>

{% hint style="success" %}
如果 Duo 没有提示您注册设备，请尝试使用隐身或隐私浏览窗口登录。
{% endhint %}

如果您尚未下载 Duo 移动 App，建议您下载：

* [下载 iOS 版](https://itunes.apple.com/us/app/duo-mobile/id422663827?mt=8)
* [下载 Android 版](https://play.google.com/store/apps/details?id=com.duosecurity.duomobile)
  {% endtab %}
  {% endtabs %}

## 使用 Duo <a href="#use-duo" id="use-duo"></a>

以下内容假设 **Duo** 是您[已启用的最高优先级方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods#using-multiple-methods)。对于组织成员来说，**组织层面的 Duo 始终是最优先的方式**。要使用 Duo 两步登录方式访问您的密码库：

1. 在任一个 Bitwarden App 上输入您的电子邮箱地址和主密码以登录您的密码库。会出现提示，要求您**启动 Duo**。启动后，将出现一个 Duo 界面，以开始您的两步登录验证。
2. 基于您的 Duo 的配置方式，通过以下方式完成验证请求：
   * 从您已注册的设备上批准 **Duo Push** 请求。
   * 在您的 **Duo 移动 App** 或**短信**中找到 6 位数验证码，然后在密码库登录界面输入此验证码。

{% hint style="success" icon="lightbulb" %}
勾选**记住我**复选框，以让 Bitwarden 在接下来的 30 天内可以识别您的设备。选择此选项意味着在此期间您不会被要求完成两步登录步骤。
{% endhint %}

登录后，您将不会被要求完成第二步的两步登录步骤即可**解锁**您的密码库。有关配置注销和锁定行为的帮助，请参阅[密码库超时选项](/docs/account/log-in-and-unlock/vault-timeout-options)。


# 两步登录 - YubiKey OTP

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/setup-two-step-login-yubikey/)
{% endhint %}

YubiKey OTP 方式的两步登录适用于高级用户，包括付费组织（家庭版、团队版或企业版）的成员。可以使用任何[支持 OTP 功能的 YubiKey](https://www.yubico.com/products/yubikey-hardware/compare-yubikeys/)，包括所有 YubiKey 4 和 5 系列设备以及 YubiKey NEO 和 YubiKey NFC。您最多可以将 5 个 YubiKey 添加到您的账户中。Bitwarden 还支持[通行密钥方式的两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)。

{% hint style="success" icon="lightbulb" %}
大多数现代 YubiKey，包括 5 系列钥匙，都支持 FIDO2 WebAuthn 协议。如果您的钥匙支持（可以使用 [Yubico Authenticator](https://www.yubico.com/products/yubico-authenticator/) 桌面应用程序来检测），我们建议按照[这些说明](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)将您的钥匙设置为 FIDO2 WebAuthn 设备。
{% endhint %}

## 设置 YubiKey <a href="#setup-yubikey" id="setup-yubikey"></a>

要启用 YubiKey 方式的两步登录：

{% hint style="warning" %}
**丢失对两步登录设备的访问会永久性将您锁定在您的密码库之外**，除非您将您的两步登录恢复代码写下并将其保存在安全的地方，或拥有已启用并可用的备用两步登录方式。

启用任何方式之后，应立即通过**两步登录**界面[获取您的恢复代码](/docs/account/two-step-login/recovery-codes)。此外，用户还可以创建 Bitwarden [导出](/docs/password-manager/import-and-export/export-vault-data)来备份密码库数据。
{% endhint %}

1、登录到 Bitwarden 网页 App。

2、从导航选择**设置** → **安全** → **两步登录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2IjxRoQwl1powHRhah6Bq/39067a5fe6c53732054f323e4afb431b/Screenshot_2025-12-31_at_1.52.00%C3%A2__PM.png?w=1259&#x26;fm=avif" alt=""><figcaption><p>两步登录设置</p></figcaption></figure></div>

3、在 **YubiKey OTP 安全密钥**旁边，选择**管理**。将提示您输入您的主密码以继续。

4、将 YubiKey 插入计算机的 USB 端口。

5、在您的网页密码库对话框中，选择第一个空白的 YubiKey 输入字段。

6、触摸 YubiKey 的按钮。

7、（可选）如果您要在支持 NFC 的移动设备上使用 YubiKey，请勾选**我的某个密钥支持 NFC**。

8、选择**保存**。一个绿色的 `已启用` 消息表明 YubiKey 方式的两步登录已被启用。

9、选择**关闭**，然后确认 **YubiKey OPT 安全密钥**选项现在已被启用（通过一个绿色的勾号 (<i class="fa-check">:check:</i>) 指示）。

重复此过程以向您的账户中添加最多 5 个 YubiKey。

{% hint style="info" %}
我们建议在继续测试两步登录之前，将活动的网页密码库选项卡保持为打开状态，以防配置错误。确认其正常工作后，请注销所有的 Bitwarden App，以要求每个 App 使用两步登录。您最终会被自动注销。
{% endhint %}

## 自托管设置 <a href="#self-hosted-setup" id="self-hosted-setup"></a>

如果您是组织管理员，则需要在 `global.override.env` 中配置一对环境变量，以允许调用 YubiKey OTP API：

| globalSettings\_\_yubico\_\_clientId | <p>使用从您的 Yubico 钥匙获取的 ID 替换这个值。</p><p>在<a href="https://upgrade.yubico.com/getapikey/">此处</a>注册 Yubico 密钥。</p> |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| globalSettings\_\_yubico\_\_key      | 输入从 Yubico 获取的密钥的值。                                                                                            |

## 使用 YubiKey <a href="#use-yubikey" id="use-yubikey"></a>

以下内容假设 **YubiKey** 是您[已启用的最高优先级方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods#using-multiple-methods)。完成以下步骤，以使用 YubiKey 访问您的密码库：

1、使用您的电子邮箱地址和主密码登录您的 Bitwarden 密码库。

2、当出现提示时，将您的 YubiKey 插入计算机的 USB 端口，或将 YubiKey 靠近启用了 NFC 的设备背面：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7jikprFVd3XRhOGRCLrEYT/82b0a7332797a1c6ee6add081ea40ab9/2025-03-25_10-15-37.png?w=874&#x26;fm=avif" alt=""><figcaption><p>YubiKey 提示</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
勾选**记住我**复选框，以让 Bitwarden 在接下来的 30 天内可以识别您的设备。选择此选项意味着在此期间您不会被要求完成两步登录步骤。
{% endhint %}

3、如果您在移动设备上使用的是**非 NFC** 的 YubiKey：

1. 将 YubiKey 插入设备。
2. 点击**取消**以结束 NFC 提示。
3. 点击用灰色下划线表示的文本输入字段。
4. 点击或按下您 YubiKey 上的按钮以插入代码。

<div align="left" data-with-frame="true"><figure><img src="https://res.cloudinary.com/bw-com/image/upload/f_auto/v1/ctf/7rncvj1f8mw7/0SakpfPW6yFdTU34AHxNu/431a5a859949f5d8da8e1a64e0072291/nonfc.png?_a=DAJCwlWIZAAB" alt=""><figcaption><p>取消 NFC</p></figcaption></figure></div>

4、选择或点击**继续**以完成登录。

登录后，您将不会被要求完成第二步的两步登录步骤即可**解锁**您的密码库。有关配置注销和锁定行为的帮助，请参阅[密码库超时选项](/docs/account/log-in-and-unlock/vault-timeout-options)。

## NFC 故障排除 <a href="#nfc-troubleshooting" id="nfc-troubleshooting"></a>

如果您的 YubiKey 的 NFC 功能无法正常使用：

**检查 NFC 是否已启用：**

1. 下载 [Yubico Authenticator](https://www.yubico.com/products/yubico-authenticator/)。
2. 将 YubiKey 插入设备。
3. 在 Yubico Authenticator 中打开钥匙，然后选择 **Toggle applications**。
4. 为您的钥匙启用所有可用的 NFC 选项。如果没有列出 NFC 选项，则您的密钥可能不支持 NFC。

**检查 NFC 配置是否正确：**

1. 下载 [YubiKey Personalization Tool](https://www.yubico.com/products/services-software/download/yubikey-personalization-tools/)。
2. 将 YubiKey 插入设备。
3. 选择 **Tools** 选项卡。
4. 选择 **NDEF Programming** 按钮。
5. 选择您希望 YubiKey 使用 NFC 功能的配置插槽。
6. 选择 **Program** 按钮。

**（仅 Android）检查如下项目：**

* 在设置过程中，确保您勾选了**我的某把钥匙支持 NFC** 复选框。
* 您的 Android 设备支持 [NFC](https://en.wikipedia.org/wiki/List_of_NFC-enabled_mobile_devices)，并且[已知可以正常与 YubiKey NEO 或 YubiKey 5 NFC 配合使用](https://forum.yubico.com/viewtopic1c5f.html?f=26\&t=1302)。
* 您已在您的 Android 设备上启用了 NFC 功能（**设置** → **更多**）。
* 您的键盘布局/格式/模式已设置为 QWERTY。

> **\[译者注]**：QWERTY 是一种键盘布局，指的是键盘左上角第一排字母的排列顺序为 `Q W T R E Y`。绝大多数电脑、手机默认都是 QWERTY。大多数国家使用 QWERTY，法国和比利时使用 AZERTY，德国和部分欧洲国家使用 QWERTZ。


# 两步登录 - 通行密钥

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/setup-two-step-login-fido/)
{% endhint %}

> **\[译者注]**：
>
> * **FIDO**：Fast IDentity Online（在线快速身份认证）。FIDO 是一套身份认证框架协议，由 [FIDO 联盟](https://fidoalliance.org/)维护并制定相应的技术规范和标准。
> * [**U2F**](https://zh.wikipedia.org/wiki/%E9%80%9A%E7%94%A8%E7%AC%AC%E4%BA%8C%E5%9B%A0%E7%B4%A0)：Universal 2nd Factor（通用第二因素）。由 [FIDO 联盟](https://fidoalliance.org/)制定的一个开放认证标准，使用专门的 USB 或 NFC 设备来加强并简化双重认证。
> * [**YubiKey**](https://zh.wikipedia.org/wiki/YubiKey)：YubiKey 是由 [Yubico](https://www.yubico.com/) 公司生产的用于身份认证的硬件设备。部分 Yubikey 型号支持 FIDO。其他支持 FIDO 的硬件还有 Google 的 [Titan 安全钥匙](https://cloud.google.com/titan-security-key)、FEITIAN 的[安全钥匙](https://www.ftsafe.com/Products/FIDO)等。

{% hint style="info" %}
Bitwarden 提供三种通行密钥功能：

* 从您的 Bitwarden 密码库为其他服务[保存和自动填充通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)。
* 使用[通行密钥登录和解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-passkeys)您的 Bitwarden 账户。**\***
* 使用[通行密钥 2FA](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)保护您的 Bitwarden 账户。**\***

**\*** 某些身份验证器，尤其是 Windows Hello，不允许您使用通行密钥同时进行登录和 2FA。
{% endhint %}

所有 Bitwarden 用户均可免费使用 FIDO2 WebAuthn 凭据进行两步登录。可以使用任何经过 FIDO2 WebAuthn 认证的验证器，包括 [YubiKey](https://www.yubico.com/)、[SoloKeys](https://solokeys.com/)、[Google Titan](https://store.google.com/product/titan_security_key)、[Nitrokey](https://www.nitrokey.com/) 等安全密钥，以及 Windows Hello 等原生生物识别选项。在 macOS 上，当前不支持 Touch ID 等非安全密钥。

> **\[译者注]**：2023.9.0 版本之前，FIDO2 WebAuthn 方式的两步登录适用于高级版用户，包括付费组织（家庭版、团队版或企业版）的成员，不适用于免费用户。

{% hint style="success" icon="lightbulb" %}
所有通过 Bitwarden 设置的新 FIDO 密钥都会注册为 WebAuthn 密钥。如果您已注册的 FIDO 密钥在网页 App 的两步登录 → 管理 FIDO2 WebAuthn 视图中被标记为（**迁移自 FIDO**），则说明该密钥为 U2F 密钥，应将其删除并重新注册，以便自动将该密钥设置为 WebAuthn 密钥。Bitwarden 将于 2025 年开始逐步停止对（**迁移自 FIDO**）U2F 密钥的支持。
{% endhint %}

FIDO2 WebAuthn 与大多数 Bitwarden 应用程序兼容。如果您想要使用不支持 FIDO2 WebAuthn 的应用程序版本，请确保您开启了其他两步登录方式。支持的应用程序包括：

* 具有[支持 FIDO2 的浏览器](https://fidoalliance.org/fido2/fido2-web-authentication-webauthn/)的设备上的**网页密码库**
* [支持 FIDO2 的浏览器](https://fidoalliance.org/fido2/fido2-web-authentication-webauthn/)上的**浏览器扩展**
* 具有[支持 FIDO2 的浏览器](https://fidoalliance.org/fido2/fido2-web-authentication-webauthn/)的 Android 和 iOS 13.3+ 上的**移动 App**
* macOS、Windows 10+ 和 Liunx 上的**桌面 App**

{% hint style="info" %}
使用自托管 Bitwarden 服务器的用户可能容易受到针对通行密钥 2FA 的网络钓鱼攻击。如果攻击者获取了用户的电子邮箱地址和主密码，他们可能会在恶意网站上嵌入 Bitwarden 通行密钥提示，诱骗受害者完成验证，从而捕获通行密钥认证响应并重放以获取账户访问权限。

为确保安全，在输入凭证或与通行密钥提示交互之前，请务必确认您访问的是正确的 Bitwarden 域名。如果登录或 2FA 页面有任何异常，请不要继续操作。
{% endhint %}

## 设置 FIDO2 WebAuthn <a href="#setup-fido-2-webauthn" id="setup-fido-2-webauthn"></a>

要启用 FIDO2 WebAuthn 方式的两步登录：

{% hint style="warning" %}
**丢失对两步登录设备的访问会永久性将您锁定在您的密码库之外**，除非您将您的两步登录恢复代码写下并将其保存在安全的地方，或拥有已启用并可用的备用两步登录方式。

启用任何方式之后，应立即通过**两步登录**界面[获取您的恢复代码](/docs/account/two-step-login/recovery-codes)。此外，用户还可以创建 Bitwarden [导出](/docs/password-manager/import-and-export/export-vault-data)来备份密码库数据。
{% endhint %}

1、登录到 Bitwarden 网页 App。

2、从导航选择**设置** → **安全** → **两步登录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2IjxRoQwl1powHRhah6Bq/39067a5fe6c53732054f323e4afb431b/Screenshot_2025-12-31_at_1.52.00%C3%A2__PM.png?w=1259&#x26;fm=avif" alt=""><figcaption><p>两步登录设置</p></figcaption></figure></div>

3、定位到**通行密钥**选项然后选择**管理**。将提示您输入您的主密码以继续。

4、给您的安全钥匙起一个友好的**名称**。

5、将安全钥匙插入设备的 USB 端口，然后选择**读取钥匙**。如果安全钥匙具有按钮，请触摸它。

{% hint style="info" %}
某些设备（包括支持通行密钥的 Windows Hello 或 macOS 设备）是原生 FIDO2 身份验证器，它们将默认提供这些选项。如果您想注册安全密钥或其他验证器，您可能需要选择**尝试另一种方式**、**其他选项**或**取消**按钮以打开其他选项。
{% endhint %}

6、选择**保存**。一个绿色的 `已启用` 消息表明 FIDO2 WebAuthn 方式的两步登录已被成功启用，并且您的密钥旁边将显示绿色的勾号 (<i class="fa-check">:check:</i>)。

7、选择**关闭**按钮，然后确认 **FIDO2 WebAuthn** 选项现在已被启用（通过一个绿色的勾号 (<i class="fa-check">:check:</i>) 指示）。

重复此过程以向您的账户中添加最多 5 个 FIDO2 WebAuthn 安全钥匙。Bitwarden 高级版账户最多可以向账户添加 10 个 FIDO2 WebAuthn 安全钥匙。了解更多有关 [Password Manager 方案](/docs/plans-and-pricing/password-manager/about-bitwarden-plans)的信息。

{% hint style="info" %}
我们建议在继续测试两步登录之前，将活动的网页密码库选项卡保持为打开状态，以防配置错误。确认其正常工作后，请注销所有的 Bitwarden App，以要求每个 App 使用两步登录。您最终会被自动注销。
{% endhint %}

## 使用 FIDO2 WebAuthn <a href="#use-fido-2-webauthn" id="use-fido-2-webauthn"></a>

以下内容假设 **FIDO2 WebAuthn** 是您[已启用的最高优先级方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods#using-multiple-methods)。完成以下步骤，以使用FIDO2 WebAuthn 设备访问您的密码库：

1、输入您的电子邮箱地址和主密码登录您的 Bitwarden 密码库。

2、将提示您读取您的安全钥匙，例如，将安全钥匙插入设备的 USB 端口然后轻按按钮：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3RuttlEwwfVX3UJKA8GTFg/ab7e0ba835a7f42ea3f10369cb66c008/2025-03-25_10-28-20.png?w=629&#x26;fm=avif" alt=""><figcaption><p>FIDO2 提示</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
勾选**记住我**复选框，以让 Bitwarden 在接下来的 30 天内可以识别您的设备。选择此选项意味着在此期间您不会被要求完成两步登录步骤。
{% endhint %}

登录后，您将不会被要求完成第二步的两步登录步骤即可**解锁**您的密码库。有关配置注销和锁定行为的帮助，请参阅[密码库超时选项](/docs/account/log-in-and-unlock/vault-timeout-options)。

## NFC 故障排除 <a href="#nfc-troubleshooting" id="nfc-troubleshooting"></a>

{% hint style="success" icon="lightbulb" %}
硬件安全钥匙通常有一个物理插头，在 NFC 识别困难的情况下可以更可靠地工作。
{% endhint %}

如果您的 YubiKey 的 NFC 功能无法正常使用：

**检查 NFC 是否已启用：**

1. 下载 [Yubico Authenticator](https://www.yubico.com/products/yubico-authenticator/)。
2. 将 YubiKey 插入设备。
3. 在 Yubico Authenticator 中打开钥匙，然后选择 **Toggle applications**。
4. 为您的钥匙启用所有可用的 NFC 选项。如果没有列出 NFC 选项，则您的密钥可能不支持 NFC。

**检查 NFC 配置是否正确：**

1. 下载 [YubiKey Personalization Tool](https://www.yubico.com/products/services-software/download/yubikey-personalization-tools/)。
2. 将 YubiKey 插入设备。
3. 选择 **Tools** 选项卡。
4. 选择 **NDEF Programming** 按钮。
5. 选择您希望 YubiKey 使用 NFC 功能的配置插槽。
6. 选择 **Program** 按钮。

**（仅 Android）检查如下项目：**

* 在设置过程中，确保您勾选了**我的某把钥匙支持 NFC** 复选框。
* 您的 Android 设备支持 [NFC](https://en.wikipedia.org/wiki/List_of_NFC-enabled_mobile_devices)，并且[已知可以正常与 YubiKey NEO 或 YubiKey 5 NFC 配合使用](https://forum.yubico.com/viewtopic1c5f.html?f=26\&t=1302)。
* 您已在您的 Android 设备上启用了 NFC 功能（**设置** → **更多**）。
* 您的键盘布局/格式/模式已设置为 QWERTY。

> **\[译者注]**：QWERTY 是一种键盘布局，指的是键盘左上角第一排字母的排列顺序为 `Q W T R E Y`。绝大多数电脑、手机默认都是 QWERTY。大多数国家使用 QWERTY，法国和比利时使用 AZERTY，德国和部分欧洲国家使用 QWERTZ。


# 两步登录恢复代码

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/two-step-recovery-code/)
{% endhint %}

当您激活任何[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)时，Bitwarden 会提供一个唯一的恢复代码。如果您[丢失了身份验证设备](/docs/account/lost-two-step-device)，请使用此代码断开所有两步登录方式并重新获得对您账户的访问权限。如果您同时丢失了恢复代码和两步设备（例如带有验证器 App 的手机或已链接的电子邮箱收件箱），您可能会被锁定在您的密码库之外。

{% hint style="success" icon="lightbulb" %}
如果您在组织中注册了[账户恢复](/docs/admin-console/manage-members/account-recovery/about-account-recovery)，则可以要求组织所有者或管理员重置您的两步登录。此方法不需要您的个人恢复代码，如下所述。
{% endhint %}

## 保存您的恢复代码 <a href="#save-your-recovery-code" id="save-your-recovery-code"></a>

启用任何两步登录方式后，应立即保存您的恢复代码，并将其存储在您选择的安全位置。将打印副本保存在安全的地方是一个不错的选择，因为它可以防止数字盗窃和意外删除。

{% hint style="info" %}
[使用恢复代码](#use-your-recovery-code)后，会生成一个新的恢复代码。确保保存更新后的代码。添加新的两步登录方式或更改主密码不会影响恢复代码。
{% endhint %}

要在 Bitwarden 网页 App 中查找您的恢复代码：

1、设置至少一种两步登录方式后，转到**设置** → **安全**。

2、选择**两步登录**。

3、选择**查看恢复代码**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2IjxRoQwl1powHRhah6Bq/39067a5fe6c53732054f323e4afb431b/Screenshot_2025-12-31_at_1.52.00%C3%A2__PM.png?w=1259&#x26;fm=avif" alt=""><figcaption><p>两步登录设置</p></figcaption></figure></div>

4、输入您的主密码然后选择**继续**。您的恢复代码将出现：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/64piqJsX7vN25To16iRFIp/09e977fae9485c0764f832c6bb4b4b04/2024-12-02_11-24-35.png?w=529&#x26;fm=avif" alt=""><figcaption><p>示例恢复代码</p></figcaption></figure></div>

## 使用您的恢复代码 <a href="#use-your-recovery-code" id="use-your-recovery-code"></a>

要使用恢复代码重新获取对您的账户的访问权限：

1. 转到您账户服务器位置的恢复页面：
   * **美国**：<https://vault.bitwarden.com/#/recover-2fa/>
   * **欧盟**：[https://vault.bitwarden.eu/#/recover-2fa/](https://vault.bitwarden.eu/#/recover-2fa)
   * **自托管**：`https://your.domain.com/#/recover-2fa/`
2. 输入您的电子邮箱地址、主密码和恢复代码。
3. 选择**提交**。

您的账户详细信息和恢复代码通过身份验证后，您将登录到您的密码库，并且之前设置的所有两步登录方式都将被禁用。

{% hint style="info" %}
恢复代码不会禁用用于组织的 Duo。如果您被组织 Duo 提示锁定在密码库之外，请联系您公司的 Duo 管理员，以获得绕过此提示的帮助。

如果您不确定 Duo 提示是个人设置的还是组织设置的，请尝试选择**使用其他两步登录方式**。
{% endhint %}

为了以后保持对您账户安全可靠的访问：

* 设置或重新激活至少一种[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。如果您不这样做，当您从无法识别的设备登录时，Bitwarden 将向您的账户电子邮箱发送[验证码](/docs/account/log-in-and-unlock/new-device-protection)。
* [保存您的新恢复代码](#save-your-recovery-code)，因为它在使用后会发生变化。

### 企业成员 <a href="#enterprise-members" id="enterprise-members"></a>

当您是某个企业版组织的成员时，提交有效的恢复代码后发生的情况可能会有所不同。

如果您的组织[要求单点登录身份验证](/docs/admin-console/oversight-visibility/enterprise-policies#require-single-sign-on-authentication)，但不[要求两步登录](/docs/admin-console/oversight-visibility/enterprise-policies#require-two-step-login)，您将被定向到 SSO 登录页面。使用您的 SSO 凭据登录然后访问您的 Bitwarden 密码库。

如果您的组织[要求两步登录](/docs/admin-console/oversight-visibility/enterprise-policies#require-two-step-login)，成功使用恢复代码后会将您从组织中移除。登录后要重新加入组织：

1. 设置一个新的[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。
2. 如果您的组织还[要求单点登录身份验证](/docs/admin-console/oversight-visibility/enterprise-policies#require-single-sign-on-authentication)，请将您的 SSO 凭据重新连接到您的 Bitwarden 账户。
3. 请求管理员或所有者在组织内[恢复您的账户](/docs/admin-console/manage-members/revoke-remove/temporarily-revoke-access#restore-access)。


# 无法访问两步登录

{% hint style="warning" %}
参阅[无法访问两步登录](/docs/account/lost-two-step-device)
{% endhint %}


# 两步登录 FAQ

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/twostep-faqs/)
{% endhint %}

本文包含有关**两步登录**的常见问题解答 (FAQ)。

### 问：可以使用 SMS 2FA 吗？ <a href="#q-can-i-use-sms-2-fa" id="q-can-i-use-sms-2-fa"></a>

**答：**&#x9274;于 SIM 卡劫持等漏洞的存在，Bitwarden 不支持 SMS 2FA。我们也不建议其他账户使用 SMS 2FA，除非它是唯一可用的方法。虽然任何第二个因素都比没有更推荐，但大多数替代方案都比 SMS 2FA 更安全。

### 问：我可以要求我的组织用户使用两步登录吗？ <a href="#q-can-i-require-my-organizations-users-to-use-two-step-login" id="q-can-i-require-my-organizations-users-to-use-two-step-login"></a>

**答：**&#x60A8;可以通过启用[两步登录策略](/docs/admin-console/oversight-visibility/enterprise-policies#two-step-login)来要求组织用户使用两步登录。此外，您还可以设置[组织层面的 Duo 2FA](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-duo)，以确保您的所有用户都拥有他们可以支配的安全的两步登录方式。

### 问：iOS 或 Android App 支持 FIDO U2F 或 FIDO2 WebAuthn 吗？ <a href="#q-is-fido-u-2-f-or-fido-2-webauthn-supported-on-my-ios-or-android-app" id="q-is-fido-u-2-f-or-fido-2-webauthn-supported-on-my-ios-or-android-app"></a>

**答：**&#x652F;持。请参阅 [FIDO2 WebAuthn 方式的两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido)。

### 问：为什么 Bitwarden 没有询问我已启用的两步登录方式？ <a href="#q-why-is-bitwarden-not-asking-for-my-enabled-two-step-login-method" id="q-why-is-bitwarden-not-asking-for-my-enabled-two-step-login-method"></a>

**答：**&#x5927;多数情况下，可能是以下两种情况之一：

1、您可能已经登录了 Bitwarden，而您只是解锁您的密码库。**登录**您的密码库需要两步登录但**解锁**不需要。有关登录与解锁之间的区别的更多信息，请参阅[密码库超时行为](/docs/account/log-in-and-unlock/vault-timeout-options#vault-timeout-action)。

2、在使用两步登录访问您的密码库时，您可能已经在设备上勾选了**记住我**复选框。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6ZKXQZRh1riGuGy44rlebh/7985d990f64c1ee20556aa88b63b591a/2024-12-02_11-26-14.png?w=497&#x26;fm=avif" alt=""><figcaption><p>记住我选项</p></figcaption></figure></div>

如果您使用了**记住我**选项，需要从您的网页密码库（**设置** → **我的账户**）中**取消会话授权**，以便该设备继续询问您的两步登录方式。

### 问：设备登录是否适用于两步登录？ <a href="#q-does-log-in-with-device-work-with-two-step-login" id="q-does-log-in-with-device-work-with-two-step-login"></a>

**答：**&#x662F;的。设备登录将取代输入您的主密码，但如果在账户上启用了该功能并且之前未为该设备选中「记住我」，则用户仍需要完成两步登录。


# 紧急访问


# 关于紧急访问

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/emergency-access/)
{% endhint %}

紧急访问让您能够为意外情况做好准备，通过指定受信任的紧急联系人，在必要时可申请访问您的 Bitwarden 密码库。受信任的紧急联系人可以被授予查看或接管权限，从而控制他们在需要介入时可以执行的操作：

* **查看**：当紧急访问请求被批准后，此用户将获得对您个人密码库中所有项目，包括登录项目的密码和附件的查看/读取权限。
* **接管**：当紧急访问请求被批准后，此用户必须创建一个主密码，以获得对您密码库的永久读取/写入权限。这将**替换**您之前的主密码，并移除之前设置的任何[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。

## 设置和使用紧急访问 <a href="#set-up-and-use-emergency-access" id="set-up-and-use-emergency-access"></a>

授予他人账户紧急访问权限需完成以下几个步骤：

1. 账户持有人在紧急情况发生之前，为其账户[添加一位受信任的联系人](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts)。
2. 当需要时，受信任的联系人[请求访问](/docs/account/emergency-access/request-and-grant-emergency-access#id-1-the-trusted-emergency-contact-requests-access-to-the-account)该账户。
3. 账户持有人[批准此请求](/docs/account/emergency-access/request-and-grant-emergency-access#id-2-the-trusted-emergency-contacts-request-is-approved-or-denied)或等待时间到期后生效。
4. [受信任的联系人访问此账户](/docs/account/emergency-access/request-and-grant-emergency-access#id-3-the-trusted-emergency-contact-gets-access)。
5. （可选）账户持有人[撤销受信任的联系人对其账户的访问权限](/docs/account/emergency-access/request-and-grant-emergency-access#manage-a-trusted-emergency-contacts-access)。

## 谁可以使用紧急访问

为紧急访问[添加受信任的联系人](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts)适用于高级版用户，包括付费版组织（家庭版、团队版和企业版）的成员。如果您的组织开启了[自动确认策略](/docs/admin-console/oversight-visibility/enterprise-policies#automatic-user-confirmation)，则您的账户将**无法**使用紧急访问。

任何拥有免费版或高级版 Bitwarden 账户且位于同一 [Bitwarden 服务器](/docs/security/server-geographies)的用户，均可被指定为受信任的紧急联系人。高级版用户可设置的受信任紧急联系人的数量没有限制。

{% hint style="success" icon="lightbulb" %}
如果您是组织管理员，在员工离职或继任规划期间，[账户恢复](/docs/admin-console/manage-members/account-recovery/about-account-recovery)可能更适合管理员工账户的访问权限。
{% endhint %}

## 工作原理 <a href="#how-it-works" id="how-it-works"></a>

{% hint style="info" %}
以下信息涉及加密密钥名称和过程，这些内容在[散列、密钥派生和加密](/docs/security/bitwarden-security-whitepaper#hashing-key-derivation-and-encryption)中有介绍。建议先阅读这些详细内容。
{% endhint %}

紧急访问使用公钥交换和加密/解密来允许用户授予受信任的紧急联系人在零知识环境下访问密码库数据的权限：

1. Bitwarden 用户（授予人）邀请另一位 Bitwarden 用户成为其可信任的紧急联系人（受让人）。邀请（有效期只有 5 天）指定了用户访问级别，并包含对受让人 **RSA 公钥**的请求。
2. 受让人将通过电子邮件收到邀请通知，并接受邀请成为可信任的紧急联系人。接受邀请后，受让人的 **RSA 公钥**将与用户记录一起存储。
3. 授予人将通过电子邮件收到接受通知，并确认受让人成为其可信任的紧急联系人。确认后，授予人的**用户对称密钥**将使用受让人的 **RSA 公钥**进行加密，并与邀请一起存储。受让人将收到确认通知。
4. 发生紧急情况时，受让人可以提交紧急访问请求以要求进入授予人的密码库。
5. 授予人将通过电子邮件收到请求通知。授予人可以随时手动批准请求，否则请求将受到授予人指定的等待时间的约束。当请求被批准或等待时间结束后，经**公钥加密的用户对称密钥**将交付给受让人，并使用受让人的 **RSA 私钥**进行解密。\
   或者，授予人可以拒绝请求，这将阻止受让人获得下一步所述的访问权限。拒绝请求不会使受让人不再是可信任的紧急联系人，也不会阻止他们在未来提出访问请求。
6. 根据指定的用户访问级别，受让人可以：
   * **查看**：获得对授予人密码库中的项目的查看/读取访问权限。
   * **接管**：被要求为授予人的密码库创建一个新的主密码。

## 下一步 <a href="#next-steps" id="next-steps"></a>

* [添加受信任的紧急联系人](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts)到您的账户。
* 与您受信任的联系人分享[如何请求访问权限](/docs/account/emergency-access/request-and-grant-emergency-access#id-1-the-trusted-emergency-contact-requests-access-to-the-account)，以备不时之需。
* 了解如何[处理针对您账户的紧急访问请求](/docs/account/emergency-access/request-and-grant-emergency-access#approve-or-deny-an-emergency-access-request)。


# 添加 & 管理受信任的紧急联系人

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/add-and-manage-trusted-emergency-contacts/)
{% endhint %}

受信任的紧急联系人是指您允许其通过[紧急访问](/docs/account/emergency-access/about-emergency-access)登录您的 Bitwarden 账户的人员。您可以随时添加或更新受信任的紧急联系人。

## 添加受信任的紧急联系人 <a href="#add-trusted-emergency-contacts" id="add-trusted-emergency-contacts"></a>

为紧急访问[添加受信任的紧急联系人](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts)适用于高级版用户，包括付费版组织（家庭版、团队版和企业版）的成员。如果您的组织开启了[自动确认策略](/docs/admin-console/oversight-visibility/enterprise-policies#automatic-user-confirmation)，则您的账户将**无法**使用紧急访问。

要为紧急访问指定受信任的紧急联系人：

### 1. 您邀请其他用户成为您受信任的紧急联系人 <a href="#id-1-you-invite-another-user-to-become-your-trusted-emergency-contact" id="id-1-you-invite-another-user-to-become-your-trusted-emergency-contact"></a>

作为想要对您的密码库授予紧急访问的人，请邀请受信任的紧急联系人：

1、在 Bitwarden 网页 App 中，转到**设置** → **紧急访问**。

2、选择 <i class="fa-plus">:plus:</i>**添加紧急联系人**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3gb0Zm4K935RUmzjd62eJq/a3930a8381fe1205b655e7a7bb0eca47/2025-12-31_09-50-39.png?w=966&#x26;fm=avif" alt=""><figcaption><p>紧急访问页面</p></figcaption></figure></div>

3、输入您信任的紧急联系人的**电子邮箱**。受信任的紧急联系人必须拥有 Bitwarden 账户（免费版或高级版），以及必须位于相同的[服务器地理位置](/docs/security/server-geographies)：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2IEldGj87MY2IMDQpty6Vr/f0e9750c278663903be46f4a5d5a4f8c/2025-12-31_09-52-02.png?w=964&#x26;fm=avif" alt=""><figcaption><p>邀请紧急联系人</p></figcaption></figure></div>

4、为受信任的紧急联系人设置[**用户访问权限**](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts#user-access)级别：**查看**或**接管**。

5、设置[**等待时间**](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts#wait-time)。

6、选择**保存**以发送邀请。

您的受信任的紧急联系人**必须立即接受此邀请**。

{% hint style="info" %}
成为受信任的紧急联系人的邀请的有效期只有 5 天。
{% endhint %}

### &#xD;2\. 他们接受邀请 <a href="#id-2-they-accept-the-invitation" id="id-2-they-accept-the-invitation"></a>

作为想要接收他人密码库的紧急访问权限的人，请接受邀请：

1、打开发送到电子邮箱的邀请，然后选择**成为紧急联系人**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1S7YBbeECgEdl1v9r4E5BU/37c6c4207cb8c6df7f69a63ea12751fd/Screenshot_2024-02-27_at_9.23.46_AM.png?w=590&#x26;fm=avif" alt=""><figcaption><p>紧急访问邀请</p></figcaption></figure></div>

2、将在浏览器中打开登录页面。根据您是否拥有账户，选择**登录**或**创建账户**以接受邀请。

接受邀请后，邀请的用户**必须确认您作为其受信任的联系人**，然后才能[发起访问请求](#use-emergency-access)。

### 3. 您确认他们为您受信任的紧急联系人 <a href="#id-3-you-confirm-them-as-your-trusted-emergency-contact" id="id-3-you-confirm-them-as-your-trusted-emergency-contact"></a>

作为想要对您的密码库授予紧急访问的人，请在受信任的联系人接受邀请后确认该联系人：

1、在 Bitwarden 网页 App 中，转到**设置** → **紧急访问**。

2、当受邀请的用户显示 `需要确认` 状态时，选择 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**菜单图标**。

3、从下拉菜单中选择**确认**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/jEvLxG2nmFJRnlTbcpwRO/891f14df501abae6c1e93ce57a527ec4/2025-12-31_09-53-35.png?w=966&#x26;fm=avif" alt=""><figcaption><p>确认紧急联系人</p></figcaption></figure></div>

4、要验证受邀请的用户，请与受邀请的用户确认显示的[指纹短语](/docs/security/encryption/account-fingerprint-phrase)，然后选择**确认**。

受信任的紧急联系人设置
&#x20;<a href="#trusted-emergency-contact-settings" id="trusted-emergency-contact-settings"></a>
------------------------------------------------------------------------------------------------

对于每位受信任的紧急联系人，请选择自动授予访问权限前的等待时间，以及他们获得的访问权限级别。

### 用户访问权限 <a href="#user-access" id="user-access"></a>

* **查看**：当紧急访问请求被批准后，此用户将获得对您个人密码库中所有项目，包括登录项目的密码和附件的查看/读取权限。
* **接管**：当紧急访问请求被批准后，此用户必须创建一个主密码，以获得对您密码库的永久读取/写入权限。这将**替换**您之前的主密码，并移除之前设置的任何[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。

### 等待时间 <a href="#wait-time" id="wait-time"></a>

当受信任的紧急联系人[请求访问权限](/docs/account/emergency-access/request-and-grant-emergency-access#id-1-the-trusted-emergency-contact-requests-access-to-the-account)时，您可以手动批准或拒绝。如果您未回应，访问权限将在您添加该特定受信任的紧急联系人时指定的等待时间后自动批准。最短等待时间为一天。

## 更改受信任的紧急联系人设置 <a href="#change-trusted-emergency-contact-settings" id="change-trusted-emergency-contact-settings"></a>

要更改紧急联系人的用户访问权限或等待时间：

1、前往**设置** → **紧急访问**。

2、选择用户的电子邮箱，这将打开其详细信息。

3、根据需要更新**用户访问权限**或**等待时间**。

4、选择**保存**。

{% hint style="success" icon="lightbulb" %}
您也可以从**设置** → **紧急访问**中管理[待处理或已授权的紧急访问请求](/docs/account/emergency-access/request-and-grant-emergency-access#approve-or-deny-an-emergency-access-request)。
{% endhint %}

## 移除受信任的紧急联系人 <a href="#remove-a-trusted-emergency-contact" id="remove-a-trusted-emergency-contact"></a>

要从您的账户中移除受信任的紧急联系人：

1、前往**设置** → **紧急访问**。

2、选择 **≡**&#x83DC;单图标。

3、选择**移除**。

4、选择**是**以确认。

## 常见问题 <a href="#frequently-asked-questions" id="frequently-asked-questions"></a>

<details>

<summary>如果我的高级版功能被取消或由于支付失败而失效，紧急访问还能正常使用吗？</summary>

如果您的高级版功能被取消，您受信任的紧急联系人仍然可以请求并获取对您密码库的访问权限。但是，您将无法添加新的或编辑现有的受信任的紧急联系人。

</details>

<details>

<summary>当我的受信任的紧急联系人更改他们的账户电子邮箱地址时会发生什么？</summary>

作为受信任的紧急联系人的用户状态与一个唯一的 Bitwarden 账户 ID 相关联，这意味着如果受信任的紧急联系人[更改了他们的电子邮箱地址](/docs/password-manager/more/password-manager-faqs#q-how-do-i-change-my-email-address)，无需重新配置即可保持其紧急访问权限。同样地，如果紧急访问授予人更改了他们的电子邮箱地址，也无需重新配置。

</details>

<details>

<summary>当我的受信任的紧急联系人删除他们的账户时会发生什么？</summary>

如果一个受信任的紧急联系人创建了新的 Bitwarden 账户并[删除](/docs/plans-and-pricing/delete-an-account-or-organization)了旧账户，他们将被自动从受信任的紧急联系人中移除，并且必须重新[被邀请](#add-trusted-emergency-contacts)。

</details>

## 下一步 <a href="#next-steps" id="next-steps"></a>

* 与您受信任的联系人分享[如何请求访问权限](/docs/account/emergency-access/request-and-grant-emergency-access#id-1-the-trusted-emergency-contact-requests-access-to-the-account)，以备不时之需。
* 了解如何[处理针对您账户的紧急访问请求](/docs/account/emergency-access/request-and-grant-emergency-access#approve-or-deny-an-emergency-access-request)。


# 请求 & 授予紧急访问权限

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/request-and-grant-emergency-access/)
{% endhint %}

作为受信任的紧急联系人，当账户持有人无法无法访问其账户或[忘记其主密码](/docs/account/i-forgot-my-master-password)时，您可以请求[紧急访问](/docs/account/emergency-access/about-emergency-access)其 Bitwarden 密码库。请求发出后，账户持有人可[批准或拒绝访问权限](/docs/account/emergency-access/request-and-grant-emergency-access#approve-or-deny-an-emergency-access-request)，或在您配置的等待时间后自动获得访问权限。

## 获取账户的紧急访问权限 <a href="#get-emergency-access-to-an-account" id="get-emergency-access-to-an-account"></a>

[受信任的紧急联系人](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts)获取紧急访问权限需经过三个步骤：

### 1. 受信任的紧急联系人请求访问账户 <a href="#id-1-the-trusted-emergency-contact-requests-access-to-the-account" id="id-1-the-trusted-emergency-contact-requests-access-to-the-account"></a>

首先，请求对此账户的访问权限：

1、在 Bitwarden 网页 App 中，转到**设置** → **紧急访问**。

2、在**被指定为紧急联系人**部分，选择您要访问的账户旁边的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**菜单图标**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6x38VldDaEOAqpuCQ4htRJ/7946735436fd16b660aad5d7969dba8d/2025-12-31_09-54-39.png?w=966&#x26;fm=avif" alt=""><figcaption><p>请求紧急访问</p></figcaption></figure></div>

3、从出现的确认信息中，选择**请求访问**。系统将向账户持有人发送一封电子邮件，告知他们有人请求访问其账户。

### 2. 受信任的紧急联系人的请求被批准或拒绝 <a href="#id-2-the-trusted-emergency-contacts-request-is-approved-or-denied" id="id-2-the-trusted-emergency-contacts-request-is-approved-or-denied"></a>

如果账户持有人无法登录，您的请求将在[等待时间](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts#wait-time)到期后自动获得批准。

但是，如果账户持有人在此之前能够登录，他们可以手动[批准或拒绝您的请求](#approve-or-deny-an-emergency-access-request)。

### 3. 若请求被批准，受信任的紧急联系人可通过查看密码库或更新主密码以登录账户来获得访问权限 <a href="#id-3-the-trusted-emergency-contact-gets-access" id="id-3-the-trusted-emergency-contact-gets-access"></a>

您的请求获得批准后，您可以访问该账户：

1、在 Bitwarden 网页 App 中，转到**设置** → **紧急访问**。

2、在**被指定为紧急联系人**部分，选择 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**菜单图标**，然后从下拉列表中选择为您[分配的访问权限](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts#user-access)相对应的选项：

* **查看**：选择此选项将显示账户持有人的密码库项目。
* **接管**：选择此选项将允许您输入并确认账户持有人的新主密码。选择**保存**，然后使用账户持有人的电子邮箱地址和新主密码登录。

## 管理受信任的紧急联系人的访问权限 <a href="#manage-a-trusted-emergency-contacts-access" id="manage-a-trusted-emergency-contacts-access"></a>

作为账户持有人，您可以在三个环节控制受信任紧急联系人对您账户的访问权限：

* 将其从受信任的紧急联系人列表中[移除](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts#remove-a-trusted-emergency-contact)。
* 为紧急访问[批准或拒绝其待处理的请求](#approve-or-deny-an-emergency-access-request)。
* 撤销已授予的紧急访问权限。具体操作步骤取决于授予的是[查看](#revoke-view-access)还是[接管](#revoke-takeover-access)权限。

### 批准或拒绝紧急访问请求 <a href="#approve-or-deny-an-emergency-access-request" id="approve-or-deny-an-emergency-access-request"></a>

如果您在受信任的紧急联系人请求访问权限时仍能登录账户，您可以在[等待时间](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts#wait-time)到期之前批准或拒绝该请求。要批准或拒绝紧急访问请求：

1、在 Bitwarden 网页 App 中，转到**设置** → **紧急访问**。

2、在**已信任的紧急联系人**部分，选择请求访问的账户旁边的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**菜单图标**。

3、选择**批准**或**拒绝**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7iPFwb2NfsjeVywrwlZxSx/8ff35e1f5d8e2febf34089528ecea5ff/2025-12-31_09-55-14.png?w=966&#x26;fm=avif" alt=""><figcaption><p>批准或拒绝紧急访问</p></figcaption></figure></div>

### 撤销查看访问权限 <a href="#revoke-view-access" id="revoke-view-access"></a>

当某人通过紧急访问被授予[查看访问权限](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts#user-access)时，他们可以查看您的密码库项目，直到您撤销该权限。

要撤销通过紧急访问授予的某人的查看访问权限：

1、在 Bitwarden 网页 App 中，转到**设置** → **紧急访问**。

2、在**已信任的紧急联系人**部分，选择激活了紧急访问权限的账户旁的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**菜单图标**。

3、选择**拒绝**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7dhQEDLZNKCwwspstJnhj0/543dd12da8a8d64952763027678cf15a/2025-12-31_09-55-33.png?w=966&#x26;fm=avif" alt=""><figcaption><p>拒绝紧急访问</p></figcaption></figure></div>

### 撤销接管访问权限 <a href="#revoke-takeover-access" id="revoke-takeover-access"></a>

当受信任的紧急联系人被授予并使用[接管访问权限](/docs/account/emergency-access/add-and-manage-trusted-emergency-contacts#user-access)时，他们将会更改您账户的主密码。因此，移除他们的访问权限的唯一方法是：

1. 获取他们为您的账户创建的新主密码。
2. 使用新主密码登录[网页 App](/docs/password-manager/getting-started/getting-started-webvault)。
3. [更改您的主密码](/docs/account/master-password#change-your-master-password)为一个他们不知道的密码。


# Password Manager


# Password Manager 概述

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/password-manager-overview/)
{% endhint %}

Bitwarden Password Manager 使企业和个人能够在面临不断上升的网络犯罪威胁时保护其在线数据。使用 Bitwarden Password Manager 为您在线使用的每个账户生成强大而唯一的密码。这样，如果一个站点遭受数据泄露，您的其他账户都不会受到损害。Password Manager 通过创建、保存和自动填充这些强密码，让您可以轻松地做到这一点，这样您就不必担心记不住它们。

## 主要功能 <a href="#key-features" id="key-features"></a>

对于个人和最终用户，Bitwarden Password Manager 提供的一些最受欢迎的功能是：

* **轻松导入**：从几乎任何密码管理解决方案中[导入](/docs/password-manager/import-and-export/import-data)您的凭据。
* **健全的自动填充**：使用 Password Manager 从[浏览器扩展](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)和[移动 App](/docs/password-manager/autofill/autofill-from/autofill-from-ios) 更轻松地登录网站。
* **凭据生成器**：在注册新网站时，使用[用户名和密码生成器](/docs/password-manager/your-vault/security-tools/generator)自信地创建安全凭据。
* **集成身份验证**：直接从 Bitwarden Password Manager [生成并自动填写 2FA 的 TOTP 代码](/docs/password-manager/your-vault/security-tools/totp)。
* **两步登录选项**：设置各种[两步登录方法](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)（包括免费选项），以确保您的重要凭据的安全。

对于企业和管理员，Bitwarden Password Manager 提供的一些最受欢迎的功能是：

* **轻松导入**：从几乎任何密码管理解决方案[导入](/docs/admin-console/manage-shared-items/import-organization-items/import-to-organization)公司的共享凭据。
* **用户管理集成**：使用众多[跨域身份管理 (SCIM)](/docs/admin-console/manage-members/scim/about-scim) 或[直接到目录](/docs/admin-console/manage-members/directory-connector/about-directory-connector)集成之一来将最终用户同步到您的 Bitwarden 组织。
* **SSO 登录**：通过任何 SAML 2.0 或 OIDC 身份提供程序，[使用现有 SSO 设置对最终用户进行身份验证](/docs/admin-console/login-with-sso/about-sso)。
* **健全的策略**：为您的最终用户实施安全实践，例如使用企业策略为管理员设置恢复丢失账户的功能。

## 安全第一原则 <a href="#security-first-principles" id="security-first-principles"></a>

Bitwarden 致力于打造安全第一的产品。密码管理器是：

* **开源**：所有源代码都托管在 GitHub 上，任何人都可以免费查看和审核。第三方审计公司和安全研究人员有偿定期进行审计。
* **端到端加密**：密码库数据的所有加密和解密均在客户端完成，这意味着任何敏感数据都不会未经加密而进入我们的服务器。
* **零知识加密**：Bitwarden 团队成员无法查看您的密码库数据，包括 Password Manager 中未加密的 URL 以及您的主密码等数据。

## 客户端 <a href="#clients" id="clients"></a>

Password Manager 为大多数设备和许多用例提供客户端应用程序：

* **网页 App**：Password Manager 网页 App 是您进行密码库管理和组织管理的主页。[立即开始使用](/docs/password-manager/getting-started/getting-started-webvault)。
* **浏览器扩展**：Password Manager 浏览器扩展非常适合自动填写和无缝创建凭证，使网上冲浪更加轻松。[立即开始使用](/docs/password-manager/getting-started/getting-started-browserext)。
* **移动 App**：Password Manager 移动 App 旨在帮助您随时随地安全地获取凭据。[立即开始使用](/docs/password-manager/getting-started/getting-started-mobile)。
* **桌面 App**：Password Manager 桌面 App 为您的桌面带来完整、优雅的密码库体验。[立即开始使用](/docs/password-manager/getting-started/getting-started-desktop)。
* **CLI**：Password Manager CLI 是一款功能强大、功能齐全的工具，可用于访问和管理您的密码库，并且非常适合帮助自动化或开发工作流程。[立即开始使用](/docs/password-manager/developer-tools/cli/password-manager-cli)。


# 开始使用


# Password Manager 网页 App

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/getting-started-webvault/)
{% endhint %}

Bitwarden 网页 App 为个人用户和组织提供了最丰富的 Bitwarden 体验。许多重要功能，例如设置[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)或管理[组织](/docs/admin-console/organizations-overview)，只能从网页 App 完成。

{% hint style="success" icon="lightbulb" %}
可以从任何流行的网页浏览器从 [vault.bitwarden.com](https://vault.bitwarden.com) 和 [vault.bitwarden.eu](https://vault.bitwarden.eu/) 访问网页 App。如果您是**自托管** Bitwarden，则为您[已配置的域名](/docs/self-hosting/deploy-and-configure/docker/linux-standard-deployment)，例如 `https://my.bitwarden.server.com`。
{% endhint %}

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2xTpSA11EOCzx8VIuVffcF/d3bc18e7fc3c3cb0bf1779fad9262cd3/2024-12-02_13-42-14.png?w=1162&#x26;fm=avif" alt=""><figcaption><p>Password Manager 网页 App</p></figcaption></figure></div>

当您首次登录网页 App 时，您会进入**所有密码库**视图。此空间将列出您的所有密码库项目，包括[登录、支付卡、身份和安全笔记](/docs/password-manager/your-vault/vault-items/vault-items)。

## 第一步 <a href="#first-steps" id="first-steps"></a>

在上面的屏幕截图中，**所有密码库**视图显示**我的密码库**视图中的 <i class="fa-filter">:filter:</i>**所有项目**。[组织](/docs/admin-console/organizations-overview)的成员将在此处列出其他密码库。使用**筛选器**列可以帮助您使用**收藏**和**文件夹**来组织您的密码库。

让我们设置一个新的文件夹并向其添加一个新的登录来作为开始：

### 创建文件夹 <a href="#create-a-folder" id="create-a-folder"></a>

要创建文件夹：

1、从下拉菜单中选择 <i class="fa-plus">:plus:</i>**新增**按钮然后选择**文件夹**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3BvTWidqL4xWQvFqBSiJIR/d68bc851d44df1b571eed16366159e0c/2024-12-02_13-50-55.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>新增文件夹</p></figcaption></figure></div>

2、为您的文件夹输入一个名称（例如 `Important Logins`），然后选择**保存**。

{% hint style="success" icon="lightbulb" %}
为了使密码库更清爽，您可以[将文件夹嵌套在其他文件夹中](/docs/password-manager/your-vault/vault-navigation/folders#nested-folders)。
{% endhint %}

### 添加登录 <a href="#add-a-login" id="add-a-login"></a>

要添加一个新的登录项目：

1、从下拉菜单中选择 <i class="fa-plus">:plus:</i>**新增**按钮然后选择**登录。**

2、输入**项目名称**。名称用于帮助您轻松识别您的密码库中的项目，因此请为其指定一个可识别的名称（例如 `My Gmail Account`）。

3、从**文件夹**下拉菜单中，选择要添加此项目的文件夹名称（例如，我们之前创建的 `Important Logins` 文件夹）。

4、为登录项目输入您的**用户名**和**密码**。现在，请输入您**现有的**密码，我们稍后会帮助您[用更强的密码替换它](#generate-a-strong-password)。

5、在**网站 (URI)** 字段中，输入网站的 URL（例如 `https://accounts.google.com`）。如果您不知道要使用哪个 URL，请导航到网站的登录界面并从地址栏中复制它。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/62IycEwbVrumSyPjB9n5XS/0df14e819c0881be3d813e235271acaf/2025-06-02_14-31-28.png?w=956&#x26;fm=avif" alt=""><figcaption><p>定位 URI</p></figcaption></figure></div>

6、选择 <i class="fa-star">:star:</i>**收藏**图标以将此项目添加到您的收藏夹。标记为收藏时，图标将被填充（**✰** → **★**）。

7、做得好！选择**保存**按钮完成添加此项目。

### 生成强密码 <a href="#generate-a-strong-password" id="generate-a-strong-password"></a>

现在新的登录项目已保存在您的密码库中，您可以使用用更强的密码替换现有的密码来增强其安全性：

1、在您的密码库中，选择要保护的项目，打开并选择**编辑**按钮。

2、在新的标签页或窗口中，打开相应的网站并登录您的账户。

{% hint style="success" icon="lightbulb" %}
如果您在 **URI 1** 字段中输入了某些内容，请单击 <i class="fa-arrow-up-right-from-square">:arrow-up-right-from-square:</i>**启动**图标以直接从您的密码库中打开它！
{% endhint %}

3、在该网站上，导航到可以**更改您的密码**的区域。

通常，您可以在**您的账户**、**安全**或**登录设置**部分中找到它。

4、大多数网站会要求您先输入**当前密码**。返回到您的 Bitwarden 密码库并单击**密码**字段旁边的 <i class="fa-copy">:copy:</i>**复制**图标。然后，返回到该网站并将其粘贴到**当前密码**字段中。

您可能已经记住了旧的密码，但养成复制和粘贴密码是一个好的习惯，因为一旦你的密码被替换成更强的密码，你将主要以这种方式登录网站。

5、返回到您的 Bitwarden 密码库并单击**密码**字段旁边的 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**图标。系统会询问您是否要覆盖当前密码，单击**是**以继续。

这将用随机生成的强密码替换您的**密码**值。从 `Fido1234` 这样的密码迁移到 `X@Ln@x9J@&u@5n##B` 可以阻止潜在的黑客入侵。

6、使用您之前使用的相同的 <i class="fa-copy">:copy:</i>**复制**图标复制您的新密码，然后点击**保存**按钮。

{% hint style="success" icon="lightbulb" %}
不用担心会覆盖您现有的密码！如果出现问题，Bitwarden 会为每个登录项目保存最近五个密码的[**密码历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#password-history)。
{% endhint %}

7、返回到刚才的网站，然后将您的强密码粘贴到**新密码**和**确认新密码**字段中。

8、**保存**密码更改后，您就完成了！

### 导入您的数据 <a href="#import-your-data" id="import-your-data"></a>

好消息！如果您将用户名和密码保存在网络浏览器或其他密码管理器中，则无需为每次登录重复以上过程。使用我们的专业导入指南之一来帮助您将数据直接传输到 Bitwarden：

* [LastPass](/docs/password-manager/import-and-export/import-guides/import-data-from-lastpass)
* [1Password](/docs/password-manager/import-and-export/import-guides/import-data-from-1password)
* [Dashlane](/docs/password-manager/import-and-export/import-guides/import-data-from-dashlane)
* [macOS & Safari](/docs/password-manager/import-and-export/import-guides/import-data-from-macos-and-safari)
* [Google Chrome](/docs/password-manager/import-and-export/import-guides/import-data-from-chrome)
* [Firefox](/docs/password-manager/import-and-export/import-guides/import-data-from-firefox)

## 保护您的密码库 <a href="#secure-your-vault" id="secure-your-vault"></a>

现在您的密码库中已充满了数据，让我们通过设置两步登录来采取一些措施来保护它。两步登录要求您在登录账户时使用额外的「令牌」验证您的身份，「令牌」通常是从不同的设备中获取。

两步登录有很多[可用的方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)，但对于免费 Bitwarden 账户，推荐的方式是使用像 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator) 这样的移动设备身份验证器 App：

1、在您的移动设备上下载 Bitwarden Authenticator。

2、在您的 Bitwarden 网页 App 中，从导航中选择**设置** → **安全** → **两步登录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2BsKs83g4cmiCUwxf2ad83/b2a90e85355f3d937aeb46139203737e/2024-12-02_10-54-31.png?w=1014&#x26;fm=avif" alt=""><figcaption><p>两步登录</p></figcaption></figure></div>

3、定位到**验证器 App** 选项然后选择**管理**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5GqQynIX94PhzJQ0tVW1aE/5dcea8d04c8a543daa7f96989f220756/2024-12-02_10-55-22.png?w=772&#x26;fm=avif" alt=""><figcaption><p>两步登录提供程序</p></figcaption></figure></div>

将提示您输入您的主密码以继续。

4、在您的移动设备上，打开 Bitwarden Authenticator 并点击 <i class="fa-plus">:plus:</i>按钮。

5、使用 Bitwarden Authenticator 扫描您的网页 App 中的二维码。扫描完成后，Bitwarden Authenticator 将显示一个 6 位数的验证码。

6、在网页 App 的对话框中输入 6 位数验证码，然后选择**启用**按钮。

7、选择**关闭**按钮返回两步登录界面，然后选择**查看恢复代码**按钮。

如果您丢失了移动设备，可以使用您的两步登录恢复代码。**这是确保您永远不会被锁定在密码库之外的关键步骤**，所以请不要跳过这一步！

8、输入您的主密码并选择**继续**按钮以获取您的恢复代码。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/64piqJsX7vN25To16iRFIp/09e977fae9485c0764f832c6bb4b4b04/2024-12-02_11-24-35.png?w=529&#x26;fm=avif" alt=""><figcaption><p>示例恢复代码</p></figcaption></figure></div>

以最适合您的方式保存您的恢复代码。信不信由你，将您的恢复代码打印出来并将其保存在安全的地方，是使代码不易被盗或无意被删除的最佳方法之一。

## 下一步 <a href="#next-steps" id="next-steps"></a>

### 注册高级版 <a href="#signup-for-premium" id="signup-for-premium"></a>

恭喜您掌握了 Bitwarden 的基础知识！我们希望每个人都能安全上网，因此我们很自豪能够免费提供您在这里学到的一切。

对于个人用户，我们提供 **1.65 美元/月**\~\~**（10 美元/年）**\~\~的高级版订阅，可解锁高级密码库功能，包括：

* 高级两步登录选项，例如 [Duo](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-duo) 和 [YubiKey 安全钥匙](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-yubikey)
* [加密文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)的存储空间
* 集成的[临时一次性密码 (TOTP) 身份验证器](/docs/password-manager/your-vault/security-tools/totp)
* 通过已信任的紧急联系人[紧急访问](/docs/account/emergency-access/about-emergency-access)您的密码库
* 报告密码和安全卫生的[密码库健康报告](/docs/password-manager/your-vault/security-tools/vault-health-reports)

要开始高级版订阅，请从**密码库**视图中选择**升级您的方案**按钮！

### 创建一个组织 <a href="#start-an-organization" id="start-an-organization"></a>

您是否需要与朋友、家人、团队或整个企业共享密码或其他密码库项目？

Bitwarden 组织可让您做到这一点。我们建议[通过创建一个免费的 2 人组织](/docs/admin-console/organizations-quick-start)来尝试从组织中共享密码的功能。

您测试了组织后，请查看我们的 [Bitwarden 定价](https://bitwarden.com/pricing/business/)页面，了解您可能感兴趣的不同付费组织类型。


# Password Manager 浏览器扩展

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/getting-started-browserext/)
{% endhint %}

Bitwarden 浏览器扩展将密码管理直接集成到您最喜爱的浏览器中。从您的浏览器市场或应用商店，或从 [Bitwarden 下载](https://bitwarden.com/download)页面下载 Bitwarden 浏览器扩展。

{% hint style="success" icon="lightbulb" %}
Safari 浏览器扩展与桌面 App 打包在一起，其可从 App Store 下载。[了解更多](/docs/password-manager/more/more-platforms/safari-web-extension)。
{% endhint %}

## 第一步 <a href="#first-steps" id="first-steps"></a>

让我们通过将一个新的登录项目添加到您的密码库来开始您的 Bitwarden 浏览器扩展之旅：

### 添加一个登录 <a href="#add-a-login" id="add-a-login"></a>

现在，让我们添加一个登录到您的新文件夹中。要创建新的登录：

1、导航到 <i class="fa-lock-keyhole">:lock-keyhole:</i>**密码库**选项卡，然后选择 <i class="fa-plus">:plus:</i>**添加**图标。

2、选择要创建的项目的类型（这里我们选择**登录**）。

3、输入这个新项目的基本信息：

* 帮助您轻松识别它的项目**名称**（例如 `Instagram Account`）
* 您的**用户名**。
* 您的当前**密码**（我们待会会用一个强大的密码来替换它）。

4、从[文件夹](/docs/password-manager/your-vault/vault-navigation/folders)下拉列表中选择一个文件夹。

{% hint style="success" icon="lightbulb" %}
如果您在工作场所使用 Bitwarden，则可以使用**所有者**下拉列表在您的组织内而不是在个人密码库中创建此项目。
{% endhint %}

5、在**网站 (URI)** 字段中，输入您登录账户的 URL（例如 `https://instaagram.com/login`）。

6、很好！选择**保存**以继续。

### 生成一个强密码 <a href="#generate-a-strong-password" id="generate-a-strong-password"></a>

现在，您已经保存了一个新的登录，让我们使用一个强密码替换您的密码来提高它的安全性：

1、在您的网页浏览器中，使用您现有的用户名和密码登录到此账户。我们将用一个更强的密码替换现有密码，但这也是练习自动填充的好机会！

要进行自动填充，请在网站登录页面打开 Bitwarden 浏览器扩展。如果该项目列在 <i class="fa-lock-keyhole">:lock-keyhole:</i>**密码库**视图的**自动填充建议**部分中，请点击该项目以自动填充它：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3tnagVMjtTufvRCrih3ctQ/9277f05114868cf0c37c069c565f2f95/Click_item_to_autofill.png?w=481&#x26;fm=avif" alt=""><figcaption><p>点击以自动填充</p></figcaption></figure></div>

2、登录后，找到可以更改密码的地方。

3、在网站的更改密码表单中，输入您的**当前密码**，您可以从 Bitwarden 使用 <i class="fa-copy">:copy:</i>**复制**图标来复制并粘贴该密码：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7y8WE9sWACC2KLASo9yASw/d1b1f78084ed20940ec76fc397b25ae8/Standard_copy_icon.png?w=484&#x26;fm=avif" alt=""><figcaption><p>标准复制图标</p></figcaption></figure></div>

4、填入旧密码后，在 Bitwarden 中打开登录项目并选择**编辑**。

5、在**密码框**中，选择 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**然后根据自己的喜好调整密码设置。您可以使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i> 图标，直到找到您喜欢的密码，然后选择**使用此密码**。从 `Fido1234` 更改为 `X@Ln@x9J@&u@5n##B` 可以阻止潜在的黑客攻击。

6、选择**保存**。

7、复制您的新密码并将其粘贴到网站上的**新密码**和**确认密码**字段中。

恭喜！您的登录现已安全且易于使用地保存在 Bitwarden 中了！

### 固定扩展 <a href="#pin-an-extension" id="pin-an-extension"></a>

固定浏览器扩展程序可确保每次打开浏览器时都可以轻松访问它。根据您使用的浏览器，此过程有所不同：

{% tabs %}
{% tab title="Chrome" %}
选择地址栏右侧的 <i class="fa-puzzle-piece">:puzzle-piece:</i>**扩展**图标，然后在扩展列表中选择 Bitwarden 旁边的**固定**图标：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4cwP0QDHWh01v1K8nMV0ma/88b4b36c5b3e9d1fccffe7552880c485/chrome_pin.png?w=340&#x26;fm=avif" alt=""><figcaption><p>Chrome 中的 Pin</p></figcaption></figure></div>
{% endtab %}

{% tab title="Firefox" %}
选择地址栏旁边的 <i class="fa-puzzle-piece">:puzzle-piece:</i>**扩展**图标，右键单击 Bitwarden 浏览器扩展，然后选择**固定到工具栏**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2O0RQxs4fr6tTKBAMOQcGy/a54ea16b59f933a209db9458c92358e6/firefox_pin.png?w=403&#x26;fm=avif" alt=""><figcaption><p>Firefox 中的 Pin</p></figcaption></figure></div>

您还可以从 Firefox 菜单中选择**查看** → **侧边栏** → **Bitwarden** 来激活永久 Bitwarden 侧边栏。

{% hint style="info" %}
如果您不想在浏览器启动时打开 Bitwarden 侧边栏，请从 Firefox 侧边栏的 Bitwarden 选项卡中选择**关闭侧边栏**。用户可能需要在每个活动的 Firefox 标签页上选择**关闭侧边栏**并重新启动 Firefox。
{% endhint %}
{% endtab %}

{% tab title="Safari" %}
右键单击工具栏中的任意位置，然后选择**自定义工具栏**打开一个拖放界面，以让您可以移动或移除工具栏中的图标：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3mD3G3rNMEUu24XBh6a3Kt/5217730380fe6ee6cd49f7c3820574ee/safari_pin.png?w=680&#x26;fm=avif" alt=""><figcaption><p>Safari 中的 Pin</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}

## 添加第二个账户 <a href="#add-a-second-account" id="add-a-second-account"></a>

您是否拥有多个 Bitwarden 账户，一个用于个人使用，一个用于工作？浏览器扩展可以同时登录五个账户！

要登录其他账户，请在浏览器扩展右上角选择当前已登录的账户：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7xbbMZ89zcTHz6ee0cA1MK/8d8972a6b995b3fd7367f248c9c60d69/screenshot_3.png?w=440&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展账户切换</p></figcaption></figure></div>

打开账户切换菜单后，选择 <i class="fa-plus">:plus:</i>**添加账户**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/343trVk3zLCF7Z12uA5wjO/ac2f56fc907372335f30d1dbf68116a1/screenshot_4.png?w=438&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展添加账户</p></figcaption></figure></div>

登录第二个账户后，您可以从同一菜单中快速切换它们，该菜单还将显示每个账户的密码库的当前状态（已锁定或已解锁）。如果您注销其中一个账户，它将从列表中移除。

{% hint style="info" %}
账户切换功能目前还不适用于 Safari 浏览器扩展。
{% endhint %}

## 下一步 <a href="#next-steps" id="next-steps"></a>

现在您已经掌握了基础知识，让我们深入了解您将经常使用的更多操作，**自动填充**和**自动保存**，以及三个推荐的设置步骤，更轻松地**解锁**密码库，将扩展**固定**到浏览器，以及**禁用浏览器内置**的密码管理器：

### 禁用内置的密码管理器 <a href="#disable-a-built-in-password-manager" id="disable-a-built-in-password-manager"></a>

大多数网络浏览器默认会自动保存您的密码，但专业人士普遍认为，相比 Bitwarden 等专用解决方案，[内置的密码管理器更容易受到攻击](https://www.wired.com/2016/08/browser-password-manager-probably-isnt-enough/)。了解更多有关[手动禁用浏览器内置密码管理器](/docs/password-manager/autofill/troubleshoot-autofill/disable-a-browsers-built-in-password-manager)的信息。

### 自动填充登录 <a href="#auto-fill-a-login" id="auto-fill-a-login"></a>

使用 Bitwarden 浏览器扩展有很多自动填充凭据的方法！最基本的方法是在网站登录页面打开 Bitwarden 浏览器扩展，然后在 <i class="fa-lock-keyhole">:lock-keyhole:</i>**密码库**选项卡中选择用于登录的自动填充建议的项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3tnagVMjtTufvRCrih3ctQ/9277f05114868cf0c37c069c565f2f95/Click_item_to_autofill.png?w=481&#x26;fm=avif" alt=""><figcaption><p>点击项目以自动填充</p></figcaption></figure></div>

请注意，当您在试图登录的网站上以保存了登录信息时，Bitwarden 浏览器扩展会覆盖一个通知气泡，报告您在该网站上的登录项目的数量。这些项目将显示在**自动填充建议**的顶部。您可以使用筛选器下拉菜单过滤建议中的内容和**所有项目**列表中的显示内容，这些下拉菜单可以通过 <i class="fa-sliders">:sliders:</i> 按钮显示或隐藏：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/12UsFuA2sxbUCBMIczJsxv/6376ae661b966e4698375c2af2c27c0d/Browser_extension_filters.png?w=480&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展筛选</p></figcaption></figure></div>

浏览器扩展项有好几种可供选择的自动填充选项，包括上下文菜单和键盘快捷键。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)。

### 自动保存登录 <a href="#auto-save-a-login" id="auto-save-a-login"></a>

Bitwarden 浏览器扩展提供一系列[浏览器内通知](/docs/password-manager/autofill/autofill-from/autosave-from-browser-extensions)，可将已解密的数据与您在登录、注册和类似网页表单中输入的数据进行比较。

当您看到此横幅时，选择**保存**以使用用户名、密码和 URI 添加新的登录项目，或更新现有登录项目。如果是新项目，还可以选择**选择文件夹...**，或在保存前**编辑**此项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4vsurEuH5deik26BWn4n1p/82757186b081890fbe92b4d73baeae53/screenshot_7.png?w=426&#x26;fm=avif" alt=""><figcaption><p>询问添加登录</p></figcaption></figure></div>

了解更多有关[使用浏览器扩展自动保存](/docs/password-manager/autofill/autofill-from/autosave-from-browser-extensions)的信息。

{% hint style="success" icon="lightbulb" %}
您知道使用 Bitwarden 浏览器扩展可以保存和自动填充通行密钥吗？[了解更多](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)关于通行密钥的信息。
{% endhint %}

### 使用 PIN 码或生物识别解锁 <a href="#unlock-with-pin-or-biometrics" id="unlock-with-pin-or-biometrics"></a>

要快速访问您的凭据，请设置 [PIN 码](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)或[生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)来解锁您的密码库。要设置一个 PIN 码：

1. 在浏览器扩展中，打开 <i class="fa-gear-complex">:gear-complex:</i>**设置**标签。
2. 在**账户安全**部分，选中**使用 PIN 码解锁**复选框。
3. 在输入框中输入所需的 PIN 码。PIN 码可以是任意字符（a-z、0-9、$、＃ 等）的组合。

{% hint style="success" icon="lightbulb" %}
**可选**：预先选中的**启动时要求生物识别**选项将要求您在浏览器重新启动时输入主密码而不是 PIN 码。如果您希望能够在浏览器重新启动时使用 PIN 码解锁，请取消选中此选项。
{% endhint %}

### 浏览器弹出窗口 <a href="#browser-pop-out" id="browser-pop-out"></a>

Bitwarden 浏览器扩展具有弹出窗口功能，允许您在使用网络浏览器时重新定位客户端。要弹出浏览器扩展，请选择下面截图中所示的图标：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1cbJy0jLBmSQmRumvYzVwp/a9e43f4c154686249056924eb3e56323/pop_out_screenshot.png?w=407&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展弹出窗口</p></figcaption></figure></div>

弹出时，浏览器扩展不会遵守您选择的[密码库超时](/docs/account/log-in-and-unlock/vault-timeout-options)设置。

### 将 Bitwarden 设为默认密码管理器 <a href="#make-bitwarden-your-default-password-manager" id="make-bitwarden-your-default-password-manager"></a>

Bitwarden 浏览器扩展有一个内置设置，可以禁用浏览器的默认密码管理器。要使用此设置：

1、导航至 Bitwarden 浏览器扩展中的 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡，然后选择**自动填充**。

2、点击启用**将 Bitwarden 设为默认密码管理器**。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5fyBdu5X6JCLu2UsaqYUO0/5cbd0a186251fe8916b5a01be1f3efb8/2026-07-14_14-59-21.png?w=1181&#x26;fm=avif" alt=""><figcaption><p>将 Bitwarden 设为默认密码管理器</p></figcaption></figure></div>

3、屏幕上会出现一个对话框，选择**允许**以授予 Bitwarden 更改您的浏览器设置的权限。


# Password Manager 移动 App

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/getting-started-mobile/)
{% endhint %}

Bitwarden 的移动 App 让您可以随身携带您的密码管理器。在任何设备上，从 [iOS App Store](https://bitwarden.com/download/apple-iphone-password-manager/) 或 Google Play Store，或访问 [get.bitwarden.com](https://get.bitwarden.com/) 以下载 Bitwarden。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/53OzJZ4klYWemxUepHMtq4/5ab47331f033259bd2e82817a99e992f/2025-01-21_15-22-10.png?w=714&#x26;fm=avif" alt=""><figcaption><p>Android 和 iOS 上的 Bitwarden</p></figcaption></figure></div>

## 第一步 <a href="#first-steps" id="first-steps"></a>

让我们通过将一个新的登录项目添加到您的密码库并确保其安全且易于查找来开始您的 Bitwarden 移动 App 之旅：

### 创建一个文件夹 <a href="#create-a-folder" id="create-a-folder"></a>

文件夹是确保您在需要使用时始终可以找到密码库项目的好方法。要创建一个文件夹：

1、选择 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡。

2、选择**密码库**，然后从设置列表中点击**文件夹**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6IwzXSJHGmSeU7oIy4z8kZ/95620b58758e50fa0e8e22a65f2bfa15/2025-01-21_15-26-07.png?w=713&#x26;fm=avif" alt=""><figcaption><p>移动端上的文件夹</p></figcaption></figure></div>

3、选择 <i class="fa-plus">:plus:</i>**添加**图标。

4、给您的新文件夹起个名字（例如 `Social Media`），然后选择**保存**。

### 添加一个登录项目 <a href="#add-a-login" id="add-a-login"></a>

现在，让我们添加一个登录项目到您的新文件夹中。要创建新的登录项目：

1、导航到 <i class="fa-lock-keyhole">:lock-keyhole:</i>**我的密码库**选项卡，然后选择 <i class="fa-plus">:plus:</i>**添加**图标。

2、选择要添加的项目的类型（这里我们选择**登录**）：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4QMufMJAsQn5qN9XY3syyL/decdef6cfc89e8af57c30e17ddeae864/2025-01-21_15-27-28.png?w=714&#x26;fm=avif" alt=""><figcaption><p>移动端添加登录</p></figcaption></figure></div>

3、为这个项目输入基本信息：

* 帮助您轻松识别它的**名称**（例如 `Instagram Account`）
* 您的**用户名**。
* 您的当前**密码**（我们待会会用一个强大的替换它）。

4、选择 <i class="fa-plus">:plus:</i>**新增 URI** 按钮，然后输入您登录账户的 URL（例如 `https://https://www.instagram.com/accounts/login/`）。

5、从文件夹下拉列表中选择一个**文件夹**，如果您按照我们的示例进行操作，请选择我们刚刚创建的 **Social Media** 文件夹！

6、很好！选择**保存**以继续。

### 生成一个强密码 <a href="#generate-a-strong-password" id="generate-a-strong-password"></a>

现在，您已经保存了一个新的登录项目，让我们使用一个强密码替换您的密码来提高它的安全性：

1、打开网页浏览器或移动 App，然后使用您现有的用户名和密码登录您的账户。登陆后，找到**更改您的密码**页面。

2、在**更改您的密码**页面，输入您的**当前密码**，您可以从 Bitwarden 复制并粘贴该密码。

3、返回 Bitwarden，选择登录项目然后在 iOS 上点击**编辑**或在 Android 上点击 <i class="fa-pen">:pen:</i>。

4、在密码框中，选择 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**然后**确认**以覆盖您的旧密码。

这将使用随机生成的强密码替换您的密码。从 `Fido1234` 更改为 `X@Ln@x9J@&u@5n##B` 可以阻止潜在的黑客攻击。

5、选择**保存**。

6、复制您的新密码并将其粘贴到另一个应用程序的**新密码**和**确认密码**字段中。

恭喜！您的登录项目现已安全且易于使用地保存在 Bitwarden 中了！

### 添加第二个账户 <a href="#add-a-second-account" id="add-a-second-account"></a>

您是否有多个 Bitwarden 账户？例如一个用于个人使用，一个用于工作。移动 App 可以一次性同时登录 5 个账户！

要登录第二个账户，请从移动 App 的顶部菜单栏选择当前已登录的账户，然后选择 <i class="fa-plus">:plus:</i>**添加账户**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/56xAZhiS6wZqKktMlFwbVn/9af5d0ce782af44fc48ebfd8057ddc4c/2025-01-21_14-58-15.png?w=713&#x26;fm=avif" alt=""><figcaption><p>移动端账户切换</p></figcaption></figure></div>

登录第二个账户后，您可以从同一菜单中快速切换它们，该菜单还将显示每一个账户的密码库的当前状态（*已锁定*或*已解锁*）。如果您注销其中一个账户，它将从此列表中移除。

## 下一步 <a href="#next-steps" id="next-steps"></a>

现在您已经掌握了基础知识，让我们深入了解 Bitwarden 移动 App 的一些更强大的功能：

{% tabs %}
{% tab title="Android" %}

### 设置自动填充 <a href="#setup-auto-fill" id="setup-auto-fill"></a>

设置自动填充以从您的 Android 设备自动输入登录信息到网页浏览器（如 Chrome）或其他 App 中。

1、在您的 Android Bitwarden App 中，点击 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡。

2、点击**自动填充**选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5Othw4YuSWmQbV1pmkvVxd/1d8fcf282bee1d729abe88570e7e650f/2025-01-21_15-29-52.png?w=346&#x26;fm=avif" alt=""><figcaption><p>Android 自动填充选项</p></figcaption></figure></div>

3、切换自动填写服务选项。您将自动跳转到 Android 设置界面。

4、在**自动填充服务**列表中，点击 **Bitwarden**。

系统会提示您确认信任 Bitwarden。点击**确定**将让 Bitwarden 读取屏幕上的内容，以了解何时提供自动填充服务。更多信息，请参阅 [Android 上的自动填充登录](/docs/password-manager/autofill/autofill-from/autofill-from-android)。

并将其开启。绿色的`已启用`信息表明自动填充处于活动状态。\
切换后，您可能需要根据您可用的或已启用的自动填充选项来更改某些 Android 本地设置。有关更多信息，请参阅 [Android 上的自动填充登录](/docs/password-manager/autofill/autofill-from/autofill-from-android)。

### 从移动 App 启动 <a href="#launch-from-mobile-apps" id="launch-from-mobile-apps"></a>

您可以在任何具有有效 URI 的密码库项目中选择 <i class="fa-arrow-up-right-from-square">:arrow-up-right-from-square:</i>**启动**按钮，以直接从 Bitwarden 启动网站。如果你不熟悉 URI 的使用，请参阅 [URI 的使用](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2PsCaLjOAe6WEfnwMkYG0P/be1fde317404835cba1e600244922d98/2025-01-21_15-32-37.png?w=713&#x26;fm=avif" alt=""><figcaption><p>从移动端启动</p></figcaption></figure></div>

### 使用生物识别解锁 <a href="#unlock-with-biometrics" id="unlock-with-biometrics"></a>

用生物识别技术解锁 Bitwarden，可以无缝访问你的密码库。如果你还没有在 Android 设备上设置[指纹解锁](https://support.google.com/nexus/answer/6285273?hl=en)或[面部解锁](https://support.google.com/pixelphone/answer/9517039?hl=en)，你需要通过 Android 的 <i class="fa-gear-complex">:gear-complex:</i>**设置** App 进行设置。

1、在您的 Android Bitwarden App 中，点击屏幕底部的 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡。

2、点击**账户安全**。

3、点击**使用生物识别解锁**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7FDRtrf7LkC22dzf3ErsR4/3c176fd1ddb2a3d188817d7e1f795adf/2025-01-21_15-16-44.png?w=714&#x26;fm=avif" alt=""><figcaption><p>移动端生物识别解锁</p></figcaption></figure></div>

**4、**&#x6839;据您的选择，系统将要求您使用指纹或面部进行验证。&#x20;

启用后，您就可以使用您刚选择的生物识别方式来打开您的 Bitwarden 应用程序，或者自动填写登录信息。

### 使用自动填充登录 <a href="#login-using-auto-fill" id="login-using-auto-fill"></a>

当您已经设置了[自动填充](/docs/password-manager/getting-started/getting-started-mobile#setup-auto-fill)和[生物识别](/docs/password-manager/getting-started/getting-started-mobile#unlock-with-biometrics)，使用 Bitwarden 登录 App 或网站就变得很简单了。

1、点击 App 或网站中的电子邮箱/用户名或密码输入框。

2、根据您的设备使用的自动填充选项，点击可用的叠加层：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3xbRUA76m4qpEyQ1b7msLo/b294ddfaae21f0e24d5e923266092df0/autofill-android-2.png?w=555&#x26;fm=avif" alt=""><figcaption><p>Android 自动填充种类</p></figcaption></figure></div>

3、将提示验证您的面部或指纹。如果您未使用[生物识别](/docs/password-manager/getting-started/getting-started-mobile#unlock-with-biometrics)，请输入您的主密码。

4、如果您已经使用 [URI 字段](/docs/password-manager/getting-started/getting-started-mobile#create-new-items)将登录信息连接到这个网站或 App，该登录将出现在此窗口中。如果没有，请点击 <i class="fa-sistrix">:sistrix:</i>**搜索**来查找。

点击此登录项目，会自动将您的电子邮箱/用户名和密码输入框中并登录！
{% endtab %}

{% tab title="iOS" %}

### 设置自动填充 <a href="#setup-auto-fill" id="setup-auto-fill"></a>

设置自动填充以从您的 iOS 设备自动输入登录信息到网页浏览器（如 Chrome）或其他 App 中。

1. 在 iOS 的 Home 界面，点击 <i class="fa-gear-complex">:gear-complex:</i>**设置** App。
2. 在设置菜单中，点击**密码**。
3. 点击**密码选项**。
4. 点击**自动填充密码**开关。绿色表示自动填充处于激活状态。
5. 在**密码和通行密钥来源：**&#x5217;表中，选择 **Bitwarden**。复选标记 (<i class="fa-check">:check:</i>) 表示已选择 Bitwarden。

创建新的登录时，请确保在 [URI 字段](#add-a-login)中输入网站地址以将其用于自动填充。

### 从移动 App 启动 <a href="#launch-from-mobile-apps" id="launch-from-mobile-apps"></a>

您可以直接从 Bitwarden 移动 App 启动一个网站，方法是在任何具有有效 URI 的密码库项目中选择 <i class="fa-arrow-up-right-from-square">:arrow-up-right-from-square:</i>**启动**按钮。如果您还不熟悉 URI 的使用，请参阅 [URI 的使用](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2PsCaLjOAe6WEfnwMkYG0P/be1fde317404835cba1e600244922d98/2025-01-21_15-32-37.png?w=713&#x26;fm=avif" alt=""><figcaption><p>从移动端启动</p></figcaption></figure></div>

### 使用生物识别解锁 <a href="#unlock-with-biometrics" id="unlock-with-biometrics"></a>

用生物识别技术解锁 Bitwarden，可以无缝访问您的密码库。如果您还没有在 iOS 设备上设置触控 ID 或面容 ID，需要先通过 iOS 的 <i class="fa-gear-complex">:gear-complex:</i>**设置** App 进行设置。

1、在您的 iOS Bitwarden App 中，点击屏幕底部的 <i class="fa-gear-complex">:gear-complex:</i>**设置**标签。

2、点击**账户安全**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7FDRtrf7LkC22dzf3ErsR4/3c176fd1ddb2a3d188817d7e1f795adf/2025-01-21_15-16-44.png?w=714&#x26;fm=avif" alt=""><figcaption><p>移动端生物识别解锁</p></figcaption></figure></div>

3、根据您的设备的可用功能，点击：

* **使用触控 ID 解锁**
* **使用面容 ID 解锁**

4、根据您的选择，将要求您使用指纹或面部进行验证。切换按钮会填满，表示某个选项处于激活状态。

启用后，您就可以使用您刚选择的生物识别方式来打开您的 Bitwarden，或者自动填充登录信息。

### 使用自动填充登录 <a href="#login-using-auto-fill" id="login-using-auto-fill"></a>

当您已经设置了[自动填充](https://help.bitwarden.in/getting-started/get-started-with-mobile-apps#setup-auto-fill-1)和[生物识别](https://help.bitwarden.in/getting-started/get-started-with-mobile-apps#unlock-with-biometrics-1)，使用 Bitwarden 登录 App 或网站就变得很简单了。

1、点击 App 或网站中的电子邮箱/用户名或密码输入框。

2、在您的键盘上方，点击**密码**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4DNAawWIUOKKVUN0cMdqLI/6fd8e01e004fdefcb72b60380ff8ee64/autofill-ios.png?w=300&#x26;fm=avif" alt=""><figcaption><p>iOS 中点击密码</p></figcaption></figure></div>

3、将提示验证您的面容 ID 或触控 ID。如果您未使用[生物识别](https://help.bitwarden.in/getting-started/get-started-with-mobile-apps#unlock-with-biometrics-1)，请输入您的主密码。

4、如果您已经使用 [URI 字段](/docs/password-manager/getting-started/getting-started-mobile#create-new-items)将登录信息连接到这个网站或 App，该登录将出现在此窗口中。如果没有，请点击 <i class="fa-sistrix">:sistrix:</i>**搜索**来查找。

点击此登录项目，会自动将您的电子邮箱/用户名和密码输入框中并登录！
{% endtab %}
{% endtabs %}


# Password Manager 桌面 App

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/getting-started-desktop)
{% endhint %}

Bitwarden 的桌面 App 将完整的密码库体验从浏览器直接带入您的桌面。桌面 App 一次支持最多 5 个已登录的账户，以便可以随时在个人账户和工作账户之间轻松切换（[了解更多](/docs/account/log-in-and-unlock/account-switching)）。

在 <i class="fa-lock-keyhole">:lock-keyhole:</i>**我的密码库**视图中，您可以浏览您的所有项目，包括您所属的组织拥有的项目。使用密码库下拉列表来筛选**所有密码库**、**我的密码库**和任何组织密码库中的项目。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/79qrrbQ4Oi7ZGUnSrE3VpZ/9e8a86298c65c028e9280a36d0bcb99f/2026-01-28_09-42-19.png?w=1001&#x26;fm=avif" alt=""><figcaption><p>桌面端的 Password Manager</p></figcaption></figure></div>

## 第一步 <a href="#first-steps" id="first-steps"></a>

让我们通过将一个新的登录项目添加到您的密码库并确保其安全且易于查找来开始您的 Bitwarden 桌面 App 之旅：

### 创建文件夹 <a href="#create-a-folder" id="create-a-folder"></a>

[文件夹](/docs/password-manager/your-vault/vault-navigation/folders)是确保您在需要使用时始终可以找到密码库项目的好方法。要创建一个文件夹：

1. 在桌面 App 的第一列中，选择**文件夹**旁边的 <i class="fa-plus">:plus:</i>**添加**图标。
2. 给您的新文件夹起个名字（例如 `Social Media`），然后选择 <i class="fa-arrow-down-to-bracket">:arrow-down-to-bracket:</i>**保存**。

### 添加登录 <a href="#add-a-login" id="add-a-login"></a>

现在，让我们添加一个登录到您的新文件夹中。要创建新的登录项目：

1、在中间列中，选择 <i class="fa-plus">:plus:</i>**添加**。添加项目面板将显示在第三列中。

2、选择要添加的项目的类型（这里我们选择**登录**）。

3、输入这个新项目的基本信息：

* 帮助您轻松识别它的**名称**（例如 `X.com Account`）
* 您的**用户名**。
* 您的当前**密码**（我们待会将用一个强大的替换它）。

4、选择 <i class="fa-plus">:plus:</i>**新建 URI** 按钮，然后输入您登录账户的 URL（例如 `https://x.com/i/flow/login`）。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5jf74Y0xH5LXouxuBLfER0/02aca3fb33feb85d0a05ecbd06e00ba5/x.comlogin_close_up.png?w=773&#x26;fm=avif" alt=""><figcaption><p>X.com 登录 URI</p></figcaption></figure></div>

5、从文件夹下拉列表中选择一个文件夹，如果您按照我们的示例进行操作，请选择我们刚刚创建的 **Social Media** 文件夹！

6、很好！选择 <i class="fa-arrow-down-to-bracket">:arrow-down-to-bracket:</i>**保存**以完成。

{% hint style="success" icon="lightbulb" %}
您还可以从桌面 App 直接将数据导入到 Bitwarden。[了解如何操作](/docs/password-manager/import-and-export/import-data#zhuo-mian-duan-cheng-xu)。
{% endhint %}

### 生成强密码 <a href="#generate-a-strong-password" id="generate-a-strong-password"></a>

现在，您已经保存了一个新的登录项目，让我们使用一个强密码替换您的密码来提高它的安全性：

1、打开网页浏览器并使用您现有的用户名和密码登录该账户。在该账户中，找到可以**更改您的密码**的位置。

2、在**更改您的密码**表单上，输入您的**当前密码**，您可以使用 <i class="fa-copy">:copy:</i>**复制**图标从 Bitwarden 复制并粘贴该密码。

3、在 Bitwarden 中，在你的项目上选择 <i class="fa-pen">:pen:</i>**编辑**。

4、在密码框中，选择 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**然后**确认**以覆盖您的旧密码。

这将使用随机生成的强密码替换您的密码。从 `Fido1234` 更改为 `X@Ln@x9J@&u@5n##B` 可以阻止潜在的黑客攻击。

5、选择 <i class="fa-arrow-down-to-bracket">:arrow-down-to-bracket:</i>**保存**。

6、使用之前使用的 <i class="fa-copy">:copy:</i>**复制**图标复制新的密码，然后将新的密码粘贴到网页浏览器的**新密码**和**确认新密码**字段中。

7、完成后，在网页浏览器中选择**保存**。

恭喜！您的登录项目现已安全且易于使用地保存在 Bitwarden 中了！

### 添加第二个账户 <a href="#add-a-second-account" id="add-a-second-account"></a>

您是否有多个 Bitwarden 账户？例如一个用于个人使用，一个用于工作。桌面 App 可以一次性同时登录 5 个账户！

要登录第二个账户，请从桌面 App 的右上角选择当前已登录的账户，然后选择 <i class="fa-plus">:plus:</i>**添加账户**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7fpUmakpNIByzoWQa1cU8L/bd9e35756805bba8bd35bc43c7630aaf/2026-04-23_09-27-28.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面端账户切换</p></figcaption></figure></div>

登录第二个账户后，您可以从同一菜单中快速切换它们，该菜单还将显示每一个账户的密码库的当前状态（*已锁定*或*已解锁*）。如果您注销其中一个账户，它将从此列表中移除。

## 下一步 <a href="#next-steps" id="next-steps"></a>

现在您已经掌握了基础知识，您可以自定义您的桌面 App 以完全按照您希望的方式工作：

{% tabs %}
{% tab title="Windows" %}

### 设置您的偏好设置 <a href="#set-your-preferences" id="set-your-preferences"></a>

要设置您的首选项，请从菜单栏中选择**文件** → **设置**。您会注意到三个部分：**安全**、**偏好设置**和 **App 设置**。

{% hint style="success" icon="lightbulb" %}
**安全**和**偏好设置**适用于[活动账户](#add-a-second-account)，应为每个账户单独设置。**App 设置**适用于所有账户。
{% endhint %}

#### 使用生物识别解锁 <a href="#unlock-with-biometrics" id="unlock-with-biometrics"></a>

桌面 App 最受欢迎的设置之一是[使用生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)，它允许使用带 PIN 的 [Windows Hello](https://docs.microsoft.com/zh-cn/windows-hardware/design/device-experiences/windows-hello)、面部识别或[其他符合 Windows Hello 生物识别要求的硬件](https://docs.microsoft.com/zh-cn/windows-hardware/design/device-experiences/windows-hello-biometric-requirements)无缝访问您的桌面 App。要设置生物识别解锁：

{% hint style="success" icon="lightbulb" %}
Windows 用户可能需要安装 [Microsoft Visual C ++ Redistributable](https://support.microsoft.com/zh-cn/topic/%E6%9C%80%E6%96%B0%E6%94%AF%E6%8C%81%E7%9A%84-visual-c-%E4%B8%8B%E8%BD%BD-2647da03-1eea-4433-9aff-95f26a218cc0)，然后才能在桌面偏好设置中开启 Windows Hello。
{% endhint %}

1、在您的计算机上启用 Windows Hello。

2、如果您的计算机支持并已启用 Windows Hello，在**安全**部分中将显示**使用 Windows Hello 解锁**选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/HQYTF4l5WyPbeTMHhhDnN/a1c42606ebb2144f88da3cbf975ec198/app_settings_windows.png?w=1312&#x26;fm=avif" alt=""><figcaption><p>Windows 解锁选项</p></figcaption></figure></div>

选中**使用 Windows Hello 解锁**选项以继续。您的计算机将提示您输入您的生物特征。

3、启用后，使用**使用 Windows Hello 解锁**按钮来解锁您的密码库。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/JSmueUxWjUGxQK0bA716O/f6bcfa6ec4523b8080a77e418e1eae8e/2025-08-13_11-20-59.png?w=939&#x26;fm=avif" alt=""><figcaption><p>使用 Windows Hello 解锁</p></figcaption></figure></div>

**安全**设置是针对每一个账户设置的，因此如果您想为另一个账户启用生物识别解锁，您需要再次执行这些步骤！

#### 自动启动 Bitwarden <a href="#start-bitwarden-automatically" id="start-bitwarden-automatically"></a>

另一个有用的功能是在启动计算机时始终启动 Bitwarden。要启用此功能，请导航到 **App 设置**部分并勾选**登录时自动启动**复选框。

与生物识别不同，此设置适用于所有已登录的账户！
{% endtab %}

{% tab title="macOS" %}

### 设置您的偏好设置 <a href="#set-your-preferences" id="set-your-preferences"></a>

要设置您的偏好设置，请从菜单栏中选择**Bitwarden** → **设置**。您会注意到三个部分：**安全**、**偏好设置**和 **App 设置**。

{% hint style="success" icon="lightbulb" %}
**安全**和**偏好设置**适用于[活动账户](#add-a-second-account)，应为每个账户单独设置。**App 设置**适用于所有账户。
{% endhint %}

#### 使用生物识别解锁 <a href="#unlock-with-biometrics" id="unlock-with-biometrics"></a>

桌面 App 最受欢迎的设置之一是[使用生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)，它允许使用**触控 ID** 技术无缝访问您的桌面 App。要设置生物识别解锁：

1、在您的计算机上启用触控 ID。请参阅 Apple 的[触控 ID 文档](https://support.apple.com/en-us/HT207054)以获取帮助。

2、如果您的计算机支持并已启用了触控 ID，在**安全**部分中将显示**使用触控 ID 解锁**选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3O1If6IchE83Qb8ee0mYqx/f212b79cde0811dfc7ecc1f50e9b3826/App_settings_update_macOS.png?w=656&#x26;fm=avif" alt=""><figcaption><p>macOS 解锁选项</p></figcaption></figure></div>

选中**使用触控 ID 解锁**选项以继续。您的计算机将提示您输入您的指纹。

3、启用后，使用**使用触控 ID 解锁**按钮来解锁您的密码库。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/MPQwBfgcoTZJvan99sZCZ/e7a2305ffdc24af1fc08adf466463841/mac_unlock_with_touch_id.png?w=431&#x26;fm=avif" alt=""><figcaption><p>使用触控 ID 解锁</p></figcaption></figure></div>

**安全**设置是针对每一个账户设置的，因此如果您想为另一个账户启用生物识别解锁，您需要再次执行这些步骤！

#### 自动启动 Bitwarden <a href="#start-bitwarden-automatically" id="start-bitwarden-automatically"></a>

另一个有用的功能是在启动计算机时始终启动 Bitwarden。要启用此功能，请导航到 **App 设置**部分并勾选**登录时自动启动**复选框。

与生物识别不同，此设置适用于所有已登录的账户账户！
{% endtab %}

{% tab title="Linux" %}

### Snap 预安装说明 <a href="#snap-post-installation-instructions" id="snap-post-installation-instructions"></a>

当您登录到应用程序时，Bitwarden Password Manager 桌面 App 使用安全存储来持久保存身份验证令牌。**如果您使用 Snap 安装的桌面 App**，则需要通过以下方式允许 App 访问安全存储：

1. 在所有发行版上，运行命令 `sudo snap connect bitwarden:password-manager-service` 。
2. 如果您已经登录到 Password Manager 桌面 App，请注销所有账户然后重新登录。

### 设置您的偏好设置 <a href="#set-your-preferences" id="set-your-preferences"></a>

要设置您的偏好设置，请从菜单栏中选择**文件** → **设置**。您会注意到三个部分：**安全**、**偏好设置**和 **App 设置**。

{% hint style="success" icon="lightbulb" %}
**安全**和**偏好设置**适用于[活动账户](#add-a-second-account)，应为每个账户单独设置。**App 设置**适用于所有账户。
{% endhint %}

#### 使用生物识别解锁 <a href="#unlock-with-biometrics" id="unlock-with-biometrics"></a>

桌面 App 最受欢迎的设置之一是[使用生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)，它允许无缝访问您的桌面 App。支持来自 `AppImage`、`Deb` 和 `.rpm` 软件包类型的 Bitwarden 桌面 App。此外，请确认您的系统有 polkit 代理和机密服务（如 GNOME-Keyring）。要启用生物识别解锁：

1、在您的计算机上启用系统身份验证。

2、在 Bitwarden 桌面 App 的**安全**部分，如果您的计算机支持并启用了系统身份验证，则会出现**使用系统身份验证解锁**选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2AMdLd9zqVZwkDMfS1ZW00/110ef66157f378b7c84748710d0ffd2c/unlock_options_linux.png?w=654&#x26;fm=avif" alt=""><figcaption><p>使用系统身份验证解锁</p></figcaption></figure></div>

选中**使用系统身份验证解锁**选项以继续。您的计算机将提示您输入您的验证。

3、启用后，在解锁界面使用**使用系统身份验证解锁**按钮来解锁您的密码库。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6UIFh90LrxZzgrbacuMw3o/ef9b39a24775d098f1ad9825094206f0/Aug_15_Screenshot_from_Bitwarden__1_.png?w=432&#x26;fm=avif" alt=""><figcaption><p>使用系统身份验证解锁密码库</p></figcaption></figure></div>

**安全**设置是针对每一个账户设置的，因此如果您想为另一个账户启用生物识别解锁，您需要再次执行这些步骤！

#### 自动启动 Bitwarden <a href="#start-bitwarden-automatically" id="start-bitwarden-automatically"></a>

另一个有用的功能是在启动计算机时始终启动 Bitwarden。要启用此功能，请导航到 **App 设置**部分并勾选**登录时自动启动**复选框。

与生物识别不同，此设置适用于所有已登录的账户！
{% endtab %}
{% endtabs %}


# 您的密码库


# 密码库项目


# 密码库项目

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/managing-items/)
{% endhint %}

## 项目类型 <a href="#item-types" id="item-types"></a>

Bitwarden 能安全存储的不仅仅是用户名和密码。您可以在密码库中存储五种类型的项目：

* **登录**：用于存储用户名和密码的组合，以便在[浏览器扩展](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)、[iOS App](/docs/password-manager/autofill/autofill-from/autofill-from-ios) 和 [Android App](/docs/password-manager/autofill/autofill-from/autofill-from-android) 上轻松自动填充。登录项目还可以存储[通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)，对于高级用户，还可以存储[验证码](/docs/password-manager/your-vault/security-tools/totp)。
* **支付卡**：用于存储信用卡或借记卡信息，以便在线结账时[在浏览器扩展和 Android App 上轻松自动填充](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities)。
* **身份**：用于存储身份信息（例如邮寄地址），以便在各种在线表单提交期间[在浏览器扩展和 Android App 上轻松自动填充](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities)。
* **安全笔记**：用于存储您想要保护的任何类型的信息的自由格式文本。
* **SSH 密钥**：使用 Bitwarden [作为 SSH 代理](/docs/password-manager/developer-tools/ssh/ssh-agent)。

## 添加项目 <a href="#add-items" id="add-items"></a>

{% hint style="success" icon="lightbulb" %}
本文将介绍如何手动添加密码库项目，但对于许多用户来说，Bitwarden 建议从大多数密码管理器或网页浏览器直接[导入项目](/docs/secrets-manager/import-export/import-data)到您的密码库中。
{% endhint %}

您可以从任何 Bitwarden App 添加密码库项目：

{% tabs %}
{% tab title="网页 App" %}
选择 <i class="fa-plus">:plus:</i>**新增**按钮然后选择要创建的项目类型：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5kGYpHHu4197INxX5kOetu/c1aa36b3847c9824b81466837229ec7d/webappnewtest.png?w=1327&#x26;fm=avif" alt=""><figcaption><p>添加项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
选择 <i class="fa-plus">:plus:</i>**新增**按钮然后选择要创建的项目类型：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3CGG1jYRfgQqi5UlWuwliO/c95b2da5c9e64564c1aa7842207a3a6f/extnew1.png?w=1118&#x26;fm=avif" alt=""><figcaption><p>添加项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
选择 <i class="fa-plus">:plus:</i>**新增**按钮然后选择要创建的项目类型：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/cMVnILAl9uoih1iTqIHx9/19168711ae327ea490fa51c8d9c27ff3/mobilenew1.png?w=961&#x26;fm=avif" alt=""><figcaption><p>添加项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7xia34eJyx1K8Gy8IXajQ7/af2b2ef342350a68b000c405ee698ab4/2026-04-23_09-58-10.png?w=800&#x26;fm=avif" alt=""><figcaption><p>添加项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="CLI" %}
使用 `create` 命令添加新的项目。请参阅 [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)以获取更多信息。
{% endtab %}
{% endtabs %}

## 复制项目凭据 <a href="#copy-item-credentials" id="copy-item-credentials"></a>

要复制项目的详细信息：

{% tabs %}
{% tab title="网页 App" %}
将鼠标悬停在项目上，然后选择项目旁边的 <i class="fa-copy">:copy:</i>**复制图标**。此时将出现一个菜单，您可以在其中选择**复制用户名**或**复制密码**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/45nnuRuxCcsbYiqG0q1kJM/db8893edf1915ee8bade94075fa5bf2d/Copy_item.png?w=1284&#x26;fm=avif" alt=""><figcaption><p>在网页 App 中复制</p></figcaption></figure></div>

您还可以前往**设置** → **外观**，勾选**在密码库中显示快速复制操作**。之后，当您将鼠标悬停在某个项目上时，就会出现图标，方便您将用户名、密码或验证码复制到剪贴板：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/71DuuvJA5TlEBrS28GwaR3/76fe8821f920a53e2ef3420a0f8ea591/Quick_copy_in_web_app.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>在网页 App 中快速复制</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
Bitwarden 浏览器扩展提供了多种[自动填充](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)方法，包括[复制按钮](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#copy-credentials)。
{% endtab %}

{% tab title="移动端" %}
您可以使用 [iOS App](/docs/password-manager/autofill/autofill-from/autofill-from-ios) 和 [Android App](/docs/password-manager/autofill/autofill-from/autofill-from-android) 自动填充项目。
{% endtab %}

{% tab title="桌面端" %}
打开项目，然后选择字段旁边的 <i class="fa-copy">:copy:</i>**复制图标**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7KlGYgWWe0BdkY5UQFerwN/91cca24b2fc1c6bb6a0ea138bad05f0d/Copy_credential_on_desktop.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>在桌面端复制凭据</p></figcaption></figure></div>
{% endtab %}

{% tab title="CLI" %}
使用 `get` 命令检索对象，例如用户名或密码。请参阅 [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli#get)以获取更多信息。。
{% endtab %}
{% endtabs %}

## 管理项目 <a href="#manage-items" id="manage-items"></a>

您可以从任何 Bitwarden App 管理您的密码库项目：

### 编辑 <a href="#edit" id="edit"></a>

要编辑项目：

{% tabs %}
{% tab title="网页 App" %}
选择您要编辑的项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单：

{% hint style="success" icon="lightbulb" %}
您也可以右键单击该项目来调出相同的菜单。
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5FmC9ha8GQ4IKU8UM1ra4x/d470974c62468ba565e58ca1917db0b1/webnew1.png?w=1150&#x26;fm=avif" alt=""><figcaption><p>编辑或删除项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
选择一个项目将其打开，然后选择**编辑**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2q1EZnISzEG3i8iU4vTKj6/b13c46c27a7fb896f31f81485859459f/extnew4.png?w=1118&#x26;fm=avif" alt=""><figcaption><p>编辑或删除项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
选择要编辑的项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单，然后选择**编辑**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/357lJe8JKMXNKEhYKUDn4u/31d5f1f811eb35b8b142f9a6f751dae2/2025-11-10_12-05-53.png?w=961&#x26;fm=avif" alt=""><figcaption><p>编辑项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}
选择一个项目将其打开，然后选择 <i class="fa-pen">:pen:</i>编辑图标：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6Y4kK7J9aLmo9SDY7Ne8VE/63bbce3c7f3e0f99d6c0783c0b367a16/2026-04-23_10-02-08.png?w=800&#x26;fm=avif" alt=""><figcaption><p>编辑项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="CLI" %}
使用 `edit` 命令编辑项目。请参阅 [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)以获取更多信息。
{% endtab %}
{% endtabs %}

### 归档 <a href="#archive" id="archive"></a>

归档是一个整理密码库的有用工具。归档的项目不会出现在搜索结果和自动填充建议中，但会包含在导出中。归档：

* 适用于所有付费方案，包括高级用户和付费组织的成员。如果订阅曾经中断，用户**不会**失去对已归档项目的访问权限。
* 适用于组织项目和个人项目。与[收藏](/docs/password-manager/your-vault/vault-navigation/favorites)类似，某个用户选择归档项目，并不会为其他有访问权限的用户归档该项目。
* **不会**从报告或导出中移除项目。

要归档项目：

{% tabs %}
{% tab title="网页 App" %}
1、选择您想要归档的项目，然后使用操作栏选择**归档**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1aRyGxLdpcvGF3fM2Bbd17/d67d2ef7eb7904d6fe02d062d736d980/Archive_with_the_web_app.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>使用网页 App 归档</p></figcaption></figure></div>

2、在对话框中选择**归档**来确认您的选择。

#### 取消归档 <a href="#unarchive" id="unarchive"></a>

在网页 App 中，从您的密码库筛选器中选择**归档**，以查看已归档的项目，然后从操作栏选择**取消归档**。
{% endtab %}

{% tab title="浏览器扩展" %}
1、使用您想要归档的项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单，然后选择**归档**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/40gA9zgbeBjx2gw77H61kM/08e93903af859aa75bbdd277b4098a90/2026-01-27_10-40-25.png?w=911&#x26;fm=avif" alt=""><figcaption><p>使用浏览器扩展归档</p></figcaption></figure></div>

2、在对话框中选择**归档**来确认您的选择。

#### 取消归档 <a href="#unarchive" id="unarchive"></a>

在浏览器扩展中，导航至**设置** → **密码库选项** → **归档**，以查看已归档的项目，然后使用 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单选择**取消归档**，即可将项目恢复到正常的密码库状态。
{% endtab %}

{% tab title="移动端" %}
使用您想要归档的项目的 <i class="fa-ellipsis">:ellipsis:</i>选项菜单，然后选择**归档**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/rrxmgUU3pLqQrYa5wDDb9/fd90c478bacd1c366e59b4be3d07b185/2026-02-23_11-48-54.png?w=820&#x26;fm=avif" alt=""><figcaption><p>使用移动 App 归档</p></figcaption></figure></div>

#### 取消归档 <a href="#unarchive" id="unarchive"></a>

在移动 App 中，从您的密码库筛选器中选择**归档**，以查看已归档的项目，然后使用 <i class="fa-ellipsis">:ellipsis:</i>选项菜单选择**取消归档**，即可将项目恢复到正常的密码库状态。
{% endtab %}

{% tab title="桌面端" %}
1、选择您想要归档的项目，然后使用操作栏选择**归档**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/kOYhUPQwYRL9Rm0SKwxsf/137b96d3023a21f04356a3fd8beb7f8b/desktop_archive.png?w=1279&#x26;fm=avif" alt=""><figcaption><p>使用桌面 App 归档</p></figcaption></figure></div>

2、在对话框中选择**归档**来确认您的选择。

#### 取消归档 <a href="#unarchive" id="unarchive"></a>

在桌面 App 中，从您的密码库筛选器中选择**归档**，以查看已归档的项目，然后从操作栏选择**取消归档**。
{% endtab %}

{% tab title="CLI" %}
要归档一个项目，请使用命令 `bw archive item <item-id>`，其中 `<item-id>` 代表您想要归档的项目的唯一标识符。

要查看归档中的项目，请使用命令 `bw list --archive`。
{% endtab %}
{% endtabs %}

### 删除 <a href="#delete" id="delete"></a>

要删除项目：

{% tabs %}
{% tab title="网页 App" %}
选择该项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单，然后选择 <i class="fa-trash-can">:trash-can:</i>**删除**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3OYHvfRCDy3OphkbEHIJEA/fa47beb671d6efc34a18d05daf630aff/webappnewtest3.png?w=1325&#x26;fm=avif" alt=""><figcaption><p>项目选项</p></figcaption></figure></div>

使用操作栏删除多个项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7zvvNDdxoagjN3OIfutrxo/26c74435273fdcb156ec617830128c04/delete_bulk.png?w=900&#x26;fm=avif" alt=""><figcaption><p>删除多个项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
选择一个项目将其打开，然后选择 <i class="fa-trash-can">:trash-can:</i>删除图标：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2q1EZnISzEG3i8iU4vTKj6/b13c46c27a7fb896f31f81485859459f/extnew4.png?w=1118&#x26;fm=avif" alt=""><figcaption><p>编辑或删除项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
点击某个项目将其打开，然后选择该项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6XFamLqIYX26cUY5LWQbPE/1a6000050526e7f4f9e8bfcad93619fe/2025-11-10_12-06-19.png?w=961&#x26;fm=avif" alt=""><figcaption><p>项目选项</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}
选择一个项目将其打开，然后选择 <i class="fa-trash-can">:trash-can:</i>删除图标：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1E8ieEw6639tLYAxe2HYir/2ec594025ea37103c9cf0de93c41e9aa/2026-04-23_10-02-08-2.png?w=979&#x26;fm=avif" alt=""><figcaption><p>删除项目</p></figcaption></figure></div>

使用操作栏删除多个项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5OBKzVV9IS7fuym9g5gchb/cdc55f2efe045a9ab6f7fac939f813a6/bulk_delete_desktop.png?w=700&#x26;fm=avif" alt=""><figcaption><p>删除多个项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="CLI" %}
使用 `delete` 命令删除项目。请参阅 [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)以获取更多信息。
{% endtab %}
{% endtabs %}

#### 密码库回收站 <a href="#vault-trash" id="vault-trash"></a>

已删除的项目将被发送到回收站，删除后它们会保留 30 天。30 天过后，该项目将被永久删除且不可恢复。在回收站中，您可以在 30 天等待期之前使用 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>菜单将项目**恢复**到您的密码库或将其**永久删除**：

{% tabs %}
{% tab title="网页 App" %}
从筛选菜单选择**回收站**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/36mo5LyroRq1BhOcjSsBb7/a05100ab172376caf15b4c454beee321/2024-12-02_14-39-40.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>网页 App 中的回收站</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
导航到**设置** → **密码库** → **回收站**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5Q0mgKjaDiIKy5ymlVaUnS/fa72b454697bedd7319da17ba671a9e5/2025-04-15_09-33-59.png?w=818&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展中的回收站</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
在**密码库**选项卡上，向下滚动到**回收站**，然后选择项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7HwDVQp0ma6RxU95ILNVtI/52275cc54ff5d789f8825d225edb0ecf/2025-04-15_10-22-16.png?w=680&#x26;fm=avif" alt=""><figcaption><p>移动 App 中的回收站</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}
从导航栏选择**回收站**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/viaKopya1CJ9N6mWKyLV6/b6a8a6e6fc9449ac1630f89deee9da79/2026-04-23_10-08-16.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 中的回收站</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}

### 克隆 <a href="#clone" id="clone"></a>

您可以克隆您拥有所有权的任何项目来创建重复项目。如果项目归组织所有，则只能由对项目的集合具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-settings#list-of-settings)访问权限的成员进行克隆，并且只能通过网页 App 完成：

{% tabs %}
{% tab title="网页 App" %}
选择要复制的项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单，然后选择 <i class="fa-copy">:copy:</i>**克隆**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3OYHvfRCDy3OphkbEHIJEA/fa47beb671d6efc34a18d05daf630aff/webappnewtest3.png?w=1325&#x26;fm=avif" alt=""><figcaption><p>项目选项</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
选择要复制的项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单，然后选择 <i class="fa-copy">:copy:</i>**克隆**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/10bowrbDmxxf8SxrMhplmJ/01597fd4926492def941caf556cd9d12/extnew5.png?w=1118&#x26;fm=avif" alt=""><figcaption><p>项目选项</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
击某个项目将其打开，然后选择该项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6XFamLqIYX26cUY5LWQbPE/1a6000050526e7f4f9e8bfcad93619fe/2025-11-10_12-06-19.png?w=961&#x26;fm=avif" alt=""><figcaption><p>项目选项</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}
选择要复制的项目的 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>选项菜单，然后选择 <i class="fa-copy">:copy:</i>**克隆**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5KRdegIaIbOHxGkMj64Fs9/fce91fc0bc5cabfa299d1fd522c0da7d/2026-04-23_10-12-38.png?w=800&#x26;fm=avif" alt=""><figcaption><p>克隆项目</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
克隆项目时不会复制[通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)。新项目将包含与原始项目相同的详细信息，但通行密钥字段将为空。
{% endhint %}

## 共享项目 <a href="#share-items" id="share-items"></a>

如果您是[组织](/docs/admin-console/organizations-overview)的成员，您可以[将密码库项目分配到组织的集合中](/docs/password-manager/organization-members/sharing)，从而将密码库项目的所有权转移给该组织。要与其他组织成员共享，请使用操作栏：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/stm9byteqzZn9dvqonHrc/000099fa7e49dffd712f1c94b966fa09/assign_to_collections.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>分配到集合</p></figcaption></figure></div>

## 下一步 <a href="#next-steps" id="next-steps"></a>

现在，您已了解密码库项目使用的基础知识，我们建议：

* 了解如何使用[检索](/docs/password-manager/your-vault/vault-navigation/search-vault)、[筛选](/docs/password-manager/your-vault/vault-navigation/filter-vault)以及在[收藏夹](/docs/password-manager/your-vault/vault-navigation/favorites)和[文件夹](/docs/password-manager/your-vault/vault-navigation/folders)中组织密码库来导航您的密码库。
* 了解您还可以向项目添加哪些内容，包括[自定义字段](/docs/password-manager/your-vault/vault-items/custom-fields)、[TOTP 种子](/docs/password-manager/your-vault/security-tools/totp)和[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)。


# 文件附件

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/attachments/)
{% endhint %}

{% hint style="info" %}
文件附件功能适用于高级用户和付费[组织](/docs/admin-console/organizations-overview)成员。这些升级方案包含每位用户 5GB 的文件附件加密存储空间。也可按 1 GB 的增量购买[更多存储空间](#add-storage-space)。
{% endhint %}

可通过任何 Bitwarden App 将文件附加到任何密码库项目，包括[共享](/docs/password-manager/organization-members/sharing)的密码库项目。不超过 500 MB（从移动 App 上传，则不超过 100 MB）的任何文件都可以附加到项目中。每个账户最多可以上传 5 GB 的总附件（除非添加更多存储空间）。附件在本地进行加密和解密，这意味着未加密的附件数据不会通过互联网传输或由服务器存储。

{% hint style="info" %}
个人密码库项目和所有 Send 的附件使用高级订阅或组织授予的个人存储空间。组织拥有的项目上的附件使用共享的组织存储空间。了解如何[添加存储空间](#add-storage-space)。
{% endhint %}

{% hint style="warning" %}
**关于 2021 年 05 月 11 日之后创建的附件的说明：**

由于附件升级，通过最新的客户端上传的附件无法在某些旧版本的客户端上打开。如果您发现你无法访问最近创建的附件，请将您的客户端升级到最新版本。（**提示**：云端网页密码库总是为最新版本。）

**冻结的或旧版的客户端**，包括 Safari 13（或更早）macOS 桌面 App 和 App 扩展，将不支持访问这些附件。
{% endhint %}

## 上传文件 <a href="#upload-a-file" id="upload-a-file"></a>

要附加文件到密码库项目：

{% tabs %}
{% tab title="网页 App" %}
要从网页 App 附加文件：

1. 打开项目然后选择**编辑**。
2. 滚动到**编辑**视图的底部，然后选择**附件**。
3. 选择**选择文件**，然后浏览您的文件。
4. 选择**上传**。
5. 选择**保存**。

保存后，**附件**部分将列出附加到此项目的所有文件。
{% endtab %}

{% tab title="浏览器扩展" %}
要从浏览器扩展附加文件：

1. 打开项目然后选择**编辑**。
2. 滚动到**编辑**视图的底部，然后选择**附件**。将弹出扩展。
3. 选择**选择文件**，然后浏览您的文件。
4. 选择**上传**。
5. 选择**保存**。

保存后，**附件**部分将列出附加到此项目的所有文件。
{% endtab %}

{% tab title="移动端" %}
要从移动 App 附加文件：

1. 打开项目，然后选择  <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**菜单**图标。
2. 选择**附件**。
3. 选择**选择文件**，然后浏览您的文件。
4. 选择**保存**（在 Android 中）或选择 <i class="fa-circle-check">:circle-check:</i>**保存**图标（在 iOS 中）。

保存后，**附件**部分将列出附加到此项目的所有文件。
{% endtab %}

{% tab title="桌面端" %}
要从桌面 App 附加文件：

1. 打开项目然后选择**编辑**。
2. 滚动到**编辑**视图的底部，然后选择**附件**。
3. 选择**选择文件**，然后浏览您的文件。
4. 选择**上传**。
5. 选择**保存**。

保存后，**附件**部分将列出附加到此项目的所有文件。
{% endtab %}

{% tab title="CLI" %}
使用 `bw create attachment` 以附加文件到现有的密码库项目，示例：

```bash
bw create attachment --file /path/to/myfile.ext --itemid <itemid>
```

更多信息，请参阅 Bitwarden [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)。
{% endtab %}
{% endtabs %}

## 查看附件 <a href="#view-an-attachment" id="view-an-attachment"></a>

在 **Android** 设备上，通过点击**查看项目**界面上的附件，图像文件（`.jpeg`、 `.png`、 `.gif`、 `.WebP`、 `.heic`）可以直接在 Bitwarden 中预览，而无需将其下载到您的设备：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/8CANFNTEL2gsoDy0zvQPG/65b328d7d01be571b66596c51f78d07d/2026-04-10_09-10-55.png?w=877&#x26;fm=avif" alt=""><figcaption><p>查看附件</p></figcaption></figure></div>

## 下载文件 <a href="#download-a-file" id="download-a-file"></a>

要在大多数 Bitwarden App 中下载附件，请打开项目。在**附件**部分中，选择文件旁边的 <i class="fa-arrow-down-to-bracket">:arrow-down-to-bracket:</i>**下载**图标。

对于 **CLI**，使用 `bw get attachment` 来下载文件，例如：

```bash
bw get attachment photo.png --itemid 99ee88d2-6046-4ea7-92c2-acac464b1412 --output /Users/myaccount/Pictures/
```

更多信息，请参阅 Bitwarden [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)。

## 导出所有附件 <a href="#export-all-attachments" id="export-all-attachments"></a>

要创建包含附件的导出：

{% tabs %}
{% tab title="网页 App" %}
要从网页 App 导出您的附件：

1、从导航中选择**工具** → **导出**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5PUGzasNsQnABG9gtso4o3/4e4880193ff45c22f0474c129e68e4e3/2025-12-17_11-43-59.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导出项目</p></figcaption></figure></div>

2、从**文件格式**下拉菜单中，选择 `.zip (with attachments)`。目前，只能从个人密码库中导出附件。

3、选择**导出**。您需要使用主密码或电子邮件验证码确认您的权限以执行此操作。。

导出文件将被发送到您的「下载」文件夹或网络浏览器设置为下载文件的位置。
{% endtab %}

{% tab title="浏览器扩展" %}
要从浏览器扩展导出您的附件：

1、打开**设置**选项卡。

2、选择**密码库选项**，然后选择**导出密码库**。

3、从**文件格式**下拉菜单中选择 `.zip (with attachments)`。目前，只能从个人密码库中导出附件。

4、选择**导出密码库**按钮以完成。您需要使用主密码或电子邮件验证码确认您的权限。

导出文件将被发送到您的「下载」文件夹或网络浏览器设置为下载文件的位置。
{% endtab %}

{% tab title="桌面 App" %}
要从桌面 App 导出您的附件：

1、从菜单栏中，导航到**文件** → **导出密码库**。

2、从**文件格式**下拉菜单中选择 `.zip (with attachments)`。目前，只能从个人密码库中导出附件。

3、选择**导出密码库**按钮以完成。您需要使用主密码或电子邮件验证码确认您的权限。

导出文件将被发送到您的「下载」文件夹或网络浏览器设置为下载文件的位置。
{% endtab %}

{% tab title="CLI" %}
要从 CLI 导出您的附件，使用如下命令：

```bash
bw export --format zip
```

{% endtab %}
{% endtabs %}

## 删除附件 <a href="#delete-an-attachment" id="delete-an-attachment"></a>

要删除附件：

{% tabs %}
{% tab title="网页 App" %}
要从网页 App 删除附件：

1. 打开项目然后选择**编辑**。
2. 滚动到**编辑**视图的底部，然后选择**附件**。
3. 选择附件旁边的 <i class="fa-trash-can">:trash-can:</i>**删除**图标。
4. 选择**是**以确认。
5. 选额**保存**。
   {% endtab %}

{% tab title="浏览器扩展" %}
要从浏览器扩展删除附件：

1. 打开项目然后选择**编辑**。
2. 滚动到**编辑**视图的底部，然后选择**附件**。将弹出扩展。
3. 选择附件旁边的 <i class="fa-trash-can">:trash-can:</i>**删除**图标。
4. 选择**是**以确认。
5. 选择 **<返回**图标。
6. 选额**保存**。
   {% endtab %}

{% tab title="移动端" %}
要从移动 App 删除附件：

1. 打开项目，然后选择  <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**菜单**图标。
2. 选择**附件**。
3. 选择附件旁边的 <i class="fa-trash-can">:trash-can:</i>**删除**图标。
4. 基于您的移动设备：

* 在 Android 上，选择**删除**以确认，然后**保存**。
* 在 iOS 上，选择**是**以确认，然后 <i class="fa-circle-check">:circle-check:</i>**保存**图标。
  {% endtab %}

{% tab title="桌面端" %}
要从桌面 App 删除附件：

1. 打开项目然后选择**编辑**。
2. 滚动到**编辑**视图的底部，然后选择**附件**。
3. 选择附件旁边的 <i class="fa-trash-can">:trash-can:</i>**删除**图标。
4. 选择**是**以确认。
5. 选额**保存**。
   {% endtab %}

{% tab title="CLI" %}
使用 `bw delete attachment` 来删除文件附件，示例：

```shellscript
bw delete attachment 7063feab-4b10-472e-b64c-785e2b870b92
```

更多信息，请参阅 Bitwarden [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)。
{% endtab %}
{% endtabs %}

## 添加存储空间 <a href="#add-storage-space" id="add-storage-space"></a>

付费用户和付费[组织](/docs/admin-console/organizations-overview)的成员拥有 5 GB 加密存储空间用于存储文件附件。个人和组织可以通过完成以下步骤购买额外的存储空间：

{% hint style="info" %}
添加存储空间将调整您的计费总金额并立即通过您的付款方式收取费用。首次扣款将按照当前计费周期的剩余时间内按比例计算。
{% endhint %}

{% tabs %}
{% tab title="个人" %}
要为您的个人密码库添加存储空间：

1、在 Bitwarden 网页 App 中，导航到**设置** → **订阅**。

2、在「存储」部分，选择**添加存储空间**按钮：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/113yhHwt2fIgkjWjmPgCa4/f3df4d33206d35873c92266a546a9ed6/Add_storage_to_individual_vault.png?w=1264&#x26;fm=avif" alt=""><figcaption><p>为个人密码库添加存储空间</p></figcaption></figure></div>

3、使用计数器，选择**要添加的存储空间 (GB)** 的数量，然后选择**提交**。
{% endtab %}

{% tab title="组织" %}
要为您的组织密码库添加存储空间：

1、打开 Bitwarden 网页 App，使用产品切换器打开管理控制台：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2uxBDdQa6lu0IgIEfcwMPP/e3de3361749b6496155e25edcfdcf08b/2024-12-02_11-19-56.png?w=1013&#x26;fm=avif" alt=""><figcaption><p>产品切换器</p></figcaption></figure></div>

2、从导航选择**计费** → **订阅**。

3、在「管理订阅」部分，选择**添加存储空间**按钮：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6tMMQEzEKXIRSa9fIUXuoh/3d9f81b717d3cee9681f1feda97d1b91/2024-12-02_15-28-55.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>为组织密码库添加存储空间</p></figcaption></figure></div>

4、使用计数器，选择**要添加的存储空间 (GB)** 的数量，然后选择**提交**。
{% endtab %}

{% tab title="自托管" %}
虽然在使用自托管服务时，附件存储仍与付费用户或组织成员绑定，但**存储空间的大小**仅受包含附件目录的卷的可用空间的限制，上限为 10 TB（10,240 GB）。用户和管理员**无需**更改任何值来提高该限制。
{% endtab %}
{% endtabs %}

## 修复旧附件 <a href="#fixing-old-attachments" id="fixing-old-attachments"></a>

在 2018 年 12月 之前，文件附件使用另外一种方式加密其数据。从那以后，我们已经转向一种更新更好的加密文件附件的方式。使用旧加密方式的所有附件在密码库清单中都将标识一个 **⚠**&#x8B66;告图标。您应该将这些旧附件升级为新的加密方式，以便其他与账户相关的功能可以正常运行：

1. 打开包含旧附件的密码库项目，然后选择**编辑**。
2. 滚动到「编辑」表单底部然后选择**附件**。
3. 点击旧附件旁边的**修复**按钮。此过程将下载附件、使用新的加密方法对其进行重新加密、将附件重新上传回您的密码库、然后删除该附件的旧版本。

附件成功升级后，**⚠**&#x8B66;告图标和修复按钮会消失。


# 自定义字段

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/custom-fields/)
{% endhint %}

自定义字段适用于任何[项目类型](/docs/password-manager/your-vault/vault-items/vault-items)，它允许您可以在密码库项目中存储额外的结构良好的数据字段。自定义字段保存为 `Name:Value` 对，它可以是这四种类型之一：

* **文本型**：存储自由格式的输入（文本、数字等）的字段值
* **隐藏型**：存储从视图中隐藏的自由格式输入的字段值（对于使用[隐藏密码访问控制](/docs/admin-console/manage-members/member-roles)的组织特别有用）
* **复选框型**：（有些客户端上叫**布尔型**）存储布尔值（真/假）的字段值
* **链接型**：链接到项目的用户名或密码的字段值。指定[正确的字段名称](#custom-field-names)后，链接型自定义字段可用于解决浏览器扩展无法自动填充特定站点的用户名和密码的问题（[了解更多](/docs/password-manager/autofill/more-autofill-options/auto-fill-custom-fields#using-linked-custom-fields)）。

{% hint style="success" icon="lightbulb" %}
**用于密钥的自定义字段**

除了常见的网页服务输入（例如 PIN 码和安全问题）外，自定义字段还可用于存储**长度最多 5000 个字符**的值，例如 RSA 4096 位 SSH 密钥。

自定义字段值的字符限制是根据**加密后的字符数量**来计算的。例如，一个 3383 个字符的 RSA-4096 私有 SSH 密钥在加密并存储在您的密码库中时将增长到约 4400 个字符。
{% endhint %}

## 创建自定义字段 <a href="#creating-custom-fields" id="creating-custom-fields"></a>

可以在任何 Bitwarden 客户端中使用**编辑项目**面板中的**自定义字段**部分将自定义字段添加到密码库项目：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/NoGCwyAZcnzss1EeYXKD1/23a7e619dfdcb4baa023f54923335050/2024-12-02_14-52-43.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>网页 App 中的自定义字段</p></figcaption></figure></div>

### 自定义字段名称 <a href="#custom-field-names" id="custom-field-names"></a>

指定的**名称**对于成功[自动填充自定义字段](/docs/password-manager/autofill/more-autofill-options/auto-fill-custom-fields)很重要。对于浏览器扩展，您可以使用上下文菜单中的**复制自定义字段名称**选项快速获取正确的字段名称（在大多数情况下，通过右键单击表单元素）：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5nnPLqyzgAhDCinQNB0uUC/a721194f39f0a8fa919066d73ff9e2c8/2024-10-29_10-50-34.png?w=980&#x26;fm=avif" alt=""><figcaption><p>复制自定义字段名称</p></figcaption></figure></div>

选择此上下文菜单选项将复制表单元素的 `id`、`name`、`aria-label` 或 `placeholder` 的值（按优先顺序）。

保存自定义字段后，您可以[从浏览器扩展中自动填充它](/docs/password-manager/autofill/more-autofill-options/auto-fill-custom-fields)。

#### 手动查找自定义字段名称 <a href="#find-custom-field-names-manually" id="find-custom-field-names-manually"></a>

如果您不使用浏览器扩展，查找字段名称的最佳方法是使用网页浏览器的开发人员工具，如下面的示例所示：

{% embed url="<https://vimeo.com/1139125687?fe=cm&fl=pl>" %}

要定位自定义字段名称：

1、在带有自定义字段的网页上，右键单击要自动填充的字段并选择**检查**。HTML 元素将打开并在开发人员控制台中突出显示。

2、查找并复制元素 `id`（查找 `id="xxx"`，其中 `xxx` 是元素的 `id` 值）。

3、在对应的密码库项目的**自定义字段**部分，选择适当的字段类型，然后选择 <i class="fa-plus">:plus:</i>**新增自定义字段**按钮：

4、在**名称**字段中粘贴已复制的元素 `id`。

5、在**值**字段中指定需要自动填充的信息（在上例中为电话号码）。

6、保存此密码库项目。

保存自定义字段后，您可以[从浏览器扩展中自动填充它](/docs/password-manager/autofill/more-autofill-options/auto-fill-custom-fields)。

### 更多关于自定义字段名称 <a href="#more-about-custom-field-names" id="more-about-custom-field-names"></a>

#### 优先顺序 <a href="#order-of-preference" id="order-of-preference"></a>

如果您手动命名自定义字段，则应**按优先顺序**使用以下 HTML 表单元素属性/值之一：

1. HTML 表单元素的 `id` 属性
2. HTML 表单元素的 `name` 属性
3. HTML 表单元素的 `aria-label` 属性
4. HTML 表单元素的 `placeholder` 属性

#### 匹配 <a href="#matching" id="matching"></a>

字段名称的匹配是**精确**且**不区分大小写**的。例如，假如您的自定义字段的名称为 `PIN`：

* **提供自动填充**：对于 `pin`、`Pin`、`PIN` 等
* **不提供自动填充**：对于 `pin2` 或 `mypin`&#x20;

#### 前缀 <a href="#prefixing" id="prefixing"></a>

在两种情况下，您可以通过使用前缀对[匹配](/docs/password-manager/your-vault/vault-items/custom-fields#matching)进行更多控制：

* **csv**：使用 `csv=` 作为自定义字段名称的前缀，允许您指定多个名称来检索和比较以进行自动填充，例如 `csv=pin,mypin,pincode`。
* **regex**：使用 `regex=` 作为自定义字段名称的前缀，将允许您在执行自动填充时执行[正则表达式](https://regexone.com/)比较。例如，`regex=^first.*name` 将为 `firstName`、`First_name` 和 `First Name` 提供自动填充。


# 密码库导航


# 检索密码库

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/searching-vault/)
{% endhint %}

通过检索 Bitwarden 密码库，可以快速找到相关项目。[基本检索](/docs/password-manager/your-vault/vault-navigation/search-vault#applications-that-use-full-text-search)查询可以在任何 Bitwarden App 中进行，高级的[全文检索](/docs/password-manager/your-vault/vault-navigation/search-vault#applications-that-use-full-text-search-1)查询可以在网页密码库、桌面 App 和浏览器扩展中进行。

任何检索操作的结果都取决于当前通过筛选器菜单或导航打开的内容。例如：

* 如果选择了**所有项目**，检索将检查所有密码库项目以获取结果。
* 如果选择的类型为**登录**，检索将检查所有登录项目以获取结果。
* 如果选择了**我的文件夹**，检索将检查该文件夹中的项目以获取结果（不包括[嵌套文件夹](/docs/password-manager/your-vault/vault-navigation/folders)中的项目）。
* 如果选择了**集合**，检索将检查所选集合以获取结果（不包括[嵌套集合](/docs/admin-console/manage-shared-items/collections/about-collections#nested-collections)中的项目）。

检索框中的占位符文本将转换为指示当前检索的位置：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2Mdb392zQHEfC44zhwLmGl/9d208498c67672f81c47b66a3084853e/2024-12-02_16-28-17.png?w=1204&#x26;fm=avif" alt=""><figcaption><p>检索文件夹</p></figcaption></figure></div>

## 基础检索 <a href="#basic-search" id="basic-search"></a>

基础检索是每个 Bitwarden App 中的默认检索模式。输入检索的文本（例如 `Github` 或 `myusername`）将在密码库项目的以下字段中检索输入的信息：

* 对于任何项目，其**名称**
* 对于任何项目，其 **ID**
* 对于登录项目，其**用户名**
* 对于登录项目，其 **URI**

检索中的每个词条必须至少出现在一个被检索的字段中。例如，一个名称为 `Email MyCompany Work`、用户名为 `alice@example.com` 的登录项目，会被诸如 `email work`、`Work MyCompany` 或 `MyCompany alice` 之类的查询返回。

## Lunr 检索 <a href="#lunr-search" id="lunr-search"></a>

在网页 App、浏览器扩展和桌面 App 中，您可以通过在查询前加上「大于」( `>`) 字符来执行更高级的 Lunr 检索。Lunr 检索涵盖更多字段，并支持高级查询语法，如词条存在性、模糊匹配和通配符。

### 索引字段 <a href="#indexed-fields" id="indexed-fields"></a>

全文检索将为每个密码库项目检索以下字段：：

* `shortid`：项目 ID 的前 8 个字符。
* `organizationid`：项目的组织 ID（如果它属于其中一个）。
* `name`：项目指定的名称。
* `subtitle`：取决于项目类型；登录为**用户名**，支付卡为**品牌**或**卡号**后四位，身份为**名称**。
* `notes`：项目的备注。除非[使用通配符](#wildcards-and-advanced-search-parameters)，否则只会列出全词匹配。
* `fields`：名称和值。仅包&#x542B;**`文本`**&#x7C7B;型字段值。
* `attachments`：附件文件的名称。
* `login.username`：登录项目的用户名。
* `login.uris`：登录项目的 URI [主机名](https://developer.mozilla.org/en-US/docs/Web/API/HTMLHyperlinkElementUtils/hostname)的值。

### 检索特定字段 <a href="#searching-specific-fields" id="searching-specific-fields"></a>

您可以使用「大于」(`>`) 符号来开始检索查询，并按以下格式指示先前列出的字段，来检索特定字段中的数据：

* `>login.username:jsmith`：将检索**用户名**被指定为 `jsmith` 的登录项目。
* `>+name:Turbo +name:Tax`：将检索**名称**中包含 `Turbo` 和 `Tax` 这两个词的所有密码库项目，但也会返回名称中包含额外词语的项目，例如 `Turbo Fast Tax Service`。
* `>+name:Turbo +name:Tax -name:Fast`：将筛选上述示例的结果，排除名称中还包含 `Fast` 一词的任何项目，例如 `Turbo Fast Tax Service`。

如果没有字段指示符，则将检索所有已索引字段。

### 通配符和高级检索参数 <a href="#wildcards-and-advanced-search-parameters" id="wildcards-and-advanced-search-parameters"></a>

检索特定字段时，您可以使用星号 (`*`) 作为特定检索值的通配符，例如：

* `>organizationid:*`：将检索属于组织的任何密码库项目。
* `>-organizationid:*`：将检索不属于组织的任何密码库项目。
* `>login.username:*@gmail.com`：将检索**用户名**以 `@gmail.com` 结尾的任何密码库项目。
* `>wild*`：将检索包含单词 `wild` 的所有密码库项目和包含 `wild` 的密码库项目的单词，例如 `wildcard`。

{% hint style="success" icon="lightbulb" %}
除通配符外，[Lunr](https://lunrjs.com/) 还提供了多种高级查询选项，包括：

* **术语组合**：使用 `+`（必须包含）或 `-`（必须不包含）前缀。基于术语组合进行检索时，会单独处理每个术语，即使它们由连字符 (`-`) 分隔。

例如，如果你有多个 Gmail 账户，检索 `>+name:Gmail +name:Work` 将**会**返回名为 `Work Gmail` 的密码库项目，但**不会**返回名为 `Personal Gmail` 的密码库项目。如果您在项目名称中使用连字符 (`-`)（例如 `Work-Gmail`），请勿将连字符包含为搜索词。

术语组合可用于精确搜索。例如，检索 `>+name:5 +name:mail +name:01` 将创建 `5-mail-01` 的精确匹配。

* **模糊匹配**：使用波浪号 (`~`) 前缀结合一个编辑距离的整数。

例如，搜索 `>name:email~1` 将返回名称为 `email` 的密码库项目**以及**名称为 `gmail` 的密码库项目。

了解更多有关使用 [Lunr 搜索指南](https://lunrjs.com/guides/searching.html)编写高级检索查询的信息。
{% endhint %}


# 筛选密码库

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/filter-your-vault/)
{% endhint %}

筛选您的密码库将控制哪些项目会显示在密码库中或密码库视图中。要筛选密码库：

{% tabs %}
{% tab title="网页 App" %}
任选一个：

* 从**筛选器**列中选择一个特征（在下面的屏幕截图中，为**登录**）。
* 选择项目旁边的彩色卡片之一（在下面的屏幕截图中，为**我**或**我的组织**）。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1UhfLlwmahJgbi0bcBtPLT/b4b1875602b0ea555626c98a388779b8/2024-12-02_14-23-39.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>网页 App 筛选器</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
使用 <i class="fa-lock-keyhole">:lock-keyhole:</i>**密码库**选项卡顶部的**密码库**、**集合**、**文件夹**或**类型**选择器。您可以使用 <i class="fa-sliders">:sliders:</i> 按钮切换筛选器下拉菜单的可见性：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/12UsFuA2sxbUCBMIczJsxv/689221013fac56ddb555ed9dabddbdc9/screenshot_6.png?w=584&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展筛选器和建议</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
通过选择**密码库**选项卡上的**密码库**菜单按钮 (<i class="fa-ellipsis">:ellipsis:</i>) 来选择一个密码库：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/44WqYfqzP9JOJPSZ4Yrzjb/9167f19bc2e27a158be5ed3fc29a5689/2025-01-21_15-38-59.png?w=714&#x26;fm=avif" alt=""><figcaption><p>移动 App 筛选器</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}
从最左边的列中选择筛选条件：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2Lng0L2TRQ177CaU8EUQ1m/650d82f70422611353ce70a347a99c72/2026-04-23_10-14-43.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 筛选器</p></figcaption></figure></div>
{% endtab %}

{% tab title="CLI" %}
使用带有 `--organizationid` 选项的 `bw list` 命令，可以按密码库列出项目。该选项可以接受组织标识符或 `null` 值。[了解更多](/docs/password-manager/developer-tools/cli/password-manager-cli#list)。
{% endtab %}
{% endtabs %}


# 文件夹

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/folders/)
{% endhint %}

文件夹是用于通过将登录、支付卡、身份和安全笔记集中在一起来组织您的个人密码库的结构。使用文件夹可以方便您查找密码库项目，并且在 Bitwarden App 中，文件夹会按字母顺序排列。

任何密码库项目都可以添加到文件夹中，包括[组织已与您共享的项目](/docs/password-manager/organization-members/sharing)。如果您通过组织共享项目，请务必注意，文件夹仅为您个人组织密码库项目；其他组织成员可以设置不同的文件夹布局。详细了解[文件夹与集合有何不同](/docs/admin-console/manage-shared-items/collections/about-collections)。

{% hint style="success" icon="lightbulb" %}
当从筛选器菜单中选择**所有密码库**时，添加到某个文件夹的项目仍会出现在您的密码库中，删除文件夹并**不会**删除该文件夹中的项目。删除文件夹是永久性的，删除后，文件夹将无法恢复。
{% endhint %}

## 创建文件夹 <a href="#create-a-folder" id="create-a-folder"></a>

可以从任何 Bitwarden 客户端 App 来创建、重命名和删除文件夹：

{% tabs %}
{% tab title="网页密码库" %}
要创建文件夹，请选择 <i class="fa-plus">:plus:</i>**新增**按钮然后从下拉菜单选择**文件夹**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3BvTWidqL4xWQvFqBSiJIR/d68bc851d44df1b571eed16366159e0c/2024-12-02_13-50-55.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>新增文件夹</p></figcaption></figure></div>

创建后，您可以随时通过选择此文件夹然后单击 <i class="fa-pen">:pen:</i>**铅笔**图标来重命名或删除文件夹：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1aG4313JkmkBvot45gZvEr/a7dc45d314407131948216acc2b2444d/2024-12-02_16-15-07.png?w=993&#x26;fm=avif" alt=""><figcaption><p>编辑或删除文件夹</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
要创建文件夹，请选择 <i class="fa-plus">:plus:</i>**新增**按钮然后从下拉菜单选择**文件夹**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1aPQBd9bT7uUf20Y1fZwSB/506e7010284c1e0d83b75204bac22eaa/2024-12-02_16-13-10.png?w=1187&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展新增文件夹</p></figcaption></figure></div>

创建后，可以随时从**设置** → **密码库** → **文件夹**菜单中重命名或删除文件夹。
{% endtab %}

{% tab title="桌面端" %}
要创建文件夹，请选择**新增** → **文件夹**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7xia34eJyx1K8Gy8IXajQ7/af2b2ef342350a68b000c405ee698ab4/2026-04-23_09-58-10.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面端添加文件夹</p></figcaption></figure></div>

创建文件夹后，您可以随时通过悬停在 <i class="fa-pen">:pen:</i>**铅笔**图标上来重命名或删除文件夹：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6t2aoywIMdBPMuJktnhEqA/53742fbe25b11095406c40ff6178d6c4/2026-04-23_10-46-29.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面端编辑文件夹</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
要创建文件夹，请点击 <i class="fa-gear-complex">:gear-complex:</i>**设置**菜单，点击**密码库**选项，然后点击**文件夹**选项。点击 <i class="fa-plus">:plus:</i>**添加**图标以添加文件夹。创建后，您可以从同一菜单中通过点击文件夹来重命名文件夹，或使用 **≡**&#x83DC;单来删除文件夹：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6IwzXSJHGmSeU7oIy4z8kZ/95620b58758e50fa0e8e22a65f2bfa15/2025-01-21_15-26-07.png?w=713&#x26;fm=avif" alt=""><figcaption><p>移动端上的文件夹</p></figcaption></figure></div>
{% endtab %}

{% tab title="CLI" %}
要创建文件夹，请使用命令：

```bash
bw create folder <foldername>
```

您可以使用 `bw edit <folderId>` 编辑现有文件夹，使用 `bw delete folder <folderId>` 删除文件夹。更多信息，请参阅 Bitwarden [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)。
{% endtab %}
{% endtabs %}

删除文件夹不会删除其中包含的任何密码库项目，也不会删除嵌套在其中的其他文件夹或其内容。

{% hint style="info" %}
如果您是某个组织的成员，在**筛选器**菜单中，集合将显示在文件夹的下方。

文件夹和集合之间有相似之处。**文件夹用于组织个人密码库的项目**（但可以包含[共享的项目](/docs/password-manager/organization-members/sharing)），仅供您个人使用，而集合则用于在组织成员之间共享。
{% endhint %}

### 嵌套文件夹 <a href="#nested-folders" id="nested-folders"></a>

文件夹可以「嵌套」，以便在密码库中合理地组织它们。嵌套文件夹的层数没有限制，但创建太多层次可能会破坏密码库的界面。

{% hint style="info" %}
在「父」文件夹中进行检索不会将嵌套在其中的文件夹中的项目作为潜在检索结果包括在内。更多信息，请参阅[检索密码库](/docs/password-manager/your-vault/vault-navigation/search-vault)。
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5blNMg0hJ9XW3Ts2qPRzF5/7a2bdfb7672c04a1a1fbae1068b8b422/2024-12-02_16-18-48.png?w=932&#x26;fm=avif" alt=""><figcaption><p>嵌套文件夹</p></figcaption></figure></div>

要创建一个嵌套文件夹，给新的文件夹起一个名称，这个名称需包括「父」文件夹，后面使用一个正斜线 (`/`) 分隔符，例如 `Personal/Email`。

如果没有相应的「父」文件夹名称，则该文件夹不会被嵌套，其标题将完整显示。

## 移动项目到文件夹 <a href="#move-items-to-a-folder" id="move-items-to-a-folder"></a>

在密码库中创建文件夹后，可以通过以下几种方式将项目移动到其中：

{% tabs %}
{% tab title="网页密码库" %}
对于网页密码库，可以任选其一：

* 导航到**添加**项目或**编辑**项目界面，从**文件夹**下拉菜单中选择您的新文件夹，然后**保存**您的项目：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4VfciDIbEZZFAG1AXbRf3S/275100f866612da15b4714adea8f1944/2024-12-02_16-20-15.png?w=1205&#x26;fm=avif" alt=""><figcaption><p>移动项目到文件夹</p></figcaption></figure></div>

* 导航到**密码库**视图，选择要移动的项目，然后使用操作栏选择 <i class="fa-folder">:folder:</i>**添加到文件夹**按钮。在「移动所选」对话框中，选择要将项目移动到的文件夹：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7zQPzdrcVIbPeX5E8LqTq/e1554b6cc22a5d50029ab8c5e61940f5/add_to_folder_bar.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>移动项目到文件夹</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
打开要移动的密码库项目，选择**编辑**按钮，使用**文件夹**下拉菜单选择文件夹，完成后选择**保存**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6b8EOCtuuHmulnNQNJmWWk/f24c97777972b15ee5000e575f2b242c/2024-10-29_11-48-18.png?w=961&#x26;fm=avif" alt=""><figcaption><p>移动项目到文件夹</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}
选择要移动的项目，然后使用操作栏选择 <i class="fa-folder">:folder:</i>**添加到文件夹**按钮。在「移动所选」对话框中，选择要将项目移动到的文件夹：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/63jzyM75IRzhAbw5nNzMHx/cf70c299326b410b9345a7a047560fae/desktop_folder.png?w=1281&#x26;fm=avif" alt=""><figcaption><p>移动项目到文件夹</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
打开要移动的密码库项目，点击**文件夹**下拉菜单，然后选择要将项目移动到的文件夹：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/169hAtd0PhW3BcYlSPy6vn/2618596e36941b06dabcb766327b664b/2025-01-22_09-44-03.png?w=712&#x26;fm=avif" alt=""><figcaption><p>移动项目到文件夹</p></figcaption></figure></div>
{% endtab %}

{% tab title="CLI" %}
使用 `bw edit` 命令来操作密码库项目 JSON 对象的 `folderId` 属性，如下例所示：

```bash
bw get item 7ac9cae8-5067-4faf-b6ab-acfd00e2c328 | jq '.folderId="3d9cecac-71a2-4637-9341-acf000eedf04"' | bw encode | bw edit item 7ac9cae8-5067-4faf-b6ab-acfd00e2c328
```

{% hint style="success" %}
使用 `edit` 功能需要：

* 使用 `get` 命令并传入要编辑的项目的确切 `id` 。
* 知道要将其移动到的文件夹的确切 `folderId`。
* 使用 [jq 之类的命令行 JSON 处理器](https://stedolan.github.io/jq/)操作 JSON 对象（特别是 `folderId` 属性）。
* 使用 `encode` 命令对 JSON 对象的更改进行编码。

如果您不熟悉对这些部件的使用，请参阅 Bitwarden [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)。
{% endhint %}
{% endtab %}
{% endtabs %}

{% hint style="success" icon="lightbulb" %}
[组织已与您共享](/docs/password-manager/organization-members/sharing)的项目可以添加到您的文件夹中，这样做只会影响该项目在您的个人密码库中的显示方式（即，将项目添加到文件夹不会授予任何人对该文件夹的访问权限，也不会改变它是否在他们的密码库中的某个文件夹中）。
{% endhint %}


# 收藏

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/favorites/)
{% endhint %}

可以将任何项目指定为**收藏**，以便快速访问您最常用的项目。

即使是[组织已与您共享](/docs/password-manager/organization-members/sharing)的项目也可以被指定为收藏，这只会影响它们在您的个人密码库中的显示方式（即您这样做不会让其他对该组织或集合有访问权限的用户也将该项目设为收藏）。

{% hint style="success" icon="lightbulb" %}
标记为**收藏**的项目将显示在浏览器扩展和移动 App的 <i class="fa-lock-keyhole">:lock-keyhole:</i>**密码库**视图的顶部，以及网页密码库和桌面 App 的 <i class="fa-star">:star:</i>**收藏**筛选器中。

在浏览器扩展中，当您浏览与之关联的网页时，登录项目将从**收藏夹**部分跳转到**自动填充建议**部分。
{% endhint %}

## 指定为收藏 <a href="#designating-favorites" id="designating-favorites"></a>

在最初创建时，或在任何时候编辑时，都可将任何密码库项目指定为收藏：

{% tabs %}
{% tab title="网页 App" %}
在「添加」或「编辑」界面，选中右上角的 <i class="fa-star">:star:</i>**星形**图标，然后**保存**该项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4XpFH5NFI6Lso21BpGNKsu/e90cd1d0d6c3e4e7296d2e0300ab3ab2/2024-12-02_16-26-17.png?w=1205&#x26;fm=avif" alt=""><figcaption><p>收藏项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
选择一个项目然后打开「编辑」界面，选中**收藏**复选框，然后**保存**该项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/36QXVM3xcSN7vALkOWQPYr/fd82e56cb60b38e4ff6a96bfb7b5d54d/2024-10-29_11-53-27.png?w=961&#x26;fm=avif" alt=""><figcaption><p>收藏项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面端" %}
在「添加项目」或「编辑项目」界面，勾选**收藏**复选框，然后**保存**该项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2BtbpzNSnydUYBu92j1bCH/12674ca7b80eaa8d327e5eb88175665d/2026-04-23_10-48-31-1.png?w=800&#x26;fm=avif" alt=""><figcaption><p>收藏项目</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
在「添加项目」或「编辑项目」界面，选中**收藏**<i class="fa-star">:star:</i>，然后**保存**该项目：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1rvKA8zNjd1RktotXjBEUg/f25cc45f33b29b901ec8e1f3ddc96d7c/2025-01-22_09-46-54.png?w=713&#x26;fm=avif" alt=""><figcaption><p>收藏项目</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}


# 安全工具


# 集成的身份验证器

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/integrated-authenticator/)
{% endhint %}

Password Manager 内置身份验证器，可直接在您的密码库中生成用于[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)的验证码，无需打开单独的 App 然后手动输入验证码。它使用 SHA-1 生成 6 位数的[基于时间的一次性密码](https://en.wikipedia.org/wiki/Time-based_One-time_Password_algorithm) (TOTP)，每 30 秒轮换一次。

{% hint style="info" %}
在 Password Manager 集成的身份验证器中密钥存储适用于所有账户。但 TOTP 验证码的生成适用于高级版或付费版组织（家庭版、团队版或企业版）成员资格。

> **\[译者注]**：
>
> 上面这句话的意思是所有账户都可以将支持双重验证 (2FA) 的网站或服务加入验证器密钥 (TOTP) 字段，但以后要生成并使用自动动生成的 TOTP 验证码，则需要高级版或付费版组织账户。
>
> Bitwarden 的 TOTP 相当于 [Authy](https://authy.com/) 或 [Google Authenticator](https://support.google.com/accounts/answer/1066447?hl=en) 等专用验证器 App。对于支持两步验证的网站或服务，您可以使用单独的验证器 App 生成验证码，也可以使用 Bitwarden 的 TOTP 生成验证码。
> {% endhint %}

Bitwarden 提供两种身份验证器：Password Manager 集成的身份验证器和 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator) App。了解更多有关[何时使用不同的身份验证器](/docs/bitwarden-authenticator/bitwarden-authenticator#bitwarden-authenticator-he-password-manager-ji-cheng-shen-fen-yan-zheng-qi-you-shen-me-qu-bie)的信息 。

## 生成 TOTP 代码 <a href="#generate-totp-codes" id="generate-totp-codes"></a>

在 Bitwarden Password Manager 中，有三种方法可以为密码库的登录项目设置 TOTP 生成：

* 从 Bitwarden 移动 App 或浏览器扩展[扫描二维码](/docs/password-manager/your-vault/security-tools/totp#scan-a-qr-code)
* 从任一个 Bitwarden App [手动输入安全密钥](#manually-add-a-secret)
* 使用 Bitwarden Authenticator App [同步代码](/docs/bitwarden-authenticator/totp-sync)，使 TOTP 也出现在 Password Manager 中。

设置完成后，集成身份验证将持续每 30 秒轮换生成 6 位数的 TOTP，您可以将其作为两步登录连接网站或 App 辅助步骤。您可以随时使用**编辑项目**界面上的 <i class="fa-camera">:camera:</i> 相机图标来更新 TOTP 种子。

### 扫描二维码 <a href="#scan-a-qr-code" id="scan-a-qr-code"></a>

要使用二维码为登录项目设置集成的身份验证：

{% tabs %}
{% tab title="移动端" %}
1、**编辑**要为其生成 TOTP 的密码库项目。

2、点击 <i class="fa-camera">:camera:</i>**设置 TOTP**。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1cjF7IObqGhZL2ETA6XhTU/10641831c6fb690b85c3c99f39f1b1b1/2025-01-21_16-46-53.png?w=712&#x26;fm=avif" alt=""><figcaption><p>移动 App 设置 TOTP</p></figcaption></figure></div>

3、扫描二维码。

4、点击**保存**以开始生成 TOTP。
{% endtab %}

{% tab title="浏览器扩展" %}
1、**编辑**要为其生成 TOTP 的密码库项目。

2、选择 <i class="fa-camera">:camera:</i>**TOTP**。它将从当前网页扫描验证器二维码。完整的二维码必须在屏幕上可见。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7vTPBRNX8Q1xxOZsqFxWBQ/3a91391f5c233743b8f6be509086f895/2024-10-29_11-04-36.png?w=966&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展 TOTP 扫描</p></figcaption></figure></div>

3、代码输入后，点击**保存**以开始生成 TOTP。
{% endtab %}
{% endtabs %}

### 手动添加密钥 <a href="#manually-add-a-secret" id="manually-add-a-secret"></a>

要手动添加安全密钥到登录项目：

1. **编辑**要为其生成 TOTP 的密码库项目。
2. 选择**验证器密钥**字段（在移动 App 中，您也可以从**编辑**视图中选择 <i class="fa-camera">:camera:</i>**设置验证器密钥** → **手动输入密钥**）。
3. 将安全密钥粘贴到**验证器密钥**字段中。
4. **保存**项目。

## 使用生成的代码 <a href="#use-generated-codes" id="use-generated-codes"></a>

将密钥添加到登录项目后，有两种方式获取 TOTP：自动填充或复制验证码。

{% hint style="info" %}
TOTP 依赖于基于时间的代码生成。如果您的设备时间与服务器时间不一致，生成的验证码将无法使用。如果您遇到 TOTP 验证码问题，请将您的设备的时区和时间设置为[**自动**](#troubleshooting)。
{% endhint %}

### 自动填充 TOTP 代码 <a href="#autofill-totp-codes" id="autofill-totp-codes"></a>

Bitwarden 浏览器扩展和 iOS（版本 18.0+）会自动填充您的 TOTP 代码，除非[**页面加载时自动填充**](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#on-page-load)选项处于非活动状态。在这种情况下，浏览器扩展还会将 TOTP 代码复制到剪贴板，方便您粘贴到表单中。

在浏览器扩展上，您还可以从上下文菜单复制 TOTP 代码：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5YmvBLK63g2xMnUewNVjOg/a63aec8b36ac65d6d91acf666fc8406f/2024-10-29_11-11-51.png?w=1102&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展上下文菜单</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
当您使用浏览器扩展中的自动填充时，默认情况下会启用自动复制 TOTP 功能。要关闭此功能，请转到**设置** → **自动填充**，然后取消选中**自动复制 TOTP**。您还可以使用旁边的**清除剪贴板**下拉菜单来指定何时清除已复制的值。
{% endhint %}

### 查看和复制 TOTP 代码 <a href="#view-and-copy-totp-codes" id="view-and-copy-totp-codes"></a>

所有 Bitwarden App 都会在密码库项目中显示轮换的 TOTP 代码，其可以像用户名或密码一样将其复制和粘贴：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/41IqtUVMLh7MLxwwNU2ZpD/b9fc56ddc82ab78130305c0751aac0ca/2024-12-02_14-55-24.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>复制 TOTP 代码</p></figcaption></figure></div>

首次打开 Bitwarden App 时，选择**验证码**以显示您的密码库中所有活动的 TOTP：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3MRb58qhCFvVHVjPaxMk6R/227fae64af8e1a13e6c86a74412929eb/2025-01-21_17-13-12.png?w=716&#x26;fm=avif" alt=""><figcaption><p>移动端的验证码</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
只要您登录了您的 Bitwarden 密码库，即使您的设备离线，生成的代码也是可用的。
{% endhint %}

### 故障排除 <a href="#troubleshooting" id="troubleshooting"></a>

TOTP 代码是根据您设备的系统时钟生成的。如果您生成的代码无效不起作用，最可能的原因是您的设备时钟与 Bitwarden 服务器的时钟不同步。要重新同步设备上的时钟：

{% tabs %}
{% tab title="Windows" %}
导航到**开始** → **设置** → **时间和语言** → **日期和时间**，关闭**自动设置时间**选项然后重新打开。

如果这不起作用，请使用以下 PowerShell 命令设置您的时区，务必将时区名称替换为[此列表](https://learn.microsoft.com/zh-cn/windows-hardware/manufacture/desktop/default-time-zones?view=windows-11#time-zones)中正确的时区名称，然后重新启动计算机：

```bash
Set-TimeZone -Id "Central Standard Time"
```

```bash
Restart-Computer
```

{% endtab %}

{% tab title="macOS" %}
导航至**系统设置** → **常规** → **日期和时间**，关闭然后重新打开**自动设置时间和日期**以及**使用当前位置自动设置时区**选项。
{% endtab %}

{% tab title="Android" %}
导航至**设置** → **系统** → **日期和时间**，关闭然后重新打开**自动设置时间**选项。
{% endtab %}

{% tab title="iOS" %}
导航至**设置** → **常规** → **日期和时间**，关闭然后重新打开**自动设置**选项。
{% endtab %}
{% endtabs %}

## 支持的更多参数 <a href="#support-for-more-parameters" id="support-for-more-parameters"></a>

默认情况下，Bitwarden 使用 SHA-1 生成 6 位数的 TOTP，并且每 30 秒轮换一次，但有些网站或服务的 TOTP 代码可能会要求不同的参数。参数可以在 Bitwarden 中通过手动编辑您的密码库项目的 `otpauth://totp/` URI 来自定义。

| 参数          | 描述              | 值                                              | 示例                 |
| ----------- | --------------- | ---------------------------------------------- | ------------------ |
| `algorithm` | 用于生成 TOTP 的加密算法 | <p>-sha1<br>-sha256<br>-sha512<br>-otpauth</p> | `algorithm=sha256` |
| `digits`    | 生成的 TOTP 的位数    | 1-10                                           | `digits=8`         |
| `period`    | 轮换 TOTP 的间隔秒数   | 必须 > 0                                         | `period=60`        |

示例：

```
otpauth://totp/Test:me?secret=JBSWY3DPEHPK3PXP&algorithm=sha256&digits=8&period=60
```

了解更多有关使用 [otpauth:// URI](https://github.com/google/google-authenticator/wiki/Key-Uri-Format) 的信息。

## 在 iOS 上设置为默认 <a href="#set-a-default-on-ios" id="set-a-default-on-ios"></a>

运行 iOS 16+ 的 iOS 用户可以将任何应用程序设置为直接从相机 App 扫描代码时存储验证码的默认应用程序，包括 [Bitwarden Authenticator](/docs/bitwarden-authenticator/bitwarden-authenticator) 和 Password Manager [集成身份验证](/docs/password-manager/your-vault/security-tools/totp)。要进行此设置：

1. 在您的设备上打开 iOS **设置** App。
2. 点击**通用**。
3. 点击**自动填充和密码**。
4. 在**验证码**部分，从**设置验证码**下拉菜单中选择一个 App。

## Azure 和 Office 365 <a href="#azure-and-office-365" id="azure-and-office-365"></a>

默认情况下，Microsoft Azure 和 Office 365 账户需要使用 Microsoft Authenticator 用于 TOTP。如果您想使用 Bitwarden Authenticator 为您的 Microsoft Azure 或 Office 365 账户生成 TOTP，您需要完成以下步骤：

1、在 Microsoft 中，导航至您的账户设置页面。根据您的账户是个人账户还是企业账户，这可能是 `account.microsoft.com` 或 `myaccount.microsoft.com`。

2、根据您的账户是个人账户还是企业账户，打开您的**安全仪表板**或选择**安全信息**。如果您正在浏览**安全仪表板**，您还需要从该界面中选择**两步验证**。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4x8LX6bcktyPDnQhPvSLOz/7903ba57aeb75b15e83562841136a16b/Screen_Shot_2023-02-23_at_10.24.27_AM.png?w=1300&#x26;fm=avif" alt=""><figcaption><p>启用 2FA</p></figcaption></figure></div>

3、选择两步验证的**启用**按钮或**添加登录方式**按钮，然后从下拉列表中选择 Authenticator App。

4、在设置过程中，您会看到一个验证方法的下拉菜单。选择**验证器 App** 或 **An App**。

5、继续，直到您看到蓝色的不同的身份验证器 App 超链接。看到超链接时选择它。

6、继续，直到您看到二维码，此时您可以按照[此处](#scan-a-qr-code)的说明进行操作。

## Steam 令牌 TOTP

> **\[译者注]**：[Steam](https://store.steampowered.com/) 游戏平台（蒸汽平台）是美国电子游戏商[威尔乌](https://www.valvesoftware.com/) (Valve) 于 2003 年 9 月 12 日推出的数字发行平台。Steam 被认为是全世界的电脑游戏界最大的数字发行平台。有关 Steam Guard（Steam 令牌）的详细信息，请参阅 [Steam 令牌](https://help.steampowered.com/zh-cn/faqs/view/06B0-26E6-2CF8-254C)。

您可以为您的 Steam 账户的 2FA 使用 Bitwarden 集成的验证器。定位密钥后，将其输入到**验证器密钥**字段中，格式如下：`steam://your_secret_key_here`。

{% hint style="warning" %}
要使用这个功能，您需要使用第三方工具手动提取你的 Steam 账户的密钥。有一些工具（如 [SteamTimeIdler](https://github.com/SteamTimeIdler/stidler/wiki/Getting-your-%27shared_secret%27-code-for-use-with-Auto-Restarter-on-Mobile-Authentication#getting-shared-secret-from-ios-windows) 和 [Steam Desktop Authenticator](https://github.com/Jessecar96/SteamDesktopAuthenticator) 等）可以帮助您完成这个操作，但此类**提取工具并未取得 Bitwarden 或 Steam 的官方支持**。使用这些工具需自行承担风险。
{% endhint %}

为 Steam 生成的代码是 5 位数的字母数字组合型，而不是传统的 6 位数数字型 TOTP。


# 用户名 & 密码生成器

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/generator/)
{% endhint %}

使用 Bitwarden 生成器工具可以轻松创建强大的密码和唯一的用户名。密码生成器可在所有 Bitwarden 客户端中使用，用户名生成器可在网页 App、浏览器扩展、桌面 App 和移动 App 中使用。

如果您目前还不是 Bitwarden 用户，您也可以访问 <https://bitwarden.com/password-generator/> 测试我们的免费的密码生成器。

## 生成密码 <a href="#generate-a-password" id="generate-a-password"></a>

要生成强大的密码：

{% tabs %}
{% tab title="网页 App" %}
从导航栏中选择**工具** → **生成器**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/70bx0hWvxAvkz5RJdIj04n/63febc4043e13292461c768d910cd450/2025-02-14_11-00-10.png?w=1122&#x26;fm=avif" alt=""><figcaption><p>网页 App 密码生成器</p></figcaption></figure></div>

您在此页面上[指定的选项](#password-types)将保存，即使您注销网页 App。您也可以使用相同的选项直接从「添加项目」或「编辑项目」界面使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**按钮快速生成强密码：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5ZVBOSK13MaXJ2S8iJTOMX/1324db87fd867667cbb6e8c1c1f4539a/2024-12-02_14-44-30.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>网页 App 密码生成器</p></figcaption></figure></div>

{% hint style="info" %}
选择[**生成器历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#generator-history)即可访问该特定客户端在任一位置创建的密码和用户名 - 即使您没有将它们保存到项目中。当您注销时，历史记录将被清除。
{% endhint %}
{% endtab %}

{% tab title="浏览器扩展" %}
选择 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成器**选项卡：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6eOmI3kZOdnfw9i5JinfUD/f1a7129244f49c7d904664632e329076/2024-10-29_10-34-01.png?w=966&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展密码生成器</p></figcaption></figure></div>

您也可以从「编辑」界面使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**按钮生成强密码：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2Cbja6OBxW2S6GVxLOqlYh/b71de03b37f5a4f4960e344a5b17cc01/2024-10-29_10-35-25.png?w=966&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展密码生成器</p></figcaption></figure></div>

如果您创建的账户没有存储在 Bitwarden 中，您也可以使用内嵌自动填充菜单，在**填充已生成的密码**提示下生成并自动填写密码：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2JcceqWgFbk4ViLCMe6qm5/ce116e8ff337f90fbbd57b52aa15fdcd/2024-11-05_10-07-08.png?w=952&#x26;fm=avif" alt=""><figcaption><p>填充已生成的密码</p></figcaption></figure></div>

使用内嵌功能时，请使用 <i class="fa-arrows-rotate">:arrows-rotate:</i>**生成**按钮生成新的密码，直到您满意为止。确保在提示时选择**新增登录**，以便将登录信息保存到 Bitwarden。[了解更多](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#inline-auto-fill-menu)。

{% hint style="info" %}
选择[**生成器历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#generator-history)即可访问该特定客户端在任一位置创建的密码和用户名 - 即使您没有将它们保存到项目中。当您注销时，历史记录将被清除。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
从导航菜单中选择**生成器**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6cFQ3iojZXLy1ZIdIXp6Zr/bf4dfb3537ea709542432997aa4f6986/2026-04-23_10-54-46.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 密码生成器</p></figcaption></figure></div>

您也可以从「添加」/「编辑」项目界面使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**按钮生成强密码：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6VInVRr9tZBOndfe4VrpXf/789852c09b48e1ac121347d224816d09/2026-04-23_10-48-31-4.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 密码生成器</p></figcaption></figure></div>

{% hint style="info" %}
选择[**生成器历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#generator-history)即可访问该特定客户端在任一位置创建的密码和用户名 - 即使您没有将它们保存到项目中。当您注销时，历史记录将被清除。
{% endhint %}
{% endtab %}

{% tab title="移动端" %}
选择 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成器**选项卡：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/Cqrt6OGquQLRJvZDuqtCk/5b42dad11498bc5c62a749c4fc096fc9/2025-01-21_15-49-19.png?w=712&#x26;fm=avif" alt=""><figcaption><p>移动 App 密码生成器</p></figcaption></figure></div>

您也可以从「添加」/「编辑」项目界面，以及通过点按「共享」图标访问 iOS App 扩展，使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**按钮生成强密码：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4NeVmiRcKfedg6Fzwp0N1Y/f91ad1097dcd379925cedee724dc7592/2025-01-21_15-51-01.png?w=715&#x26;fm=avif" alt=""><figcaption><p>移动 App 密码生成器</p></figcaption></figure></div>

{% hint style="info" %}
选择[**生成器历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#generator-history)即可访问该特定客户端在任一位置创建的密码和用户名 - 即使您没有将它们保存到项目中。当您注销时，历史记录将被清除。
{% endhint %}
{% endtab %}

{% tab title="CLI" %}
使用 generate 命令生成密码：

```shellscript
bw generate -uln --length 14
```

生成密码的附加选项标志包括：

* `--minNumber`
* `--minSpecial`
* `--ambiguous`

更多信息，请参阅 Bitwarden [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)。
{% endtab %}
{% endtabs %}

### 密码类型 <a href="#password-types" id="password-types"></a>

#### 密码 <a href="#password" id="password"></a>

密码是随机生成的一组可自定义字符类型的字符串。密码的选项包括：

* **长度**：密码中字符的数量。
* **最少数字**：如果启用，则是密码中数字 **0-9** 的最少数量。
* **最少特殊字符**：如果启用，则是密码中特殊字符 **!@#$%^&\*** 的最少数量。
* **A-Z**：在密码中包含大写字母。
* **a-z**：在密码中包含小写字母。
* **0-9**：在密码中包含数字。
* **!@#$%^&\***：在密码中包含特殊字符。
* **避免模棱两可的字符**：防止您的密码同时包含 `1` 和 `l` 或同时包含 `0` 和 `o`。

{% hint style="danger" %}
除非您需要满足网站的特定密码要求，否则我们建议将**最少数字**和**最少特殊字符**保持尽可能低 (0-1)，因为过度约束会限制生成的密码的强度。
{% endhint %}

#### 密码短语 <a href="#passphrase" id="passphrase"></a>

密码短语是随机生成的词组，例如 `panda-lunchroom-uplifting-resisting`。密码短语的选项包括：

* **单词数量**：密码中的单词数量。
* **单词分隔符**：用于分隔密码中单词的字符（在上面的示例中为 `-`）。
* **大写**：将密码中每个单词的首字母大写。
* **包含数字**：在您的密码中包含一个单个数字字符。

## 生成用户名 <a href="#generate-a-username" id="generate-a-username"></a>

要生成用户名：

{% tabs %}
{% tab title="网页 App" %}
从导航栏中选择**工具** → **生成器**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2862v5xPV5qQM7XfdUvNlI/0f8fe47b6d9efb0a6d77b245a1f63cdf/2025-02-14_11-02-02.png?w=1122&#x26;fm=avif" alt=""><figcaption><p>网页 App 用户名生成器</p></figcaption></figure></div>

您也可以从「编辑」界面使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**按钮生成用户名：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1zpNFR8fu9DBo2krqln5hr/e893f1f3e8d85d58d20c8e316f247666/2024-12-02_14-44-30.png?w=1038&#x26;fm=avif" alt=""><figcaption><p>网页 App 用户名生成器</p></figcaption></figure></div>

{% hint style="info" %}
选择[**生成器历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#generator-history)即可访问该特定客户端在任一位置创建的密码和用户名 - 即使您没有将它们保存到项目中。当您注销时，历史记录将被清除。
{% endhint %}
{% endtab %}

{% tab title="浏览器扩展" %}
选择 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成器器**选项卡，然后选择**用户名**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3WEaJYUplgEdjgoSxlQ842/40d3eed8347cb6b0a600d06f42cc1941/2024-10-29_10-39-00.png?w=966&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展用户名生成器</p></figcaption></figure></div>

您还可以从「编辑」界面使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**按钮生成用户名：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/23CDvd3ErFQIZNYwgh000F/c19c373ecb6ca2d6aad2587a1b16dd12/2024-10-29_10-39-56.png?w=966&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展用户名生成器</p></figcaption></figure></div>

{% hint style="info" %}
选择[**生成器历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#generator-history)即可访问该特定客户端在任一位置创建的密码和用户名 - 即使您没有将它们保存到项目中。当您注销时，历史记录将被清除。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
从导航菜单中选择**生成器**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2VGPd4WOwydbovDJdyVT51/f2f447821533afc4dad139bc0059a05f/2026-04-23_10-55-35.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 用户名生成器</p></figcaption></figure></div>

您还可以从「添加」/「编辑」项目界面使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**按钮生成用户名：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7xTg7VVE7CgTZhBl5LlYui/6f187f63e0cf89dcd4fa9b4fb2866ad5/2026-04-23_10-48-31-5.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 用户名生成器</p></figcaption></figure></div>

{% hint style="info" %}
选择[**生成器历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#generator-history)即可访问该特定客户端在任一位置创建的密码和用户名 - 即使您没有将它们保存到项目中。当您注销时，历史记录将被清除。
{% endhint %}
{% endtab %}

{% tab title="移动端" %}
选择 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成器器**选项卡：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6nfsTiHypQvXrfz7qI7AKI/6e41b1fedea81895497268b0fd825215/2025-01-21_15-56-24.png?w=714&#x26;fm=avif" alt=""><figcaption><p>移动 App 用户名生成器</p></figcaption></figure></div>

您也可以从「添加」/「编辑」项目界面，以及通过点按「共享」图标访问 iOS App 扩展，使用 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成**按钮生成用户名：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2Obfpm7UdBizkwASepMS6j/998c1448556484b867160f7412aa984c/2025-01-21_15-51-01.png?w=715&#x26;fm=avif" alt=""><figcaption><p>移动 App 用户名生成器</p></figcaption></figure></div>

{% hint style="info" %}
选择[**生成器历史记录**](/docs/password-manager/your-vault/security-tools/password-and-generator-history#generator-history)即可访问该特定客户端在任一位置创建的密码和用户名 - 即使您没有将它们保存到项目中。当您注销时，历史记录将被清除。
{% endhint %}
{% endtab %}
{% endtabs %}

### 用户名类型 <a href="#username-types" id="username-types"></a>

#### 附加地址电子邮箱 <a href="#plus-addressed-email" id="plus-addressed-email"></a>

选择此类型以使用您的电子邮箱提供商的子地址（也称为「附加地址」或「别名」）功能。这将基于您指定的**电子邮箱地址**生成一个附加地址（以 `+` 和随机字符串命名）的用户名。

在浏览器扩展和桌面 App 的「添加」/「编辑」项目界面，您可以选择使用**随机字符串**（例如 `alice+gsd4aqqe@bitwarden.com`）生成用户名，或基于项目的**网站名称**（例如 `alice+github.com@ bitwarden.com`）生成用户名。**电子邮箱地址**仅限于浏览器和桌面 App，因为它需要知道登录的 [URI](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)，在其他位置，用户名生成器默认使用**随机字符串**。

{% hint style="success" icon="lightbulb" %}
**为什么要使用附加地址电子邮箱？**

附加地址电子邮箱可以让您在注册新的服务时过滤您的电子邮箱中的所有垃圾邮件。使用用户名 `alice+rnok6xsh@bitwarden.com` 注册服务时，仍会向 `alice@bitwarden.com` 发送电子邮件，但您可以轻松过滤包含 `+rnok6xsh` 的电子邮件，以防止它们堵塞您的收件箱。
{% endhint %}

#### Catch-all 电子邮箱 <a href="#catch-all-email" id="catch-all-email"></a>

选择此类型以使用您的域名配置的 Catch-all 收件箱。这将在您指定的**域名**中生成一个随机的电子邮箱地址。

在浏览器扩展和桌面 App 的添加/编辑项目界面，您可以选择使用**随机**（例如 `bqzjlero@gardenllc.com`）字符串生成用户名，或基于项目的**网站名称**（例如 `twitter.com@gardenllc.com`）生成用户名。**网站名称**仅限于浏览器和桌面上的添加/编辑界面，因为它需要知道登录的 [URI](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)，在其他位置，用户名生成器默认为**随机**。

{% hint style="success" icon="lightbulb" %}
**为什么要使用 Catch-all 电子邮箱？**

在某些情况下，拥有自己域名（例如 `@bitwarden.com`）的公司可以使用 Catch-all 收件箱避免电子邮件进入您的个人收件箱，而是将它们路由到一个已共享的（有时未经检查）公司收件箱，以备万一将来需要他们的这些记录。

在其他情况下，拥有自己域名（例如 `@gardenllc.com`）的个人可以使用 Catch-all 设置将电子邮件从具有面向隐私的用户名（例如 `github.com@gardenllc.com`）的账户路由到他们的实际收件箱。
{% endhint %}

#### 转发的电子邮箱别名 <a href="#forwarded-email-alias" id="forwarded-email-alias"></a>

选择此类型以将用户名生成器与您的外部别名服务集成。大多数 Bitwarden 应用程序支持与 SimpleLogin、AnonAddy、Firefox Relay、Fastmail、Forward Email 和 DuckDuckGo 集成。移动 App 目前支持与 SimpleLogin、AnonAddy 和 Firefox Relay 集成。

{% hint style="success" icon="lightbulb" %}
**为什么使用转发的电子邮箱别名？**

使用 [SimpleLogin](https://simplelogin.io/) 和 [Addy.io](https://addy.io/) 等电子邮箱别名服务时，您可以使用匿名地址（例如，`nobody-knows-its-me.d0p0r@slmail.me`）来注册网络账户，邮件将转发到您实际的收件箱（例如，`alice@bitwarden.com`）。这可以防止网站或服务在您注册时收集个人信息（在此示例中，名称 Alice 以及她在 Bitwarden 工作的事实）。
{% endhint %}

要设置您的电子邮箱别名集成：

{% tabs %}
{% tab title="SimpleLogin" %}
1、登录您的 SimpleLogin 账户。

2、从导航中选择 **API Keys**。SimpleLogin 会要求您输入密码以创建 API 密钥。

3、在「New API Key」部分中，输入表示将由 Bitwarden 使用的新密钥的名称，然后选择 **Create**。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6ie1Qpk8LYapG6JRX3X1dD/06c1083c6e146c2822f0e4a47b507785/Screen_Shot_2022-06-30_at_3.17.59_PM.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>SimpleLogin API 密钥</p></figcaption></figure></div>

4、**Copy** 此 API 密钥然后将其粘贴到 Bitwarden 用户名生成器的 **API 密钥**字段中。

5、Password Manager 浏览器扩展、移动 App 和桌面 App 可以连接到自托管的 SimpleLogin 服务器。如果您自托管 SimpleLogin，请输入**服务器 URL**。

6、选择**重新生成用户名**以生成一个用户名并同时自动在 SimpleLogin 中自动创建相应的别名。
{% endtab %}

{% tab title="Addy.io" %}
1、登录到您的 Addy.io 账户。

2、在 Addy.io 中，从导航菜单选择 **Setting**。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/18PUguJXkABllufHgtNEJi/564febbfe28d3f0cd491c3216d62db9e/addy_settings.png?w=1100&#x26;fm=avif" alt=""><figcaption><p>AnonAddy 设置</p></figcaption></figure></div>

3、在「Setting」界面的 **General** 选项卡上，向下滚动到 **Update Default Alias Domain**。选择您希望用作别名的默认域名。

{% hint style="info" %}
此处选择的默认域名必须与 Bitwarden 用户名生成器中使用的域名匹配。
{% endhint %}

4、选择 **API Keys** 选项卡然后点击 **Create New API Key** 按钮。

5、在「Create New API Key」对话框中，输入表示 Bitwarden 将使用的新令牌的 **Name**、**Expiration**，然后确认您的 Addy.io 账户密码。完成必填字段后，选择 **Create API Key**。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6o8021KYChu6jzEGvUbXDH/b56977c26a44b431486796cb4965f23d/create_new_api_key.png?w=1084&#x26;fm=avif" alt=""><figcaption><p>AnonAddy 生成令牌</p></figcaption></figure></div>

6、复制「Personal Access Key」然后将其粘贴到 Bitwarden 用户名生成器的 **API 密钥**字段中。

{% hint style="success" %}
我们建议将此个人访问令牌添加到您的 Bitwarden 中的 Addy.io 密码库项目中，因为该令牌只会在 Addy.io 中显示一次。
{% endhint %}

7、在**域名**字段中，输入您在**步骤 3** 中选择的 Addy.io 域名。作为 Addy.io 的免费用户，您的选项为 `anonaddy.me`、`<username>.anonaddy.me` 或 `<username>.anonaddy.com`。

8、Password Manager 浏览器扩展、移动 App 和桌面 App 可以连接到自托管的 Addy.io 服务器。如果您自托管 SimpleLogin，请输入**服务器 URL**。

9、选择**重新生成用户名**以生成一个用户名并同时自动在 Addy.io 中自动创建相应的别名。
{% endtab %}

{% tab title="Firefox Relay" %}
1、登录到您的 Firefox Relay 账户。

2、选择配置文件图标然后从下拉列表中选择 **Setting**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3jK0OhlASgzDZo1Xu2c97O/f24ae0b64e7fe7736e757b33a89510c6/Screen_Shot_2022-06-01_at_3.38.56_PM.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>Firefox Relay 设置菜单</p></figcaption></figure></div>

3、复制 **API Key** 然后将其粘贴到 Bitwarden 用户名生成器的 **API 密钥**字段中。

4、选择**重新生成用户名**以生成一个用户名并同时自动在 Firefox Relay 中自动创建相应的掩码。
{% endtab %}

{% tab title="Fastmail" %}
1、登录到您的 Fastmail 账户。

2、选择配置文件图标然后从下拉列表中选择 **Setting**。

3、从导航菜单中，选择 **Password & Security**，然后选择 **Manage API tokens**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/J1fPSFIIO7FgPyAyBgpbh/d4dd85f7f7201731936de872ff4a5134/2024-12-23_15-17-17.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>Fastmail API 令牌</p></figcaption></figure></div>

4、选择 **New API token** 然后生成 API 令牌：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1FieLCzKTItKNqDIhWBrbH/2816de1ec7580e2e90cf80e38d311993/2024-12-23_15-18-50.png?w=750&#x26;fm=avif" alt=""><figcaption><p>新增 API 令牌</p></figcaption></figure></div>

包含以下设置：

* **Read-only access** **disabled**
* **Masked Email enabled**

5、复制 **API Key** 然后将其粘贴到 Bitwarden 用户名生成器的 **API 密钥**字段中。

6、选择**重新生成用户名**以生成用户名并在 Fastmail 中自动创建相应的别名。
{% endtab %}

{% tab title="Forward Email" %}
1、登录您的 [Forward Email](https://forwardemail.net/) 账户。

2、Forward Email 使用默认域名 `hideaddress.net`，但是如果您有已注册的域名，则可以将其连接到该服务。详细信息，请参阅 [Forward Email 设置指南](https://forwardemail.net/zh/guides)。

3、在 Forward Email 中，导航至**我的账户** → **安全**页面，然后复制「开发人员访问 API 令牌」：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/0bYzljpbdqH7AdFqDh7sr/f43a225e5614a00b1dd391f17fbd916d/Screen_Shot_2023-06-30_at_1.06.04_PM.png?w=988&#x26;fm=avif" alt=""><figcaption><p>复制转发的电子邮箱 API 令牌</p></figcaption></figure></div>

4、在 Bitwarden 用户名生成器中，将复制的令牌粘贴到 **API 访问令牌**中，然后输入 `hideaddress.net` 或您已注册的**域名**。

5、选择**重新生成用户名**以生成用户名并在 Forward Email 中自动创建相应的别名。
{% endtab %}

{% tab title="DuckDuckGo " %}
1、按照 [DuckDuckGo 说明](https://duckduckgo.com/email/)设置您的 Duck 地址。

2、设置好 Duck 地址后，选择 DuckDuckGo 电子邮件保护页面上的 **Autofill** 选项卡，然后打开网页浏览器的开发人员工具。

3、单击 **Generate Private Duck Address** 按钮并查看开发人员工具窗口中的 **Network** 选项卡。选择「地址」请求调用的 API POST，然后定位到 API 授权项目。该项目看起来像这样：`authorization: Bearer <API token value>.`

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5Rj9xrPrgp13Pl9KGuap7Z/855fa2f0defc41a68b512b92027bf540/DDG_generate_private_address.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>生成 DuckDuckGo 电子邮箱别名</p></figcaption></figure></div>

4、复制 API 授权令牌的值然后将其粘贴到 Bitwarden 用户名生成器的 **API 密钥**字段中。

5、选择**重新生成用户名**以生成一个用户名并在 DuckDuckGo 中自动创建对应的别名。
{% endtab %}
{% endtabs %}

#### 随机单词 <a href="#random-word" id="random-word"></a>

选择此类型可为您的用户名生成一个随机单词。随机单词的选项包括：

* **大写**：将您的用户名首字母大写。
* **包含数字**：在您的用户名中包含一个 4 位数的数字。


# 密码 & 生成器历史记录

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/password-and-generator-history/)
{% endhint %}

Bitwarden 维护两个独立的历史记录：一个用于保存的登录的密码，另一个用于[生成的用户名、密码和密码短语](/docs/password-manager/your-vault/security-tools/generator)。如果您生成密码后忘记保存，或者重置密码的操作未完成，这对于您查找之前的密码会很有帮助。

## 密码历史记录 <a href="#password-history" id="password-history"></a>

Bitwarden 会为每个[登录项目](/docs/password-manager/your-vault/vault-items/vault-items)存储最近保存的五个密码，包括[已删除](/docs/password-manager/your-vault/vault-items/vault-items#vault-trash)但尚未被永久移除的项目。当您编辑[隐藏的自定义字段](/docs/password-manager/your-vault/vault-items/custom-fields)时，其先前的值也会保存在密码历史记录中，并计入五个已保存条目之一。注销或切换 Bitwarden 客户端不会影响或清除密码历史记录。

{% hint style="warning" %}
访问密码历史记录会立即以纯文本形式显示旧密码。
{% endhint %}

要查看项目的密码历史记录：

{% tabs %}
{% tab title="网页 App" %}
打开项目然后选择**密码历史记录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/RT3R5a33WrejA8qnIcmqa/fed083be7acb5fbedfd52e223a086bb5/Password_history_on_web.png?w=730&#x26;fm=avif" alt=""><figcaption><p>网页 App 中的密码历史记录</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动 App" %}
打开项目然后选择窗口底部附近的**密码历史记录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1RJbcOMMkIfVTprx3NZbyQ/82a1eb915b795d439df8fe91917d65af/Password_history_on_mobile.png?w=1125&#x26;fm=avif" alt=""><figcaption><p>移动 App 中的密码历史记录</p></figcaption></figure></div>
{% endtab %}

{% tab title="浏览器扩展" %}
打开项目然后选择**密码历史记录**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2XVetRKi7VLJ7Ctq7scOll/411a752e576a21b533f326b938ca6fa4/Password_history_on_browser.png?w=372&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展中的密码历史记录</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面 App" %}
打开项目然后选择窗口底部附近的**密码历史记录**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/lvf2rvKuNcJNUYzXOTI99/cef223bdb6cf8f575314705ed12766aa/2026-04-23_11-08-39.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 中的密码历史记录</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}

## 生成器历史记录 <a href="#generator-history" id="generator-history"></a>

您还可以访问[生成器](/docs/password-manager/your-vault/security-tools/generator)的最近历史记录。每一个客户端存储自己生成的用户名、密码和口令；生成器历史记录不会在 Bitwarden 客户端之间同步。注销会擦除该客户端的特定生成器历史记录。

例如，在移动 App 中生成的密码仅出现在移动 App 的生成器历史记录中。它们不会出现在网页 App 的生成器历史记录中，以及注销网页 App 不会移除移动 App 的生成器历史记录。

{% hint style="warning" %}
访问生成器历史记录会立即以纯文本形式显示之前生成的选项。
{% endhint %}

{% tabs %}
{% tab title="网页 App" %}
要访问生成器历史记录：

1. 选择**工具**。
2. 选择**生成器**。
3. 选择**生成器历史记录**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/W3Cbil4ZzaNUgIoarf6Qm/76248637321f4e4314eb0aa89b1f42af/Generator_history_on_web.png?w=1270&#x26;fm=avif" alt=""><figcaption><p>网页 App 中的生成器历史记录</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动 App" %}
生成的密码和密码短语列在移动 App 的生成器历史记录中。目前不包括生成的用户名。

要访问生成器历史记录：

1. 点击 <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i>**生成器图标**。
2. 点击 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>**菜单**图标。
3. 点击**密码历史记录**。
   {% endtab %}

{% tab title="浏览器扩展" %}
要访问生成器历史记录：

1. 选择**生成器**。
2. 向下滚动然后选择**生成器历史记录**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/10EgyHZiwC9p2gkuOdhbkN/52083c2ccc2cbd1abd2bd5afb8cbb74e/Generator_history_on_browser.png?w=379&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展中的生成器历史记录</p></figcaption></figure></div>
{% endtab %}

{% tab title="桌面 App" %}
要访问生成器历史记录，请从菜单栏转到**查看** → **生成器历史记录**。
{% endtab %}
{% endtabs %}

要删除客户端的生成器历史记录，请选择列表下方的**清除历史记录**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1BFNT1klLnRNy3o8NLXGmB/0b21df796fbdc3e26d5ff2a046b82b15/Clear_generator_history.png?w=468&#x26;fm=avif" alt=""><figcaption><p>清除生成器历史记录</p></figcaption></figure></div>


# 密码库健康报告

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/reports/)
{% endhint %}

密码库健康报告可用于评估 Bitwarden 个人或组织密码库的安全性。「重复使用的密码」和「弱密码」等报告可在客户端本地运行。这样就可以在 Bitwarden 无法访问未加密版本数据的情况下识别出违规项目。

{% hint style="info" %}
大多数密码库健康报告适用于高级版用户，包括付费版组织（家庭版、团队版或企业版）的成员。但[数据泄露报告](#data-breach-report-individual-vaults-only)对所有用户都是免费的。
{% endhint %}

## 查看报告 <a href="#view-a-report" id="view-a-report"></a>

个人密码库报告会扫描保存到您个人密码库中的项目，以及您有权访问的组织项目。组织报告将扫描您组织集合中的项目，所有者和管理员可从 Admin Console 访问这些报告。

### 运行个人密码库报告 <a href="#run-an-individual-vault-report" id="run-an-individual-vault-report"></a>

登录到网页 App 然后从导航栏选择**报告**。然后选择要运行的报告：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/JcoKvP7eLrZHUEKmjTqgc/0213680bf5546cfc7df498d9931c8d2f/2024-12-02_16-29-59.png?w=1204&#x26;fm=avif" alt=""><figcaption><p>报告页面</p></figcaption></figure></div>

### 运行组织密码库报告 <a href="#run-an-organization-vault-report" id="run-an-organization-vault-report"></a>

从 Admin Console 访问组织密码库报告：

1、登录到 Bitwarden 网页 App，然后打开 Admin Console：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2uxBDdQa6lu0IgIEfcwMPP/e3de3361749b6496155e25edcfdcf08b/2024-12-02_11-19-56.png?w=1013&#x26;fm=avif" alt=""><figcaption><p>产品切换器</p></figcaption></figure></div>

2、导航到**报告** → **报告**。

3、选择要运行的报告：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5POQmt3TrEgfFzRNwHancg/9a67882a07d8894747ebb5bc3bbdcaae/2024-12-02_16-31-14.png?w=1205&#x26;fm=avif" alt=""><figcaption><p>组织报告</p></figcaption></figure></div>

## 可用的报告 <a href="#available-reports" id="available-reports"></a>

报告可从个人密码库的**报告**页面或管理控制台的**报告** → **报告**页面获取。

### 暴露的密码 <a href="#exposed-passwords" id="exposed-passwords"></a>

「暴露的密码」报告可以识别被黑客公开发布或在暗网上出售的已知数据泄露事件中暴露的密码。

该报告使用受信任的网络服务在已知泄露密码的数据库中检索您所有密码哈希值的前 5 位，然后，将返回的匹配的散列列表与您的密码的完整散列列表进行本地比较。这种比较只在本地进行，以保护你的 [*k*-匿名性](https://zh.wikipedia.org/wiki/K-%E5%8C%BF%E5%90%8D%E6%80%A7)。

被识别后，您应该为违规账户或服务创建一个新的密码。

{% hint style="success" icon="lightbulb" %}
**为什么要使用密码哈希值的前 5 位？**

如果此报告使用您的实际密码来执行，那这些密码是否暴露并不重要了，因为您主动将其泄露给此服务了。并且这个报告的结果并不意味着您的个人账户已被泄露，只是您使用的密码已经在这些暴露的密码数据库中被发现，您应该避免使用泄露的密码和非唯一的密码。
{% endhint %}

### 重复使用的密码 <a href="#reused-passwords" id="reused-passwords"></a>

「重复使用的密码」报告可以识别密码库中的非唯一密码。如果在多个服务中重复使用相同的密码，当一个服务被攻破时，会让黑客轻松获取您的更多在线账户的访问权限。

被识别后，您应该为违规账户或服务创建一个唯一的密码。

### 弱密码 <a href="#weak-passwords" id="weak-passwords"></a>

「弱密码」报告可以识别出容易被黑客和用于破解密码的自动化工具猜中的弱密码，并按弱点的严重性进行排序。Bitwarden 密码生成器可以帮助您创建更强大的密码。该报告使用 [zxcvbn](https://dropbox.tech/security/zxcvbn-realistic-password-strength-estimation) 进行密码强度分析。

被识别后，您应该使用 Bitwarden 密码生成器为违规账户或服务创建一个强密码。

### 不安全网站 <a href="#unsecured-websites" id="unsecured-websites"></a>

「不安全网站」报告可以识别在 URI 中使用不安全 (`http://`) 方案的登录项目。使用 `https://` 的 TLS/SSL 加密通信要安全得多。要了解更多信息，请参阅 [URI 的使用](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)。

被识别后，您应该将违规的 URI 由 `http://` 更改为 `https://`。

### 未激活 2FA <a href="#inactive-2fa" id="inactive-2fa"></a>

「未激活 2FA」报告可以识别如下的登录项目：

* 该服务提供了通过 TOTP 的双重验证 (2FA)
* 您尚未存储 TOTP 验证器密钥

双重验证 (2FA) 是保护您账户安全的一个重要的安全设置。如果网站提供，您应该始终启用双重验证。通过将 URI 数据与来自 <https://2fa.directory/> 的数据进行交叉引用，可以识别出违规项目。

被识别后，使用 `Instructions` （说明）超链接来为每个违规项目设置 2FA。

<div align="left" data-with-frame="true"><figure><img src="https://res.cloudinary.com/bw-com/image/upload/f_auto/v1/ctf/7rncvj1f8mw7/3USpBf7beuGcdJvMhDrwNI/570672e3220f09e0398ced33a154b1ea/inactive-2fa.png?_a=DAJAUVWIZAAB" alt=""><figcaption><p>报告 Instructions</p></figcaption></figure></div>

### 成员访问权限 <a href="#member-access" id="member-access"></a>

「成员访问权限」报告显示每个用户有权访问的**群组**、**集合**和**项目**的总数：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4oNfzpIcDwn2XjUgG0lPG3/a51bac815082055fdd6f47a40937b72d/2024-09-10_16-13-31.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>成员访问权限报告</p></figcaption></figure></div>

要定位特定人员，请在**搜索成员**字段中输入他们的电子邮箱。选择相邻的 **→导出图标**以下载包含每个成员详细信息的 `.csv` 文件，其中包含：

* 基本账户详细信息，包括其**名称**以及是否启用了**两步登录**或**账户恢复**
* 他们的**群组**分配情况
* 他们可以访问哪些**集合**以及拥有的[**集合权限**](/docs/admin-console/manage-shared-items/collections/collection-permissions)级别
* 成员可以访问的**总计项目**数量

{% hint style="success" icon="lightbulb" %}
您还可以下载 `.csv` [成员列表](/docs/admin-console/manage-members/user-management#download-list-of-members)，其中包括特定账户的详细信息，例如 Secrets Manager 是否已激活以及他们在组织中的状态。
{% endhint %}

### 数据泄露（仅个人密码库） <a href="#data-breach-individual-vaults-only" id="data-breach-individual-vaults-only"></a>

「数据泄露」报告使用一项名为 Have I Been Pwned (HIBP) 的服务来识别已知事件中的泄露数据（电子邮箱地址、密码、信用卡、DoB 等）。

> **\[译者注]**：DoB：Date of Birth，出生日期

当您创建一个 Bitwarden 账户时，您可以选择在您决定使用主密码之前运行此报告。要运行此报告，您的主密码的哈希值将发送到 HIBP，并与存储的已暴露哈希值进行比较。Bitwarden 永远不会泄露您的主密码。

HIBP 将「泄漏」定义为「通常是由于访问控制不足或软件的安全弱点造成数据在脆弱的系统中无意中暴露的事件」。更多信息，请参阅 [HIBP 常见问题文档](https://haveibeenpwned.com/FAQs)。

{% hint style="info" %}
如果您是自托管 Bitwarden，想要在您的实例中运行数据泄露报告，您需要购买 HIBP 订阅密钥，该密钥将授权您对 API 进行调用。可以[在此处](https://haveibeenpwned.com/API/Key)购买此密钥。

拥有此密钥后，打开 `./bwdata/env/global.override.env` 并将 `globalSetting__hibpApiKey=` 的占位符值 `REPLACE` 替换为您购买的 API 密钥：

```yaml
globalSettings__hibpApiKey=REPLACE
```

更多信息，请参阅[配置环境变量](/docs/self-hosting/deploy-and-configure/configuration-options/environment-variables)。
{% endhint %}


# 更改存在风险的密码

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/change-at-risk-passwords/)
{% endhint %}

Bitwarden 会在您的密码库中显示**审查并更改存在风险的密码**，或在已打开的登录项目的密码字段下方显示**存在风险的密码**或**立即更改**标签，提示您更新弱密码、重复使用的密码或已暴露的密码。更换存在风险的密码可以增强您的整体安全性，并降低账户被入侵的风险。

此通知的出现有以下两个原因：

* 作为组织成员，管理团队识别出了弱密码、重复使用的密码或已暴露的密码，然后要求您更新。您可能还会收到电子邮件通知。该横幅会出现在浏览器扩展的**密码库**视图中，您可能还会收到关于存在风险密码的电子邮件：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2N1WqXBUVvutN9qQR73WbQ/ad56aeac00234010b56e1cc74a4ba542/2025-04-25_13-08-23.png?w=980&#x26;fm=avif" alt=""><figcaption><p>更改存在风险的密码</p></figcaption></figure></div>

* 作为高级版用户，Bitwarden 通过[密码库健康报告](/docs/password-manager/your-vault/security-tools/vault-health-reports)自动识别出您的密码库中的弱密码、重复使用的密码或已暴露的密码。当您在浏览器扩展、桌面 App 和网页 App 中打开**查看登录**页面时，会显示此通知。

在浏览器扩展中，点击此横幅并使用**更改**按钮，以将每个存在风险的密码更新为更强的新密码。或者，在每个被标记的登录项目中选择**立即更改**按钮。大多数情况下，浏览器扩展会直接跳转到该服务的密码修改页面。请记住：

* 您必须在网站的「更改密码」表单中以及在 Bitwarden 密码库中同时更改此密码。
* 您应该使用[密码生成器](/docs/password-manager/your-vault/security-tools/generator#liu-lan-qi-kuo-zhan)创建一个强大且唯一的新密码。


# 主密码二次验证

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/master-password-re-prompt/)
{% endhint %}

对于任何[项目](/docs/password-manager/your-vault/vault-items/vault-items)，您可在添加或编辑界面启用**主密码二次验证**选项，以要求在访问或自动填充密码库中的敏感项目时验证您的[主密码](/docs/account/master-password)：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/sgKb0RX5hGdrdKLmXcR0R/f78654839e18b3f474dd3e95ed0d203c/2024-12-02_14-38-06.png?w=1036&#x26;fm=avif" alt=""><figcaption><p>主密码重新提示</p></figcaption></figure></div>

根据您使用的 App 不同，主密码二次验证功能的行为略有差异，例如：

* 在启用该功能的网页 App、浏览器扩展和桌面 App 中，查看项目或编辑任何内容时均需重新输入主密码。
* 在移动 App 中，仅查看隐藏字段（如密码、隐藏的自定义字段、信用卡卡号）时需重新输入主密码。编辑该条目的任何内容时同样需要重新输入主密码。

未设置主密码的用户（例如使用[受信任设备 SSO](/docs/admin-console/login-with-sso/trusted-devices/about-trusted-devices) 或 [Key Connector](/docs/self-hosting/key-connector/about-key-connector) 的组织用户）将无法使用主密码二次验证功能。此外，使用[紧急访问](/docs/account/emergency-access/about-emergency-access#use-emergency-access)的受信任联系人查看受保护的密码库项目时无需重新输入主密码。

{% hint style="warning" %}
主密码二次验证**并非**一种加密机制。该功能仅作为界面层面的防护措施，技术娴熟的用户可能找到绕过它的方法。建议您在离开无人看管的设备或使用共享工作站时，**务必**保持密码库处于锁定状态。
{% endhint %}


# 管理设备

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/manage-devices/)
{% endhint %}

**设备**列表显示所有已登录您账户的 Bitwarden 客户端 App。对于每台设备，您可以查看客户端类型、上次活动时间以及首次登录您账户的时间。您还可以使用此列表批准或拒绝[来自其他设备的登录请求](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device#approve-a-log-in-request)或[设备信任请求](/docs/account/log-in-and-unlock/using-single-sign-on/add-a-trusted-device)。

{% hint style="info" %}
**设备**是指您登录过的 Bitwarden App 的唯一安装实例。重新安装 App、清除 App 数据或清除 Cookie 可能会导致同一设备多次出现。
{% endhint %}

要查看**设备**列表：

* 在网页 App 中，导航至**设置** → **安全** → **设备**。
* 在浏览器扩展中，导航至**设置** → **账户安全** → **设备**。
* 在桌面 App 中，使用菜单栏导航至**账户** → **设备**。
* 在移动 App 中，导航至**账户安全** → **设备**。

在**设备**列表中，您会看到每一行对应一台设备，其包含以下内容：

| 列    | 描述                                                                                                                                                                                                                                                                                                                                                                                  |
| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 设备   | 设备的类型，例如**移动端**或**扩展**，以及其操作系统或平台，例如 **iOS** 或 **Firefox**。                                                                                                                                                                                                                                                                                                                         |
| 最近活动 | <p>设备上次处于活动状态的时间范围，例如<strong>过去 14 天</strong>，或者：</p><p></p><p>- <strong>当前会话</strong>：表示您当前正在使用的设备。<br>- <strong>请求待处理</strong>：表示来自设备的<a href="/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device#approve-a-log-in-request">登录请求</a>或<a href="/docs/account/log-in-and-unlock/using-single-sign-on/add-a-trusted-device">设备信任请求</a>。选择此设备以批准或拒绝请求。</p> |
| 首次登录 | 设备首次登录您的 Bitwarden 账户的日期和时间。                                                                                                                                                                                                                                                                                                                                                        |


# \*Phishing Blocker

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/phishing-blocked/)
{% endhint %}

Bitwarden Phishing Blocker 用于检测已知的网络钓鱼网站，并将用户重定向到安全的通知页面，从而确保凭据不会被误输入或被泄露。Phishing Blocker 使用定期更新的开源的 [Phishing.Database](https://github.com/Phishing-Database/Phishing.Database) 来识别网络钓鱼网站。

{% hint style="info" %}
目前，Phishing Blocker 不适用于 Bitwarden Safari 浏览器扩展。
{% endhint %}

## 使用 Phishing Blocker  <a href="#use-phishing-blocker" id="use-phishing-blocker"></a>

默认情况下，Phishing Blocker 适用于个人高级版和家庭版用户。要使用 Phishing Blocker，您必须登录 Bitwarden 浏览器扩展。当 Phishing Blocker 识别出已知的网络钓鱼网站时：

1、Bitwarden 不会加载已知的网络钓鱼网站，而是会将用户重定向到一个警告页面，提示该网站已被拦截。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7IDSIId3ZA7nRT1T8gdX1T/3382ba87ffa5a38d8fa68b03d4ea0dcc/Phiishing-blocker-cropped.png?w=542&#x26;fm=jpg" alt="钓鱼拦截器"><figcaption></figcaption></figure></div>

2、选择合适的选项：

* **关闭标签页**：选择此选项将关闭 Bitwarden 已拦截的恶意标签页。
* **继续**：选择此选项将允许您继续访问该网站并关闭 Bitwarden Phishing Blocker。

{% hint style="warning" %}
选择**继续**将访问之前被识别为存在网络钓鱼活动的网站。此操作可能会导致您的凭据泄露。建议谨慎选择此选项。
{% endhint %}

若您选择**继续**并认为该网站被误判为网络钓鱼网站，[请向 Phishing.Database 提交误报报告](https://github.com/Phishing-Database/Phishing.Database/issues/new?template=00-false-positive.yml)。

## 切换 Phishing Blocker <a href="#toggle-phishing-blocker" id="toggle-phishing-blocker"></a>

您可以在浏览器扩展中通过导航至**设置** → **账户安全**，然后选择开关来**打开**或**关闭** Phishing Blocker：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4jeEBHYQeUpsZNOoKKUeW1/d19fe64cfed2edba32983f45c5434490/phishing_setting.png?w=750&#x26;fm=jpg" alt="切换钓鱼拦截器"><figcaption><p>切换 Phishing Blocker</p></figcaption></figure></div>

## 工作原理 <a href="#how-it-works" id="how-it-works"></a>

Bitwarden Phishing Blocker 使用 Phishing.Database 来引用已知的网络钓鱼网站。这个开源工具由用户每日更新，用于识别有害的 URL。

{% hint style="info" %}
所有网站检查均由 Bitwarden 浏览器扩展在本地执行。任何数据都不会与 Bitwarden 或第三方共享。
{% endhint %}

1. Bitwarden 浏览器扩展直接从 Phishing.Database 获取列表。
2. Bitwarden API 使用 SHA-256 校验和来识别列表的更改并获取更新后的列表。
3. 使用浏览器扩展，Bitwarden 会在页面加载时将 URL 与网络钓鱼列表进行比对。
4. 如果网站与网络钓鱼数据库中的已知威胁匹配，Bitwarden 会将您带到拦截界面，并提供离开网站或继续访问的选项。


# 外观


# 更改 App 外观

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/change-theme/)
{% endhint %}

Bitwarden 网页密码库、浏览器扩展、桌面 App 和移动 App 都包含有时尚的主题。浏览器扩展还包含一些其他外观选项：

{% tabs %}
{% tab title="网页 App" %}
要更改网页 App 的主题：

1、导航至**设置** → **外观**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7vKmhsOfJqieQbYRxALV75/0ed7782f100100ab3d86567e6b1b0a9d/2025-12-31_10-27-36.png?w=1044&#x26;fm=avif" alt=""><figcaption><p>网页 App 外观</p></figcaption></figure></div>

2、从**主题**下拉菜单中，选择您喜欢的主题然后选择**保存**！
{% endtab %}

{% tab title="浏览器扩展" %}
要更改浏览器扩展的主题：

1、打开浏览器扩展的 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡。

2、选择**外观**。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6IZpsItvhtnImItOfXJ9HW/5502397e3024f97c473eaf05fc7cb9cd/2024-12-03_10-51-17.png?w=970&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展选择主题</p></figcaption></figure></div>

3、使用**主题**下拉菜单选择您喜欢的主题。

4、使用**扩展宽度**选项以扩大浏览器扩展的尺寸。

5、使用**紧凑模式**以提高浏览器扩展中显示的信息密度。
{% endtab %}

{% tab title="桌面端" %}
要更改桌面 App 的主题：

1、打开桌面 App 的**偏好设置**面板（Windows 上为**文件** → **设置**；macOS 上为 **Bitwarden** → **偏好设置**）。&#x20;

2、滚动到 **App 设置**部分，然后使用**主题**下拉菜单选择您喜欢的主题！

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7dOzSglXr4rlM97zKoqptq/5c07e025316518564fd77207944fd546/2026-01-28_11-16-18.png?w=988&#x26;fm=avif" alt=""><figcaption><p>桌面端更改主题</p></figcaption></figure></div>

{% hint style="success" %}
桌面 App 中的主题是为所有已登录账户全局设置的。[了解更多](/docs/account/log-in-and-unlock/account-switching)。
{% endhint %}
{% endtab %}

{% tab title="移动端" %}
要更改移动 App 的主题：

1、打开移动 App 的 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡。&#x20;

2、点击**外观**。&#x20;

3、点击**主题**选项选择您喜欢的主题！

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/ntCXOl03Oi6zmXx5Z9j5C/1329fb58540811d4b195b638b2628aca/2025-05-20_15-28-44.png?w=720&#x26;fm=avif" alt=""><figcaption><p>移动端更改主题</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
在 Android 上，您还可以使用**动态颜色**选项，使 Bitwarden 的配色方案与您的壁纸相匹配。
{% endhint %}
{% endtab %}
{% endtabs %}


# 本地化

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/localization/)
{% endhint %}

## 更改 App 语言 <a href="#change-app-language" id="change-app-language"></a>

要更改 Bitwarden App 的语言：

{% tabs %}
{% tab title="网页 App" %}
Bitwarden 网页 App 默认使用您的网页浏览器语言，而网页浏览器语言通常由您设备的系统语言决定。要手动覆盖此默认设置并为 Bitwarden 网页 App 设置其他语言：

1、从导航中选择**设置** → **外观**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7vKmhsOfJqieQbYRxALV75/0ed7782f100100ab3d86567e6b1b0a9d/2025-12-31_10-27-36.png?w=1044&#x26;fm=avif" alt=""><figcaption><p>网页 App 外观</p></figcaption></figure></div>

2、从**语言**下拉菜单中选择一种语言。
{% endtab %}

{% tab title="桌面端" %}
Bitwarden 桌面 App 默认使用您设备的系统语言，要覆盖此默认设置并为 Bitwarden 桌面 App 设置其他语言：

1、打开桌面 App 的**偏好设置**面板（在 Windows 上，**文件** → **设置**）（在 macOS 上，**Bitwarden** → **偏好设置**）。

2、滚动到 **App 设置**部分的底部，然后使用**语言**下拉菜单选择您的语言。

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6NSZV46oKRi7Roeu7g2ATZ/8a7cacb71d48d47bb11c7ef46ec88903/2026-04-23_11-12-59.png?w=800&#x26;fm=avif" alt=""><figcaption><p>桌面 App 语言设置</p></figcaption></figure></div>
{% endtab %}

{% tab title="移动端" %}
Bitwarden 移动 App 默认使用您设备的系统语言，要覆盖此默认设置并为 Bitwarden 移动 App 设置其他语言：

1、打开移动 App 然后点击**设置**选项卡。

2、点击**外观**。

3、定位到**语言**字段然后选择您的首选语言。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5pqOwt6W99sLHRCpN1DX1w/bc3581ebc015c0343c116c5eb609e2f5/2025-01-21_15-19-31.png?w=715&#x26;fm=avif" alt=""><figcaption><p>移动端语言设置</p></figcaption></figure></div>

4、重新启动应用程序以应用更改。
{% endtab %}

{% tab title="浏览器扩展" %}
Bitwarden 浏览器扩展默认使用您的网页浏览器语言，而网页浏览器语言通常由您设备的系统语言决定。浏览器扩展本身没有更改语言的设置，更改网页浏览器的语言也会更改扩展的语言。

* [了解如何更改 Chrome 的语言](https://support.google.com/chrome/answer/173424?co=GENIE.Platform%3DDesktop\&hl=zh-Hans)
* [了解如何更改 Firefox 的语言](https://support.mozilla.org/zh-CN/kb/%E4%BD%BF%E7%94%A8%E8%AF%AD%E8%A8%80%E5%8C%85%E6%94%B9%E5%8F%98Firefox%E7%95%8C%E9%9D%A2%E8%AF%AD%E8%A8%80)
  {% endtab %}
  {% endtabs %}

## 目前支持的语言 <a href="#currently-supported-languages" id="currently-supported-languages"></a>

目前支持以下语言。请注意，**并非所有语言都适用于所有客户端应用程序**：

| 符号    | 语言-原始               | 语言-中文                                                                                                                   |
| ----- | ------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| af    | Afrikaans           | [南非语](https://zh.wikipedia.org/wiki/%E5%8D%97%E9%9D%9E%E8%AA%9E)                                                        |
| az    | Azərbaycanca        | [阿塞拜疆语](https://zh.wikipedia.org/wiki/%E9%98%BF%E5%A1%9E%E6%8B%9C%E7%96%86%E8%AF%AD)                                    |
| be    | Беларуская          | [白俄罗斯语](https://zh.wikipedia.org/wiki/%E7%99%BD%E4%BF%84%E7%BD%97%E6%96%AF%E8%AF%AD)                                    |
| bg    | български           | [保加利亚语](https://zh.wikipedia.org/wiki/%E4%BF%9D%E5%8A%A0%E5%88%A9%E4%BA%9A%E8%AF%AD)                                    |
| ca    | català              | [加泰隆语](https://zh.wikipedia.org/wiki/%E5%8A%A0%E6%B3%B0%E9%9A%86%E8%AF%AD)                                              |
| cs    | čeština             | [捷克语](https://zh.wikipedia.org/wiki/%E6%8D%B7%E5%85%8B%E8%AF%AD)                                                        |
| da    | dansk               | [丹麦语](https://zh.wikipedia.org/wiki/%E4%B8%B9%E9%BA%A6%E8%AF%AD)                                                        |
| de    | Deutsch             | [德语](https://zh.wikipedia.org/wiki/%E5%BE%B7%E8%AF%AD)                                                                  |
| el    | Ελληνικά            | [现代希腊语](https://zh.wikipedia.org/wiki/%E5%B8%8C%E8%85%8A%E8%AF%AD)                                                      |
| en    | English             | [英语](https://zh.wikipedia.org/wiki/%E8%8B%B1%E8%AF%AD)                                                                  |
| en-GB | English (British)   | [英国英语](https://zh.wikipedia.org/wiki/%E8%8B%B1%E5%9C%8B%E8%8B%B1%E8%AA%9E)                                              |
| eo    | Esperanto           | [世界语](https://zh.wikipedia.org/wiki/%E4%B8%96%E7%95%8C%E8%AF%AD)                                                        |
| es    | español             | [西班牙语](https://zh.wikipedia.org/wiki/%E8%A5%BF%E7%8F%AD%E7%89%99%E8%AF%AD)                                              |
| et    | eesti               | [爱沙尼亚语](https://zh.wikipedia.org/wiki/%E7%88%B1%E6%B2%99%E5%B0%BC%E4%BA%9A%E8%AF%AD)                                    |
| fa    | فارسی               | [波斯语](https://zh.wikipedia.org/wiki/%E6%B3%A2%E6%96%AF%E8%AF%AD)                                                        |
| fi    | suomi               | [芬兰语](https://zh.wikipedia.org/wiki/%E8%8A%AC%E5%85%B0%E8%AF%AD)                                                        |
| fr    | français            | [法语](https://zh.wikipedia.org/wiki/%E6%B3%95%E8%AF%AD)                                                                  |
| he    | עברית               | [希伯来语](https://zh.wikipedia.org/wiki/%E5%B8%8C%E4%BC%AF%E6%9D%A5%E8%AF%AD)                                              |
| hi    | हिन्दी              | [印地语](https://zh.wikipedia.org/wiki/%E5%8D%B0%E5%9C%B0%E8%AF%AD)                                                        |
| hr    | hrvatski            | [克罗地亚语](https://zh.wikipedia.org/wiki/%E5%85%8B%E7%BD%97%E5%9C%B0%E4%BA%9A%E8%AF%AD)                                    |
| hu    | magyar              | [匈牙利语](https://zh.wikipedia.org/wiki/%E5%8C%88%E7%89%99%E5%88%A9%E8%AF%AD)                                              |
| id    | Bahasa Indonesia    | [印尼语](https://zh.wikipedia.org/wiki/%E5%8D%B0%E5%B0%BC%E8%AF%AD)                                                        |
| it    | italiano            | [意大利语](https://zh.wikipedia.org/wiki/%E6%84%8F%E5%A4%A7%E5%88%A9%E8%AF%AD)                                              |
| ja    | 日本語                 | [日语](https://zh.wikipedia.org/wiki/%E6%97%A5%E8%AF%AD)                                                                  |
| ko    | 한국어                 | [朝鲜语](https://zh.wikipedia.org/wiki/%E6%9C%9D%E9%B2%9C%E8%AF%AD)、[韩语](https://zh.wikipedia.org/wiki/%E9%9F%A9%E8%AF%AD) |
| lv    | Latvietis           | [拉脱维亚语](https://zh.wikipedia.org/wiki/%E6%8B%89%E8%84%B1%E7%BB%B4%E4%BA%9A%E8%AF%AD)                                    |
| ml    | മലയാളം              | [马拉雅拉姆语](https://zh.wikipedia.org/wiki/%E9%A9%AC%E6%8B%89%E9%9B%85%E6%8B%89%E5%A7%86%E8%AF%AD)                          |
| nb    | norsk (bokmål)      | [书面挪威语](https://zh.wikipedia.org/wiki/%E6%9B%B8%E9%9D%A2%E6%8C%AA%E5%A8%81%E8%AA%9E)                                    |
| nl    | Nederlands          | [荷兰语](https://zh.wikipedia.org/wiki/%E8%8D%B7%E5%85%B0%E8%AF%AD)                                                        |
| pl    | polski              | [波兰语](https://zh.wikipedia.org/wiki/%E6%B3%A2%E5%85%B0%E8%AF%AD)                                                        |
| pt-BR | português do Brasil | [巴西葡萄牙语](https://zh.wikipedia.org/zh-tw/%E5%B7%B4%E8%A5%BF%E8%91%A1%E8%90%84%E7%89%99%E8%AF%AD)                         |
| pt-PT | português           | [葡萄牙语](https://zh.wikipedia.org/wiki/%E8%91%A1%E8%90%84%E7%89%99%E8%AF%AD)                                              |
| ro    | română              | [罗马尼亚语](https://zh.wikipedia.org/wiki/%E7%BD%97%E9%A9%AC%E5%B0%BC%E4%BA%9A%E8%AF%AD)                                    |
| ru    | русский             | [俄语](https://zh.wikipedia.org/wiki/%E4%BF%84%E8%AF%AD)                                                                  |
| sk    | slovenčina          | [斯洛伐克语](https://zh.wikipedia.org/wiki/%E6%96%AF%E6%B4%9B%E4%BC%90%E5%85%8B%E8%AF%AD)                                    |
| sr    | Српски              | [塞尔维亚语](https://zh.wikipedia.org/wiki/%E5%A1%9E%E5%B0%94%E7%BB%B4%E4%BA%9A%E8%AF%AD)                                    |
| sv    | svenska             | [瑞典语](https://zh.wikipedia.org/wiki/%E7%91%9E%E5%85%B8%E8%AF%AD)                                                        |
| th    | ไทย                 | [泰语](https://zh.wikipedia.org/wiki/%E6%B3%B0%E8%AF%AD)                                                                  |
| tr    | Türkçe              | [土耳其语](https://zh.wikipedia.org/wiki/%E5%9C%9F%E8%80%B3%E5%85%B6%E8%AF%AD)                                              |
| uk    | українська          | [乌克兰语](https://zh.wikipedia.org/wiki/%E4%B9%8C%E5%85%8B%E5%85%B0%E8%AF%AD)                                              |
| vi    | Tiếng Việt          | [越南语](https://zh.wikipedia.org/wiki/%E8%B6%8A%E5%8D%97%E8%AF%AD)                                                        |
| zh-CN | 中文（中国大陆）            | [简体中文](https://zh.wikipedia.org/wiki/%E7%AE%80%E5%8C%96%E5%AD%97)                                                       |
| zh-TW | 中文（台灣）              | [繁体中文](https://zh.wikipedia.org/wiki/%E7%B9%81%E4%BD%93%E5%AD%97)                                                       |

> **\[译者注]**：更多语言代码参阅 [ISO 639-1](https://zh.wikipedia.org/wiki/ISO_639-1)。

## 看不到您的语言吗？ <a href="#dont-see-your-language" id="dont-see-your-language"></a>

如果您的语言没有在网页密码库或桌面 App 中列出，或者您的浏览器扩展或移动 App 没有动态地使用您的语言，**我们需要您的帮助！**

Bitwarden 使用一个名为 [Crowdin](https://crowdin.com/) 的翻译工具来管理我们在许多不同语言上的本地化工作（**无需编程知识**）。

* 要对现有的翻译做出贡献或进行修改，[请加入我们的项目](https://crowdin.com/projects/kspearrin)。
* 要开始将 Bitwarden 翻译成一种新的语言，请加入我们的项目并联系[项目所有者](https://crowdin.com/profile/tgreer)。


# 同步密码库

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/vault-sync/)
{% endhint %}

通过任何 Bitwarden App 添加、编辑或删除[密码库项目](/docs/password-manager/your-vault/vault-items/vault-items)后，都会自动推送更改到您的 Bitwarden 服务器，无论是云托管还是自托管。

为了将这些更改拉取到其他 Bitwarden App，您的密码库将需要同步。

## 自动同步 <a href="#automatic-sync" id="automatic-sync"></a>

您的个人[网页密码库](/docs/password-manager/getting-started/getting-started-webvault)拥有的项目将始终保持同步。组织拥有的项目将跨用户和客户端应用程序每 30 分钟自动同步一次。

Bitwarden App（桌面 App、浏览器扩展、移动 App 和 CLI）将在登录时自动同步，并在解锁时定期同步。您也可以[手动同步](/docs/password-manager/your-vault/syncing-your-vault#what-is-vault-syncing-1)您的密码库，以立即拉取更改。

{% hint style="info" %}
当您在新设备上安装 Bitwarden 时，登录到您现有的账户将自动拉取您的最新密码库数据。
{% endhint %}

## 手动同步 <a href="#manual-sync" id="manual-sync"></a>

要从 Bitwarden App 手动同步密码库：

{% tabs %}
{% tab title="浏览器扩展" %}
在 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡中，选择**密码库选项**然后使用**立即同步密码库**按钮。
{% endtab %}

{% tab title="移动端" %}
打开 <i class="fa-gear-complex">:gear-complex:</i>**设置**标签，点击**其他**选项然后点击**立即同步密**。

切换**启用刷新时同步**选项，以允许在 <i class="fa-lock-keyhole">:lock-keyhole:</i>**我的密码库**选项卡上使用下拉手势来同步密码库。
{% endtab %}

{% tab title="桌面端" %}
从菜单栏选择**文件** → **同步密码库**。

{% hint style="info" %}
只有[当前活动的账户](/docs/account/log-in-and-unlock/account-switching)会同步，即使密码库被锁定，账户也能被同步。
{% endhint %}
{% endtab %}

{% tab title="CLI" %}
使用 `sync` 命令来手动同步您的密码库：

```batch
bw sync
```

更多详情，请参阅 Bitwarden [CLI 文档](/docs/password-manager/developer-tools/cli/password-manager-cli)。
{% endtab %}
{% endtabs %}

## 故障排除 <a href="#troubleshooting" id="troubleshooting"></a>

如果您的密码库无法正常同步，请检查以下内容：

### 时间戳不匹配 <a href="#mismatched-timestamp" id="mismatched-timestamp"></a>

请确认您设备的时间是否正确，例如您所在的时区。Bitwarden 使用TLS/SSL，如果时间戳不匹配，Bitwarden app 将无法连接到服务器。

### VPN 或广告拦截器干扰 <a href="#vpn-or-ad-blocker-interference" id="vpn-or-ad-blocker-interference"></a>

在某些情况下，VPN 或广告拦截器浏览器扩展可能会干扰 Bitwarden app 与服务器之间的连接。此问题通常出现在浏览器扩展上。请尝试关闭 VPN 或广告拦截器浏览器扩展，然后[手动同步您的密码库](#manual-sync)。


# 客户端 App 设置

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/app-settings/)
{% endhint %}

以下章节列出了 Bitwarden Password Manager App 可用的设置：

## 浏览器扩展 <a href="#browser-extension" id="browser-extension"></a>

<details>

<summary><strong>账户安全</strong></summary>

* **解锁选项**：
  * **使用生物识别解锁**：设置[生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)。
    * **启动时提示生物识别**：允许在首次启动时使用生物识别解锁 Bitwarden。
  * **使用 PIN 码解锁**：设置 [PIN 码解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)。
    * **浏览器重启时要求主密码**：在首次启动时要求使用主密码解锁 Bitwarden。
* **密码库超时**：
  * **超时时间**：设置 Bitwarden 在[超时前](/docs/account/log-in-and-unlock/vault-timeout-options#session-timeout)保持活动的时长。
  * **超时动作**：设置 Bitwarden 在[超时时](/docs/account/log-in-and-unlock/vault-timeout-options#session-timeout-action)将执行的动作。
* **管理设备**：使用[另一台设备](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)或[受信任的设备](/docs/account/log-in-and-unlock/using-single-sign-on/add-a-trusted-device)批准登录请求。
* **其他选项**：
  * **指纹短语**：查看您账户的[指纹短语](/docs/security/encryption/account-fingerprint-phrase)。
  * **两步登录**：打开网页 App 以设置[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。
  * **更改主密码**：打开网页 App 以[更改您的主密码](/docs/account/master-password#change-your-master-password)。

</details>

<details>

<summary><strong>自动填充</strong></summary>

* **自动填充建议**：
  * **在表单字段显示自动填充建议**：激活[内嵌自动填充菜单](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#inline-menu)。
    * **将身份显示为建议**：在内嵌自动填充菜单中包含[身份](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities)。
    * **将支付卡显示为建议**：在内嵌自动填充菜单中包含[支付卡](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities)。
    * **选择图标时显示建议**：点击内嵌图标以激活自动填充菜单，而不仅仅是聚焦于填充字段。
* **将 Bitwarden 设为默认密码管理器**：（仅限 Chrome）[禁用浏览器的内置密码管理器](/docs/password-manager/autofill/troubleshoot-autofill/disable-a-browsers-built-in-password-manager)，并将 Bitwarden 设为默认。
* **在密码库视图中始终将支付卡显示为自动填充建议**：在密码库视图的自动填充建议区域显示所有支付卡。
* **在密码库视图中始终将身份显示为自动填充建议**：在密码库视图的自动填充建议区域显示所有身份。
* **自动填充快捷键**：
  * **管理快捷键**：为 Bitwarden 设置自定义键盘快捷键。
* **页面加载时自动填充**：
  * **页面加载时自动填充**：激活[页面加载时自动填充](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#on-page-load)。
  * **登录项目的默认自动填充设置**：设置项目在[页面加载时自动填充](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#on-page-load)的默认值。此默认值可以被单个项目覆盖。
* **附加选项**：
  * **显示上下文菜单选项**：允许[通过上下文菜单](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#context-menu)访问 Bitwarden 选项（通常使用右键点击）。
  * **自动复制 TOTP**：凭据被用于自动填充后，[自动将 TOTP 复制到剪贴板](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#totp-autofill)。
  * **清除剪贴板**：设置何时清除从 Bitwarden 复制到您剪贴板的内容。
  * **默认 URL 匹配检测**：设置 [Bitwarden 识别自动填充建议](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)的默认方式。
  * **屏蔽域名**：设置一个域名列表，[阻止 Bitwarden 为其使用自动填充](/docs/password-manager/autofill/more-autofill-options/blocking-autofill)。

</details>

<details>

<summary><strong>通知</strong></summary>

* **保存到密码库选项**：
  * **询问保存和使用通行密钥**：网站或服务支持通行密钥时，[允许 Bitwarden 创建和自动填充通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)。
  * **询问添加登录**：当您使用未存储在 Bitwarden 中的凭据登录时，允许 Bitwarden [提示您新增项目](/docs/password-manager/autofill/autofill-from/autosave-from-browser-extensions#ask-to-add-login)。
  * **询问更新现有登录**：当使用的凭据与 Bitwarden 中存储的凭据不匹配时，允许 Bitwarden [提示您更新项目](/docs/password-manager/autofill/autofill-from/autosave-from-browser-extensions#ask-to-update-existing-login)。
* **排除域名**：设置一个域名列表，阻止提示添加或更新。

</details>

<details>

<summary><strong>密码库选项</strong></summary>

* **文件夹**：添加或编辑[文件夹](/docs/password-manager/your-vault/vault-navigation/folders)。
* **导入项目**：将数据[导入您的密码库](/docs/password-manager/import-and-export/import-data)或[导入组织](/docs/admin-console/manage-shared-items/import-organization-items/import-to-organization)。
* **导出密码库**：[从您的密码库导出](/docs/password-manager/import-and-export/export-vault-data)或[从您的组织中导出](/docs/admin-console/manage-shared-items/export-organization-items/export-organization-items)数据。
* **回收站**：查看[最近删除](/docs/password-manager/your-vault/vault-items/vault-items#delete)的项目。
* **立即同步**：手动触发[密码库同步](/docs/password-manager/your-vault/syncing-your-vault)。

</details>

<details>

<summary><strong>外观</strong></summary>

* **主题**：切换 Bitwarden 的颜色模式（浅色模式、深色模式或跟随系统）。
* **扩展宽度**：切换扩展窗口的宽度（默认、宽或超宽）。
* **紧凑模式（beta 版）**：压缩扩展中元素之间的空白空间。
* **在扩展图标上显示自动填充建议的登录数量**：在扩展图标上显示可用于此页面的自动填充建议的数量。
* **显示动画**：在您使用浏览器扩展时，显示动画，例如在切换视图时的滑动效果。
* **密码库自定义**
  * **显示网站图标并获取更改密码的 URL**：允许 Bitwarden 获取存储在您密码库中的凭据的[网站图标](/docs/security/data/website-icons)和[更改密码的 URL](/docs/password-manager/your-vault/security-tools/change-at-risk-passwords)。
  * **在密码库上显示快速复制操作**：在密码库视图中的每个项目上显示[用于复制用户名或密码的按钮](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#copy-credentials)。
  * **点击自动填充建议中的项目以填充**：[点击密码库视图中的项目](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#click-items)以自动填充其凭据，而不是点击「填充」按钮。

</details>

## 移动端 <a href="#mobile" id="mobile"></a>

<details>

<summary><strong>账户安全</strong></summary>

* **批准登录请求**：
  * **待处理的登录请求**：使用[另一台设备](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/log-in-with-device)或[受信任的设备](/docs/account/log-in-and-unlock/using-single-sign-on/add-a-trusted-device)批准登录请求。
* **解锁选项**：
  * **使用生物识别/面容 ID/触控 ID 解锁**：设置[生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)。
  * **使用 PIN 码解锁**：设置 [PIN 码解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)。
    * **App 重启时要求主密码**：首次启动时要求使用主密码解锁 Bitwarden。
* **验证器同步**：
  * **允许验证器同步**：允许 Bitwarden Password Manager 将[验证码同步到 Bitwarden Authenticator](/docs/bitwarden-authenticator/totp-sync)。
* **会话超时**：
  * **超时时间**：设置 Bitwarden 在[超时前](/docs/account/log-in-and-unlock/vault-timeout-options#session-timeout)保持活动的时长。
  * **超时动作**：设置 Bitwarden 在[超时时](/docs/account/log-in-and-unlock/vault-timeout-options#session-timeout-action)将执行的动作。
* **其他**：
  * **指纹短语**：查看您账户的[指纹短语](/docs/security/encryption/account-fingerprint-phrase)。
  * **两步登录**：打开网页 App 以设置[两步登录](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)。
  * **更改主密码**：打开网页 App 以[更改您的主密码](/docs/account/master-password#change-your-master-password)。

</details>

<details>

<summary><strong>自动填充 (Android)</strong></summary>

* **自动填充服务**：允许 Bitwarden [使用您保存的登录信息登录](/docs/password-manager/autofill/autofill-from/autofill-from-android)您的设备上的 App 和网站。这将要求您在后续窗口中选择 Bitwarden 作为您首选的服务。
  * **显示自动填充建议**：选择是否在键盘（[内嵌](/docs/password-manager/autofill/autofill-from/autofill-from-android#inline)）或输入字段上方（[弹窗](/docs/password-manager/autofill/autofill-from/autofill-from-android#popup)）显示自动填充建议。
* **通行密钥管理**：打开 Android App 设置，[将 Bitwarden 设为您的首选的通行密钥提供程序](/docs/password-manager/autofill/autofill-from/autofill-from-android#using-passkeys)。
  * **特权 App**：了解更多有关 Bitwarden 在您使用通行密钥时如何保护您免受网络钓鱼的信息。
* **使用无障碍功能**：允许在无障碍菜单中将自动填充作为[快速操作磁贴](/docs/password-manager/autofill/autofill-from/autofill-from-android#quick-action-tiles)使用。这将要求您在后续窗口中为 Bitwarden 开启无障碍功能。
* **自动复制 TOTP**：凭据被用于自动填充后，自动将 [TOTP](/docs/password-manager/your-vault/security-tools/totp) 复制到剪贴板。
* **询问添加项目**：在您使用未保存在您的密码库中的凭据登录时，允许 Bitwarden 提示您保存项目。
* **默认 URI 匹配检测**：设置 [Bitwarden 识别自动填充建议](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)的默认方式。
* **阻止自动填充**：设置一个域名列表，[阻止 Bitwarden 为其使用自动填充](/docs/password-manager/autofill/more-autofill-options/blocking-autofill)。

</details>

<details>

<summary><strong>自动填充 (iOS)</strong></summary>

* **自动填充**：
  * **密码自动填充**：了解如何设置[自动填充](/docs/password-manager/autofill/autofill-from/autofill-from-ios)，然后点击**继续**进入 iOS 菜单，您将在那里进行设置。
  * **App 扩展**：了解 Safari App 扩展，然后点击**激活 App 扩展**来启用它。
* **附加选项**：
  * **自动复制 TOTP**：凭据被用于自动填充后，自动将 [TOTP](/docs/password-manager/your-vault/security-tools/totp) 复制到剪贴板。
  * **默认 URI 匹配检测**：设置 [Bitwarden 识别自动填充建议](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)的默认方式。

</details>

<details>

<summary><strong>密码库</strong></summary>

* **文件夹**：添加或编辑[文件夹](/docs/password-manager/your-vault/vault-navigation/folders)。
* **导出密码库**：[从您的密码库导出](/docs/password-manager/import-and-export/export-vault-data)或[从您的组织中导出](/docs/admin-console/manage-shared-items/export-organization-items/export-organization-items)数据。
* **导入项目**：打开网页 App 将数据[导入您的密码库](/docs/password-manager/import-and-export/import-data)或[导入组织](/docs/admin-console/manage-shared-items/import-organization-items/import-to-organization)。

</details>

<details>

<summary><strong>外观</strong></summary>

* **语言**：选择 Bitwarden App 使用的语言。
* **主题**：切换 Bitwarden 的颜色模式（浅色模式、深色模式或跟随系统）。
* **使用动态颜色**：(仅限 Android) 根据您的壁纸为 Bitwarden 应用配色方案。
* **显示网站图标**：允许 Bitwarden 获取存储在您的密码库中的凭据的[网站图标](/docs/security/data/website-icons)。

</details>

<details>

<summary><strong>其他</strong></summary>

* **允许刷新时同步**：允许使用下拉手势来[同步您的密码库](/docs/password-manager/your-vault/syncing-your-vault)。
* **清除剪贴板**：设置何时清除从 Bitwarden 复制到您剪贴板的内容。
* **允许通用剪贴板**：(仅限 iOS) 允许从 Bitwarden 移动 App 复制的数据粘贴到使用相同 Apple ID 登录的其他设备上。
* **允许屏幕截图**：(仅限 Android) 允许 Bitwarden 移动 App 出现在截图和屏幕共享中。
* **连接到 Watch**：(仅限 iOS) [将 Bitwarden 连接到您的 Apple Watch](/docs/password-manager/more/more-platforms/apple-watch-totp)，以便轻松访问 TOTP。
* **Siri & 快捷指令访问权限**：(仅限 iOS) 允许 Bitwarden 使用 App Intents 响应 Siri 和快捷指令。

</details>

## 桌面端 <a href="#desktop" id="desktop"></a>

<details>

<summary><strong>账户安全</strong></summary>

* **密钥库超时**：
  * **超时时间**：设置 Bitwarden 在[超时前](/docs/account/log-in-and-unlock/vault-timeout-options#session-timeout)保持活动的时长。
  * **超时动作**：设置 Bitwarden 在[超时时](/docs/account/log-in-and-unlock/vault-timeout-options#session-timeout-action)将执行的动作。
* **使用 PIN 码解锁**：设置 [PIN 码解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)。
* **重启时使用主密码锁定**：要求 Bitwarden 桌面 App 在首次启动时使用主密码解锁。
* **使用系统身份验证解锁**：(仅限 Linux) 设置[生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)。
* **使用触控 ID 解锁**：(仅限 macOS) 设置[生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)。
  * **App 重启时要求触控 ID**：(仅限 macOS) 在首次启动时自动提示使用生物识别。
* **使用 Windows Hello 解锁**：(仅限 Windows) 设置[生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)。
  * **App 重启时要求主密码或 PIN 码**：(仅限 Windows) 要求 Bitwarden 桌面 App 在首次启动时使用主密码或 PIN 码解锁。

</details>

<details>

<summary><strong>偏好设置</strong></summary>

* **清除剪贴板**：设置何时清除从 Bitwarden 复制到您剪贴板的内容。
* **复制到剪贴板时最小化**：当您将项目数据复制到剪贴板时，自动最小化 Bitwarden。
* **显示网站图标并获取更改密码的 URL**：允许 Bitwarden 获取存储在您密码库中的凭据的[网站图标](/docs/security/data/website-icons)和[更改密码的 URL](/docs/password-manager/your-vault/security-tools/change-at-risk-passwords)。

</details>

<details>

<summary><strong>App 设置 (Linux)</strong></summary>

与**安全**和**偏好设置**不同，这些设置适用于使用桌面 App 的所有账户：

{% hint style="success" icon="lightbulb" %}
在 Linux 上，**系统托盘**是位于屏幕右下角的一排快捷方式。**Dash** 是一排常用的和正在运行的 App，通常位于屏幕左侧。
{% endhint %}

* **保持 Bitwarden 在后台运行**：当您关闭窗口时，可以从托盘访问 Bitwarden。建议在使用 SSH 代理或浏览器集成时使用。
* **登录时自动启动**：登录到您的计算机时，自动启动 Bitwarden 桌面 App。
* **允许浏览器集成**：(非 Safari) 允许 Bitwarden 浏览器扩展与[桌面 App 集成](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#set-up-biometrics-for-browser-extension)以进行生物识别解锁。在 Safari 中，无需激活此选项即可使用集成功能。
  * **要求浏览器集成验证**：在 Bitwarden 桌面 App 和浏览器扩展之间建立集成时，要求确认[指纹短语](/docs/security/encryption/account-fingerprint-phrase)。
* **使用硬件加速**：如果您遇到图形或性能问题，请关闭此选项。
* **启用 SSH 代理**：允许 Bitwarden 桌面 App 充当 [SSH 代理](/docs/password-manager/developer-tools/ssh/ssh-agent)。
* **主题**：切换 Bitwarden 的颜色模式（浅色模式、深色模式或跟随系统）。
* **语言**：选择 Bitwarden 桌面 App 使用的语言。

</details>

<details>

<summary><strong>App 设置 (macOS)</strong></summary>

与**安全**和**偏好设置**不同，这些设置适用于使用桌面 App 的所有账户：

{% hint style="success" icon="lightbulb" %}
在 macOS 上，**菜单栏**是位于屏幕顶部的一排菜单。**Dock** 是一排常用的和正在运行的 App，可通过将光标移动到屏幕边缘来显示。
{% endhint %}

* **保持 Bitwarden 在后台运行**：当您关闭窗口时，可以从托盘访问 Bitwarden。建议在使用 SSH 代理或浏览器集成时使用。
* **登录时自动启动**：当你登录到计算机时，自动启动 Bitwarden 桌面 App。
* **允许浏览器集成**：(非 Safari) 允许 Bitwarden 浏览器扩展与[桌面 App 集成](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#set-up-biometrics-for-browser-extension)以进行生物识别解锁。在 Safari 中，无需激活此选项即可使用集成功能。
  * **要求浏览器集成验证**：在 Bitwarden 桌面 App 和浏览器扩展之间建立集成时，要求确认[指纹短语](/docs/security/encryption/account-fingerprint-phrase)。
* **使用硬件加速**：如果您遇到图形或性能问题，请关闭此选项。
* **启用 SSH 代理**：允许 Bitwarden 桌面 App 充当 [SSH 代理](/docs/password-manager/developer-tools/ssh/ssh-agent)。
* **允许屏幕截图**：允许 Bitwarden 桌面 App 出现在截图和屏幕共享中。关闭时，桌面 App 在大多数截图和屏幕共享中将不可见。
* **允许 DuckDuckGo 浏览器集成**：(仅限 macOS) 允许[ Bitwarden 桌面 App 与 DuckDuckGo macOS 浏览器之间](/docs/password-manager/more/more-platforms/duckduckgo-macos-browser-integration)的集成。
* **主题**：切换 Bitwarden 的颜色模式（浅色模式、深色模式或跟随系统）。
* **语言**：选择 Bitwarden 桌面 App 使用的语言。

</details>

<details>

<summary><strong>App 设置 (Windows)</strong></summary>

与**安全**和**偏好设置**不同，这些设置适用于使用桌面 App 的所有账户：

{% hint style="success" icon="lightbulb" %}
在 Windows 上，**系统托盘**是位于屏幕右下角的一排快捷方式。**任务栏**是一排常用的和正在运行的 App，通常位于屏幕底部中间。
{% endhint %}

* **保持 Bitwarden 在后台运行**：当您关闭窗口时，可以从托盘访问 Bitwarden。建议在使用 SSH 代理或浏览器集成时使用。
* **登录时自动启动**：当你登录到计算机时，自动启动 Bitwarden 桌面 App。
* **允许浏览器集成**：(非 Safari) 允许 Bitwarden 浏览器扩展与[桌面 App 集成](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#set-up-biometrics-for-browser-extension)以进行生物识别解锁。在 Safari 中，无需激活此选项即可使用集成功能。
  * **要求浏览器集成验证**：在 Bitwarden 桌面 App 和浏览器扩展之间建立集成时，要求确认[指纹短语](/docs/security/encryption/account-fingerprint-phrase)。
* **使用硬件加速**：如果遇到图形或性能问题，请关闭此选项。
* **启用 SSH 代理**：允许 Bitwarden 桌面 App 充当 [SSH 代理](/docs/password-manager/developer-tools/ssh/ssh-agent)。
* **允许屏幕截图**：允许 Bitwarden 桌面 App 出现在截图和屏幕共享中。关闭时，桌面 App 在大多数截图和屏幕共享中将不可见。
* **主题**：切换 Bitwarden 的颜色模式（浅色模式、深色模式或跟随系统）。
* **语言**：选择 Bitwarden 桌面 App 使用的语言。

</details>


# 键盘快捷键

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/keyboard-shortcuts/)
{% endhint %}

键盘快捷键能加速完成 Bitwarden 中的常用操作，例如[自动填充](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)登录信息和保存新项目。它们可以帮助您更高效地进行导航，并为使用鼠标提供了一种重要的替代方案。

## 浏览器扩展快捷键 <a href="#browser-extension-shortcuts" id="browser-extension-shortcuts"></a>

这些快捷键允许您使用键盘操作 Bitwarden 浏览器扩展。如果不起作用，您可能需要[更新浏览器的快捷键设置](#customize-browser-extension-shortcuts)。

### 通用 <a href="#general" id="general"></a>

| 作用          | 按键                         |
| ----------- | -------------------------- |
| 激活扩展        | `Ctrl/Cmd` + `Shift` + `Y` |
| 生成密码并复制到剪贴板 | `Ctrl/Cmd` + `Shift` + `9` |
| 锁定密码库       | `Ctrl/Cmd` + `Shift` + `N` |

### 自动填充 <a href="#autofill" id="autofill"></a>

您可以[使用键盘快捷键自动填充凭据](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#keyboard-shortcuts)至网站。当用户名和密码字段在同一页面上并列出现时，或在分步登录流程中分别出现时，自动填充快捷键均可生效。

| 作用              | 按键                                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------------- |
| 自动填充当前网站上次使用的登录 | <p><code>Ctrl/Cmd</code> + <code>Shift</code> + <code>L</code></p><p>再次按下可在匹配的登录之间循环</p>                                  |
| 自动填充上次使用的支付卡    | [创建键盘快捷键](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities#using-keyboard-shortcuts)。 |
| 自动填充上次使用的身份     | [创建键盘快捷键](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities#using-keyboard-shortcuts)。 |

{% hint style="success" icon="lightbulb" %}
如果登录使用 [Bitwarden 身份验证器](/docs/password-manager/your-vault/security-tools/totp)生成的 TOTP，并且您使用自动填充快捷键，则 TOTP 会在自动填充后自动复制到剪贴板。按下 `Cmd/Ctrl` + `V` 以粘贴 TOTP。
{% endhint %}

### 自定义浏览器扩展快捷键 <a href="#customize-browser-extension-shortcuts" id="customize-browser-extension-shortcuts"></a>

部分浏览器（包括 Microsoft Edge 和 Safari）使用的默认快捷键与 Bitwarden 的快捷键存在冲突。要解决此问题，请调整浏览器的默认快捷键，使 Bitwarden 的快捷键能够正常工作。具体步骤因浏览器而异：

* **基于 Chromium 的浏览器（包括 Chrome、Edge、Vivaldi、Brave）**：前往浏览器设置页面，例如 `chrome://extensions/shortcuts` 或 `edge://extensions/shortcuts`，更改存在冲突的快捷键或应用新的快捷键。
* **Safari**：更新 [Mac 键盘快捷键](https://support.apple.com/zh-cn/guide/mac-help/mchlp2271/mac)。您可能需要为显示/隐藏侧边栏重新分配快捷键，以确保[自动填充快捷键](#autofill)正常工作。
* **Firefox**：更新[扩展的快捷键设置](https://support.mozilla.org/zh-CN/kb/%E7%AE%A1%E7%90%86Firefox%E7%9A%84%E6%89%A9%E5%B1%95%E5%BF%AB%E6%8D%B7%E6%96%B9%E5%BC%8F)。

## 桌面 App 快捷键 <a href="#desktop-app-shortcuts" id="desktop-app-shortcuts"></a>

### 通用 <a href="#general" id="general"></a>

| 作用                                                                             | 按键                         |
| ------------------------------------------------------------------------------ | -------------------------- |
| 锁定密码库                                                                          | `Ctrl/Cmd` + `L`           |
| 打开 Bitwarden 偏好设置                                                              | `Ctrl/Cmd` + `,`           |
| 重新加载 Bitwarden 桌面 App                                                          | `Ctrl/Cmd` + `Shift` + `R` |
| 退出 Bitwarden 桌面 App                                                            | `Ctrl/Cmd` + `Q`           |
| 将光标置于密码库的搜索框中                                                                  | `Ctrl/Cmd` + `F`           |
| 打开 [Bitwarden 生成器](/docs/password-manager/your-vault/security-tools/generator) | `Ctrl/Cmd` + `G`           |

### 编辑项目 <a href="#edit-items" id="edit-items"></a>

<table data-search="false"><thead><tr><th>作用</th><th>按键</th></tr></thead><tbody><tr><td>添加新的登录</td><td><code>Ctrl/Cmd</code> + <code>N</code></td></tr><tr><td>编辑项目时撤销上一个操作</td><td><code>Ctrl/Cmd</code> + <code>Z</code></td></tr><tr><td>重做编辑中的项目的最后一个操作</td><td><code>Ctrl/Cmd</code> + <code>Y</code></td></tr><tr><td>选择当前活动字段或项目的所有文本</td><td><code>Ctrl/Cmd</code> + <code>A</code></td></tr><tr><td>剪切并复制选中的文本</td><td><code>Ctrl/Cmd</code> + <code>X</code></td></tr><tr><td>复制选中的文本</td><td><code>Ctrl/Cmd</code> + <code>C</code></td></tr><tr><td>粘贴最后复制的文本</td><td><code>Ctrl/Cmd</code> + <code>V</code></td></tr><tr><td>复制已打开项目的用户名</td><td><code>Ctrl/Cmd</code> + <code>U</code></td></tr><tr><td>复制已打开项目的密码</td><td><code>Ctrl/Cmd</code> + <code>P</code></td></tr><tr><td>复制已打开项目的 TOTP</td><td><code>Ctrl/Cmd</code> + <code>T</code></td></tr></tbody></table>

### 调整显示 <a href="#adjust-display" id="adjust-display"></a>

| 作用      | 按键                                                                                 |
| ------- | ---------------------------------------------------------------------------------- |
| 放大      | `Ctrl/Cmd` + `=`                                                                   |
| 缩小      | `Ctrl/Cmd` + `-`                                                                   |
| 重置缩放级别  | `Ctrl/Cmd` + `0`                                                                   |
| 进入全屏模式  | <p>Windows 和 Linux：<code>F11</code></p><p>Mac：<code>Fn</code> + <code>F</code></p> |
| 打开开发者模式 | Windows 和 Linux：`F12`                                                              |

### 控制窗口 <a href="#control-window" id="control-window"></a>

| 作用                        | 按键                                                                                 |
| ------------------------- | ---------------------------------------------------------------------------------- |
| 最小化 Bitwarden 桌面 App      | `Ctrl/Cmd` + `M`                                                                   |
| 将 Bitwarden 桌面 App 隐藏到托盘  | `Ctrl/Cmd` + `Shift` + `M`                                                         |
| 始终将 Bitwarden 桌面 App 置于顶层 | <p><code>Ctrl/Cmd</code> + <code>Shift</code> + <code>T</code></p><p>再次按下可撤消操作</p> |
| 关闭 Bitwarden 桌面 App 窗口    | `Ctrl/Cmd` + `W`                                                                   |


# 自动填充


# 从 ... 自动填充


# 从浏览器扩展自动填充

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/auto-fill-browser/)
{% endhint %}

Bitwarden 的自动填充功能让登录变得快捷安全。当您访问网站时，浏览器扩展会自动识别该网站，并将您密码库中匹配的凭据填充到登录字段中。您可以根据自己的喜好配置自动填充方式。

{% hint style="info" %}
[基本验证提示](/docs/password-manager/autofill/more-autofill-options/basic-auth-prompts)的工作方式与本文描述的自动填充方式不同。
{% endhint %}

## 设置自动填充 <a href="#setup-auto-fill" id="setup-auto-fill"></a>

首先，所有浏览器扩展的自动填充方式都要求您的登录项目[已分配网站 URI](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)。这样才能将您保存的凭据关联到正确的网站。

接下来，不同自动填充方式的配置和使用步骤各不相同，具体说明请参见下文。

在**设置** → **自动填充**菜单中，某些选项适用于所有或大多数自动填充方式：

* 为获得最佳性能，请勾选**将 Bitwarden 设为默认的密码管理器**并[停用浏览器的密码管理器](/docs/password-manager/autofill/troubleshoot-autofill/disable-a-browsers-built-in-password-manager)。这样可以防止浏览器的密码管理工具干扰 Bitwarden 的自动填充功能。
* 如果您不希望在启用自动填充时自动复制 TOTP，请取消选中[**自动复制 TOTP**](#totp-autofill)。
* 从**清除剪贴板**下拉菜单中，选择您首选的时间间隔，以控制从您的密码库复制的值保留多长时间。默认值为五分钟。
* 选择您的**默认 URI 匹配检测**，即 Bitwarden 用于将网站与您保存的凭据配对的逻辑。除非[您的组织另有指定](/docs/admin-console/oversight-visibility/enterprise-policies#default-uri-match-detection)，否则默认值为**基础域名**。
* 选择并添加[**屏蔽域名**](/docs/password-manager/autofill/more-autofill-options/blocking-autofill)，以阻止在特定网站上自动填充。

## 浏览器扩展中的自动填充方式 <a href="#autofill-methods-in-the-browser-extension" id="autofill-methods-in-the-browser-extension"></a>

自动填充登录信息的最基本方式是与 Bitwarden 浏览器扩展交互。当您访问某个网站并且与至少一个项目的已保存的 URI 匹配时，该网站的匹配项目数量将显示在 Bitwarden 扩展图标的顶部。

{% hint style="success" icon="lightbulb" %}
要隐藏匹配项目的总数，请转至 <i class="fa-gear-complex">:gear-complex:</i>**设置** → **外观**，然后取消选中**在扩展图标上显示自动填充建议的登录的数量**。
{% endhint %}

选择 **Bitwarden 扩展徽章**以打开您的密码库，匹配的项目将显示在顶部的自动填充建议部分。如果您想要包含支付卡或身份，请转至**设置** → **自动填充**，然后选中**在密码库视图中始终将支付卡显示为自动填充建议**或**在密码库视图中始终将身份显示为自动填充建议**。

要查找项目，请选择 <i class="fa-sliders">:sliders:</i>**筛选器图标**以打开并应用筛选器到**自动填充建议**和**所有项目**结果中：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/12UsFuA2sxbUCBMIczJsxv/6376ae661b966e4698375c2af2c27c0d/Browser_extension_filters.png?w=480&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展的筛选</p></figcaption></figure></div>

### 从自动填充建议中点击项目 <a href="#click-item-from-autofill-suggestions" id="click-item-from-autofill-suggestions"></a>

要自动填充出现在顶部自动填充建议区域中的项目：

1. 在网站的登录页面上，打开 Bitwarden 浏览器扩展。
2. 转到**密码库**选项卡。
3. 如果该项目列在**自动填充建议**部分，点击项目的任意位置即可自动填充您的凭据：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3tnagVMjtTufvRCrih3ctQ/9277f05114868cf0c37c069c565f2f95/Click_item_to_autofill.png?w=481&#x26;fm=avif" alt=""><figcaption><p>点击项目以自动填充</p></figcaption></figure></div>

这将把您保存的详细信息填入到检测到的输入字段中。如果网页或服务包含多个具有相关 URI 的项目，Bitwarden 将始终自动填充上次使用的登录信息。

{% hint style="info" %}
如果目标字段位于[不受信任的 iframe](#autofill-in-iframes) 中，或者当前站点使用 HTTP（[项目已保存 URI](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill) 要求使用 HTTPS）您可能会在自动填充之前收到警告。
{% endhint %}

若要在**自动填充建议**中打开某个条目，请选择 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i>菜单图标 → **查看**。

### 复制凭据 <a href="#copy-credentials" id="copy-credentials"></a>

您也可以选择项目旁边的 <i class="fa-copy">:copy:</i>**复制图标**。将出现一个菜单，您可以在其中选择**复制用户名**或**复制密码**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7y8WE9sWACC2KLASo9yASw/d1b1f78084ed20940ec76fc397b25ae8/Standard_copy_icon.png?w=484&#x26;fm=avif" alt=""><figcaption><p>标准复制图标</p></figcaption></figure></div>

或者，您可以在项目旁边添加三个快速复制操作按钮，以将您的用户名、密码或验证码专门复制到剪贴板：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5w7lobEk81aOGfLKFjRp2e/301afdc4fffc7878b1b0baacc58e788b/Quick_copy_icons.png?w=482&#x26;fm=avif" alt=""><figcaption><p>快速复制操作</p></figcaption></figure></div>

该选项默认停用。要启用它，请转到**设置** → **外观**，然后打开**在密码库上显示快速复制操作**开关。

### 查看登录 <a href="#view-login" id="view-login"></a>

当浏览器打开已保存的 URI 时，点击扩展中对应的登录项目即可打开**查看登录**页面。然后选择**自动填充**，即可在该页面输入您的信息：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/Y4VkZTrM140OgvjZe5lhc/a2f9c0003aec18d74b26581c57768e96/Autofill_on_View_Login.png?w=480&#x26;fm=avif" alt=""><figcaption><p>在查看登录上自动填充</p></figcaption></figure></div>

如果您选择**自动填充**并且您所在的网站与登录项目保存的 URI 不匹配时，您可以选择**自动填充并添加此网站**到登录项目，或者使用**自动填充但不添加**此网站到您的密码库。

### 拖放登录 <a href="#drag-and-drop-logins" id="drag-and-drop-logins"></a>

浏览器扩展和桌面 App 包含将用户名和密码字段拖放到网站的登录表单中以填充凭据的功能：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7m5Ghz2w281MDQXtvWVdAZ/ded43247a3295552fed4690a3431b095/browser_gif.gif?w=750&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展的拖放功能</p></figcaption></figure></div>

要拖放凭据：

1、将光标悬停在 Bitwarden 浏览器扩展或桌面 App 的**用户名**或**密码**字段上。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/38KJr7zvVSKmYri1WaRXGg/5bab3513a7300ef20f9f55a33ba80c82/2025-02-20_11-07-33.png?w=250&#x26;fm=avif" alt=""><figcaption><p>悬停在用户名或密码上</p></figcaption></figure></div>

2、图标出现后，将该字段拖入到所需的登录表单中。

## 其他填充方式 <a href="#drag-and-drop-logins" id="drag-and-drop-logins"></a>

当您的密码库在浏览器扩展中已锁解时，还有多种方式可以自动填充您的凭据。这些选项可能会更快，因为您不需要与浏览器扩展进行交互。

对于下面描述的所有自动填充选项，在两种情况下您可能会在自动填充之前收到警告：

* 如果目标字段位于[不受信任的 iframe](#autofill-in-iframes) 中。
* 当前站点使用 HTTP，但[项目保存的 URI](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill) 要求 HTTPS。

### 内嵌菜单 <a href="#inline-menu" id="inline-menu"></a>

使用内嵌自动填充菜单可以快速输入来自您 Bitwarden 密码库中的登录凭据、[通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)以及 [TOTP](/docs/password-manager/your-vault/security-tools/totp) 代码。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/H7DjdJNvQH00yGNLf5gsC/1ec6f0ce9a94862b0cae1d8b8d679fc8/2024-10-29_14-41-02.png?w=961&#x26;fm=avif" alt=""><figcaption><p>内嵌自动填充菜单</p></figcaption></figure></div>

#### 激活内嵌自动填充菜单 <a href="#activate-the-inline-autofill-menu" id="activate-the-inline-autofill-menu"></a>

要启用内嵌自动填充菜单：

1、登录并解锁 Bitwarden [浏览器扩展](/docs/password-manager/getting-started/getting-started-browserext)。

2、选择 <i class="fa-gear-complex">:gear-complex:</i>**设置** → **自动填充**。

3、勾选**在表单字段显示自动填充建议**，这将打开更多选项。

* （可选）如果您希望内嵌自动填充菜单[建议这些项目类型](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities#using-the-inline-menu)，请选中**将身份显示为建议**和**将支付卡显示为建议**。
* （可选）要仅当选择 Bitwarden 图标时显示可用于自动填充的匹配项目，请选中**选择图标时显示建议**。如果此设置未勾选，则匹配的项目会立即出现在表单字段下方。

我们建议您[停用浏览器的自动填充](/docs/password-manager/autofill/troubleshoot-autofill/disable-a-browsers-built-in-password-manager)选项。如果您的浏览器的自动填充功能已启用，它可能会与 Bitwarden 的自动填充菜单产生冲突。

#### 使用内嵌自动填充菜单 <a href="#use-the-inline-auto-fill-menu" id="use-the-inline-auto-fill-menu"></a>

{% tabs %}
{% tab title="使用内嵌自动填充登录" %}
要使用内嵌自动填充菜单登录账户：

1、选择登录表单的用户名字段。如果您尝试登录时密码库已锁定，菜单会提示您解锁密码库。

2、将显示内嵌自动填充菜单。此时，请选择您希望在网站上使用的登录名或密码。

{% hint style="info" %}
没有看到您想使用的登录凭据吗？编辑密码库项目并选择**自动填充和保存**，或在 URI 字段中手动输入网站。
{% endhint %}

3、如果没有为该网站保存凭据，请选择✚**新建项目**，浏览器扩展将打开一个新的项目，您可以在其中保存新的登录凭据。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1nVpqyl5FuzMPIaKezwZ8c/8a715cb0b1e1423815f0b66b0e8b1b42/web-browser-extension-autofill-newitem.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>创建项目</p></figcaption></figure></div>

{% hint style="info" %}
如果内嵌自动填充菜单对浏览器造成意外干扰，可按 `Esc` 键将其关闭。
{% endhint %}
{% endtab %}

{% tab title="使用内嵌自动填充输入 TOTP" %}
要使用内嵌自动填充功能自动填充 TOTP 代码，将光标置于登录表单上的 TOTP 字段中。当显示内嵌自动填充菜单时，选择 TOTP 代码：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3RaBZBRgkfwVF0mQPRZYBJ/840a46c911d09ead87ac09fdb0955493/2025-01-03_09-22-34.png?w=642&#x26;fm=avif" alt=""><figcaption><p>TOTP 内嵌自动填充单个登录</p></figcaption></figure></div>

如果此网站有多个登录，内嵌自动填充菜单将显示每一个登录的 TOTP 代码：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1rc2rXC3daH5mcEZNRgbv1/db47ffbb4a3b987ff2e3e7842900ceb6/2025-01-02_17-23-28.png?w=450&#x26;fm=avif" alt=""><figcaption><p>内嵌 TOTP 自动填充</p></figcaption></figure></div>
{% endtab %}

{% tab title="使用内嵌自动填充创建账户" %}
要使用内嵌自动填充菜单向 Bitwarden 添加新账户，无论是使用已有凭据登录还是全新创建账户，请按以下步骤操作：

1、在登录表单中选择用户名。如果您已有该网站的凭据，请输入用户名和密码。如果没有，请继续下一步，Bitwarden 将帮助您创建它们。

{% hint style="success" %}
先不要提交登录表单！
{% endhint %}

2、选择内嵌的**保存到 Bitwarden** 或**新增登录**按钮：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/UuqBaeAqEKusL9ByoUi2q/43352b0ca6b80838e72ab13f7e5bd8a7/2026-07-14_10-16-23.png?w=1396&#x26;fm=avif" alt=""><figcaption><p>保存到 Bitwarden</p></figcaption></figure></div>

3、在弹出的浏览器扩展中，可以查看已导入的用户名和密码，或创建一组新的。若需创建新密码，请使用[密码生成器](/docs/password-manager/your-vault/security-tools/generator)。

4、现在也是编辑该项目的其他信息（如**名称**或**所有者**）的好时机。

5、选择**保存并填充**按钮，将登录信息保存至 Bitwarden，并自动继续网站的登录或账户创建流程：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1ATTneDqBvNTFNds8YOCFh/cae4c9f4b872eec97aa5cae911633f1a/2026-07-14_10-17-33.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>保存并填充</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}

### 上下文菜单 <a href="#context-menu" id="context-menu"></a>

在不打开浏览器扩展程序的情况下，您可以在用户名或密码输入栏上点击右键，然后使用 **Bitwarden** → **自动填充**选项。当您尝试此操作时，如果您的密码库已锁定，则会打开一个新的标签页，提示您解锁。解锁后，浏览器扩展将自动继续填充您的用户名、密码、支付卡或身份信息。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6GKKvIe7GwwOBtp9gmh862/4d39f59a8a862bb83d53e50f9f68d107/2024-12-03_09-12-06.png?w=823&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展上下文菜单</p></figcaption></figure></div>

{% hint style="info" %}
目前，Safari 浏览器扩展不支持使用上下文菜单自动填充。
{% endhint %}

### 键盘快捷键 <a href="#keyboard-shortcuts" id="keyboard-shortcuts"></a>

最快捷的方法之一是使用自动填充键盘快捷键。此方法适用于用户名和密码字段在同一页面上并列出现的情况，以及在分步登录流程中分别出现的场景。

#### 设置键盘快捷键 <a href="#set-up-keyboard-shortcuts" id="set-up-keyboard-shortcuts"></a>

用于登录项目的默认快捷键是：`Ctrl/Cmd` + `Shift` + `L`。如果您想更改快捷键或默认快捷键不起作用，请[更新浏览器的快捷键设置](/docs/password-manager/your-vault/keyboard-shortcuts#browser-extension-shortcuts)。您还可以为[支付卡和身份信息创建快捷键](/docs/password-manager/autofill/more-autofill-options/auto-fill-cards-and-identities#using-keyboard-shortcuts)。

如果您使用的是 Microsoft Edge 浏览器，请确保升级到最新的基于 Chromium 内核的版本。

#### 使用键盘快捷键 <a href="#use-keyboard-shortcuts" id="use-keyboard-shortcuts"></a>

要使用快捷键：

1. 将光标放在第一个登录字段（例如用户名）中。
2. 按下 `Ctrl/Cmd` + `Shift` + `L`。
3. （可选）如果检测到的 URI 具有多个登录信息，则将使用最后一次使用的登录信息进行自动填充。再次按下相同的快捷键可在多个登录信息之间切换。

如果您在尝试使用自动填充快捷键时密码库处于锁定状态，则会弹出一个窗口提示您解锁。解锁后，浏览器扩展将自动继续填充您的凭据。

{% hint style="success" %}
如果登录使用 [Bitwarden 验证器](/docs/password-manager/your-vault/security-tools/totp) TOTP，并且您使用自动填充快捷键，自动填充后会自动将 TOTP 复制到剪贴板。您要做的就是使用 `Cmd/Ctrl+V` 来粘贴！
{% endhint %}

### 页面加载时 <a href="#on-page-load" id="on-page-load"></a>

{% hint style="danger" %}
此功能默认情况下被禁用，因为虽然它通常比较安全，但受损或不受信任的网站可能会利用此功能窃取凭据。

浏览器扩展不允许在页面加载时自动填充[不受信任的 iframe](#auto-fill-in-inframes)，并且当根据[该项目的已保存 URI](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill) 预期使用 HTTPS 时，浏览器扩展将在 HTTP 站点上自动填充之前向用户发出警告。
{% endhint %}

页面加载时自动填充功能将在加载与登录项目的 URI 值对应的网页时自动填充登录信息。**页面加载时自动填充**功能默认未启用。启用后，您可以为所有项目设置默认行为（开启或关闭）。

要启用此功能，请导航到浏览器扩展中的**设置** → **自动填充**，勾选**页面加载时自动填充**复选框，然后选择默认行为。启用并设置默认行为后，您还可以为每一个密码库项目单独指定页面加载时的自动填充行为：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5PxR0j79XtzMCrF4R6xUtu/49fca8557bb393247d750e3b3030c0e8/2024-12-03_09-14-59.png?w=978&#x26;fm=avif" alt=""><figcaption><p>页面加载选项</p></figcaption></figure></div>

使用此约定，您可以将浏览器扩展设置为，例如：

* 仅对指定的少数几个项目执行页面加载时自动填充（即对所有密码库项目**默认关闭**，并对指定的项目**手动打开**）。
* 对除指定的少数几个项目之外的所有项目执行页面加载时自动填充（即对所有密码库项目**默认打开**，并对指定的项目**手动关闭**）。

## 浏览器扩展中的自动填充故障排除 <a href="#troubleshoot-autofill-from-the-browser-extension" id="troubleshoot-autofill-from-the-browser-extension"></a>

如果您的浏览器扩展在自动填充特定网站的用户名和密码时出现问题，您可以使用[链接型自定义字段](/docs/password-manager/autofill/more-autofill-options/auto-fill-custom-fields#using-linked-custom-fields)来强制自动填充。

### iframe 中的自动填充 <a href="#autofill-in-iframes" id="autofill-in-iframes"></a>

浏览器扩展会悄悄地禁用不受信任的 iframe 的[页面加载自动填充](#on-page-load)，并在您使用键盘快捷键、上下文菜单或直接从浏览器扩展手动触发自动填充时发出警告。

「不受信任」的 iframe 被定义为 `src=""` 值与登录项目的 URI 不匹配的 iframe，如全局设置或特定于项目的[匹配检测行为](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill#match-detection-options)所指示的那样。

## 自动填充不常用的凭据 <a href="#autofill-less-common-credentials" id="autofill-less-common-credentials"></a>

### TOTP 自动填充 <a href="#totp-autofill" id="totp-autofill"></a>

如果您使用[集成的身份验证器](/docs/password-manager/your-vault/security-tools/totp)，浏览器扩展将自动填充您的 TOTP 代码，前提是您使用上下文菜单、键盘快捷键或手动自动填充（对没有保存 URI 的项目使用**填充**按钮）。您也可以使用内嵌自动填充菜单来填写 TOTP 代码。**如果您使用页面加载时自动填充功能，浏览器扩展程序将不会自动填写您的 TOTP 代码**。

默认情况下，自动填充登录后，您的 TOTP 也会被复制到剪贴板。如果您使用页面加载时自动填充功能，这是推荐的工作流程。

{% hint style="success" icon="lightbulb" %}
在浏览器扩展中使用自动填充时，默认会启用自动复制 TOTP 功能。如需停用，请前往**设置** → **自动填充**，取消勾选**自动复制 TOTP**。此外，使用旁边的**清除剪贴板**下拉菜单，指定复制内容的清除时间。
{% endhint %}

### 使用 Bitwarden 中存储的通行密钥登录 <a href="#log-in-with-passkeys-stored-in-bitwarden" id="log-in-with-passkeys-stored-in-bitwarden"></a>

您可以[使用通行密钥登录](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)网站。保存新通行密钥时，网站 URI 会保存在登录项目中。要使用通行密钥，请打开网站如何开始通行密钥登录流程。相关的通行密钥将显示在 Bitwarden 浏览器扩展对话框中。选择您要使用的通行密钥，然后按**确认**。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5KeuUZox5shd0zDMxPHKXn/1aab35dfceed0ed9cdb17b143be9a890/2024-10-29_11-39-33.png?w=961&#x26;fm=avif" alt=""><figcaption><p>使用通行密钥登录</p></figcaption></figure></div>

[内嵌自动填充菜单](#inline-auto-fill-menu)还可用于使用通行密钥轻松进行身份验证。

{% hint style="info" %}
浏览器扩展不会为[**排除域名**](/docs/password-manager/autofill/more-autofill-options/exclude-domains)列表中的任何域名提供保存或使用通行密钥的功能。
{% endhint %}


# 从浏览器扩展自动保存

{% hint style="success" %}
询问更新现有登录对应的[官方文档地址](https://bitwarden.com/help/autosave-from-browser-extensions/)
{% endhint %}

Bitwarden 浏览器扩展提供一系列浏览器内的通知，可将您的解密数据与您在登录、注册和类似网页表单中输入的数据进行比较。其中包括：

* 保存或使用通行密钥的通知。
* 添加未检测到的登录的通知。
* 更新现有的登录的通知。
* 保存新 URI 的通知。

这些通知默认为激活状态，但可以通过浏览器扩展的**设置** → **通知**菜单将其关闭。

{% hint style="success" icon="lightbulb" %}
您还可以从**设置** → **通知** → **排除域名**菜单中阻止指定网站以触发自动保存通知。更多信息，请参阅[对指定网站屏蔽自动保存](/docs/password-manager/autofill/more-autofill-options/exclude-domains)。
{% endhint %}

## 询问保存和使用通行密钥 <a href="#ask-to-save-and-use-passkeys" id="ask-to-save-and-use-passkeys"></a>

当 Bitwarden 检测到您正在为某个网站创建新的通行密钥，或提示您使用已保存在 Bitwarden 中的通行密钥登录时，Bitwarden 将会提示您保存新通行密钥或使用已保存的通行密钥登录：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5KeuUZox5shd0zDMxPHKXn/1aab35dfceed0ed9cdb17b143be9a890/2024-10-29_11-39-33.png?w=961&#x26;fm=avif" alt=""><figcaption><p>使用通行密钥登录</p></figcaption></figure></div>

更多信息，请参阅[自动填充通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)。

## 询问添加登录 <a href="#ask-to-add-login" id="ask-to-add-login"></a>

当 Bitwarden 检测到您为一个未存储在 Bitwarden 中的页面输入了登录信息时，Bitwarden 将会提示您将这些凭据保存到 Bitwarden 中：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4vsurEuH5deik26BWn4n1p/82757186b081890fbe92b4d73baeae53/screenshot_7.png?w=426&#x26;fm=avif" alt=""><figcaption><p>询问添加登录</p></figcaption></figure></div>

通过该通知，您可以选择是将其存储在个人项目（即**我的密码库**）中，还是存储在某个组织中。在保存之前，您还可以使用编辑 <i class="fa-pen-to-square">:pen-to-square:</i> 按钮对项目进行编辑。

## 询问更新现有的登录 <a href="#ask-to-update-existing-login" id="ask-to-update-existing-login"></a>

当 Bitwarden 检测到您在表单中输入的登录信息与 Bitwarden 中已保存的信息不一致时（例如，如果您最近在某个网站上更新了密码，但没有在 Bitwarden 中更新），Bitwarden 将会提示您在 Bitwarden 中更新您的凭据：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3nn8Vz526Il3onWPHMUUAi/90fd3af3616b60c2961064a56205d525/2025-05-20_16-19-00.png?w=1007&#x26;fm=avif" alt=""><figcaption><p>询问更新现有的登录</p></figcaption></figure></div>

## 询问保存 URI <a href="#ask-to-save-a-uri" id="ask-to-save-a-uri"></a>

当使用浏览器扩展**自动填充**登录项目，但该登录项目的 URI 与当前访问的网站不匹配时，浏览器扩展将提供将新 URI 保存到该登录项目的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/67h2UzB5cit1oVpEKTUcVs/dfeadfd6749961b76fb9746a36cc9085/2025-12-04_09-37-06.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>确认自动填充</p></figcaption></figure></div>


# 从 iOS App 自动填充

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/auto-fill-ios/)
{% endhint %}

Bitwarden 可以自动填充您的密码和通行密钥，以便您可以无缝登录网站和 App，同时维护强大而安全的密码。自动填充功能通过检测与您登录的服务相匹配的密码库项目，以减少了您在登录过程中的复制和粘贴操作。

移动端自动填充当前不支持自定义字段和拆分登录工作流程（当用户名和密码字段显示在独立的界面上时）。

## 设置自动填充 <a href="#setup-auto-fill" id="setup-auto-fill"></a>

{% hint style="info" %}
大多数自动填充方式要求登录项目具有[分配的网站 URI](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)。
{% endhint %}

iOS 上有几种不同的自动填充方式：

* **键盘自动填充**：（推荐）使用此选项可以在任何 iOS App（包括网页浏览器）中通过一个键盘按钮或上滑提示来使用 Bitwarden 自动填充。
* **浏览器 App 扩展自动填充**：使用此选项仅可以在网页浏览器 App（例如 Safari）中通过分享菜单来使用 Bitwarden 自动填充。
* **长按文本字段自动填充**：使用此选项可在更多位置从 Bitwarden 自动填充。

{% hint style="success" icon="lightbulb" %}
如果设备的[密码库超时行为](/docs/account/log-in-and-unlock/vault-timeout-options#vault-timeout-action)设置为**注销**，并且您仅启用了需要 NFC（例如带 NFC 的 YubiKey）的[两步登录方式](/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)，则当前无法在 iOS 上使用自动填充，因为 iOS 不允许 NFC 输入中断自动填充工作流。

要么将您的密码库超时行为改为**锁定**，要么启用另一种两步登录方式。
{% endhint %}

{% hint style="info" %}
如果您使用的 Argon2id 的 KDF 内存值高于 48 MB，则每次启动 iOS 自动填充或通过共享表单创建新的 Send 时，都会显示警告对话框。要避免出现此消息，参阅在[此处](/docs/security/encryption/encryption-key-derivation#argon2id)调整 Argon2id 设置或启用[生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics#enable-unlock-with-biometrics)。
{% endhint %}

### 键盘自动填充 <a href="#keyboard-auto-fill" id="keyboard-auto-fill"></a>

要在 iOS 上激活键盘自动填充密码，请完成以下步骤。这也将激活用于通行密钥自动填充的上滑菜单：

1、在您的设备上打开 iOS **️设置**，然后选点击**通用**。

2、点击**自动填充与密码**。&#x20;

3、打开**自动填充密码和通行密钥**开关，然后从**自动填充自：**&#x5217;表中打开 **Bitwarden**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5jxVP3WslH4ppIdFq9viqX/613fbbb9eacbb14f56c0fbcee17bc9a1/2025-01-22_11-00-15.png?w=352&#x26;fm=avif" alt=""><figcaption><p>iOS 上设置自动填充</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
我们强烈建议在**自动填充自：**&#x5217;表中禁用任何其他自动填充服务（例如钥匙串）。
{% endhint %}

接下来，测试一下自动填充以确保其可以正常工作：

1、打开一个您当前未登录的 App 或网站。

2、在登录界面点击用户名或密码字段。键盘将上滑出一个匹配的登录 (`my_username`) 或 <i class="fa-key">:key:</i>**密码**按钮：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/vQG8BTWlHg2AQxBlXe4S3/63f2a5e9c32c2f38b29ec0ab0af24d57/autofill-ios.jpeg?w=932&#x26;fm=avif" alt=""><figcaption><p>iOS 上的自动填充</p></figcaption></figure></div>

3、如果显示一个[匹配的登录](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)，请点击以自动填充。如果显示 <i class="fa-key">:key:</i>**密码**按钮，请点击它浏览您的密码库以搜索要使用的登录项目。如果显示 <i class="fa-key">:key:</i>**密码**按钮，可能是因为您的密码库中没有具有[匹配 URI](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill) 的项目。

{% hint style="info" %}
遇到 `Biometric unlock disabled pending verification of master password`（生物识别解锁已禁用，等待验证主密码） 消息吗？了解[该怎么做](/docs/password-manager/autofill/auto-fill-faqs#q-what-do-i-do-about-biometric-unlock-disabled-pending-verification-of-master-password)。
{% endhint %}

### 浏览器 App 扩展自动填充 <a href="#browser-app-extension-auto-fill" id="browser-app-extension-auto-fill"></a>

要启用 iOS 上的浏览器 App 扩展自动填充：

1、打开 Bitwarden iOS  App 然后点击 **⚙️设置**。

2、点击**自动填充**。

3、在自动填充部分点击 **App 扩展**选项。&#x20;

4、点击**启用 App 扩展**按钮。&#x20;

5、从上滑出的分享菜单中，点击 **Bitwarden**。&#x20;

绿色的`扩展已激活！`消息指示已成功激活此选项。

然后测试一下 App 扩展以确保其可以正常工作：

1、打开您设备的网页浏览器，然后导航到一个您当前未登录的网站。

2、点击**分享**图标。

3、向下滚动并点击 **Bitwarden** 选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3Icxd3YqcXjBrjHVAeluwm/8be732b1ed2adebfd0a7af00f7150a97/extension.png?w=311&#x26;fm=avif" alt=""><figcaption><p>共享菜单中的 Bitwarden</p></figcaption></figure></div>

{% hint style="info" %}
如果您启用了[使用生物识别解锁](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)，则首次点击此选项时，将提示您验证您的主密码。
{% endhint %}

4、Bitwarden 界面将在您的设备上向上滑出，并列出此网站的[匹配登录项目](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)。点击该项目以自动填充。

{% hint style="success" icon="lightbulb" %}
如果未列出登录项目，则可能是因为您的密码库中没有与 [URI 匹配](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)的项目。
{% endhint %}

### 长按文本字段自动填充 <a href="#long-press-a-text-field" id="long-press-a-text-field"></a>

通过长按任何文本字段，可以从 Bitwarden 自动填充数据，前提是键盘自动填充选项已激活：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/77glhnjH87Z6PKscElWtZy/f9229264859577c0490cf423237f8502/2025-01-22_11-05-33.png?w=359&#x26;fm=avif" alt=""><figcaption><p>iOS 上长按文本字段</p></figcaption></figure></div>

## 自动填充期间切换账户 <a href="#switch-accounts-during-autofill" id="switch-accounts-during-autofill"></a>

如果您[登录了多个账户](/docs/account/log-in-and-unlock/account-switching)，您的移动 App 将默认尝试自动填充当前活动账户的凭据。在自动填充过程中，您可以通过轻按头像气泡来切换账户。

## 使用通行密钥 <a href="#using-passkeys" id="using-passkeys"></a>

### 设置 Bitwarden 以使用通行密钥 <a href="#setup-bitwarden-for-use-with-passkeys" id="setup-bitwarden-for-use-with-passkeys"></a>

自动填充通行密钥（包括 Bitwarden 提示创建新的通行密钥）需要 iOS 17.0 或更高版本。

要使用下述功能：

1、打开 iOS **设置** App。

2、导航至**密码** → **密码选项**。

3、打开以下选项：

* 打开**自动填充密码和通行密钥**。
* 在**密码和通行密钥来源：** 列表中打开 **Bitwarden**。

### 创建通行密钥 <a href="#create-a-passkey" id="create-a-passkey"></a>

在网站或 App 上创建新的通行密钥时，iOS App 将提示您存储此通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6rccoaRtUBbEnUjQxfSTNi/d033196df75950bae5bd7a20e8a7edd2/passkey-ios-1__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>创建通行密钥</p></figcaption></figure></div>

选择**继续**。

{% hint style="info" %}
如果您不想将此通行密钥存储在 Bitwarden 中，请选择**其他选项**，或者选择**其他登录选项**以使用未存储在 Bitwarden 中的通行密钥登录。
{% endhint %}

如果该服务已存在一个通行密钥，Bitwarden 将允许您通过选择 **➕**&#x56FE;标以创建一个新的项目来保存新的通行密钥，或覆盖现有的通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6L5s6XBFjvaaEiDZ68m00Q/a130745c2276068fd0be066a47a34684/passkey-ios-2__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>保存或覆盖通行密钥</p></figcaption></figure></div>

{% hint style="info" %}
每个登录项目只能保存一个通行密钥。如果一个凭证保存在多个地方，例如作为两个登录项目分别保存在个人密码库和组织密码库中，则每个登录项目都可以保存不同的通行密钥。
{% endhint %}

### 使用存储在 Bitwarden 中的通行密钥登录 <a href="#sign-in-using-a-passkey-stored-in-bitwarden" id="sign-in-using-a-passkey-stored-in-bitwarden"></a>

要使用 Bitwarden 中存储的密钥，请在网站上启动通行密钥登录。移动 App 将提供使用存储在 Bitwarden 密码库中的通行密钥登录的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/b6fY5o4CBxhW4ZjDIpanR/56ffdbf1ff93b7387be273bc7df15e6b/passkey-ios-3__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>使用通行密钥登录</p></figcaption></figure></div>

选择**继续**。

{% hint style="info" %}
如果您不想将此通行密钥存储在 Bitwarden 中，请选择**其他选项**，或者选择**其他登录选项**以使用未存储在 Bitwarden 中的通行密钥登录。
{% endhint %}


# 从 Android App 自动填充

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/auto-fill-android/)
{% endhint %}

Bitwarden 可以自动填充您的密码，以便您可以无缝登录网站和 App，同时维护强大而安全的密码。自动填充功能通过检测与您登录的服务相匹配的密码库项目，以减少了您在登录过程中的复制和粘贴操作。

移动端自动填充当前不支持自定义字段和拆分登录工作流程（当用户名和密码字段显示在单独的界面上时）。

{% hint style="warning" %}
对于要安装的应用程序，请务必**仅安装并自动填充来自受信任来源**（例如 Google Play Store 或 F-Droid）**的应用程序**，因为恶意应用程序可能会伪造知名应用程序的包名称。[了解更多](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill#android)。
{% endhint %}

## 设置自动填充 <a href="#set-up-autofill" id="set-up-autofill"></a>

根据您设备上所运行的 Android 版本，有几种不同的方式来启用 Bitwarden 上的自动填充功能。要设置自动填充：

1、导航至**设置** → **自动填充**。

2、点击**自动填充服务**以允许 Bitwarden 使用您保存的登录信息登录您设备上的 App。

3、当您的设备要求您提供用于密码、通行密钥和自动填充的首选服务时，请选择 **Bitwarden**。

4、返回 Bitwarden **设置** → **自动填充**界面，选择以下**显示自动填充建议**选项之一：

* **内嵌**：此选项将在键盘中建议自动填充的凭据。
* **弹窗**：此选项将在输入字段的弹出窗口中建议自动填充的凭据。

5、如果您使用 Brave 或 Chrome 作为网页浏览器，请打开**使用 Brave 自动填充集成**或**使用 Chrome 自动填充集成**选项，以确保自动填充功能在这些浏览器中能正常工作。更多信息，请参阅[下文](#browser-integrations)。

{% hint style="info" %}
由于 Brave 和 Chrome Android App 的运行机制，除非手动启用浏览器标志，否则自动填充功能在使用 HTTP 的网站上将无法正常工作。要在 Brave/Chrome 上为 HTTP 网站启用自动填充功能：

1. 导航至 `brave://flags`
2. 搜索**被视为安全的不安全来源** ，然后启用该标志
3. 添加所需的 HTTP 域名/IP 地址，例如：`http://192.0.2.0/24` 或 `http://myserver.local`
4. 重启 Brave 浏览器
   {% endhint %}

6、如果您想使用快速操作磁贴，请打开**使用无障碍**。当您的设备将您带到**无障碍**菜单时，也请在该位置打开 Bitwarden。

{% hint style="success" icon="lightbulb" %}
快速操作磁贴不需要在 Bitwarden 中打开**自动填充服务**，这意味着如果这是您的首选方式，您可以跳过前面的步骤，但您需要使用 <i class="fa-pen">:pen:</i> 图标编辑磁贴，以将 Bitwarden 磁贴选项放置在符合您使用习惯的位置。
{% endhint %}

{% hint style="info" %}
遇到问题了吗？请参阅我们的 [Android 自动填充故障排除](/docs/password-manager/autofill/troubleshoot-autofill/troubleshooting-android-auto-fill)指南。如果您仍然无法使用 Android 自动填充功能，请[联系我们](https://bitwarden.com/contact/)。
{% endhint %}

## 自动填充方式 <a href="#autofill-methods" id="autofill-methods"></a>

### 内嵌 <a href="#inline" id="inline"></a>

此方式在键盘中建议自动填充的凭据：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2LxDxR7KcVd68U9UydYxat/e02408654528f4262a293de61e1439bb/2025-07-30_10-56-55.png?w=771&#x26;fm=avif" alt=""><figcaption><p>Android 内嵌自动填充</p></figcaption></figure></div>

如果您没有看到建议：

* 确保您使用的是 Android 11+ 和兼容的 IME (Input Method Editor)。
* 检查您使用的键盘 IME 是否支持内嵌。

### 弹窗 <a href="#popup" id="popup"></a>

当设备聚焦于包含匹配登录项的输入框时，此方法会叠加显示弹出菜单。若密码库处于解锁状态，您将获得立即自动填充或打开密码库的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1fIoPhOLMcXzvd0Y8aw1pm/642f9f722291f2de3daf93f2fd9a6450/2025-07-30_10-59-13.png?w=705&#x26;fm=avif" alt=""><figcaption><p>Android 弹出自动填充</p></figcaption></figure></div>

\
您将看到两个选项。第一个（上面的我的登录项目）将使用匹配的 URI 自动填充第一个登录（上面的 `my_username`）。第二个（上面的 **Bitwarden**）将允许您从具有匹配 URI 的登录列表中进行选择。

此方法需要 Android 8+。

### 浏览器集成 <a href="#browser-integrations" id="browser-integrations"></a>

如果您使用 Brave、Chrome 或 Vivaldi 作为您的网页浏览器，请打开**使用 Brave \<browser> 集成**选项（其中 **\<browser>** 是浏览器的名称），以确保自动填充功能在这些浏览器中能正常工作。此操作将引导您进入相应浏览器的设置界面，您需在此启用此选项以使用第三方服务。

这是 Chrome 所必需的，以便它能够安全地使用 Bitwarden 通过其受保护的自动填充系统自动填充密码，并且要求在 Bitwarden 中启用**自动填充服务**，并且安装的 Chrome App 版本至少为 135。这些选项将禁用浏览器内置的自动填充功能，转而使用 Bitwarden。

{% hint style="warning" %}
Bitwarden 会自动检测您是否正在使用 **Edge、Opera 或 Samsung Internet**，无需为这些浏览器启用集成选项，并且会在这些浏览器中使用改进后的自动填充逻辑。

在使用 Edge、Opera 或 Samsung Internet 时，请务必仅自动填充受信任且合法的网站，因为存在一个可能导致凭据被自动填充到恶意网站的嵌入式或隐藏的 iframe 中的漏洞。
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1Qm4g428OlYOBvzAxKwUNU/77106f75d8f5af42bed8bde4db9dc325/2025-07-30_13-14-04.png?w=892&#x26;fm=avif" alt=""><figcaption><p>启用 Android 集成</p></figcaption></figure></div>

### 快速操作磁贴 <a href="#quick-action-tiles" id="quick-action-tiles"></a>

快速操作磁贴使用 Android 无障碍服务，让您能在通知下拉设置菜单中直接访问自动填充操作。快速操作磁贴不需要在 Bitwarden 中打开**自动填充服务**，但您需要使用 <i class="fa-pen">:pen:</i> 图标编辑磁贴，以将 Bitwarden 磁贴选项放置在符合您使用习惯的位置：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7MHfjTUrRjdLtBoyL3Ukz2/7980adfc9de7b6b2659f1955d3d987fd/2025-07-30_11-07-51.png?w=745&#x26;fm=avif" alt=""><figcaption><p>Android 快速操作自动填充</p></figcaption></figure></div>

要使用快速操作磁贴，请导航至需要自动填充的页面或 App，向下滑动以访问磁贴，然后点击要使用的磁贴。

## ~~兼容模式~~ <a href="#compatibility-mode" id="compatibility-mode"></a>

~~启用**为浏览器自动填充使用兼容模式**选项后，将启用一种安全性较低的自动填充逻辑，该逻辑与更多浏览器兼容，尤其是 Edge、Opera 和 Samsung Internet 浏览器。~~

~~兼容模式允许 Bitwarden 从地址栏检测匹配的 URI 来进行自动填充，而不仅仅是从表单的属性（例如用户名或密码）中检测。这有助于自动填充在更广泛的场景下工作，但也会在某些浏览器中引入风险。~~

{% hint style="warning" %}
~~在某些浏览器中启用兼容模式会引入一个漏洞，该漏洞可能允许恶意网站将凭据自动填充到嵌入式或隐藏的 iframe 中：~~

* ~~Chrome、Brave 和 Firefox 将始终使用标准的自动填充逻辑，无论是否启用此选项，从而确保您获得最大程度的保护。~~
* ~~Edge、Opera 和 Samsung Internet 将使用安全性较低的自动填充逻辑。如果您启用此选项，请务必仅在受信任的合法网站上使用自动填充功能。~~
  {% endhint %}

## 自动填充通行密钥 <a href="#autofill-passkeys" id="autofill-passkeys"></a>

Bitwarden Android App 可用于存储和自动填充通行密钥。要启用自动填充通行密钥，请导航至**设置** → **自动填充**，然后点击**通行密钥管理**以访问 Android 设置，将 Bitwarden 配置为您的通行密钥提供程序。请注意，Android 系统不允许 Bitwarden 等第三方通行密钥提供程序支持基于通行密钥的 2FA（又称「不可发现凭据」）；Bitwarden 存储的通行密钥只能用作主要登录凭据。了解更多有关[在 Android 上存储和自动填充通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys#android)的信息 。

## 自动填充期间切换账户 <a href="#switch-accounts-during-autofill" id="switch-accounts-during-autofill"></a>

如果您[登录了多个账户](/docs/account/log-in-and-unlock/account-switching)，您的移动 App 将默认尝试自动填充当前活动账户的凭据。在自动填充过程中，您可以通过轻按头像气泡来切换账户。


# 更多自动填充选项


# 填充辅助

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/fill-assist/)
{% endhint %}

填充辅助功能通过提供人工编写并审核的指令，帮助浏览器扩展确定如何自动填充凭据，从而**提高了 Bitwarden 精选的网站上的自动填充的准确性**，这些网站是已知的会广泛导致用户自动填充问题的网站。

通常，网站之所以会导致自动填充问题，是因为它们在用于登录或创建账户的表单代码中偏离了广泛采用的规范。填充辅助功能通过让 Bitwarden 识别行为异常的网站，并为浏览器扩展在这些网站上如何自动填充创建自定义指令，从而解决了这一问题。

## 启用填充辅助 <a href="#turn-on-fill-assist" id="turn-on-fill-assist"></a>

可通过**设置** → **自动填充**菜单为 Bitwarden 浏览器扩展启用填充辅助，适用于 2026.6.0 及以上版本的所有用户。

{% hint style="info" %}
无需任何额外操作！启用后，您将在收录于精选列表的网站上体验到更出色的自动填充性能。本文后续部分将详细说明填充辅助的工作原理。
{% endhint %}

由于填充辅助是促进更简便自动填充的一种方法，因此[自定义字段](/docs/password-manager/your-vault/vault-items/custom-fields)会被支持填充辅助的网站所取代。

## 工作原理 <a href="#how-it-works" id="how-it-works"></a>

填充辅助由 Bitwarden [Map the Web](https://github.com/bitwarden/map-the-web/) 项目提供支持，是专为解决自动填充问题而构建的多种工具之一。它通过人工编写并审核的指令替代默认的自动填充逻辑，来指导自动填充在其支持的任意网站上应如何运作。我们来详细解析一下：

* **支持的网站**：填充辅助仅在您浏览的网站包含在映射中时才会介入；通常，这些网站是广泛被报告会导致 Bitwarden 用户出现自动填充问题的网站。
* **替代默认逻辑**：当在支持的网站上自动填充时，填充辅助会指示浏览器扩展忽略其通常使用的启发式规则（包括用户创建的[自定义字段](/docs/password-manager/your-vault/vault-items/custom-fields)），转而采用更具针对性的替代方案。
* **人工编写的指令**：填充辅助使用一份由人工编写并审核的 CSS 选择器映射表，来描述 Bitwarden 在支持填充辅助网站上应自动填充哪些凭据。

这些映射表由浏览器扩展客户端在每次同步时或每 6 小时获取一次，以保持与最新填充辅助指令同步。因此，有两个关键点需要注意：

* **数据隐私**：获取后，浏览器扩展会将该文件存储在本地，因此，当自动填充操作使用填充辅助时，**无需也绝不会向 Bitwarden 发送任何数据**。
* **独立于客户端发布**：由于浏览器扩展会定期获取最新的映射，您无需等待客户端发布，新的或更新的指令即可生效。

### 报告问题 <a href="#report-an-issue" id="report-an-issue"></a>

另请注意，由于填充辅助指令针对表单上的特定 CSS 选择器，当网站维护者进行更改时，这些指令可能会失效。我们鼓励所有用户继续[报告自动填充问题](https://docs.google.com/forms/d/e/1FAIpQLSfkxh1w6vK8fLYwAbAAEVhvhMAJwfFNDtYtPUVk1y5WTHvJmQ/viewform)，因为部分报告可能适合更新或添加填充辅助指令。


# 自动填充通行密钥

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/storing-passkeys/)
{% endhint %}

{% hint style="info" %}
Bitwarden 提供三种通行密钥功能：

* 从 Bitwarden 密码库为其他服务[保存和自动填充通行密钥](/docs/password-manager/autofill/more-autofill-options/autofill-passkeys)
* [使用通行密钥登录和解锁](#log-in-and-unlock-with-your-passkey)您的 Bitwarden 账户 <mark style="color:red;">**ª**</mark>
* 使用[通行密钥 2FA](/docs/account/two-step-login/setup-two-step-login/two-step-login-via-fido) 保护您的 Bitwarden 账户 <mark style="color:red;">**ª**</mark>

<mark style="color:red;">**ª**</mark> - 某些身份验证器，尤其是 Windows Hello，不允许您使用通行密钥进行登录和 2FA。
{% endhint %}

通行密钥是传统密码的安全替代方案，让您无需输入密码即可登录 App 和网站。根据 [FIDO 联盟](https://fidoalliance.org/overview/)制定的标准开发，绕过了标准密码可能存在的漏洞（如网络钓鱼）。

通行密钥保存在您的 Bitwarden 密码库中，并使用浏览器扩展或移动 App 在您日常使用的 App 和网站上自动填充它们。存储的通行密钥受 Bitwarden 可信赖的端到端加密保护。

## 什么是通行密钥？ <a href="#what-are-passkeys" id="what-are-passkeys"></a>

通行密钥是密码的替代方案，可以让用户在不同设备上快速、方便、安全地登录网站和 App。通行密钥指的是一种可发现的 FIDO 凭证，它可以通过同步实现跨设备的安全无密码登录，或作为设备绑定通行密钥专用于单个硬件。

App 和服务可以要求在保存或访问用它们创建的通行密钥时使用 PIN、密码、图案或生物识别因素进行验证。

### 通行密钥的类型 <a href="#types-of-passkeys" id="types-of-passkeys"></a>

通行密钥通过 Bitwarden 浏览器扩展和移动 App 进行存储和调用。可被发现的通行密钥和不可被发现的 FIDO2 凭据都可以存储在 Bitwarden 中，并用于登录具有通行密钥功能的网站。

## 使用 Bitwarden 保存和自动填充通行密钥 <a href="#using-passkeys-with-bitwarden" id="using-passkeys-with-bitwarden"></a>

{% tabs %}
{% tab title="浏览器扩展" %}
{% hint style="info" %}
浏览器扩展不会为[**排除域名**](/docs/password-manager/autofill/more-autofill-options/exclude-domains)列表中的任何域名提供保存或使用通行密钥的选项。
{% endhint %}

### 允许浏览器扩展使用通行密钥 <a href="#allow-passkeys-with-the-browser-extension" id="allow-passkeys-with-the-browser-extension"></a>

首先打开浏览器扩展，然后进入**设置** → **通知**，确认**询问保存和使用通行密钥**选项已勾选。

如果您不希望在某些特定站点上使用 Bitwarden 通行密钥，您可以设置[排除域名](/docs/password-manager/autofill/more-autofill-options/exclude-domains)。

### 创建通行密钥 <a href="#create-a-passkey" id="create-a-passkey"></a>

在网站或 App 上创建新的通行密钥时，Bitwarden 会提示您存储此通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3kj9zFGb1nJgW236SUaBON/4a6fc1892506164f37586fa4a4fc9aa2/2024-10-29_11-33-21.png?w=961&#x26;fm=avif" alt=""><figcaption><p>保存通行密钥</p></figcaption></figure></div>

{% hint style="info" %}
如果您不希望将通行密钥存储在 Bitwarden 中，请选择**使用您的设备或硬件密钥**。
{% endhint %}

每个登录项目只能保存一个通行密钥。如果某项服务已存在通行密钥，可覆盖现有通行密钥，或选择 <i class="fa-plus">:plus:</i> 添加图标来创建新的登录项目以存储额外的通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2GnYjzxkUFsYftwOSKz1Fi/e065e2784cd4b1eb21470fdfd64a35e9/2024-10-29_11-37-38.png?w=961&#x26;fm=avif" alt=""><figcaption><p>为现有登录保存通行密钥</p></figcaption></figure></div>

### 使用存储在 Bitwarden 中的通行密钥登录 <a href="#sign-in-using-a-passkey-stored-in-bitwarden" id="sign-in-using-a-passkey-stored-in-bitwarden"></a>

首先，确认**询问保存和使用通行密钥**选项已开启。然后在网站上发起通行密钥登录。从弹出的窗口中选择已保存的通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5KeuUZox5shd0zDMxPHKXn/1aab35dfceed0ed9cdb17b143be9a890/2024-10-29_11-39-33.png?w=961&#x26;fm=avif" alt=""><figcaption><p>使用通行密钥登录</p></figcaption></figure></div>

或者，也可以使用[内嵌自动填充菜单](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions#inline-auto-fill-menu)通过通行密钥进行身份验证。

{% hint style="info" %}
如果您之前选择了**使用您的设备或硬件密钥**，Bitwarden 将不会提供输入或保存通行密钥的选项。如果您误点了此选项或改变了主意，请将该网站从[屏蔽的域名](/docs/password-manager/autofill/more-autofill-options/blocking-autofill)中移除。下次您访问该服务的登录页面时，Bitwarden 会询问是否保存您的通行密钥。
{% endhint %}
{% endtab %}

{% tab title="iOS" %}
您可以在 iOS 17.0+ 版本中通过 Bitwarden 保存和使用通行密钥。

### 设置 Bitwarden 以使用通行密钥 <a href="#setup-bitwarden-for-use-with-passkeys" id="setup-bitwarden-for-use-with-passkeys"></a>

要允许 Bitwarden 在 iOS 中存储和使用通行密钥：

1. 打开 iOS **设置** App。
2. 前往**密码** → **查看自动填充设置。**
3. 点击**自动填充密码和通行密钥**。此时将显示可存储通行密钥的 App 列表。
4. 点击 **Bitwarden**。

### 创建通行密钥 <a href="#create-a-passkey" id="create-a-passkey"></a>

在网站或 App 上创建新的通行密钥时，iOS App 将提示您存储此通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6rccoaRtUBbEnUjQxfSTNi/d033196df75950bae5bd7a20e8a7edd2/passkey-ios-1__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>创建通行密钥</p></figcaption></figure></div>

选择**继续**。

{% hint style="info" %}
如果您不想将此通行密钥存储在 Bitwarden 中，请选择**其他选项**。
{% endhint %}

每个登录项目只能保存一个通行密钥。如果某项服务已存在通行密钥，可覆盖现有通行密钥，或选择 <i class="fa-plus">:plus:</i> 添加图标来创建新的登录项目以存储额外的通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6L5s6XBFjvaaEiDZ68m00Q/a130745c2276068fd0be066a47a34684/passkey-ios-2__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>保存或覆盖通行密钥</p></figcaption></figure></div>

### 使用存储在 Bitwarden 中的通行密钥登录 <a href="#sign-in-using-a-passkey-stored-in-bitwarden" id="sign-in-using-a-passkey-stored-in-bitwarden"></a>

要使用 Bitwarden 中存储的通行密钥，请在网站上发起通行密钥登录。移动 App 将提供使用存储在 Bitwarden 密码库中的通行密钥登录的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/b6fY5o4CBxhW4ZjDIpanR/56ffdbf1ff93b7387be273bc7df15e6b/passkey-ios-3__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>使用通行密钥登录</p></figcaption></figure></div>

选择**继续**。

{% hint style="info" %}
如果您更倾向于使用未存储在 Bitwarden 中的通行密钥登录，请选择**其他登录选项**。
{% endhint %}
{% endtab %}

{% tab title="Android" %}
您可以在 Android 14.0+ 版本中通过 Bitwarden 保存和使用通行密钥。

{% hint style="info" %}
在 Android 中，Bitwarden 存储的通行密钥只能用作主要的登录凭据。Android 不允许像 Bitwarden 这样的第三方通行密钥提供程序支持基于通行密钥的 2FA，也称为「不可发现凭据」。
{% endhint %}

### 设置 Bitwarden 以使用通行密钥 <a href="#setup-bitwarden-for-use-with-passkeys" id="setup-bitwarden-for-use-with-passkeys"></a>

要允许 Bitwarden 在 Android 中存储和使用通行密钥：

1. 打开 Bitwarden App。
2. 前往**设置** → **自动填充。**
3. 点击**通行密钥管理**。
4. 点击**继续**。
5. 这将打开您设备的设置 App。将 Bitwarden 配置为您的通行密钥提供程序。

### 创建通行密钥 <a href="#create-a-passkey" id="create-a-passkey"></a>

在网站或 App 上创建新的通行密钥时，Bitwarden Android App 将提示您存储此通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4mBZ6s599BKxzn86CDwBhH/e2a313ab3dc263cd93f5da24e7cad778/passkey-android-1__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>创建通行密钥</p></figcaption></figure></div>

选择**创建**。

{% hint style="info" %}
如果您不想将此通行密钥存储在 Bitwarden 中，请选择**以另一种方式保存**。
{% endhint %}

每个登录项目只能保存一个通行密钥。如果某项服务已存在通行密钥，可覆盖现有通行密钥，或选择 <i class="fa-plus">:plus:</i> 添加图标来创建新的登录项目以存储额外的通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/m8rHHqT8hmuEY7wB9WKld/573de4ef230d2d9cdbdcd94574b55168/passkey-android-2__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>保存或覆盖通行密钥</p></figcaption></figure></div>

### 使用存储在 Bitwarden 中的通行密钥登录 <a href="#sign-in-using-a-passkey-stored-in-bitwarden" id="sign-in-using-a-passkey-stored-in-bitwarden"></a>

要使用 Bitwarden 中存储的通行密钥，请在网站上发起通行密钥登录。移动 App 将提供使用存储在 Bitwarden 密码库中的通行密钥登录的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2COiWur13OpX1QZ7Fy0tbR/65e2b4d39e2387fdcb0ba380ab52fa04/passkey-android-3__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>使用通行密钥登录</p></figcaption></figure></div>

选择**登录**以使用您的通行密钥登录。

{% hint style="info" %}
如果您更倾向于使用未存储在 Bitwarden 中的通行密钥登录，请选择**更多已保存的登录**。
{% endhint %}
{% endtab %}
{% endtabs %}

## 查看 Bitwarden 中的通行密钥 <a href="#viewing-passkeys-in-bitwarden" id="viewing-passkeys-in-bitwarden"></a>

通行密钥保存后，可以从任何 Bitwarden App 查看它，其位于**通行密钥**字段中：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2SofQpuQstpo6gnIg9irwM/5ad0255aa61813dd55a6d4081e7c234d/2024-12-02_16-07-56.png?w=1205&#x26;fm=avif" alt=""><figcaption><p>您的密码库中的通行密钥</p></figcaption></figure></div>

{% hint style="info" %}
如果此登录项目启用了主密码二次验证，您需要重新输入主密码才能访问此通行密钥。
{% endhint %}

### 删除通行密钥 <a href="#deleting-passkeys" id="deleting-passkeys"></a>

要从密码库项目中删除通行密钥：

1、从 Password Manager 网页 App、浏览器扩展或桌面 App 打开项目的**编辑**界面。

2、选择**通行密钥**字段的 <i class="fa-circle-minus">:circle-minus:</i>删除图标。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/448nZ5ybyis0nUEwWsq6kt/8442776aca2a73eec13d30ce25b08f9a/2024-12-02_16-08-55.png?w=694&#x26;fm=avif" alt=""><figcaption><p>删除通行密钥</p></figcaption></figure></div>

### 导出和导入通行密钥 <a href="#export-and-import-passkeys" id="export-and-import-passkeys"></a>

通行密钥包含在 Bitwarden 生成的 [JSON 导出](/docs/password-manager/import-and-export/export-vault-data)文件中，导出后即可[导入到 Bitwarden 账户](/docs/password-manager/import-and-export/import-data)中。


# 自动填充支付卡 & 身份

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/auto-fill-card-id/)
{% endhint %}

Bitwarden 不止于[自动填充用户名和密码](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)！部分 Bitwarden App 还可以自动填充[支付卡](/docs/password-manager/your-vault/vault-items/vault-items#zhi-fu-ka)和[身份信息](/docs/password-manager/your-vault/vault-items/vault-items#shen-fen)，以简化网上购物、账户创建等操作。对于组织成员，策略可能会[阻止使用支付卡项目](/docs/admin-console/oversight-visibility/enterprise-policies#remove-card-item-type)导致无法自动填充支付卡。

{% hint style="info" %}
目前，自动填充支付卡适用于浏览器扩展和 Android。自动填充身份信息仅适用于浏览器扩展。
{% endhint %}

## 设置支付卡 & 身份自动填充 <a href="#set-up-card-and-identity-autofill" id="set-up-card-and-identity-autofill"></a>

{% hint style="success" icon="lightbulb" %}
在 Android 上，自动填充支付卡不需要进行任何额外的设置，只需进行[基本的自动填充设置](/docs/password-manager/autofill/autofill-from/autofill-from-android)即可。以下说明仅适用于浏览器扩展。
{% endhint %}

您可以通过**设置** → **自动填充**中的以下选项，将支付卡和身份添加到列出的自动填充建议中：

* **在密码库视图中始终将支付卡显示为自动填充建议**：将支付卡包含在密码库视图的建议中。当位于自动填充建议中时，点击支付卡项目即可自动填充。
* **在密码库视图中始终将身份显示为自动填充建议**：将身份包含在密码库视图的建议中。当位于自动填充建议中时，点击身份项目即可自动填充。

{% hint style="info" %}
自动填充建议始终优先于[收藏](/docs/password-manager/your-vault/vault-navigation/favorites)。如果您有收藏的支付卡或身份，当开启这些选项后，它们会从**收藏**移至**自动填充建议**中。
{% endhint %}

您可以通过**设置** → **自动填充**中的以下选项，让支付卡和身份在内嵌自动填充菜单中可用，前提是**在表单字段上显示自动填充建议**选项已开启：

* **将支付卡显示为建议**：将支付卡包含在内嵌自动填充菜单中。这要求**在表单字段上显示自动填充建议**选项已开启。
* **将身份显示为建议**：将身份包含在内嵌自动填充菜单中。这要求**在表单字段上显示自动填充建议**选项已开启。

## 自动填充支付卡 & 身份 <a href="#autofilling-cards-and-identities" id="autofilling-cards-and-identities"></a>

您可以使用几种不同的方式来自动填充支付卡或身份：

{% tabs %}
{% tab title="浏览器扩展" %}

### 使用内嵌菜单 <a href="#using-the-inline-menu" id="using-the-inline-menu"></a>

要使用内嵌自动填充菜单启用支付卡和身份自动填填充功能，请按照上一章节所述，打开**将身份显示为建议**和**将支付卡显示为建议**选项。同时，**在表单字段上显示自动填充建议**选项也必须打开。

打开后，当您点击表单时，您存储的支付卡和身份信息将列出。选择填充表单信息时您希望使用的支付卡或身份信息：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2IZKkQJjPBvDgT3Z6IZMoR/2d00c6b6789b78addd486fd974720ddd/2024-08-13_13-10-20.png?w=1188&#x26;fm=avif" alt=""><figcaption><p>内嵌自动填充支付卡</p></figcaption></figure></div>

{% hint style="info" %}
如果您的 Bitwarden 密码库中没有已保存的支付卡或身份信息，您可以在填写信息后从内嵌菜单中选择 <i class="fa-plus">:plus:</i>**新增支付卡** / **新增身份**，以将新项目保存到您的 Bitwarden 密码库中。
{% endhint %}

### 使用浏览器扩展的密码库视图 <a href="#using-the-browser-extensions-vault-view" id="using-the-browser-extensions-vault-view"></a>

要从扩展的密码库中自动填充支付卡或身份信息，请按照上一章节所述，打开**在密码库视图中将支付卡显示为自动填充建议**和**在密码库视图中将身份显示为自动填充建议**选项。

打开后，您的支付卡和身份信息将出现在**密码库**视图的**自动填充建议**部分。点击支付卡或身份信息上的任意位置即可自动填充：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3tnagVMjtTufvRCrih3ctQ/9277f05114868cf0c37c069c565f2f95/Click_item_to_autofill.png?w=481&#x26;fm=avif" alt=""><figcaption><p>点击项目以自动填充</p></figcaption></figure></div>

浏览器扩展会查找网页上与支付卡或身份信息相对应的任何字段，并自动填充它们。

### 使用上下文菜单 <a href="#using-the-context-menu" id="using-the-context-menu"></a>

{% hint style="info" %}
使用上下文菜单自动填充目前不适用于 Safari 浏览器扩展。
{% endhint %}

无需打开浏览器扩展程序，您可以通过右键点击输入字段，然后使用 **Bitwarden** → **自动填充**选项来自动填充支付卡和身份。如果您在尝试执行此操作时密码库已锁定，则会打开一个窗口，提示您解锁。解锁后，浏览器扩展将自动继续自动填充您的信息。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6GKKvIe7GwwOBtp9gmh862/4d39f59a8a862bb83d53e50f9f68d107/2024-12-03_09-12-06.png?w=823&#x26;fm=avif" alt=""><figcaption><p>浏览器扩展上下文菜单</p></figcaption></figure></div>

### 使用键盘快捷键 <a href="#using-keyboard-shortcuts" id="using-keyboard-shortcuts"></a>

可以使用键盘快捷键自动填充支付卡和身份。要使用此功能，必须手动为支付卡和身份设置键盘快捷键：

1、打开 Bitwarden 浏览器扩展然后选择 <i class="fa-gear-complex">:gear-complex:</i>**设置**。

2、从设置菜单中选择**自动填充**，然后选择**管理快捷键**以打开浏览器自动填充设置窗口。

3、在 Bitwarden Password Manager 键盘快捷键中，配置您希望用于**为当前网站自动填充最后一次使用的支付卡**和**为当前网站自动填充最后一次使用的身份**的键盘快捷键。
{% endtab %}

{% tab title="Android App" %}
在 Android 上，支付卡将自动以建议的形式内嵌（在您的键盘中），或以弹窗的形式出现在字段上方，具体取决于[激活了哪种自动填充方式](/docs/password-manager/autofill/autofill-from/autofill-from-android#autofill-methods)。目前，此功能适用于 Chrome 和 Chromium 浏览器。例如，以弹窗的形式：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2ekny75ulY7xoyqz80Kz1z/f3954ac976db5283aa064efc6a78cc5e/2025-08-12_10-32-44.png?w=727&#x26;fm=avif" alt=""><figcaption><p>Android 支付卡弹窗</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}


# 自动填充自定义字段

{% hint style="info" %}
对应的[官方文档地址](https://bitwarden.com/help/article/auto-fill-custom-fields/)
{% endhint %}

Bitwarden 不止于[自动填充用户名和密码](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)！Bitwarden 浏览器扩展还可以自动填充[自定义字段](/docs/password-manager/your-vault/vault-items/custom-fields)，以简化安全问题、PIN 码等的填充。

此外，如果您的浏览器扩展在自动填充特定站点的用户名和密码时遇到问题，使用[链接型自定义字段](#shi-yong-lian-jie-de-zi-ding-yi-zi-duan)可以强制自动填充。

{% hint style="success" icon="lightbulb" %}
要使自动填充正常工作，正确命名自定义字段很重要。[了解更多](/docs/password-manager/your-vault/vault-items/custom-fields#custom-field-names)。
{% endhint %}

要自动填充自定义字段：

1、打开浏览器扩展，导航到**密码库**视图。此视图会自动检测已打开的标签页中显示的网页（例如 `myverizon.com`），并浮现所有具有相应 URI 的登录。

2、如果某个项目出现在**自动填充建议**中，点击包含自定义字段的项目的任意位置即可自动填充：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3tnagVMjtTufvRCrih3ctQ/9277f05114868cf0c37c069c565f2f95/Click_item_to_autofill.png?w=481&#x26;fm=avif" alt=""><figcaption><p>点击项目以自动填充</p></figcaption></figure></div>

浏览器扩展将查找与[自定义字段名称](/docs/password-manager/your-vault/vault-items/custom-fields#custom-field-names)匹配的任何字段，并自动填充该字段的值。

## 使用链接型自定义字段 <a href="#using-linked-custom-fields" id="using-linked-custom-fields"></a>

链接型自定义字段可用于解决浏览器扩展无法自动填充特定站点的用户名和密码时的问题。要创建和自动填充链接型自定义字段：

1、在项目**编辑**面板的**自定义字段**部分，从字段类型下拉菜单中选择**链接型**。

2、在**名称**输入框中，[为自定义字段指定一个名称](/docs/password-manager/your-vault/vault-items/custom-fields#custom-field-names)，使其与用户名或密码的 HTML 表单元素 `id`、`name`、`aria-label` 或 `placeholder` 相对应。

{% hint style="success" icon="lightbulb" %}
您可以通过右键点击表单元素然后使用**复制自定义字段名称**上下文菜单选项来获取其正确的值：

<img src="https://bitwarden.com/assets/5nnPLqyzgAhDCinQNB0uUC/a721194f39f0a8fa919066d73ff9e2c8/2024-10-29_10-50-34.png?w=980&#x26;fm=avif" alt="" data-size="original">

{% endhint %}

3、选择**添加**。

4、根据您在自动填充时遇到问题的凭据类型，为字段值选择**用户名**或**密码**。在许多情况下，您需要为每个凭据类型创建一个链接型自定义字段。

5、**保存**对密码库项目的更改。

现在您已经创建了一个或多个链接型自定义字段，您可以使用[前面部分中描述的方法](#auto-fill-custom-fields)自动填充了。当您操作时，您的浏览器扩展将自动填充用户名、密码或两者到为字段名称指定的 HTML 表单元素中。

## 特殊自动填充场景 <a href="#special-auto-fill-scenarios" id="special-auto-fill-scenarios"></a>

### HTML <a href="#html" id="html"></a>

自定义字段通常被填充到 HTML `<form>` 或 `<input>` 元素中，但是 Bitwarden 浏览器扩展也可以将自定义字段值自动填充到 HTML `<span>` 元素的 `innerText` 中。

要自动填充到 `<span>` 元素中，打开的标签页必须具有 `data-bwautofill` 属性。因此，在以下场景中：

```html
<span data-bwautofill id="myspan">Bitwarden is great.</span>
```

**名称**为 `myspan` 的自定义字段会将 `Bitwarden is great` 替换为保存在该自定义字段的**值**中的任何内容。


# 自动填充基本验证提示

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/basic-auth-autofill/)
{% endhint %}

如下图所示的登录提示，被称为「基本」或「原生」身份验证提示，**如果只有 1 个具有**[**匹配 URI**](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill) **的登录项目**，Bitwarden 浏览器扩展将自动填充。您也可以使用浏览器扩展的 <i class="fa-arrow-up-right-from-square">:arrow-up-right-from-square:</i>**启动**按钮来自动打开并登录基本的受自治保护的资源。

默认情况下，基本验证提示的自动填充将使用[主机](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill#host) URI 匹配检测选项，这样自动填充的限制性更强。可以通过设置相关密码库项目的[匹配检测选项](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)来更改。

如果发现多个登录项目有匹配的 URI，浏览器扩展将无法自动填充您的凭据，您需要手动复制/粘贴您的用户名和密码来登录。

如果只有一个有匹配 URI 的登录项目，则凭据将在后台自动填充，并且不会显示任何身份验证提示。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6rUtQ8FzPTPuKM0sXZ4iyc/3fc116ce5eba8bc70f8dbebfac0eafa6/basic-auth-prompt.png?w=1192&#x26;fm=avif" alt=""><figcaption><p>基本验证提示</p></figcaption></figure></div>

{% hint style="info" %}
由于基本验证提示的设计方式，自动填充必须是非交互式的。这意味着您不能使用**密码库**视图、上下文菜单或键盘快捷键在基本验证提示上进行自动填充。
{% endhint %}


# 对指定网站屏蔽自动填充

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/blocking-uris/)
{% endhint %}

Bitwarden 浏览器扩展和 Android 移动 App 的用户可以明确阻止在某些域名或 URI 上自动填充：

{% tabs %}
{% tab title="浏览器扩展" %}
{% hint style="success" icon="lightbulb" %}
被指定为屏蔽的域名将屏蔽自动填充、屏蔽通行密钥提示，以及屏蔽保存或更新凭据提示。
{% endhint %}

要为浏览器扩展指定要屏蔽的域名：

1. 在 Bitwarden 浏览器扩展中，打开 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡。
2. 选择**自动填充**，然后滚动到屏幕底部并选择**屏蔽域名**。
3. 选择**添加域名**，然后指定要屏蔽的域名。
4. 选择**保存**。
   {% endtab %}

{% tab title="Android" %}
{% hint style="info" %}
屏蔽自动填充 URI 目前仅适用于 **Android 8.0 (Oreo)** 或更高版本。
{% endhint %}

要为 Android 指定要屏蔽自动填充的 URI：

1、在 Bitwarden Android App 中，点击 <i class="fa-gear-complex">:gear-complex:</i>**设置**。

2、点击**自动填充**。

3、向下滚动并点击**屏蔽自动填充**。

4、点击**新增屏蔽的 URI**，然后输入 URI。多个 URI 之间使用逗号分隔，例如：

```bash
https://instagram.com,androidapp://com.instagram.android,https://facebook.com
```

5、点击**保存**。

### 获取 Android App URI <a href="#getting-android-app-uris" id="getting-android-app-uris"></a>

对于通过网络浏览器访问的网站，正确的 URI 是登录页面的 `https://..` 地址，例如 `https://instagram.com` 或 `https://instagram.com/accounts/login`。

**对于 Android App**，[URI 方案](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill#uri-schemes)始终以 `androidapp://` 作为开头，这与典型的网络浏览器 URI 有些不一样。例如：

* Instagram Android App 的 URI 为 `androidapp://com.instagram.android`。
* Reddit Android App 的 URI 为 `androidapp://com.reddit.frontpage`。
* Bitwarden Android App 的 URI 为 `androidapp://com.x8bit.bitwarden`。

{% hint style="success" icon="lightbulb" %}
为 Android App 获取正确的 URI 的一种简单方法是访问 Google Play 商店中的 App 页面，点击分享按钮，然后将复制的链接粘贴到您方便阅读的地方。此链接看起来类似于 `https://play.google.com/store/apps/details?id=com.instagram.android`，`id=` 之后的值就是您的 URI，在本示例中为 `com.instagram.android`。

对于 iOS 用户，可以使用自动填充功能打开 Bitwarden 获取 App URI。打开 Bitwarden 后，选择屏幕右上角的 <i class="fa-plus">:plus:</i> 图标。从这里复制新的密码库项目中包含的 URI。将此 URI 粘贴到此 App 的现有登录项目中。
{% endhint %}
{% endtab %}
{% endtabs %}


# 对指定网站屏蔽自动保存

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/exclude-domains/)
{% endhint %}

Bitwarden 浏览器扩展可配置为排除指定站点，使其不触发[自动保存通知](/docs/password-manager/autofill/autofill-from/autosave-from-browser-extensions)。当某个域名位于**排除域名**列表中时，Bitwarden 不会发出任何可用的通知，包括保存新的登录、更新现有登录、保存或使用通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4vsurEuH5deik26BWn4n1p/82757186b081890fbe92b4d73baeae53/screenshot_7.png?w=426&#x26;fm=avif" alt=""><figcaption><p>询问添加登录</p></figcaption></figure></div>

要配置排除域名，请导航到 **设置** → **通知** → **排除域名**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/qUGIVQR379ac3R2dXdoy8/06b4dec0b9e02911903052789c44723c/2024-12-03_11-00-24.png?w=970&#x26;fm=avif" alt=""><figcaption><p>排除域名配置</p></figcaption></figure></div>

域名排除不会注册「完整」的 URL，只会注册域名组件。例如 `https://github.com/bitwarden/browser` 保存后将解析为 `github.com`，这意味着浏览器扩展不会明确提示保存 GitHub 凭据。


# 自动填充故障排除


# 用于自动填充的 URI

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/uri-match-detection/)
{% endhint %}

在登录项目中包含统一资源标识符 (URI) 以使用[自动填充](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions)，然后选择 <i class="fa-arrow-up-right-from-square">:arrow-up-right-from-square:</i>**启动**图标直接从您的密码库打开网站或 App。URI 是一串字符，用于标识网站地址 (URL)、服务器 IP 地址、[移动 App 包 ID](#uris-for-mobile-apps) 等。

## 将 URI 保存到登录项目 <a href="#save-uris-in-login-items" id="save-uris-in-login-items"></a>

当您创建或编辑登录项目时，请将其输入到**网站 (URI)** 字段中。当浏览器扩展[自动保存](/docs/password-manager/autofill/autofill-from/autosave-from-browser-extensions)新登录时，会自动填充网站的 URI。

您可以将多个 URI 添加到单个登录项目。要重新排序，请在网页 App 或浏览器扩展中编辑项目，然后通过拖放将 URI 调整为您偏好的顺序：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/aDbOEJ6x8G44gkDYcuHJ6/dfef7ac49894805dd0e1e718452e6a60/2025-03-25_09-45-56.png?w=967&#x26;fm=avif" alt=""><figcaption><p>编辑网站 (URI) 字段</p></figcaption></figure></div>

### 将 URI 保存到现有登录项目 <a href="#save-uri-to-existing-login-item" id="save-uri-to-existing-login-item"></a>

您可以使用浏览器扩展来自动填充与您尝试登录的网站没有匹配 URI 的登录项目。

1、打开浏览器扩展并找到您要填充的登录项目。该项目可以被搜索，或位于**所有项目**列表中。选择 <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i> 菜单然后选择**自动填充**。确认自动填充界面将显示在浏览器中。此界面将显示保存到登录项目的所有 URI，以及您当前所在网站的 URI。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/67h2UzB5cit1oVpEKTUcVs/dfeadfd6749961b76fb9746a36cc9085/2025-12-04_09-37-06.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>确认自动填充</p></figcaption></figure></div>

2、选择您想要执行的操作。

### URI 方案格式 <a href="#format-uri-schemes" id="format-uri-schemes"></a>

格式良好的 URI 在开头应包含一个方案，例如 `https://` 方案，以安全地引用网站地址。如果未指定方案，则假定为 `http://`。

方案包括：

* `http://` 或 `https://`：用于引用网站地址（例如：`https://www.github.com`）
* `androidapp://`：用于引用 Android App 的包 ID 或名称（例如：`androidapp://com.instagram.android`）

### 查找移动 App URI <a href="#find-uris-for-mobile-apps" id="find-uris-for-mobile-apps"></a>

获取 iOS 和 Android 设备上安装的 App 的 URI 可能比较麻烦。以下是在 iOS 和 Android App 上获取 URI 的一些提示：

{% tabs %}
{% tab title="iOS" %}
在 iOS 上，查找原生应用程序 URI 的最简单方法是：

1. 在 App 的登录界面，点击 <i class="fa-key">:key:</i>**密码**打开 Bitwarden。
2. 打开 Bitwarden 后，选择屏幕右上角的 <i class="fa-plus">:plus:</i>图标。
3. URI 将自动包含到新的密码库项目中（如果 App 允许），可以将其复制并粘贴到任何现有的登录项目中。
   {% endtab %}

{% tab title="Android" %}
{% hint style="warning" %}
在 Android 上，Password Manager 使用包名称（例如 `com.google.android.gm`）在已安装的应用程序中自动填充。对于已安装的应用程序，请务必**仅安装并自动填充来自受信任来源**（例如 Google Play Store 或 F-Droid）**的应用程序**，

对于 Google Play Store 或 F-Droid 等外部​​来源，Android 不强制包名称的唯一性。这意味着恶意开发人员可以创建和分发旨在获取使用与官方知名应用程序相同的包名称（例如 `com.google.android.gm`）的凭据的应用程序。此类申请将通过自动填充提供，但您可以通过以下方式保护自己：

* 仅安装来自受信任来源的应用程序，例如 Google Play Store 或 F-Droid。
* 仅将凭据自动填充到官方版本的应用程序中。
  {% endhint %}

在 Android 上，查找原生应用程序 URI 的最简单方法是：

1. 访问 Google Play 商店中的 App 页面。
2. 找到分享按钮并将链接复制到剪贴板。
3. 将复制的链接粘贴到可以阅读的地方。此链接看起来像这样：

   `https://play.google.com/store/apps/details?id=com.instagram.android`，`id=` 之后的值就是您的 URI，在本示例中为 `com.instagram.android`。
   {% endtab %}
   {% endtabs %}

{% hint style="info" %}
Android 版本 13 及更高版本支持启动应用程序。
{% endhint %}

## 设置匹配检测 <a href="#match-detection-options" id="match-detection-options"></a>

您可以微调 Bitwarden 将您保存的 URI 与您当前使用的网站或 App 进行比较的方式，确保在合适的时间将您的凭据建议为自动填充。有多种[匹配检测选项](#match-detection-options-1)可供选择。

### 默认匹配检测 <a href="#default-match-detection" id="default-match-detection"></a>

所有新登录项目的默认 URI 匹配方式是[**基础域名**](#base-domain)。要更改您的账户的默认匹配检测：

1. 转到 <i class="fa-gear-complex">:gear-complex:</i>**设置**。
2. 选择**自动填充**。
3. 从**默认 URI 匹配检测**下拉菜单中选择您的首选方式。

{% hint style="info" %}
如果**默认 URI 匹配检测**选项不存在，则是因为您的组织所有者或管理员已选择了[您的组织的默认匹配](/docs/admin-console/oversight-visibility/enterprise-policies#default-uri-match-detection)。
{% endhint %}

### 按项目的匹配检测 <a href="#match-detection-by-item" id="match-detection-by-item"></a>

您还可以为各个项目更改匹配检测。在登录项目的**网站 (URI)** 字段中，选择 **⚙️设置**图标以选择匹配检测方式。这将覆盖您账户的默认匹配检测选项。

## 匹配检测选项 <a href="#match-detection-options" id="match-detection-options"></a>

分配给登录项目的每一个 URI 都有一个关联的匹配检测选项。该选项决定了 Bitwarden 何时将此登录作为自动填充，这通常是通过与具体的组成部分的匹配来确定的。下图对 URI 的组成部分进行了分解：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/2J7AdBKH3DLQwoyGhNAWJA/7fcfdc4cf80202d9c90a1350a75542e2/urlgraphic.png?w=930&#x26;fm=avif" alt=""><figcaption><p>URI 示意图</p></figcaption></figure></div>

{% hint style="info" %}
由于 Android API 提供的自动填充服务的限制，Android Password Manager 客户端当前无法基于**端口**或**路径**来匹配 URI。
{% endhint %}

### 基础域名 <a href="#base-domain" id="base-domain"></a>

选择**基础域名**，当 URI 的顶级域名 (`.com`) 和二级域名 (`google`) 与检测到的资源相匹配时，Bitwarden 将弹出提示提供自动填充。实施基础域名匹配可与任何国家/地区代码顶级域名（例如 `.it` 或 `.co.uk`）配合使用。对于使用唯一域名（例如不同国家/地区）的站点，请创建其他基本域名条目。

例如，URI 为 `https://google.com`，使用基础域名匹配检测：

| URL                           | 自动填充？                           |
| ----------------------------- | ------------------------------- |
| `http://google.com`           | <i class="fa-check">:check:</i> |
| `https://accounts.google.com` | <i class="fa-check">:check:</i> |
| `https://google.net`          | <i class="fa-xmark">:xmark:</i> |
| `http://yahoo.com`            | <i class="fa-xmark">:xmark:</i> |

{% hint style="info" %}
带有本地 TLD（例如 `http://mysite.local` 或 `https://mysite.lan`）或单术语主机名（例如 `http://localdevice`）URI 的用于自动填充的登录项目，将无法使用基础域名检测。我们建议使用[主机匹配](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill#host)。
{% endhint %}

> **\[译者注]**：本地 TLD、单术语主机名，通常用于本地环境，而不是互联网上的公开服务。因此，Bitwarden 等工具无法对它们进行基础域名检测。
>
> * **本地 TLD (local TLD)**：TLD 是域名中最后一部分，即顶级域名，例如 `.com`、`.org` 等。本地 TLD 是指用于本地网络或开发环境的特殊顶级域名，例如 `.local`、`.lan` ，它不是互联网上公开注册的域名，而是专门为本地环境设计的，通常用于开发、测试或内部网络。
> * **单术语主机名 (Single-Term Hostname)**：主机名是域名的一部分，用于标识网络中的特定设备或服务。单术语主机名是指没有域名层级结构的简单主机名，例如 `http://localdevice`，这是一个非常简单的地址，仅包含主机名 (`localdevice`)，没有域名后缀 (如 `.com` 或 `.local`)。这种形式的主机名通常用于本地网络中的设备，例如路由器、打印机或其他本地服务。

### 主机 <a href="#host" id="host"></a>

{% hint style="info" %}
由于 Android API 提供的自动填充服务的限制，Android Password Manager 客户端当前无法基于**端口**或**路径**来匹配 URI。
{% endhint %}

选择**主机**，当主机名和端口（若指定了）与检测到的资源相匹配时，Bitwarden 将弹出提示以提供自动填充。

例如，URI 为 `https://sub.domain.com:4000`，使用主机匹配检测：

| URL                                     | 自动填充？                           |
| --------------------------------------- | ------------------------------- |
| `http://sub.domain.com:4000`            | <i class="fa-check">:check:</i> |
| `https://sub.domain.com:4000/page.html` | <i class="fa-check">:check:</i> |
| `https://domain.com`                    | <i class="fa-xmark">:xmark:</i> |
| `https://sub.domain.com`                | <i class="fa-xmark">:xmark:</i> |
| `https://sub2.sub.domain.com:4000`      | <i class="fa-xmark">:xmark:</i> |
| `https://sub.domain.com:5000`           | <i class="fa-xmark">:xmark:</i> |

{% hint style="warning" %}
在使用[基于键盘的建议](/docs/password-manager/autofill/autofill-from/autofill-from-ios#keyboard-auto-fill)时，iOS 将始终使用基础域匹配自动填充建议。登录时打开 Bitwarden App，将允许您手动选择适当的 App 进行自动填充。
{% endhint %}

### 开始于 <a href="#starts-with" id="starts-with"></a>

{% hint style="warning" %}
**开始于**是一种高级选项，如果使用不当可能会非常危险。如果您不清楚自己在做什么，请勿使用此选项。
{% endhint %}

选择**开始于**，当检测到的资源以登录项目的 URI 值开头（无论后面跟什么）时，Bitwarden 将弹出提示以提供自动填充。

例如，URI 为 `https://sub.domain.com/path/`，使用开始于匹配检测：

| URL                                                  | 自动填充？                           |
| ---------------------------------------------------- | ------------------------------- |
| `https://sub.domain.com/path/`                       | <i class="fa-check">:check:</i> |
| `https://sub.domain.com/path/page.html`              | <i class="fa-check">:check:</i> |
| `https://sub.domain.com`                             | <i class="fa-xmark">:xmark:</i> |
| `https://sub.domain.com:4000/path/page.html`（被端口阻断了） | <i class="fa-xmark">:xmark:</i> |
| `https://sub.domain.com/path`（缺少斜杠）                  | <i class="fa-xmark">:xmark:</i> |

### 正则表达式 <a href="#regular-expression" id="regular-expression"></a>

{% hint style="warning" %}
**正则表达式**是一种高级选项，如果使用不当可能会非常危险。如果您不清楚自己在做什么，请勿使用此选项。
{% endhint %}

选择**正则表达式**，当检测到的资源与一个指定的[正则表达式](https://zh.wikipedia.org/wiki/%E6%AD%A3%E5%88%99%E8%A1%A8%E8%BE%BE%E5%BC%8F)相匹配时，Bitwarden 将弹出提示以提供自动填充。正则表达式始终不区分大小写。

#### 不安全的示例 <a href="#unsafe-example" id="unsafe-example"></a>

URI 为 `^https://.*google\.com$`，使用正则表达式匹配检测：

| URL                                       | 自动填充？                           |
| ----------------------------------------- | ------------------------------- |
| `https://google.com`                      | <i class="fa-check">:check:</i> |
| `https://sub.google.com`                  | <i class="fa-check">:check:</i> |
| `https://malicious-site.com?q=google.com` | <i class="fa-check">:check:</i> |
| `http://google.com`                       | <i class="fa-xmark">:xmark:</i> |
| `https://yahoo.com`                       | <i class="fa-xmark">:xmark:</i> |

这可能比预期的要匹配得更多。考虑避免使用句号 (`.`)，除非转义 (`\`)，否则会匹配任意字符。

#### 安全的示例 <a href="#safe-example" id="safe-example"></a>

URI 为 `^https://[a-z]+\.wikipedia\.org/w/index\.php`，使用正则表达式匹配检测：

| URL                                                                               | 自动填充？                           |
| --------------------------------------------------------------------------------- | ------------------------------- |
| `https://en.wikipedia.org/w/index.php?title=Special:UserLogin&returnto=Bitwarden` | <i class="fa-check">:check:</i> |
| `https://pl.wikipedia.org/w/index.php?title=Specjalna:Zaloguj&returnto=Bitwarden` | <i class="fa-check">:check:</i> |
| `https://en.wikipedia.org/w/index.php`                                            | <i class="fa-check">:check:</i> |
| `https://malicious-site.com`                                                      | <i class="fa-xmark">:xmark:</i> |
| `https://en.wikipedia.org/wiki/Bitwarden`                                         | <i class="fa-xmark">:xmark:</i> |

### 精确 <a href="#exact" id="exact"></a>

选择**精确**，当登录项目的 URI 值与检测到的资源精确匹配时，Bitwarden 将弹出提示以提供自动填充。

例如，URI 为 `https://www.google.com/page.html`，使用精确匹配检测：

| URL                                          | 自动填充？                           |
| -------------------------------------------- | ------------------------------- |
| `https://www.google.com/page.html`           | <i class="fa-check">:check:</i> |
| `http://www.google.com/page.html`            | <i class="fa-xmark">:xmark:</i> |
| `https://www.google.com/page.html?query=123` | <i class="fa-xmark">:xmark:</i> |
| `https://www.google.com`                     | <i class="fa-xmark">:xmark:</i> |

{% hint style="success" icon="lightbulb" %}
如表中所示，您可以使用精确匹配检测将自动填充限制为仅 `https://` 网站上。请注意，无论是否使用精确匹配，浏览器扩展都会在自动填充 HTTP 网站之前向用户发出警告，因为根据该项目保存的 URI，HTTPS 是预期的。
{% endhint %}

### 从不 <a href="#never" id="never"></a>

选择**从不**，Bitwarden 将从不为登录项目弹出以提供自动填充。

## 等效域名 <a href="#equivalent-domains" id="equivalent-domains"></a>

可以在网页密码库的**账户设置** → **域名规则**页面设置等效域名，这样就可以链接域名，以便于自动填充。例如，将 `turbotax.com` 和 `intuit.com` 设置为等效域名，意味着，将 `turbotax.com` 作为 URI 保存的密码库项目也将在 `intuit.com` 上提供自动填充。

Bitwarden 维护一个经过审核的主要网站的默认等效域名列表，例如 `apple.com` 和 `icloud.com`，以改善您的自动填填充体验。您可以将鼠标悬停在任何给定的等效域名上，然后使用 <i class="fa-gear-complex">:gear-complex:</i>选项菜单选择 <i class="fa-xmark">:xmark:</i>**排除**，以禁用该等效域名。

{% hint style="success" %}
对于使用[精确匹配检测](#exact)的项目，等效域名将被忽略。例如，一个保存的 URI 为 `apple.com` 并设置为**精确**的项目，将不会为 `icloud.com` 提供自动填充，即使 `icloud.com` 是默认的等效域名。
{% endhint %}


# 停用浏览器的内置密码管理器

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/disable-browser-autofill/)
{% endhint %}

如果您是 Bitwarden 的新手，很可能您使用的网页浏览器一直在保存和自动填充您的密码。大多数网页浏览器默认启用了这一功能，但专家们普遍认为，[内置的密码管理器比 Bitwarden 这样的专业解决方案要脆弱](https://www.wired.com/2016/08/browser-password-manager-probably-isnt-enough/)。我们建议停用浏览器的内置密码管理器，以提高您的安全性并防止干扰您的 Bitwarden 体验。

{% hint style="info" %}
Bitwarden 浏览器扩展可在托管终端上部署。了解有关[在托管设备上部署 Bitwarden 浏览器扩展](/docs/admin-console/deploy-client-apps/browserext-deploy)的更多信息。
{% endhint %}

## 安装 Bitwarden 时 <a href="#when-you-install-bitwarden" id="when-you-install-bitwarden"></a>

首次安装 Bitwarden 时，会提示您将 Bitwarden 设为默认的密码管理器：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6EXjuiuhxjTCNoxlL9uZRq/513b2d10487c86d0ebed4cc050cbcfba/2026-07-14_14-56-41.png?w=1199&#x26;fm=avif" alt=""><figcaption><p>将 Bitwarden 设为默认</p></figcaption></figure></div>

点击**继续**后，屏幕上将弹出一个对话框。选择**允许**授予 Bitwarden 权限以修改您的浏览器设置。

## 从 Bitwarden 设置菜单 <a href="#from-the-bitwarden-settings-menu" id="from-the-bitwarden-settings-menu"></a>

如果在安装过程中跳过了提示，某些浏览器上的 Bitwarden 浏览器扩展内置了将 Bitwarden 设为默认密码管理器的设置：

1、导航至 Bitwarden 浏览器扩展中的 <i class="fa-gear-complex">:gear-complex:</i>**设置**选项卡，然后选择**自动填充**。

2、点击以启用**将 Bitwarden 设置为您的默认密码管理器**。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5fyBdu5X6JCLu2UsaqYUO0/5cbd0a186251fe8916b5a01be1f3efb8/2026-07-14_14-59-21.png?w=1181&#x26;fm=avif" alt=""><figcaption><p>将 Bitwarden 设置为默认</p></figcaption></figure></div>

3、屏幕上将出现一个对话框，选择**允许**以授予 Bitwarden 更改浏览器设置的权限。

## 从浏览器设置菜单手动操作 <a href="#manually-from-your-browser-settings" id="manually-from-your-browser-settings"></a>

如果上述方法均无效，请从浏览器设置菜单中手动关闭浏览器自带的密码管理器：

{% hint style="success" icon="lightbulb" %}
很多流行的浏览器，如 Opera 和 Brave，使用一个被称为「Chromium」的 Google Chrome 框架。如果您正在使用这些浏览器之一，请参考 **Chrome/Chromium** 部分的说明。
{% endhint %}

{% tabs %}
{% tab title="Chrome/Chromium" %}
在 Chrome 浏览器或任何基于 Chromium 的浏览器（如 Opera 或 Brave）的地址栏中输入  `chrome://password-manager/settings`（将 `chrome` 替换为浏览器名称（例如 `brave://password-manager/settings`））导航到**密码**页面。

在此页面上，切换**提示保存密码和通行密钥**和**自动登录**开关为关闭状态：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/278FMIhP9usz83Q8zlSZRs/34fc118d1a52fcba111b22f786ad00bf/Turn_off_Chrome_Password_Manager.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>停用 Chrome Password Manager</p></figcaption></figure></div>

然后选择**密码**以查看浏览器中存储的所有密码：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4P5alfndwwNgCpTYrSCg61/bc1570211deec146aa51aa6f35f9fed2/View_passwords_saved_in_Chrome_Password_Manager.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>Chrme 已保存的密码</p></figcaption></figure></div>

如果您还没有将这些密码保存到 Bitwarden 中，请[将它们导出](/docs/password-manager/import-and-export/import-guides/import-data-from-chrome#export-from-chrome)，以便将来导入 Bitwarden。导出后，您应该从浏览器的存储中删除这些密码。
{% endtab %}

{% tab title="Edge" %}
虽然 Edge 浏览器基于 Chromium 内核，但操作步骤略有不同。请导航到 `edge://wallet/settings`。在此页面上，选择 **Microsoft 密码管理器**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6tRRYJbZ2xmQZ0ehL2xbvh/4c9c416b6e52c9bd1b3eaf9b75eaaca7/edge-disable-autosave.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>Edge 禁用密码</p></figcaption></figure></div>

然后，将**要求保存密码**和**自动填充密码和通行密钥**的开关设置为**关闭**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3minVF9zEGs9SuGDSQ9FAE/4c3e66b91f7905a5f65ff164afbb3e01/edge_disable_all.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>切换保存密码</p></figcaption></figure></div>
{% endtab %}

{% tab title="Firefox" %}
在 Firefox 中，导航到**设置** → **密码和自动填充**，向下滚动并取消勾选**密码**、**付款方式**和**地址及更多**部分中所有预先勾选的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/72yK5CCMKa9pcfCcdvUZqL/70345d0065b2e093519bcb0dbf74ce86/firefox_update.png?w=1071&#x26;fm=avif" alt=""><figcaption><p>Firefox 密码选项</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb" %}
Bitwarden Password Manager 为高级用户提供各种[报告](/docs/password-manager/your-vault/security-tools/vault-health-reports)，如「泄露密码」报告和「重复使用的密码」报告，并**为所有用户提供免费的数据泄露报告**。
{% endhint %}

您还可以通过选择**已保存的密码**按钮来查看 Firefox 已经保存的所有登录信息：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5UrQ6bGCjV0VdHvy6rzece/fb1d2fc1bd28f1af3fdf4ad890039c84/firefox_update_2.png?w=1148&#x26;fm=avif" alt=""><figcaption><p>Firefox 已保存的登录</p></figcaption></figure></div>

如果您还没有将这些密码保存到 Bitwarden 中，请[将它们导出](/docs/password-manager/import-and-export/import-guides/import-data-from-firefox)，以便将来导入 Bitwarden。导出后，您应该从 Firefox 中 <i class="fa-trash-can">:trash-can:</i>**移除**这些密码。
{% endtab %}

{% tab title="Safari" %}
在 Safari 中，从菜单栏打开**设置**，然后导航到**自动填充**选项卡。在这个选项卡上，取消勾选所有预先勾选的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4nuEz911vsIAUegHVL0Zec/7d663935c4f9e65297c14598f1037b72/safari-disable.png?w=919&#x26;fm=avif" alt=""><figcaption><p>Safari 密码选项</p></figcaption></figure></div>

您还可以通过导航到**密码**选项卡来了解 Safari 已经保存了哪些密码。如果已保存了密码，此选项卡将引导您进入 Apple 密码 App。：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6eZMZC98Grc7sbdHbBfXtK/4c72d19c26e56ad7dfb3267f466bd119/safari-delete.png?w=919&#x26;fm=avif" alt=""><figcaption><p>Safari 已保存的密码</p></figcaption></figure></div>

如果您还没有将这些密码保存到 Bitwarden 中，请在 Bitwarden 中为这些密码创建登录项目。所有密码都保存到 Bitwarden 中后，请从 Safari 中**移除**这些密码。
{% endtab %}

{% tab title="Vivaldi" %}
在 Vivaldi 中，打开 <i class="fa-gear-complex">:gear-complex:</i>**Vivaldi 设置**窗口，然后从左侧导航中选择 <i class="fa-eye">:eye:</i>**隐私**。向下滚动到「密码」部分然后取消选中**保存网页密码**选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6nk9FVDeg8XaUz22Xahr8T/ee0f597cc264da5a30853588d541f074/vivaldi-disable.png?w=1346&#x26;fm=avif" alt=""><figcaption><p>Vivaldi 密码选项</p></figcaption></figure></div>

您还可以通过选择**显示已保存的密码**按钮来了解 Vivaldi 已经保存了哪些密码：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1j5qvcTAVsXficByKFewec/fd6f86731a9e15d38e0cbc39f4f64197/vivaldi-delete.png?w=756&#x26;fm=avif" alt=""><figcaption><p>Vivaldi 已保存的密码</p></figcaption></figure></div>

如果您还没有将这些密码保存到 Bitwarden 中，请在 Bitwarden 中为这些密码创建登录项目。所有密码都保存到 Bitwarden 中后，请从 Vivaldi 中**移除**这些密码。[了解如何操作](https://help.vivaldi.com/zh-hans/desktop/privacy/password-management/#Deleting_passwords)。
{% endtab %}

{% tab title="Tor" %}
虽然 Tor 与 Firefox 共享同一来源，但 Tor 是独立的，因为它默认不保存您的登录信息。如果您没有手动配置过 Tor 来保存和自动填充登录信息，那么您已经做好了一切准备。

如果您配置过，请在地址栏中输入 `about:preferences#privacy` 导航到**密码**页面，然后向下滚动到「登录和密码」部分。取消勾选所有您已勾选的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4FcJnbhCUhDNITJjiy9ciD/d0f83af69188afaf619788c7e60c9a1b/tor-disable.png?w=996&#x26;fm=avif" alt=""><figcaption><p>Tor 密码选项</p></figcaption></figure></div>

您还可以通过选择**已保存的登录...** 按钮来了解 Tor 已经保存了哪些登录信息：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3NHOIo5RIwTjVecqRPeT5Y/6c1e26dc5385006a498b77c48e1048c2/tor-delete.png?w=996&#x26;fm=avif" alt=""><figcaption><p>Tor 已保存的密码</p></figcaption></figure></div>

如果您还没有将这些密码保存到 Bitwarden 中，请在 Bitwarden 中为这些密码创建登录项目。所有密码都保存到 Bitwarden 中后，请从 Tor 中 <i class="fa-trash-can">:trash-can:</i>**移除**这些密码。
{% endtab %}

{% tab title="DuckDuckGo" %}
在 DuckDuckGo 中，导航至**设置** → **自动填充**。在此页面中，取消选中**用户名和密码**复选框。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6kAbV4w8EiJX20O9VZOQyl/c6df545c4bc464122b250527b80494d3/Screenshot_2023-11-03_at_11.06.54_AM.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>禁用 DuckDuckGo Password Manager</p></figcaption></figure></div>

您可以通过选择**导出密码**来创建现有数据的备份。创建备份文件后，选择**查看自动填充内容...** 并删除已存储的自动填充数据，以移除之前保存的建议。

在「Password Manager」部分，macOS 用户可以选择使用 Bitwarden。[此处](/docs/password-manager/more/more-platforms/duckduckgo-macos-browser-integration)了解更多有关 Bitwarden DuckDuckGo macOS 浏览器集成的信息。
{% endtab %}
{% endtabs %}


# Android 自动填充故障排除

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/auto-fill-android-troubleshooting/)
{% endhint %}

如果您使用 [Android 自动填充](/docs/password-manager/autofill/autofill-from/autofill-from-android)时遇到问题，请首先验证您的 Android 版本是否与您选择的自动填充方法兼容。Bitwarden 支持几种不同的自动填充方法，具体取决于您的 Android 版本：

| 选项            | 要求的版本...       | 要求同时启用...        |
| ------------- | -------------- | ---------------- |
| 自动填充服务        | Android 8+     | -                |
| 内嵌自动填充        | Android 11+    | 自动填充服务，支持内嵌的 IME |
| ~~Draw-Over~~ | ~~Android 6+~~ | ~~无障碍~~          |
| 无障碍           | 所有 Android 版本  | -                |

接下来，确认登录项目保存的 URI 格式是否正确。在 Android 上，Password Manager 使用网站地址（例如 `https://gmail.com`）在网页浏览器中自动填充，以及使用包名称（例如 `com.google.android.gm`）在已安装的应用程序中自动填充。

{% hint style="warning" %}
对于要安装的应用程序，请务必**仅安装并自动填充来自受信任来源**（例如 Google Play Store 或 F-Droid）**的应用程序**，因为恶意应用程序可能会伪造知名应用程序的包名称。[了解更多](/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill#android)。
{% endhint %}

## 自动填充服务故障排除 <a href="#troubleshooting-the-autofill-service" id="troubleshooting-the-autofill-service"></a>

如果当您的设备聚焦在用户名或密码输入字段时，Bitwarden 自动填充服务叠加层不可见，您的设备可能需要启用特定于设备的设置：

**对于华为/荣耀设备**，请启用 Dropzone：

1. 打开华为/荣耀「优化器」App（也称为「手机管家」）。
2. 点击底部一行中间的 **Dropzone**。
3. 向右滑动切换开关以允许 Dropzone。

**对于 Oppo 和其他设备**，请启用「浮动窗口」：

1. 打开 Android 设置 App。
2. 导航到**隐私/安全**。
3. 找到**浮动窗口**或**应用管理**，然后点击打开。
4. 向右滑动切换开关以允许「浮动窗口」。

## 无障碍服务故障排除 <a href="#troubleshooting-the-accessibility-service" id="troubleshooting-the-accessibility-service"></a>

使用无障碍服务遇到的最常见的问题是，**Android 电池优化**设置会自动关闭服务（如无障碍服务）以保护电池。要解决这个问题，**请关闭针对 Bitwarden 的电池优化**。

如果您持续遇到无障碍服务的问题：

1. 请再次检查您的电池优化设置。如果针对 Bitwarden 的电池优化处于开启状态，请将其关闭。
2. 如果您使用电池保护程序或任务管理器 App，请尝试将其禁用，看看是否会有所改变。如果有，请将 Bitwarden 添加到例外列表中。
3. 检查内置的任务管理器。您需要调出正在运行的 App 视图，然后按住 App 图标或向上滑动 Bitwarden App，然后选择**锁定**。

请注意，如果您曾经强制停止了 Bitwarden App，该服务也会挂起。

{% hint style="success" icon="lightbulb" %}
此网站 <https://dontkillmyapp.com/>，或许可以帮助您确定设备的默认电池优化配置。
{% endhint %}

{% hint style="info" %}
如果您仍然无法让 Android 自动填充功能正常工作，请[联系我们](https://bitwarden.com/contact/)。
{% endhint %}

## ~~Draw-Over 疑难解答~~ <a href="#troubleshooting-draw-over" id="troubleshooting-draw-over"></a>

~~Draw-Over 与 Bitwarden 自动填充功能的交互方式有所不同，具体取决于您所使用的 Android 版本。如果遇到问题，请根据下表进行检查：~~

| 版本             | 描述                                    |
| -------------- | ------------------------------------- |
| ~~Android 5~~  | ~~**不可用**，默认授予权限。~~                   |
| ~~Android 6~~  | ~~**要求**使用无障碍，因为弹出式窗口是唯一可用的选项。~~      |
| ~~Android 7+~~ | ~~**可选**。如果您只想使用自动填充快速操作磁贴而不使用弹出窗口。~~ |

{% hint style="info" %}
如果您仍然无法正常使用 Android 自动填充功能，请[联系我们](https://bitwarden.com/contact)。
{% endhint %}


# 自动填充 FAQ

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/autofill-faqs/)
{% endhint %}

### 问：如何禁用 Bitwarden 无障碍气泡？ <a href="#q-how-do-i-disable-the-bitwarden-accessbility-bubble" id="q-how-do-i-disable-the-bitwarden-accessbility-bubble"></a>

1. 在您的 Android 设备中打开**设置**。
2. 导航到**无障碍**。
3. 选择 **Bitwarden**。
4. 将 Bitwarden 快捷方式切换为关闭。

### ~~问：可以自动填充分离式登录工作流吗？~~ <a href="#q-can-i-auto-fill-on-a-split-login-workflow" id="q-can-i-auto-fill-on-a-split-login-workflow"></a>

~~**答：**&#x5206;离式登录工作流（即用户名和密码字段分别显示在不同的屏幕上）可以被 Bitwarden 浏览器扩展程序自动填充，但目前不支持移动 App。~~

### 问：在 iPad 上使用物理键盘时，可以使用自动填充功能吗？ <a href="#q-can-i-use-auto-fill-while-using-a-physical-keyboard-on-an-ipad" id="q-can-i-use-auto-fill-while-using-a-physical-keyboard-on-an-ipad"></a>

**答：**&#x53EF;以。要在使用物理键盘时使用自动填充功能：

1. 打开您的 iOS 设备上的 <i class="fa-gear-complex">:gear-complex:</i>**设置** App。
2. 点击**通用**。
3. 点击**键盘**。
4. 在「所有键盘」部分，将**快捷键**切换为打开。

### 问：Android 设备中如何禁用 Google 自动填充？ <a href="#q-how-do-i-disable-google-auto-fill-in-my-android-device" id="q-how-do-i-disable-google-auto-fill-in-my-android-device"></a>

**答：**&#x8981;在您的 Android 设备中禁用 Google 自动填充：

1. 在您的 Android 设备中打开**设置**。
2. 向下滚动并点击 **Google**。
3. 点击 **Google 自动填充**然后将其切换为关闭。

### 问：出现「生物识别解锁已禁用，等待验证主密码」时怎么办？ <a href="#q-what-do-i-do-about-biometric-unlock-disabled-pending-verification-of-master-password" id="q-what-do-i-do-about-biometric-unlock-disabled-pending-verification-of-master-password"></a>

**答：**&#x8FD9;种情况最常发生在 iOS 上，当您更改了设备的生物识别设置时（例如在触控 ID 中添加了另一个手指）。要解决此错误：

1. **如果您已激活了** [**PIN 码**](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)**验证**，禁用它。
2. 注销您的 Bitwarden 移动 App。
3. 检查您的设备设置是否设置为[使用 Bitwarden 进行自动填充](/docs/password-manager/autofill/autofill-from/autofill-from-ios#keyboard-auto-fill)。
4. 重新登录到您的 Bitwarden 移动 App。
5. 如果要将 PIN 码验证用作[生物识别](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlocking-with-biometrics)的备份，请重新启用 [PIN 码](/docs/account/log-in-and-unlock/more-log-in-unlock-methods/unlock-with-pin)验证。

### 问：当「基础域名」是设定的规则时，URI 匹配是否对某些网站无效？ <a href="#q-does-uri-matching-not-work-with-certain-websites-when-base-domain-is-the-set-rule" id="q-does-uri-matching-not-work-with-certain-websites-when-base-domain-is-the-set-rule"></a>

**答：**&#x7531;于您当前所在的 URL 可能为多个网站提供服务，因此一些通常应该匹配的结果会被过滤掉。要了解更多有关这些网站的更多信息，请访问 [publicsuffix.org](https://publicsuffix.org/)。


# 导入 & 导出


# 导入到您的密码库或集合

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/import-data/)
{% endhint %}

从不同的密码管理器、其他 Bitwarden 密码库或[加密导出](/docs/password-manager/import-and-export/encrypted-exports)来导入登录和数据，以即时传输信息，省去手动输入。您可以从任何允许导出的密码管理解决方案中导入数据。

{% hint style="success" icon="lightbulb" %}
本文介绍如何导入到您自己的密码库或您具有访问权限的[集合](#import-to-a-collection)。如果您正在管理某个组织，则可能需要[导入到组织](/docs/admin-console/manage-shared-items/import-organization-items/import-to-organization)。
{% endhint %}

## 从常见的密码管理器 & 文件类型导入 <a href="#common-password-manager-file-type-imports" id="common-password-manager-file-type-imports"></a>

Bitwarden 支持从许多常见的密码管理解决方案中导入数据，包括：

* [从 LastPass 导入](/docs/password-manager/import-and-export/import-guides/import-data-from-lastpass)
* [从 1Password 导入](/docs/password-manager/import-and-export/import-guides/import-data-from-1password)
* [从 Firefox 导入](/docs/password-manager/import-and-export/import-guides/import-data-from-firefox)
* [从 Google Chrome、Edge 或 Chromium 导入](/docs/password-manager/import-and-export/import-guides/import-data-from-chrome)
* [从 Password Safe 导入](/docs/password-manager/import-and-export/import-guides/import-data-from-password-safe)
* [从其他 Bitwarden 密码库导入](/docs/password-manager/import-and-export/export-vault-data)

Bitwarden 兼容来自其他密码管理器的[其他文件类型](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。如果您的解决方案未列出，但可以导出数据，请编辑文件以使其符合[支持的格式](/docs/password-manager/import-and-export/condition-bitwarden-import)。

## 导入到您的个人密码库 <a href="#import-to-your-personal-vault" id="import-to-your-personal-vault"></a>

数据可以从网页 App、浏览器扩展、桌面 App 或 CLI 导入到 Bitwarden。数据在发送到服务器存储之前会在本地进行[加密](/docs/security/encryption/encryption-protocols)。

{% hint style="info" %}
虽然某些项目类型无法导入，但您仍可将其添加到密码库：

* 将[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)逐个上传到新的密码库。
* 在新的密码库中重新创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
  {% endhint %}

{% tabs %}
{% tab title="网页 App" %}
要将数据导入到您的 Bitwarden 密码库：

1、选择**工具**。

2、选择**导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1NbyPb9dN545ZqKGRZYB3x/e6b8f3f31aa82bb05cef12c5a5c4c193/2025-12-17_11-25-08.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入项目</p></figcaption></figure></div>

3、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="info" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

4、从**文件格式**下拉菜单中，选择您的导出数据的[文件格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

5、要输入您的数据，请执行以下操作之一：

* 选择**选择文件**，然后从您的计算机中选择已导出的文件。
* 将已导出的文件的内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

6、选择**导入**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

7、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="浏览器扩展" %}
要将数据导入到您的密码库：

1、选择**设置**。

2、选择**密码库选项**。

3、选择**导入项目**。将出现一个新窗口。

4、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

5、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

6、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

7、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

8、数据导入后，请从您的设备中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="移动端" %}
在移动设备上导入数据有两种方式。使用 CXP 直接导入通常最为简便，但目前仅支持少数密码管理 App。

### 移动设备最常用的方式 <a href="#most-common-method-for-mobile" id="most-common-method-for-mobile"></a>

对于大多数设备，打开移动浏览器，登录 Bitwarden，然后按照[网页 App 的导入步骤](#wang-ye-app)操作。

### 使用凭据交换协议 (CXP) 直接导入 <a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

Bitwarden 支持 [FIDO 凭据交换协议 (CXP)](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)。该协议通过省去手动下载和处理数据文件的步骤，提供了一种替代且通常更快的导入方式。当前存储您数据的密码管理器 App 也必须支持 CXP，具体步骤因 App 而异。

#### 使用 iOS 设备 CXP <a href="#cxp-with-ios-devices" id="cxp-with-ios-devices"></a>

要使用 **iOS 26+** 移动设备导入数据：

1、打开保存有数据的其他兼容 CXP 的密码管理器 App。

2、根据 App 的不同，找到导出数据选项，然后选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

{% hint style="info" %}
例如，在 **Apple 密码** App 中：

1. 点击 <i class="fa-ellipsis">:ellipsis:</i>选项图标。
2. 点击**导出数据到其他 App**。
3. 在出现的列表中，勾选您想要转移的密码和通行密钥。完成后，点击**继续**。
   {% endhint %}

3、在**导出密码**界面上，点击**继续**。

4、选择 **Bitwarden** 作为目标位置，然后点击**继续**。

5、点击**在 Bitwarden 中继续**。

6、Bitwarden App 将打开。点击**继续**以确认导入。

7、完成后，将出现一条消息，确认您的数据已成功导入。

#### 使用 **Android** 设备 CXP <a href="#cxp-with-android-devices" id="cxp-with-android-devices"></a>

要使用 **Android 10+** 移动设备导入数据：

1、打开 Bitwarden App。

2、点击**设置**。

3、点击**密码库**。

4、点击**导入项目**。

5、点击**从其他 App 导入**。

6、选择您保存数据的其他兼容 CXP 的密码管理器 App，然后点击**继续**。

7、根据 App 的不同，选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

8、完成后，将出现一条消息，确认您的数据已成功导入。

{% hint style="info" %}
目前，Android 不支持通过 CXP 导入 Dashlane 数据。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
要将数据导入到您的密码库：

1、从导航菜单选择**导入**。

2、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

3、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

4、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

5、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

6、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="CLI" %}
要将数据导入您的密码库，请使用以下 [CLI](/docs/password-manager/developer-tools/cli/password-manager-cli) 命令：

```shell
bw import <format> <path>
```

`bw import` 命令需要格式（使用 `bw import --formats` 获取格式列表）和路径，例如：

```shell
bw import <format> /Users/myaccount/Documents/mydata.csv
```

数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}
{% endtabs %}

## 导入到集合 <a href="#import-to-a-collection" id="import-to-a-collection"></a>

将数据导入[集合](/docs/admin-console/manage-shared-items/collections/create-collections)以组织项目，以及与您的直接队友或家人共享项目。如果您正在管理 Bitwarden 组织，请考虑[将数据导入组织](/docs/admin-console/manage-shared-items/import-organization-items/import-to-organization)中。

在**导入**页面，选择您组织的**密码库**然后选择**集合**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5i5K8TyWXdbpJLNlsfyd3v/ff5bd0dedb26341e355c8537faafee2e/2025-12-17_11-28-45.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入到集合</p></figcaption></figure></div>

## 导入错误故障排除 <a href="#troubleshoot-import-errors" id="troubleshoot-import-errors"></a>

如果超过限制或文件中包含未分配的项目，您将看到一个「导入错误」的消息。导入被拒绝时，不会将数据添加到您的密码库中。

### 文件限制 <a href="#file-limits" id="file-limits"></a>

导入的文件最多可包含：

* 4,000 个项目。
* 2,000 个文件夹。
* 2,000 个集合。
* 7,000 个项目-文件夹关系（例如，1 个项目存在于 3 个文件夹中，可以算作 3 个项目 - 文件夹关系）。
* 8,000 个项目-集合关系（例如，1 个项目存在于 3 个集合中，可以算作 3 个项目 - 集合关系）。

如果您的文件太大，请将其拆分为较小的文件然后分别导入。

### 字段长度限制 <a href="#field-length-limits" id="field-length-limits"></a>

如果文件（通常是 `.csv`）中的某个项目超过了字段的**加密**字符限制，Bitwarden 将不会导入其中的任何内容。系统将显示一个「导入错误」的消息，并详细说明具体的问题。

{% hint style="success" icon="lightbulb" %}
导入时，Bitwarden 的加密过程会将文本扩展 30-50%，这可能会使您的字段超出字符限制。例如，最常见的`备注`字段可能会从 8,000 个字符增加到超过 10,000 个字符，从而超出限制并引发错误。
{% endhint %}

要修复此错误并上传数据：

1. 在文本编辑器或电子表格程序中打开 `.csv` 文件。
2. 查看错误信息的详细信息，找出导致问题的项目。例如，我们来解释以下错误：\
   `[2] [Login] “My New Item”: The field Notes exceeds the maximum encrypted value length of 10000 characters.`
   * `[2]` 标识违规项目所在的索引号，该索引号已调整为与大多数电子表格程序中的行号匹配
   * `[Login]` 标识违规项目的项目 `type`（类型）
   * `"My New Item"` 标识违规项目的 `name`（名称）
   * `Notes` 标识超出了字符数限制的字段（列）
   * `10000` 标识该字段（列）允许的字符数限制
3. 减少字符数或删除违规项目。
4. 保存文件。
5. 返回 Bitwarden 然后[导入更新后的文件](#import-to-your-personal-vault)。

### 文件包含未分配的项目 <a href="#https-bitwarden.com-help-import-data-file-contains-unassigned-items" id="https-bitwarden.com-help-import-data-file-contains-unassigned-items"></a>

组织用户（非[管理员或所有者](/docs/admin-console/manage-members/member-roles#member-roles)）必须将所有导入的凭证分配给至少一个集合。有两种方法可以解决此导入错误：

* 分配一个您拥有**管理集合**权限的现有集合。
* 为未指定的项目创建一个新的集合。通过输入一个新的集合名称来[自定义导入文件](/docs/password-manager/import-and-export/condition-bitwarden-import)。这将自动创建该集合并将项目添加到其中。

{% hint style="success" icon="lightbulb" %}
要尽量减少此错误，请启用[限制为所有者和管理员可以创建集合](/docs/admin-console/manage-shared-items/collections/collection-settings#restrict-collection-creation-to-owners-and-admins)设置以阻止用户创建集合。
{% endhint %}

### 组织最多只能拥有两个集合 <a href="#organization-can-only-have-a-maximum-of-two-collections" id="organization-can-only-have-a-maximum-of-two-collections"></a>

免费组织最多可以拥有两个[集合](/docs/admin-console/manage-shared-items/collections/about-collections)。如果您尝试导入的文件中指定了两个以上的集合，则会出现导入错误。有几个选项可以解决此问题：

* 如果您尝试导入 `.csv` 或 `.json`，请[编辑该文件](/docs/password-manager/import-and-export/condition-bitwarden-import)以删除附加的集合。
* 升级您的方案，以便您可以创建更多集合并按原样导入文件。


# 导入指南


# 从 LastPass 导入

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/import-from-lastpass/)
{% endhint %}

使用这篇文章帮助您从 LastPass 导出数据并导入到 Bitwarden。

## 从 LastPass 导出 <a href="#export-from-lastpass" id="export-from-lastpass"></a>

您可以从 LastPass 的网页密码库或从 LastPass 浏览器扩展[导出数据](https://support.lastpass.com/help/export-your-passwords-and-secure-notes-lp040004)：

{% hint style="success" icon="lightbulb" %}
您可以跳过此步骤并立即开始使用[直接导入选项](#import-to-bitwarden)导入到 Bitwarden，仅适用于 Bitwarden 浏览器扩展和桌面 App。
{% endhint %}

{% tabs %}
{% tab title="LastPass 网页密码库" %}
要从 LastPass 网页密码库导出您的数据：

1、从左侧边栏选择 <i class="fa-rocket">:rocket:</i>**Advanced Options** 选项。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5uCdlKvfGTjYIEJvKtpbQw/14cd0e6bfb36a53b1f1d6f88d3808a90/lastpassadvancedoptions.png?w=1272&#x26;fm=avif" alt=""><figcaption><p>从网页密码库导出</p></figcaption></figure></div>

2、从管理您的密码库部分，选择 **Export** 选项。此时，LastPass 将向您发送一封电子邮件以确认导出。

3、在您的收件箱中，确认此导出操作，返回到您的 LastPass 网页密码库，并再次选择 **Export** 选项以完成导出。

根据您的浏览器，您的密码库数据将自动保存为 `.csv` 文件或以 `.csv` 格式显示在屏幕上：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6TIRhpByBC4coLrP58zG8a/fb2da8df01a2e0f56e87f45612182e86/lastpass-copy.png?w=749&#x26;fm=avif" alt=""><figcaption><p>LastPass 导出</p></figcaption></figure></div>

4、如果您的密码库数据显示在屏幕上，全选显示的数据，将其复制并粘帖到一个新的 `export.csv` 文件中。

{% hint style="warning" %}
一些用户报告了一个 bug：密码中的特殊字符（`&`、`<`、`>` 等）在导出时，被更改成了 HTML 编码的值（例如 `&amp;`）。

如果您在导出的数据中发现了这个 bug，请使用文本编辑器查找并替换所有被更改的值，然后再导入到 Bitwarden。
{% endhint %}
{% endtab %}

{% tab title="LastPass 浏览器扩展" %}
要从 LastPass 浏览器扩展导出您的数据：

1、在浏览器扩展中，导航到 **Account** → **Fix a problem yourself** → **Export vault items** → **Export data for use anywhere**。

{% hint style="info" %}
如果您使用旧版本的 LastPass 浏览器扩展，则可能需要导航至 **Account Options** → **Advanced** → **Export** → **LastPass CSV File**。
{% endhint %}

2、输入您的主密码以验证导出尝试。

根据您的浏览器，您的密码库数据将自动保存为 `.csv` 文件或以 `.csv` 格式显示在屏幕上：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6TIRhpByBC4coLrP58zG8a/fb2da8df01a2e0f56e87f45612182e86/lastpass-copy.png?w=749&#x26;fm=avif" alt=""><figcaption><p>LastPass 导出</p></figcaption></figure></div>

3、如果您的密码库数据显示在屏幕上，全选显示的文本数据，然后将其复制并粘帖到一个新的 `export.csv` 文件中。
{% endtab %}
{% endtabs %}

## 导入到 Bitwarden <a href="#import-to-bitwarden" id="import-to-bitwarden"></a>

可以从 LastPass 直接导入，也可以使用从 LastPass [导出的文件](#export-from-lastpass)导入。如果您是使用 LastPass SSO 的团队成员，在您使用**直接导入**选项导入个人数据之前，LastPass 管理员将需要完成一个简短的设置过程。无论哪种方式，数据在发送到服务器存储之前都会在本地进行[加密](/docs/security/encryption/encryption-protocols)。

{% hint style="info" %}
虽然某些项目类型无法导入，但您仍可将其添加到密码库：

* 将[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)逐个上传到新的密码库。
* 在新的密码库中重新创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
  {% endhint %}

{% tabs %}
{% tab title="直接导入" %}
{% hint style="success" icon="lightbulb" %}
如果您是使用 LastPass SSO 的团队成员，LastPass 管理员需要先完成一个简单的设置过程，然后您才能使用**直接导入**选项（[了解更多](#direct-import-with-sso)）。
{% endhint %}

可以使用 Password Manager 浏览器扩展和桌面 App 从您的 LastPass 账户直接导入个人密码库数据，而无需您上传文件。要进行直接导入：

1、登录到 Password Manager 浏览器扩展或桌面 App。

2、在浏览器扩展中，选择**设置**选项卡，然后选择**密码库**然后选择**导入项目**选项。或者，在桌面 App 中，从导航菜单选择**导入**。

3、从下拉菜单中完成以下字段：

* **密码库**或**导入目的地**：选择导入目的地，例如您的个人密码库或您拥有访问权限的组织密码库。
* **文件夹**或**集合**：选择您希望将导入的内容移动到的特定文件夹或您拥有访问权限的组织集合。
* [**文件格式**](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)：选择 **LastPass**。
* 在 LastPass 说明框中，选择**直接从 LastPass 导入**选项。
* 输入您的 **LastPass 电子邮箱地址**。如果您代表企业进行导入，我们建议您使用 LastPass [管理员](https://support.lastpass.com/s/document-item?language=en_US\&bundleId=lastpass\&topicId=LastPass/uac_admin_roles.html&_LANG=enus)凭据。使用超级管理员凭据可能会导致导入失败。

4、选择**导入数据**按钮以触发导入。

5、将提示您输入 LastPass 主密码，或者如果您的 LastPass 账户使用 SSO，登录到您的 IdP。无论哪种情况，请按照提示登录到您的 LastPass 账户。

{% hint style="success" icon="lightbulb" %}
如果您的 LastPass 账户激活了多重身份验证，系统将提示您输入来自身份验证器 App 的一次性通行代码。如果您使用 Duo 方式的 MFA，则仅支持应用内审批以满足您的 MFA 要求。
{% endhint %}

[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)、回收站等附加项目需要手动上传到您的密码库。
{% endtab %}

{% tab title="文件导入" %}
从大多数 Password Manager App 导出的文件可以导入到 Bitwarden（了解如何[从 LastPass 导出文件](#export-from-lastpass)）。在本节中，我们将重点介绍使用网页 App 进行导入：

1、通过 [https://vault.bitwarden.com](< https://vault.bitwarden.com>)，<https://vault.bitwarden.eu> 或自托管的 `https://your.bitwarden.domain.com` 登录到网页密码库。

2、从导航选择**工具** → **导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1NbyPb9dN545ZqKGRZYB3x/e6b8f3f31aa82bb05cef12c5a5c4c193/2025-12-17_11-25-08.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入项目</p></figcaption></figure></div>

3、从下拉菜单中完成以下字段：

* **导入目的地**：选择导入目的地，例如您的个人密码库或您拥有访问权限的组织密码库。
* **文件夹**或**集合**：选择您希望将导入的内容移动到的特定文件夹或您拥有访问权限的组织集合。
* [**文件格式**](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)：选择导入文件的格式。

4、选择**选择文件**然后添加一个文件用于导入，或将文件内容**复制/粘贴**到输入框中。

{% hint style="warning" %}
导入时不会检查重复。如果您多次导入同一文件或导入密码库中已有的项目，则会创建重复的项目。
{% endhint %}

5、选择**导入**按钮以触发导入。如果您要导入受密码保护的 .`json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

6、成功导入后，从您的计算机中将导入源文件删除。这将在您的计算机受到威胁时为您提供保护。

[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)、回收站等附加项目需要手动上传到您的密码库。
{% endtab %}

{% tab title="CLI" %}
要通过 CLI 将数据导入您的密码库，请使用以下命令：

```bash
bw import <format> <path>
```

`bw import` 命令需要格式（使用 `bw import --formats` 获取格式列表）和路径，例如：

```bash
bw import <format> /Users/myaccount/Documents/mydata.csv
```

成功导入后，从您的计算机中将导入源文件删除。这将在您的计算机受到威胁时为您提供保护。
{% endtab %}
{% endtabs %}

## 使用 SSO 直接导入 <a href="#direct-import-with-sso" id="direct-import-with-sso"></a>

{% hint style="warning" %}
以下 IdP 不支持使用 SSO 的 LastPass 账户的直接导入：

* Google Workspace
* ADFS
  {% endhint %}

如果您是使用 SSO 的 LastPass 团队管理员，则您需要先完成以下操作，然后您的团队才能使用**直接导入**选项：

* 在 IdP 的 LastPass 应用程序中添加 `bitwarden://sso-callback-lp` 和 `bitwarden://import-callback-lp` 作为允许的回调 URL。

如果您的用户使用 Password Manager 浏览器扩展：

* 在您的 IdP 的 LastPass 应用程序中添加 `[protocol]://[identifier]/sso-connector.html?lastpass=1` 或 `https://your.server.com/sso-connector.html?lp=1` 作为允许的回调 URL。
* 在您的 IdP 的 LastPass 应用程序中添加 `chrome-extension://nngceckbapebfimnlniiiahkandclblb`，`ms-browser-extension://jbkfoedolllekgbhcbcoahefnbanhhlh` 和/或 `moz-extension://23462205-0e62-4cc8-80c4-910cf54b82c2` 作为允许的回调 URL。

## 导入错误故障排除 <a href="#troubleshoot-import-errors" id="troubleshoot-import-errors"></a>

如果出现「导入错误」消息，则不会有任何数据添加到您的密码库中。[修复导入文件问题](/docs/password-manager/import-and-export/import-data#troubleshoot-import-errors)然后重试。

### 组织最多只能拥有俩个集合 <a href="#organization-can-only-have-a-maximum-of-two-collections" id="organization-can-only-have-a-maximum-of-two-collections"></a>

免费 Bitwarden 组织最多可以拥有两个集合来组织项目。导入数据时，Bitwarden 会将 LastPass  `grouping` 值视为集合。如果您的 LastPass 导出包含 3 个或更多 `grouping` 值，并且您是免费 Bitwarden 组织的一部分，您将收到 「This organization can only have a maximum of two collections（该组织最多只能拥有两个集合）」的导入错误。

当 Lastpass 导出包含 3 个或更多 `grouping` 值时，就会发生该错误。`grouping` 字段中的值被 Bitwarden 解释为[集合](/docs/admin-console/manage-shared-items/collections/about-collections)，但[免费组织](/docs/plans-and-pricing/password-manager/about-bitwarden-plans)限制为仅两个集合。例如，下面的 `.csv` 将导致该错误：

```
url,username,password,totp,extra,name,grouping,fav
https://www.facebook.com/login.php,username,password,,,Facebook,Social,0
https://twitter.com/login,username,password,,,Twitter,Social,0
https://asana.com/,login,password,,,Asana,Productivity Tools,0
https://github.com/login,username,password,,,Github,Productivity Tools,0
https://www.paypal.com/login,username,password,,,Paypal,Finance,0
https://www.bankofamerica.com/,username,password,,,Bankofamerica,Finance,0
```

要解决这个问题，请删除每个项目的 `grouping` 列和 `grouping` 基准，包括后面的逗号，例如，编辑：

```
https://github.com/login,username,password,,,Github,Productivity Tools,0
```

将其减少为：

```
https://github.com/login,username,password,,,Github,0
```


# 从 1Password 导入

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/import-from-1password/)
{% endhint %}

使用这篇文章帮助您从 1Password 导出数据并导入到 Bitwarden。1Password 数据支持导出为 `.1pux`（要求 1Password v8.5+）、`.1pif` 或 `.csv` 文件，这取决于您使用的客户端版本和操作系统。了解 [1Password 导出包含哪些数据](https://support.1password.com/export/?mac#get-help)。

{% hint style="success" icon="lightbulb" %}
iOS 版 1Password 支持通过凭证交换功能导出您的数据，包括通行密钥。[了解如何使用凭证交换功能](https://support.1password.com/export/?ios)轻松从 1Password 迁移到 Bitwarden。
{% endhint %}

## 从 1Password 导出 <a href="#export-your-1-password-1-pif-logins" id="export-your-1-password-1-pif-logins"></a>

完成以下步骤以从 1Password 桌面 App 导出数据：

{% hint style="success" icon="lightbulb" %}
目前，只有 1Password 8 允许您一次导出多个密码库。如果您使用 1Password 8，请跳至**步骤 3**。
{% endhint %}

1、导航到您想要导出数据的密码库。

2、在密码库中，选择您要导出的项目。按住 Ctrl/Cmd 键可以选择多个密码库项目，或者按 Ctrl/Cmd + A 键选择所有项目。

3、基于您的设备：

* 在 Windows 中，选择**文件** → **导出**，或右键单击然后选择**导出**。
* 在 macOS 中，选择**文件** → **导出** → **所有项目...**。

{% hint style="info" %}
从 macOS 导出 `.csv` 文件时，您还必须选择 **All Fields**，然后勾选 **Include Column Labels**。
{% endhint %}

4、在导出窗口中，指定一个位置和文件格式。

## 导入 Bitwarden <a href="#import-to-bitwarden" id="import-to-bitwarden"></a>

数据可以从网页 App、浏览器扩展、桌面 App 以及 CLI 导入到 Bitwarden。数据在发送到服务器存储之前会在本地进行[加密](/docs/security/encryption/encryption-protocols)。

{% hint style="info" %}
虽然某些项目类型无法导入，但您仍可将其添加到密码库：

* 将[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)逐个上传到新的密码库。
* 在新的密码库中重新创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
  {% endhint %}

{% tabs %}
{% tab title="网页 App" %}
要将数据导入到您的 Bitwarden 密码库：

1、选择**工具**。

2、选择**导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1NbyPb9dN545ZqKGRZYB3x/e6b8f3f31aa82bb05cef12c5a5c4c193/2025-12-17_11-25-08.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入项目</p></figcaption></figure></div>

3、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="info" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

4、从**文件格式**下拉菜单中，选择您的导出数据的[文件格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

5、要输入您的数据，请执行以下操作之一：

* 选择**选择文件**，然后从您的计算机中选择已导出的文件。
* 将已导出的文件的内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

6、选择**导入**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

7、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="浏览器扩展" %}
要将数据导入到您的密码库：

1、选择**设置**。

2、选择**密码库选项**。

3、选择**导入项目**。将出现一个新窗口。

4、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

5、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

6、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

7、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

8、数据导入后，请从您的设备中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="移动端" %}
在移动设备上导入数据有两种方式。使用 CXP 直接导入通常最为简便，但目前仅支持少数密码管理 App。

### 移动设备最常用的方式 <a href="#most-common-method-for-mobile" id="most-common-method-for-mobile"></a>

对于大多数设备，打开移动浏览器，登录 Bitwarden，然后按照[网页 App 的导入步骤](#wang-ye-app)操作。

### 使用凭据交换协议 (CXP) 直接导入 <a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

Bitwarden 支持 [FIDO 凭据交换协议 (CXP)](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)。该协议通过省去手动下载和处理数据文件的步骤，提供了一种替代且通常更快的导入方式。当前存储您数据的密码管理器 App 也必须支持 CXP，具体步骤因 App 而异。

#### 使用 iOS 设备 CXP <a href="#cxp-with-ios-devices" id="cxp-with-ios-devices"></a>

要使用 **iOS 26+** 移动设备导入数据：

1、打开保存有数据的其他兼容 CXP 的密码管理器 App。

2、根据 App 的不同，找到导出数据选项，然后选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

{% hint style="info" %}
例如，在 **Apple 密码** App 中：

1. 点击 <i class="fa-ellipsis">:ellipsis:</i>选项图标。
2. 点击**导出数据到其他 App**。
3. 在出现的列表中，勾选您想要转移的密码和通行密钥。完成后，点击**继续**。
   {% endhint %}

3、在**导出密码**界面上，点击**继续**。

4、选择 **Bitwarden** 作为目标位置，然后点击**继续**。

5、点击**在 Bitwarden 中继续**。

6、Bitwarden App 将打开。点击**继续**以确认导入。

7、完成后，将出现一条消息，确认您的数据已成功导入。

#### 使用 **Android** 设备 CXP <a href="#cxp-with-android-devices" id="cxp-with-android-devices"></a>

要使用 **Android 10+** 移动设备导入数据：

1、打开 Bitwarden App。

2、点击**设置**。

3、点击**密码库**。

4、点击**导入项目**。

5、点击**从其他 App 导入**。

6、选择您保存数据的其他兼容 CXP 的密码管理器 App，然后点击**继续**。

7、根据 App 的不同，选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

8、完成后，将出现一条消息，确认您的数据已成功导入。

{% hint style="info" %}
目前，Android 不支持通过 CXP 导入 Dashlane 数据。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
要将数据导入到您的密码库：

1、从导航菜单选择**导入**。

2、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

3、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

4、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

5、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

6、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="CLI" %}
要将数据导入您的密码库，请使用以下 [CLI](/docs/password-manager/developer-tools/cli/password-manager-cli) 命令：

```shell
bw import <format> <path>
```

`bw import` 命令需要格式（使用 `bw import --formats` 获取格式列表）和路径，例如：

```shell
bw import <format> /Users/myaccount/Documents/mydata.csv
```

数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}
{% endtabs %}

如果出现「导入错误」消息，则不会有任何数据添加到您的密码库中。[修复导入文件问题](/docs/password-manager/import-and-export/import-data#troubleshoot-import-errors)然后重试。


# 从 Keeper 导入

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/import-from-keeper/)
{% endhint %}

使用以下两种方法之一，快速将数据从 Keeper Password Manager 传输到 Bitwarden：

* 使用 Bitwarden 浏览器扩展或桌面 App，无需下载文件即可[直接导入数据](#import-directly-from-keeper)。
* 使用任意 Bitwarden App，[从您的 Keeper 账户下载导出文件然后将其导入](#use-an-exported-file-for-import) Bitwarden。

## 直接从 Keeper 导入 <a href="#import-directly-from-keeper" id="import-directly-from-keeper"></a>

要将 Keeper 数据直接导入 Bitwarden，而无需下载导出文件并手动传输数据：

1、在 Bitwarden 桌面 App 或浏览器扩展中，打开**导入**页面：

* 在桌面 App 中，从导航栏选择**导入**。
* 在浏览器扩展中，导航到**设置** → **密码库选项** → **导入**。

2、选择要导入到的**密码库**，以及（可选）选择要添加导入数据的**文件夹**或**集合**。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1vFewL4JR9Ctyph0J6x5VU/6bb9611b833ab83116c44a8c2d6074a6/2026-07-15_09-53-04.png?w=1187&#x26;fm=avif" alt=""><figcaption><p>从 Keeper 直接导入</p></figcaption></figure></div>

3、从**文件格式**下拉菜单中，选择 **Keeper**。

4、从**方式**下拉菜单中，选择**直接导入器**。

5、输入您的 **Keeper 电子邮箱**和**数据中心位置**。

{% hint style="success" %}
您的**数据中心位置**与登录 Keeper 时选择的区域相对应。在网页端登录 Keeper 密码库时，该信息也可在 URL 中找到（例如， `keepersecurity.com` 代表美国， `keepersecurity.eu` 代表欧盟，以此类推）。
{% endhint %}

6、选择**导入**，并在提示时完成 Keeper 所需的身份验证步骤。这需要您的**主密码或 SSO** 以及某种形式的**设备批准**。以下是两种可能出现的界面示例：

{% tabs %}
{% tab title="主密码" %}
作为 Keeper 的个人用户，您通常需要：

1、选择一种**设备批准**方式。对于个人用户，可选择以下方式：

* 发送至您 Keeper 账户关联的电子邮箱的**电子邮件**。
* 从 Keeper 网页 App 批准的 **Keeper Push** 通知。
* 用于 Keeper 账户的**双重身份验证方式**。

{% hint style="info" %}
Bitwarden 目前支持 Keeper 短信、验证器 App 和 Keeper DNA 选项用于双重身份验证。
{% endhint %}

2、输入您的 Keeper **主密码**。
{% endtab %}

{% tab title="SSO" %}
作为使用 Keeper 进行工作的团队中的一员，您通常需要：

1、选择**导入**后，自动启动浏览器窗口以完成 SSO 身份验证。

2、选择一种**设备批准**方式。对于企业用户，可选择以下方式：

1. 从 Keeper 网页 App 批准的 **Keeper Push** 通知。
2. 由团队管理员进行**管理员审批**。
3. 用于 Keeper 账户的**双重身份验证方式**。

{% hint style="info" %}
Bitwarden 目前支持 Keeper 短信、验证器 App 和 Keeper DNA 选项用于双重身份验证。
{% endhint %}
{% endtab %}
{% endtabs %}

## 使用导出的文件导入 <a href="#use-an-exported-file-for-import" id="use-an-exported-file-for-import"></a>

### 从 Keeper 导出 <a href="#export-from-keeper" id="export-from-keeper"></a>

要从 Keeper 网页 App 导出数据：

1、从网页 App 的右上角选择您的账户电子邮箱，然后从下拉菜单中选择**设置**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/37IrIjwTCvp8aeNOYgVINt/b5520f293391b24fa825eaa2e944788b/2025-01-06_09-30-34.png?w=971&#x26;fm=avif" alt=""><figcaption><p>从 Keeper 导出</p></figcaption></figure></div>

2、从设置弹出窗口中，选择**导出**。

3、选择 **CSV** 或 **JSON** 导出文件类型。

4、选择**导出**。

5、输入您的 Keeper 主密码。

6、选择**立即导出**。

### 导入到 Bitwarden <a href="#import-to-bitwarden" id="import-to-bitwarden"></a>

数据可以从网页 App、浏览器扩展、桌面 App 以及 CLI 导入到 Bitwarden。数据在发送到服务器存储之前会在本地进行[加密](/docs/security/encryption/encryption-protocols)。

{% hint style="info" %}
虽然某些项目类型无法导入，但您仍可将其添加到密码库：

* 将[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)逐个上传到新的密码库。
* 在新的密码库中重新创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
  {% endhint %}

{% tabs %}
{% tab title="网页 App" %}
要将数据导入到您的 Bitwarden 密码库：

1、选择**工具**。

2、选择**导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1NbyPb9dN545ZqKGRZYB3x/e6b8f3f31aa82bb05cef12c5a5c4c193/2025-12-17_11-25-08.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入项目</p></figcaption></figure></div>

3、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="info" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**管理集合**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

4、从**文件格式**下拉菜单中，选择您的导出数据的[文件格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

5、要输入您的数据，请执行以下操作之一：

* 选择**选择文件**，然后从您的计算机中选择已导出的文件。
* 将已导出的文件的内容复制并粘贴到文本框中。

{% hint style="danger" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

6、选择**导入**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

7、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="浏览器扩展" %}
要将数据导入到您的密码库：

1、选择**设置**。

2、选择**密码库选项**。

3、选择**导入项目**。将出现一个新窗口。

4、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

5、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

6、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

7、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

8、数据导入后，请从您的设备中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="移动端" %}
在移动设备上导入数据有两种方式。使用 CXP 直接导入通常最为简便，但目前仅支持少数密码管理 App。

### 移动设备最常用的方式 <a href="#most-common-method-for-mobile" id="most-common-method-for-mobile"></a>

对于大多数设备，打开移动浏览器，登录 Bitwarden，然后按照[网页 App 的导入步骤](#wang-ye-app)操作。

### 使用凭据交换协议 (CXP) 直接导入 <a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

Bitwarden 支持 [FIDO 凭据交换协议 (CXP)](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)。该协议通过省去手动下载和处理数据文件的步骤，提供了一种替代且通常更快的导入方式。当前存储您数据的密码管理器 App 也必须支持 CXP，具体步骤因 App 而异。

#### 使用 iOS 设备 CXP <a href="#cxp-with-ios-devices" id="cxp-with-ios-devices"></a>

要使用 **iOS 26+** 移动设备导入数据：

1、打开保存有数据的其他兼容 CXP 的密码管理器 App。

2、根据 App 的不同，找到导出数据选项，然后选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

{% hint style="info" %}
例如，在 **Apple 密码** App 中：

1. 点击 <i class="fa-ellipsis">:ellipsis:</i>选项图标。
2. 点击**导出数据到其他 App**。
3. 在出现的列表中，勾选您想要转移的密码和通行密钥。完成后，点击**继续**。
   {% endhint %}

3、在**导出密码**界面上，点击**继续**。

4、选择 **Bitwarden** 作为目标位置，然后点击**继续**。

5、点击**在 Bitwarden 中继续**。

6、Bitwarden App 将打开。点击**继续**以确认导入。

7、完成后，将出现一条消息，确认您的数据已成功导入。

#### 使用 **Android** 设备 CXP <a href="#cxp-with-android-devices" id="cxp-with-android-devices"></a>

要使用 **Android 10+** 移动设备导入数据：

1、打开 Bitwarden App。

2、点击**设置**。

3、点击**密码库**。

4、点击**导入项目**。

5、点击**从其他 App 导入**。

6、选择您保存数据的其他兼容 CXP 的密码管理器 App，然后点击**继续**。

7、根据 App 的不同，选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

8、完成后，将出现一条消息，确认您的数据已成功导入。

{% hint style="info" %}
目前，Android 不支持通过 CXP 导入 Dashlane 数据。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
要将数据导入到您的密码库：

1、从导航菜单选择**导入**。

2、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

3、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

4、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

5、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

6、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="CLI" %}
要将数据导入您的密码库，请使用以下 [CLI](/docs/password-manager/developer-tools/cli/password-manager-cli) 命令：

```shell
bw import <format> <path>
```

`bw import` 命令需要格式（使用 `bw import --formats` 获取格式列表）和路径，例如：

```shell
bw import <format> /Users/myaccount/Documents/mydata.csv
```

数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}
{% endtabs %}

如果出现「导入错误」消息，则不会有任何数据添加到您的密码库中。[修复导入文件问题](/docs/password-manager/import-and-export/import-data#troubleshoot-import-errors)然后重试。


# 从 Dashlane 导入

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/import-from-dashlane/)
{% endhint %}

使用这篇文章帮助您从 Dashlane 导出数据并导入到 Bitwarden。Dashlane 数据导出主要以 `.csv` 文件的形式提供，可从网页 App 下载，其可以直接导入到 Bitwarden。如果您从旧版 Dashlane 应用程序导出 `.json`，也可以将其导入 Bitwarden。

## 从 Dashlane 网页 App 导出 <a href="#export-from-dashlane-web-app" id="export-from-dashlane-web-app"></a>

要从 Dashlane 网页 App 导出数据：

1、选择**我的账户**下拉菜单，然后选择**设置**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5JMQiiNRcMkyPjzC3lsvBp/ef2a9492c16bbeaa7f9eedecf9a11764/Screen_Shot_2022-03-10_at_2.57.56_PM.png?w=946&#x26;fm=avif" alt=""><figcaption><p>从 Dashlane 导出</p></figcaption></figure></div>

2、从设置列表中，选择**导出数据**：

<div data-with-frame="true"><figure><img src="https://bitwarden.com/assets/wOZOD6rm3nmVJf3xy4DKY/3ed0a6daaf4a518ebe48906c644f7211/Screen_Shot_2022-03-10_at_2.58.08_PM.png?w=953&#x26;fm=avif" alt=""><figcaption><p>从 Dashlane 导出</p></figcaption></figure></div>

3、选择**导出到 CSV** 按钮然后保存此文件。

Dashlane 将数据导出为可解压缩为多个 `.csv` 文件的 `.zip` 文件。对于每个 `.csv`（`credentials.csv`、`ids.csv` 等），请分别遵循导入过程。

## 导入 Bitwarden <a href="#import-to-bitwarden" id="import-to-bitwarden"></a>

数据可以从网页 App、浏览器扩展、桌面 App 以及 CLI 导入到 Bitwarden。数据在发送到服务器存储之前会在本地进行[加密](/docs/security/encryption/encryption-protocols)。

{% hint style="info" %}
虽然某些项目类型无法导入，但您仍可将其添加到密码库：

* 将[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)逐个上传到新的密码库。
* 在新的密码库中重新创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
  {% endhint %}

{% tabs %}
{% tab title="网页 App" %}
要将数据导入到您的 Bitwarden 密码库：

1、选择**工具**。

2、选择**导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1NbyPb9dN545ZqKGRZYB3x/e6b8f3f31aa82bb05cef12c5a5c4c193/2025-12-17_11-25-08.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入项目</p></figcaption></figure></div>

3、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="info" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**管理集合**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

4、从**文件格式**下拉菜单中，选择您的导出数据的[文件格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

5、要输入您的数据，请执行以下操作之一：

* 选择**选择文件**，然后从您的计算机中选择已导出的文件。
* 将已导出的文件的内容复制并粘贴到文本框中。

{% hint style="danger" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

6、选择**导入**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

7、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="浏览器扩展" %}
要将数据导入到您的密码库：

1、选择**设置**。

2、选择**密码库选项**。

3、选择**导入项目**。将出现一个新窗口。

4、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

5、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

6、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

7、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

8、数据导入后，请从您的设备中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="移动端" %}
在移动设备上导入数据有两种方式。使用 CXP 直接导入通常最为简便，但目前仅支持少数密码管理 App。

### 移动设备最常用的方式 <a href="#most-common-method-for-mobile" id="most-common-method-for-mobile"></a>

对于大多数设备，打开移动浏览器，登录 Bitwarden，然后按照[网页 App 的导入步骤](#wang-ye-app)操作。

### 使用凭据交换协议 (CXP) 直接导入 <a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

Bitwarden 支持 [FIDO 凭据交换协议 (CXP)](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)。该协议通过省去手动下载和处理数据文件的步骤，提供了一种替代且通常更快的导入方式。当前存储您数据的密码管理器 App 也必须支持 CXP，具体步骤因 App 而异。

#### 使用 iOS 设备 CXP <a href="#cxp-with-ios-devices" id="cxp-with-ios-devices"></a>

要使用 **iOS 26+** 移动设备导入数据：

1、打开保存有数据的其他兼容 CXP 的密码管理器 App。

2、根据 App 的不同，找到导出数据选项，然后选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

{% hint style="info" %}
例如，在 **Apple 密码** App 中：

1. 点击 <i class="fa-ellipsis">:ellipsis:</i>选项图标。
2. 点击**导出数据到其他 App**。
3. 在出现的列表中，勾选您想要转移的密码和通行密钥。完成后，点击**继续**。
   {% endhint %}

3、在**导出密码**界面上，点击**继续**。

4、选择 **Bitwarden** 作为目标位置，然后点击**继续**。

5、点击**在 Bitwarden 中继续**。

6、Bitwarden App 将打开。点击**继续**以确认导入。

7、完成后，将出现一条消息，确认您的数据已成功导入。

#### 使用 **Android** 设备 CXP <a href="#cxp-with-android-devices" id="cxp-with-android-devices"></a>

要使用 **Android 10+** 移动设备导入数据：

1、打开 Bitwarden App。

2、点击**设置**。

3、点击**密码库**。

4、点击**导入项目**。

5、点击**从其他 App 导入**。

6、选择您保存数据的其他兼容 CXP 的密码管理器 App，然后点击**继续**。

7、根据 App 的不同，选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

8、完成后，将出现一条消息，确认您的数据已成功导入。

{% hint style="info" %}
目前，Android 不支持通过 CXP 导入 Dashlane 数据。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
要将数据导入到您的密码库：

1、从导航菜单选择**导入**。

2、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

3、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

4、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

5、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

6、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="CLI" %}
要将数据导入您的密码库，请使用以下 [CLI](/docs/password-manager/developer-tools/cli/password-manager-cli) 命令：

```shell
bw import <format> <path>
```

`bw import` 命令需要格式（使用 `bw import --formats` 获取格式列表）和路径，例如：

```shell
bw import <format> /Users/myaccount/Documents/mydata.csv
```

数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}
{% endtabs %}

如果出现「导入错误」消息，则不会有任何数据添加到您的密码库中。[修复导入文件问题](/docs/password-manager/import-and-export/import-data#troubleshoot-import-errors)然后重试。


# 从 Chrome、Edge & Chromium 浏览器导入

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/import-from-chrome/)
{% endhint %}

将您在基于 Chromium 的浏览器（例如 Google Chrome、Microsoft Edge 和 Opera）中保存的密码快速传输到您的 Bitwarden密码库。有两种方式：

* [导出浏览器数据](#export-from-your-browser)然后将其导入 Bitwarden
* [从浏览器直接导入](#import-directly-from-browser)（仅适用于桌面 App）

## 从浏览器导出 & 导入文件 <a href="#export-and-import-a-file-from-your-browser" id="export-and-import-a-file-from-your-browser"></a>

### 从浏览器导出 <a href="#export-from-your-browser" id="export-from-your-browser"></a>

从桌面浏览器或移动浏览器导出数据：

{% tabs %}
{% tab title="桌面端浏览器" %}
要从桌面端 Chrome 或 Edge 导出密码：

1. 使用地址栏导航至 `chrome://password-manager/settings` 或 `edge://wallet/passwords`。
2. 定位到**导出密码**，然后点击**下载文件**。可能会提示您输入计算机的密码以进行授权。对于 Microsoft Edge，这可能隐藏在已保存密码部分的 **⋯**&#x83DC;单后面。
3. 指定一个保存导出文件的位置，并验证格式是否为 **comma-separated values (CSV)**。
4. 选择**保存**以完成导出。
   {% endtab %}

{% tab title="移动端浏览器" %}
要从移动设备 Chrome 或 Edge 导出密码：

1. 点击 **⋯**&#x83DC;单按钮然后点击**密码管理器**。
2. 点击**设置**。
3. 点击**导出密码...** 。可能会提示您输入设备 PIN 码或生物识别信息以进行授权。
4. 指定一个位置以保存您的导出文件。
   {% endtab %}
   {% endtabs %}

### 导入 Bitwarden <a href="#import-to-bitwarden" id="import-to-bitwarden"></a>

数据可以从网页 App、浏览器扩展、桌面 App 以及 CLI 导入到 Bitwarden。数据在发送到服务器存储之前会在本地进行[加密](/docs/security/encryption/encryption-protocols)。

{% hint style="info" %}
虽然某些项目类型无法导入，但您仍然可以将它们添加到密码库：

* 将[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)逐个上传到新密码库。
* 在新密码库中重新创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
  {% endhint %}

{% tabs %}
{% tab title="网页 App" %}
要将数据导入到您的 Bitwarden 密码库：

1、选择**工具**。

2、选择**导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1NbyPb9dN545ZqKGRZYB3x/e6b8f3f31aa82bb05cef12c5a5c4c193/2025-12-17_11-25-08.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入项目</p></figcaption></figure></div>

3、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="info" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**管理集合**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

4、从**文件格式**下拉菜单中，选择您的导出数据的[文件格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

5、要输入您的数据，请执行以下操作之一：

* 选择**选择文件**，然后从您的计算机中选择已导出的文件。
* 将已导出的文件的内容复制并粘贴到文本框中。

{% hint style="danger" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

6、选择**导入**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

7、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="浏览器扩展" %}
要将数据导入到您的密码库：

1、选择**设置**。

2、选择**密码库选项**。

3、选择**导入项目**。将出现一个新窗口。

4、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

5、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

6、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

7、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

8、数据导入后，请从您的设备中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="移动端" %}
在移动设备上导入数据有两种方式。使用 CXP 直接导入通常最为简便，但目前仅支持少数密码管理 App。

### 移动设备最常用的方式 <a href="#most-common-method-for-mobile" id="most-common-method-for-mobile"></a>

对于大多数设备，打开移动浏览器，登录 Bitwarden，然后按照[网页 App 的导入步骤](#wang-ye-app)操作。

### 使用凭据交换协 <a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

在移动设备上导入数据有两种方式。使用 CXP 直接导入通常最为简便，但目前仅支持少数密码管理 App。

### 移动设备最常用的方式 <a href="#most-common-method-for-mobile" id="most-common-method-for-mobile"></a>

对于大多数设备，打开移动浏览器，登录 Bitwarden，然后按照[网页 App 的导入步骤](#wang-ye-app)操作。

### 使用凭据交换协议 (CXP) 直接导入 <a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

Bitwarden 支持 [FIDO 凭据交换协议 (CXP)](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)。该协议通过省去手动下载和处理数据文件的步骤，提供了一种替代且通常更快的导入方式。当前存储您数据的密码管理器 App 也必须支持 CXP，具体步骤因 App 而异。

#### 使用 iOS 设备 CXP <a href="#cxp-with-ios-devices" id="cxp-with-ios-devices"></a>

要使用 **iOS 26+** 移动设备导入数据：

1、打开保存有数据的其他兼容 CXP 的密码管理器 App。

2、根据 App 的不同，找到导出数据选项，然后选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

{% hint style="info" %}
例如，在 **Apple 密码** App 中：

1. 点击 <i class="fa-ellipsis">:ellipsis:</i>选项图标。
2. 点击**导出数据到其他 App**。
3. 在出现的列表中，勾选您想要转移的密码和通行密钥。完成后，点击**继续**。
   {% endhint %}

3、在**导出密码**界面上，点击**继续**。

4、选择 **Bitwarden** 作为目标位置，然后点击**继续**。

5、点击**在 Bitwarden 中继续**。

6、Bitwarden App 将打开。点击**继续**以确认导入。

7、完成后，将出现一条消息，确认您的数据已成功导入。

#### 使用 **Android** 设备 CXP <a href="#cxp-with-android-devices" id="cxp-with-android-devices"></a>

要使用 **Android 10+** 移动设备导入数据：

1、打开 Bitwarden App。

2、点击**设置**。

3、点击**密码库**。

4、点击**导入项目**。

5、点击**从其他 App 导入**。

6、选择您保存数据的其他兼容 CXP 的密码管理器 App，然后点击**继续**。

7、根据 App 的不同，选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

8、完成后，将出现一条消息，确认您的数据已成功导入。

{% hint style="info" %}
目前，Android 不支持通过 CXP 导入 Dashlane 数据。
{% endhint %}

### &#x20;<a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

{% endtab %}

{% tab title="桌面端" %}
要将数据导入到您的密码库：

1、从导航菜单选择**导入**。

2、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

3、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

4、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

5、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

6、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="CLI" %}
要将数据导入您的密码库，请使用以下 [CLI](/docs/password-manager/developer-tools/cli/password-manager-cli) 命令：

```shell
bw import <format> <path>
```

`bw import` 命令需要格式（使用 `bw import --formats` 获取格式列表）和路径，例如：

```shell
bw import <format> /Users/myaccount/Documents/mydata.csv
```

数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}
{% endtabs %}

如果出现「导入错误」消息，则不会有任何数据添加到您的密码库中。[修复导入文件问题](/docs/password-manager/import-and-export/import-data#troubleshoot-import-errors)然后重试。

## 从浏览器直接导入 <a href="#import-directly-from-browser" id="import-directly-from-browser"></a>

Bitwarden 桌面 App 可以从这些浏览器导入密码，而无需手动导出文件：

* Chrome
* Edge（仅限 Windows 和 macOS）
* Opera
* Brave
* Vivaldi（仅限 Windows 和 macOS）
* Arc（仅限 macOS）

此选项适用于从此[下载页面](https://bitwarden.com/download/#downloads-desktop)安装的 Windows 和 Mac 桌面 App。直接导入方式不适用于 Linux 系统，也不适用于从 Mac App Store 或 Windows Microsoft Store 安装的桌面 App。

{% hint style="info" %}
已知在 2025.11.0 及更高版本中，**从浏览器直接导入**选项（具体来说是 `bitwarden_chromium_import_helper.exe` 进程）在尝试从浏览器存储中提取凭据时，可能会被某些 EDR 软件或 Windows 用户账户控制 (UAC) 标记。

* **作为管理员**，您可以主动通过 UAC 或 EDR 软件将 `bitwarden_chromium_import_helper.exe` 设置为以管理员身份运行，以防止用户尝试导入时出现失败或警告。
* **作为用户**，如果在此过程中出现允许 App 更改您的设备的提示，请选择**是**以继续导入。

**\[译者注]**：EDR - Endpoint Detection and Response（终端威胁检测与响应）。EDR 是一种企业级安全软件，用来监控电脑（终端）上的可疑行为，并及时阻止或警告潜在的攻击。
{% endhint %}

要从浏览器导入您的数据：

1、登录到 Bitwarden 桌面 App。

2、选择**文件**。

3、选择**导入数据**。

4、从**密码库**下拉菜单中，选择数据的保存目的地：

* **个人密码库**：选择**我的密码库**以及（可选）选择移动项目到的**文件夹**。
* **组织密码库**：选择组织密码库名称然后选择一个**集合**。(需要[**管理集合**](/docs/admin-console/manage-shared-items/collections/about-collections#collections-permissions)权限）。

5、从**文件格式**下拉菜单中选择您的浏览器。如果该浏览器兼容并安装在同一设备上，下方将显示两个选项。

6、选择**从浏览器直接导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1dZKYVPQpd1TVDcmUuwLq2/23e9b222768964108ade8c02e52134ee/Directly_import_with_Chromium.png?w=652&#x26;fm=avif" alt=""><figcaption><p>直接从浏览器导入</p></figcaption></figure></div>

7、选择包含密码的**浏览器配置文件**。

8、选择**导入**。

9、输入计算机密码以确认。

{% hint style="danger" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}


# 从 macOS & Safari 导入

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/import-from-safari/)
{% endhint %}

使用这篇文章帮助您从以下平台导出数据并导入到 Bitwarden。

* Safari
* macOS
* iCloud
* Mac Keychain

{% hint style="success" %}
导出密码要求 **Safari 15.0+** 或 **macOS Monterey (12.0)+**。
{% endhint %}

## 从 Safari 或 macOS 导出 <a href="#export-from-safari-or-macos" id="export-from-safari-or-macos"></a>

您可以直接从 Mac 计算机上的 Safari 或 macOS 密码导出密码：

{% tabs %}
{% tab title="Safari" %}
要从 Safari 导出数据：

1、从 macOS 菜单栏中选择**文件** → **导出浏览器数据到文件**，选择**密码**，然后选择**下载**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3j4W80s3G7wqFtVrbzKMO4/36308c2c647912bf204739f2bc5f80f2/2024-12-30_12-58-55.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>从 Safari 导出</p></figcaption></figure></div>

2、将导出保存到任何位置，然后使用触控 ID 或您的 macOS 密码来完成导出。
{% endtab %}

{% tab title="macOS 密码 App" %}
要从 macOS 密码 App 导出数据：

1、定位并打开 macOS **密码** App。系统会提示您使用触控 ID 或密码以继续。

3、App 解锁后，选择**文件**，然后选择**将所有密码导出到文件...**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6r88eOsL7rY2f6KJj4U79x/3fbfbc41456deaf86a48e85173190405/2025-03-11_09-47-02.png?w=750&#x26;fm=avif" alt=""><figcaption><p>从 macOS 密码 App 导出</p></figcaption></figure></div>

3、系统会弹出一个对话框，以确认您想要导出已保存的密码。选择**导出密码...**&#x4EE5;继续。

4、将导出保存到任何位置，然后使用触控 ID 或您的 macOS 密码来完成导出。
{% endtab %}
{% endtabs %}

## 导入 Bitwarden <a href="#import-to-bitwarden" id="import-to-bitwarden"></a>

数据可以从网页 App、浏览器扩展、桌面 App 以及 CLI 导入到 Bitwarden。数据在发送到服务器存储之前会在本地进行[加密](/docs/security/encryption/encryption-protocols)。

{% hint style="info" %}
虽然某些项目类型无法导入，但您仍可将其添加到密码库：

* 将[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)逐个上传到新的密码库。
* 在新的密码库中重新创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
  {% endhint %}

{% tabs %}
{% tab title="网页 App" %}
要将数据导入到您的 Bitwarden 密码库：

1、选择**工具**。

2、选择**导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1NbyPb9dN545ZqKGRZYB3x/e6b8f3f31aa82bb05cef12c5a5c4c193/2025-12-17_11-25-08.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入项目</p></figcaption></figure></div>

3、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="info" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**管理集合**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

4、从**文件格式**下拉菜单中，选择您的导出数据的[文件格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

5、要输入您的数据，请执行以下操作之一：

* 选择**选择文件**，然后从您的计算机中选择已导出的文件。
* 将已导出的文件的内容复制并粘贴到文本框中。

{% hint style="danger" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

6、选择**导入**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

7、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="浏览器扩展" %}
要将数据导入到您的密码库：

1、选择**设置**。

2、选择**密码库选项**。

3、选择**导入项目**。将出现一个新窗口。

4、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

5、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

6、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

7、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

8、数据导入后，请从您的设备中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="移动端" %}
在移动设备上导入数据有两种方式。使用 CXP 直接导入通常最为简便，但目前仅支持少数密码管理 App。

### 移动设备最常用的方式 <a href="#most-common-method-for-mobile" id="most-common-method-for-mobile"></a>

对于大多数设备，打开移动浏览器，登录 Bitwarden，然后按照[网页 App 的导入步骤](#wang-ye-app)操作。

### 使用凭据交换协议 (CXP) 直接导入 <a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

Bitwarden 支持 [FIDO 凭据交换协议 (CXP)](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)。该协议通过省去手动下载和处理数据文件的步骤，提供了一种替代且通常更快的导入方式。当前存储您数据的密码管理器 App 也必须支持 CXP，具体步骤因 App 而异。

#### 使用 iOS 设备 CXP <a href="#cxp-with-ios-devices" id="cxp-with-ios-devices"></a>

要使用 **iOS 26+** 移动设备导入数据：

1、打开保存有数据的其他兼容 CXP 的密码管理器 App。

2、根据 App 的不同，找到导出数据选项，然后选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

{% hint style="info" %}
例如，在 **Apple 密码** App 中：

1. 点击 <i class="fa-ellipsis">:ellipsis:</i>选项图标。
2. 点击**导出数据到其他 App**。
3. 在出现的列表中，勾选您想要转移的密码和通行密钥。完成后，点击**继续**。
   {% endhint %}

3、在**导出密码**界面上，点击**继续**。

4、选择 **Bitwarden** 作为目标位置，然后点击**继续**。

5、点击**在 Bitwarden 中继续**。

6、Bitwarden App 将打开。点击**继续**以确认导入。

7、完成后，将出现一条消息，确认您的数据已成功导入。

#### 使用 **Android** 设备 CXP <a href="#cxp-with-android-devices" id="cxp-with-android-devices"></a>

要使用 **Android 10+** 移动设备导入数据：

1、打开 Bitwarden App。

2、点击**设置**。

3、点击**密码库**。

4、点击**导入项目**。

5、点击**从其他 App 导入**。

6、选择您保存数据的其他兼容 CXP 的密码管理器 App，然后点击**继续**。

7、根据 App 的不同，选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

8、完成后，将出现一条消息，确认您的数据已成功导入。

{% hint style="info" %}
目前，Android 不支持通过 CXP 导入 Dashlane 数据。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
要将数据导入到您的密码库：

1、从导航菜单选择**导入**。

2、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

3、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

4、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

5、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

6、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="CLI" %}
要将数据导入您的密码库，请使用以下 [CLI](/docs/password-manager/developer-tools/cli/password-manager-cli) 命令：

```shell
bw import <format> <path>
```

`bw import` 命令需要格式（使用 `bw import --formats` 获取格式列表）和路径，例如：

```shell
bw import <format> /Users/myaccount/Documents/mydata.csv
```

数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}
{% endtabs %}

## 导入错误故障排除 <a href="#troubleshoot-import-errors" id="troubleshoot-import-errors"></a>

如果出现「导入错误」消息，则不会有任何数据添加到您的密码库中。[修复导入文件问题](/docs/password-manager/import-and-export/import-data#troubleshoot-import-errors)然后重试。

### iCloud/Mac 钥匙串/Safari 导入问题 <a href="#icloud-mac-keychain-safari-import-issues" id="icloud-mac-keychain-safari-import-issues"></a>

* 从 Safari 15.0 开始，您可以将密码从 Safari 导出到 `.csv` 文件中。导出后，[调整您的 .csv](/docs/password-manager/import-and-export/condition-bitwarden-import) 以符合 Bitwarden 的格式，然后导入您的数据。


# 从 Firefox 导入

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/import-from-firefox/)
{% endhint %}

使用这篇文章帮助您从 Firefox 导出数据并导入到 Bitwarden。

## 从 Firefox 导出 <a href="#export-from-firefox" id="export-from-firefox"></a>

从 Firefox 导出可能会有所不同，具体取决于您所使用的版本，或者如果您使用的是基于 Firefox 的浏览器（例如 Tor 浏览器或 Waterfox）：

{% tabs %}
{% tab title="最新版本" %}
要从最新版 Firefox 导出您的登录信息：

1、使用地址栏导航到 `about:logins`。

2、选择右上方的 **⋯**&#x83DC;单按钮，并从下拉列表中选择**导出登录信息...**。

将提示您指定一个位置来保存导出的登录信息。

Firefox 会将登录信息导出为 `.csv` 文件。
{% endtab %}

{% tab title="旧版本" %}
某些旧版本的 Firefox 不支持本地导出。完成以下步骤以使用 FF Password Exporter 导出：

1、[下载](https://github.com/kspearrin/ff-password-exporter)，安装然后打开 FF Password Exporter。

2、从检测到的 Firefox 用户配置中或从指定的自定义配置目录中，选择一个用户配置。如果您为用户配置设置了主密码，请输入该密码。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7roVmndD8pbSSBawXTrl1r/ecbf9ac6492e7c77109c76216490780a/ff-password-exporter.png?w=668&#x26;fm=avif" alt=""><figcaption><p>Firefox 导出器</p></figcaption></figure></div>

3、选择**导出密码**按钮。

4、选择 `.csv` 文件格式，并将文件保存到设备中。
{% endtab %}

{% tab title="基于 Firefox" %}
某些基于 Firefox 的浏览器提供了不同于 vanilla Firefox 的登录导出位置。如果从**最新版本**导出不成功，请尝试以下方法：

1、使用地址栏导航到 `about:preferences#privacy`。

2、点击**保存登录信息**按钮。

3、选择右上方的 **⋯**&#x83DC;单按钮，并从下拉列表中选择**导出登录信息**。

将提示您指定一个位置来保存导出的登录信息。

大多数基于 Firefox 的浏览器会将登录信息导出为 `.csv` 文件。
{% endtab %}
{% endtabs %}

## 导入 Bitwarden <a href="#import-to-bitwarden" id="import-to-bitwarden"></a>

数据可以从网页 App、浏览器扩展、桌面 App 以及 CLI 导入到 Bitwarden。数据在发送到服务器存储之前会在本地进行[加密](/docs/security/encryption/encryption-protocols)。

{% hint style="info" %}
虽然某些项目类型无法导入，但您仍可将其添加到密码库：

* 将[文件附件](/docs/password-manager/your-vault/vault-items/file-attachments)逐个上传到新的密码库。
* 在新的密码库中重新创建 [Send](/docs/password-manager/bitwarden-send/about-send)。
  {% endhint %}

{% tabs %}
{% tab title="网页 App" %}
要将数据导入到您的 Bitwarden 密码库：

1、选择**工具**。

2、选择**导入**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/1NbyPb9dN545ZqKGRZYB3x/e6b8f3f31aa82bb05cef12c5a5c4c193/2025-12-17_11-25-08.png?w=1156&#x26;fm=avif" alt=""><figcaption><p>导入项目</p></figcaption></figure></div>

3、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="info" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**管理集合**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

4、从**文件格式**下拉菜单中，选择您的导出数据的[文件格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

5、要输入您的数据，请执行以下操作之一：

* 选择**选择文件**，然后从您的计算机中选择已导出的文件。
* 将已导出的文件的内容复制并粘贴到文本框中。

{% hint style="danger" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

6、选择**导入**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

7、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="浏览器扩展" %}
要将数据导入到您的密码库：

1、选择**设置**。

2、选择**密码库选项**。

3、选择**导入项目**。将出现一个新窗口。

4、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

5、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

6、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

7、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

8、数据导入后，请从您的设备中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="移动端" %}
在移动设备上导入数据有两种方式。使用 CXP 直接导入通常最为简便，但目前仅支持少数密码管理 App。

### 移动设备最常用的方式 <a href="#most-common-method-for-mobile" id="most-common-method-for-mobile"></a>

对于大多数设备，打开移动浏览器，登录 Bitwarden，然后按照[网页 App 的导入步骤](#wang-ye-app)操作。

### 使用凭据交换协议 (CXP) 直接导入 <a href="#direct-import-with-the-cxp" id="direct-import-with-the-cxp"></a>

Bitwarden 支持 [FIDO 凭据交换协议 (CXP)](https://fidoalliance.org/specifications-credential-exchange-specifications/?lang=zh-hans)。该协议通过省去手动下载和处理数据文件的步骤，提供了一种替代且通常更快的导入方式。当前存储您数据的密码管理器 App 也必须支持 CXP，具体步骤因 App 而异。

#### 使用 iOS 设备 CXP <a href="#cxp-with-ios-devices" id="cxp-with-ios-devices"></a>

要使用 **iOS 26+** 移动设备导入数据：

1、打开保存有数据的其他兼容 CXP 的密码管理器 App。

2、根据 App 的不同，找到导出数据选项，然后选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

{% hint style="info" %}
例如，在 **Apple 密码** App 中：

1. 点击 <i class="fa-ellipsis">:ellipsis:</i>选项图标。
2. 点击**导出数据到其他 App**。
3. 在出现的列表中，勾选您想要转移的密码和通行密钥。完成后，点击**继续**。
   {% endhint %}

3、在**导出密码**界面上，点击**继续**。

4、选择 **Bitwarden** 作为目标位置，然后点击**继续**。

5、点击**在 Bitwarden 中继续**。

6、Bitwarden App 将打开。点击**继续**以确认导入。

7、完成后，将出现一条消息，确认您的数据已成功导入。

#### 使用 **Android** 设备 CXP <a href="#cxp-with-android-devices" id="cxp-with-android-devices"></a>

要使用 **Android 10+** 移动设备导入数据：

1、打开 Bitwarden App。

2、点击**设置**。

3、点击**密码库**。

4、点击**导入项目**。

5、点击**从其他 App 导入**。

6、选择您保存数据的其他兼容 CXP 的密码管理器 App，然后点击**继续**。

7、根据 App 的不同，选择要导入的项目。您可能需要完成额外步骤，例如登录或确认您要移动数据。

8、完成后，将出现一条消息，确认您的数据已成功导入。

{% hint style="info" %}
目前，Android 不支持通过 CXP 导入 Dashlane 数据。
{% endhint %}
{% endtab %}

{% tab title="桌面端" %}
要将数据导入到您的密码库：

1、从导航菜单选择**导入**。

2、从**密码库**下拉菜单中，选择数据的保存目的地：

* 要将数据保存到您的个人密码库中，请选择**我的密码库**。（可选）选择一个现有[**文件夹**](/docs/password-manager/your-vault/vault-navigation/folders)来组织导入的项目。

{% hint style="success" icon="lightbulb" %}
如果您的数据文件包含您之前密码管理器中的文件夹，并且您从下拉菜单中选择了一个目标文件夹，则导入的文件夹将被嵌套在您选择的文件夹内。
{% endhint %}

* 要将数据保存到某个组织密码库中，请选择组织的名称。（可选）选择一个[集合](/docs/admin-console/manage-shared-items/collections/create-collections)来组织导入的项目并与其他成员共享。（您只能选择您具有[**可以管理**](/docs/admin-console/manage-shared-items/collections/collection-permissions#permissions)权限的集合。）

3、从**文件格式**下拉菜单中，选择[导入文件的格式](/docs/password-manager/import-and-export/import-and-export-faqs#q-what-file-formats-does-bitwarden-support-for-import)。

4、选择**选择文件**然后选取一个文件，或将文件内容复制并粘贴到文本框中。

{% hint style="warning" %}
导入过程不会检查重复。如果您多次导入同一文件或导入的项目已经存在于密码库中，则会创建重复的项目。
{% endhint %}

5、选择**导入数据**。如果您正在导入受密码保护的 `.json` 文件，请在出现的**确认密码库导入**窗口中输入密码。

6、数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}

{% tab title="CLI" %}
要将数据导入您的密码库，请使用以下 [CLI](/docs/password-manager/developer-tools/cli/password-manager-cli) 命令：

```shell
bw import <format> <path>
```

`bw import` 命令需要格式（使用 `bw import --formats` 获取格式列表）和路径，例如：

```shell
bw import <format> /Users/myaccount/Documents/mydata.csv
```

数据导入后，请从您的计算机中删除已导出的数据文件。这将在您的计算机受到威胁时为您提供保护。如果您是从其他密码管理器或浏览器导入到 Bitwarden，您可能还需要从该工具中删除数据。
{% endtab %}
{% endtabs %}

如果出现「导入错误」消息，则不会有任何数据添加到您的密码库中。[修复导入文件问题](/docs/password-manager/import-and-export/import-data#troubleshoot-import-errors)然后重试。




---

[Next Page](/llms-full.txt/1)