Bitwarden 帮助中心中文版
⮐ Bitwarden Help Center个人主页联系我
  • 关于
  • 首页
  • 发布记录
  • 账户
    • 创建 Bitwarden 账户
    • 登录 & 解锁
      • 主密码
      • 忘记主密码
      • 新设备登录保护
      • 使用 SSO 登录
      • 使用设备登录
      • 使用通行密钥登录 (Beta)
      • 账户切换
      • 使用 PIN 码解锁
      • 使用生物识别解锁
      • 密码库超时选项
    • 两步登录
      • 两步登录现场指南
      • 两步登录方式
      • 设置指南
        • 两步登录 - 验证器
        • 两步登录 - 电子邮箱
        • 两步登录 - Duo
        • 两步登录 - YubiKey
        • 两步登录 - 通行密钥
      • 恢复代码
      • 丢失了辅助设备
      • 两步登录 FAQ
    • 更多
      • 紧急访问
      • 本地化
      • *异常流量错误
  • Password Manager
    • Password Manager 概述
    • 入门
      • Password Manager 网页 App
      • Password Manager 浏览器扩展
      • Password Manager 移动 App
      • Password Manager 桌面 App
    • 密码库基础
      • 密码库项目
      • 用户名 & 密码生成器
      • 自定义字段
      • 集成的验证器
      • 文件附件
      • 共享
      • 集合
      • 存储通行密钥
      • *通行密钥 FAQ
    • 密码库管理
      • 文件夹
      • 收藏
      • 同步密码库
      • 检索密码库
      • 密码库健康报告
    • 导入 & 导出
      • 导入数据到密码库
      • 导入指南
        • 从 LastPass 导入
        • 从 1Password 导入
        • 从 Keeper 导入
        • 从 Dashlane 导入
        • 从 Google Chrome 导入
        • 从 macOS & Safari 导入
        • 从 Firefox 导入
        • 从 Password Safe 导入
        • 从 Myki 导入
      • 导出密码库数据
      • 加密导出
      • 调整 Bitwarden .csv 或 .json
      • *Bitwarden 导入器工具
      • 导入 & 导出 FAQ
    • 自动填充
      • 自动填充基础
        • 在浏览器扩展中自动填充登录
        • 在 Android 上自动填充登录
        • 在 iOS 上自动填充登录
        • 自动填充支付卡和身份
        • 自动填充自定义字段
      • 使用 URI
      • 屏蔽自动填充
      • 基本验证提示
      • 键盘快捷键
      • 禁用浏览器的内置密码管理器
      • Android 自动填充故障排除
      • 自动填充 FAQ
    • Bitwarden Send
      • 关于 Send
      • 创建 Send
      • 接收 Send
      • Send 生命周期
      • Send 隐私
      • CLI 上的 Send
      • Send 加密
      • Send FAQ
    • 开发者工具
      • Password Manager API
      • Password Manager CLI
      • CLI 身份验证挑战
      • 用于 CLI 验证的个人 API 密钥
      • SSH 代理
    • 更多
      • Password Manager FAQ
      • 更改 App 主题
      • DuckDuckGo macOS 浏览器集成
      • Apple Watch 上的 Bitwarden
      • 在 Firefox 隐私窗口中使用 Bitwarden
      • 离线使用 Bitwarden
      • 排除域名
      • Safari 网页扩展
      • uMatrix 和 NoScript 访问规则
      • 与 Bitwarden 支持排除移动端故障
  • Bitwarden Authenticator
    • Bitwarden Authenticator
    • 导入 & 导出
    • FAQ
  • Secrets Manager
    • Secrets Manager 概述
    • 入门
      • Secrets Manager 快速入门
      • 开发人员快速入门
      • 登录 Secrets Manager
      • 管理您的组织
    • 您的机密
      • 工程
      • 机密
      • 机器账户
      • 访问令牌
      • 机密解密
    • 导入 & 导出
      • 导入数据
      • 导出数据
    • 开发人员工具
      • Secrets Manager CLI
      • Secrets Manager SDK
    • 集成
      • Ansible
      • GitHub Actions
      • GitLab CI/CD
      • Secrets Manager Kubernetes Operator
    • 更多
      • Secrets Manager FAQ
  • 管理控制台
    • 组织快速入门
    • 组织基础
      • 组织
      • 集合
      • 群组
      • 企业策略
      • 集合管理
    • 用户管理
      • 用户管理
      • 成员角色和权限
      • 声明域名
      • 声明账户
      • 账户恢复
      • SCIM
        • 关于 SCIM
        • JumpCloud SCIM 集成
        • Microsoft Entra ID SCIM 集成
        • Okta SCIM 集成
        • OneLogin SCIM 集成
        • Ping Identity SCIM 集成
      • 目录连接器
        • 关于目录连接器
        • 目录连接器桌面 App
        • 目录连接器 CLI
        • 目录连接器文件存储
        • 同步选项和筛选器
        • 清除同步缓存
        • 调度同步
        • 使用 AD 或 LDAP 同步
        • 使用 Microsoft Entra ID 同步
        • 使用 Google Workspace 同步
        • 使用 Okta 同步
        • 使用 OneLogin 同步
      • 入职和继任概述
    • 导入 & 导出
      • 导入数据到组织
      • 导出密码库数据
      • 调整 Bitwarden .csv 或 .json
    • SSO 登录
      • 关于 SSO 登录
      • SAML 2.0 配置
      • OIDC 配置
      • 成员解密选项
      • 声明域名
      • 实施指南
        • ADFS SAML 实施
        • Auth0 SAML 实施
        • AWS SAML 实施
        • Duo SAML 实施
        • Google SAML 实施
        • JumpCloud SAML 实施
        • Keycloak SAML 实施
        • Microsoft Entra ID SAML 实施
        • Okta SAML 实施
        • OneLogin SAML 实施
        • Ping Identity SAML 实施
        • ADFS OIDC 实施
        • Microsoft Entra ID OIDC 实施
        • Okta OIDC 实施
        • Ping Identity OIDC 实施
        • Cloudflare Zero Trust SSO 实施
      • 受信任设备
        • 关于受信任设备
        • 设置受信任设备 SSO
        • 添加受信任设备
        • 批准受信任设备
      • Key Connector
        • 关于 Key Connector
        • 部署 Key Connector
      • *在您的 IdP 上配置 Bitwarden(SAML 2.0)
      • SSO 登录 FAQ
    • 报告
      • 密码库健康报告
      • 事件日志
      • Elastic SIEM
      • Microsoft Sentinel SIEM
      • Panther SIEM
      • Rapid7 SIEM
      • Splunk SIEM
    • 最终用户入职
      • 关于本章节
      • 欢迎电子邮件模板
      • 管理团队入职电子邮件
      • 最终用户采用电子邮件
      • 客户激活套件
      • 入职流程
    • 部署客户端 App
      • 部署浏览器扩展
        • 使用 GPO、Linux 策略和 .plist 文件部署浏览器扩展
        • 使用 Intune 部署浏览器扩展
      • 部署桌面端 App
        • 使用 Intune 部署桌面端 App
      • 部署移动端 App
        • 使用 Intune 部署移动端 App
      • 为您的服务器配置客户端
      • 使用设备管理停用浏览器密码管理器
    • Bitwarden 公共 API
    • 更多
      • 组织 FAQ
      • 链接到项目
      • 企业版 Bitwarden 功能数据表
      • 团队版和企业版迁移指南
      • LastPass 企业版迁移指南
      • 组织所有者离职时的访问权限管理
      • PoC 项目清单
      • 为生产准备试用组织
      • *团队版 Bitwarden 对比指南
  • 提供商门户
    • 提供商门户概览
    • 提供商门户快速入门
    • 提供商用户
    • 添加客户组织
    • *添加现有组织
    • 持续管理
    • 取消链接客户组织
    • 提供商事件日志
    • 提供商计费
    • 提供商 FAQ
    • 业务单元门户
      • 业务单元门户
      • 业务单元门户快速入门
  • 自托管
    • 安装 & 部署指南
      • Docker
        • Linux 标准部署
        • Linux 手动部署
        • Linux 离线部署
        • Windows 标准部署
        • Windows 离线部署
        • Unified 部署 (Beta)
      • Helm
        • 使用 Helm 自托管
        • Azure AKS 部署
        • OpenShift 部署
        • AWS EKS 部署
        • 添加 rawManifest 文件
    • 自托管组织
    • 迁移步骤
    • 证书选项
    • 配置环境变量
    • 数据库选项
    • 连接到外部 MSSQL 数据库
    • Kerberos 集成
    • 更新实例
    • 备份托管数据
    • 付费功能许可证
    • 系统管理员门户
    • 为服务器配置客户端
    • 连接客户端到实例
    • 自托管 SCIM
    • 自托管家庭赞助
    • 自托管 Send
    • 配置推送中继
    • *作为 MSP 部署 Bitwarden
    • 托管 FAQ
  • 安全
    • Bitwarden 安全白皮书
    • 密码库数据
    • 管理数据
    • 加密方式
    • KDF 算法
    • 账户加密密钥
    • 账户指纹短语
    • 数据存储
    • 合规、审计和认证
    • 服务器地理位置
    • 版本控制
    • 使用网站图标时的隐私
    • Bitwarden 软件发布支持
    • Bitwarden 的分包商
    • 来自 Bitwarden 的电子邮件
    • Bitwarden 地址
    • 安全 FAQ
  • 计划和定价
    • Password Manager
      • Password Manager 计划
      • 从个人升级到组织
      • 兑换家庭赞助
      • 高级会员续费
    • Secrets Manager
      • Secrets Manager 计划
      • 注册 Secrets Manager
    • Bitwarden 经销商
    • 开始企业版试用
    • 组织续费
    • 更新计费信息
    • 税费计算
    • 删除账户或组织
    • 取消订阅
    • 计费 FAQ
    • *更新 Bitwarden 计划 (2019-2020)
    • *更新 Password Manager 计划 & 订阅
    • *哪种计划适合我?
  • 学习中心
    • 关于学习中心
    • 使用 Bitwarden 的第一步
    • 了解 Password Manager
    • Password Manager
      • Bitwarden 入门:个人用户
      • Bitwarden 入门:管理员
      • Bitwarden 入门:成员
      • Bitwarden 入门:经销商或 MSP
    • Bitwarden 高级用户
    • 面向企业管理员的 Bitwarden
    • 了解 Secrets Manager
    • 面向 MSP 的 Bitwarden
    • 了解 Passwordless.dev
  • *杂项
    • 11 月弃用通知
    • Bitwarden 术语表
    • 迁移脚本
    • Bitwarden 101 视频系列-入门
    • Secrets Manager Beta 版注册
    • 未分配的密码库项目已移至管理控制台
    • 原生移动 App
  • 附录
    • 翻译约定
    • 资源
由 GitBook 提供支持
在本页
  • SSH 密钥存储
  • 创建新的 SSH 密钥
  • 组织 SSH 密钥
  • 编辑现有密钥
  • 将密钥导入 Bitwarden
  • 配置 Bitwarden SSH 代理
  • 启用 SSH 代理
  • 测试 SSH 密钥
  • 使用 SSH 密钥验证 Git
  • 使用 Git 仓库进行身份验证
  • 为 SSH 签名配置 Git
  • 签署 Git 提交
  1. Password Manager
  2. 开发者工具

SSH 代理

上一页用于 CLI 验证的个人 API 密钥下一页更多

最后更新于1个月前

对应的

Bitwarden SSH 代理可以安全地加密和存储您的 SSH(安全 Shell)密钥,以用于以下目的:

  • 验证服务器身份

  • 签署 Git 提交

  • 与基于 SSH 的服务进行交互

Bitwarden SSH 代理将您的密钥组织并保护在一个安全的位置。SSH 密钥可以通过桌面 App、网页 App、浏览器扩展和移动 App 访问。SSH 密钥可以通过桌面 App、网页 App 和浏览器扩展生成。

SSH 代理需要 2025.1.2 或更新版本。

macOS:

macOS 商店构建版本目前暂不支持 SSH 代理,可用于获得 SSH 代理支持。

Linux:

Flatpak 版本目前暂不支持 SSH 代理,可用于获得 SSH 代理支持。

SSH 密钥存储

您可以在 Bitwarden 桌面 App 中创建并保存新的 SSH 密钥。Bitwarden 存储的 SSH 密钥将包含以下内容:

字段
描述

密钥名称

您的 SSH 密钥的名称

私钥

私钥是敏感数据,服务器将使用它来帮助建立安全连接。私钥数据应谨慎处理并保持安全。用户可以使用 Bitwarden 生成一个安全且唯一的私钥

公钥

与您要连接的服务器共享的密钥的一部分

指纹

从公钥生成的短唯一字符串,用于识别。例如,可以使用指纹验证 SSH 签名的 Git 提交

创建新的 SSH 密钥

您可以通过 Bitwarden 桌面 App、网页 App 或浏览器扩展创建新的 SSH 密钥。创建后,存储在 Bitwarden 中的 SSH 密钥可以通过桌面 App、网页 App、浏览器扩展和移动 App 访问。

1、选择新建按钮然后选择 SSH 密钥作为项目类型。

目前,Bitwarden 只能生成 ED25519 类型的 SSH 密钥。

2、填写诸如名称等其余详细信息,完成后选择 💾保存图标。

组织 SSH 密钥

组织拥有的 SSH 密钥不能在 SSH 代理中使用。个人组织用户可以创建 SSH 密钥并将其存储在个人密码库中用于身份验证。不建议共享 SSH 凭据。

编辑现有密钥

SSH 密钥保存到 Bitwarden 密钥库中后,您可以对它们进行编辑:

要在 Bitwarden 桌面 App 上编辑 SSH 密钥:

1、打开 Bitwarden 桌面 App 然后导航至 SSH 密钥。

2、找到要编辑的 SSH 密钥,然后选择 ✏️编辑。

3、完成所需更改后,选择 💾保存。

要在 Bitwarden 网页 App 上编辑 SSH 密钥:

1、打开 Bitwarden 网页 App 然后导航至 SSH 密钥。

2、定位并选择要编辑的 SSH 密钥。屏幕上将出现一个对话框,然后选择编辑。

3、完成所需更改后,选择保存。

要在 Bitwarden 移动 App 上编辑 SSH 密钥:

1、打开 Bitwarden 移动 App 然后导航至 SSH 密钥。

2、定位要编辑的 SSH 密钥,然后选择编辑。

3、完成所需更改后,选择保存。

要在 Bitwarden 浏览器扩展上编辑 SSH 密钥:

1、打开 Bitwarden 浏览器扩展然后导航至 SSH 密钥。

2、定位并选择要编辑的 SSH 密钥。屏幕上将出现一个对话框,然后选择编辑。

3、完成所需更改后,选择保存。

将密钥导入 Bitwarden

现有的 SSH 密钥可通过桌面客户端导入 Bitwarden。

1、从导航菜单中选择 🔑SSH 密钥。

2、复制要导入到 Bitwarden 的现有 SSH 密钥。使用从剪贴板导入密钥选项。这将自动将 SSH 密钥粘贴到 Bitwarden 中。

导入的密钥必须是 OpenSSH 或 PKCS#8 格式。

此外,目前还不兼容从 Putty 导入的 SSH 密钥。

配置 Bitwarden SSH 代理

要将 Bitwarden 用作您的主要 SSH 代理,您需要配置 SSH 客户端,以与 Bitwarden 进行身份验证。

要在 Windows 上启用 Bitwarden SSH 代理,必须禁用 Windows 机器上的 OpenSSH 服务。要禁用 OpenSSH:

1、在 Windows 机器上,导航至服务 → OpenSSH Authentication Agent。可使用 Windows 搜索栏查找服务。

2、打开 OpenSSH Authentication Agent 属性窗口后,将启动类型设置设为禁用。

3、调整设置后,选择应用,然后选择确定。

macOS 商店

要在 macOS 商店下载上启用 Bitwarden SSH 代理:

1、配置 SSH_AUTH_SOCK 变量,使其指向 Bitwarden SSH 代理套接字。下面的示例演示了如何执行此操作(将 <user> 替换为您的用户名):

export SSH_AUTH_SOCK=/Users/<user>/Library/Containers/com.bitwarden.desktop/Data/.bitwarden-ssh-agent.sock

.dmg 下载

要在 macOS .dmg 下载上启用 Bitwarden SSH 代理:

1、配置 SSH_AUTH_SOCK 变量,使其指向 Bitwarden SSH 代理套接字。下面的示例演示了如何执行此操作(将 <user> 替换为您的用户名):

export SSH_AUTH_SOCK=/Users/<user>/.bitwarden-ssh-agent.sock

2、或者,配置 SSH_AUTH_SOCKET:

launchctl setenv "SSH_AUTH_SOCKET" "/Users/<user>/.bitwarden-ssh-agent.sock"

要在 Linux 上启用 Bitwarden SSH 代理:

1、配置 SSH_AUTH_SOCK 变量,使其指向 Bitwarden SSH 代理套接字。下面的示例演示了如何执行此操作(将 <user> 替换为您的用户名):

export SSH_AUTH_SOCK=/home/<user>/.bitwarden-ssh-agent.sock

Shell 配置

1、访问您的 .bashrc 或 .zshrc 文件:

nano ~/.bashrc
nano ~/.zshrc

2、在 .bashrc 或 .zshrc 文件中设置环境变量:

export SSH_AUTH_SOCK=/home/<user>/.bitwarden-ssh-agent.sock

Snap 和 Flatpak

要在 Snap 和 Flatpak 安装上启用 Bitwarden SSH 代理:

1、配置 SSH_AUTH_SOCK 变量,使其指向 Bitwarden SSH 代理套接字。下面的示例演示了如何执行此操作(将 <user> 替换为您的用户名):

# Snap
export SSH_AUTH_SOCK=/home/<user>/snap/bitwarden/current/.bitwarden-ssh-agent.sock

# Flatpak
export SSH_AUTH_SOCK=/home/<user>/.var/app/com.bitwarden.desktop/data/.bitwarden-ssh-agent.sock`

启用 SSH 代理

要在 Bitwarden 桌面 App 上启用 SSH 代理,请导航至设置然后启用 SSH 代理。

测试 SSH 密钥

为 Bitwarden 配置好 SSH 代理后,我们就可以通过请求 SSH 列表来测试设置:

ssh-add -L

这将返回保存在 Bitwarden 桌面客户端中的 SSH 密钥列表。

访问 SSH 密钥时,Bitwarden 的行为会根据客户端的锁定或解锁状态而有所不同:

  • 已锁定的密码库:如果您的 Bitwarden 密码库处于锁定状态,Bitwarden 会自动提示您解锁密码库以获取 SSH 密钥。

  • 已解锁的密码库:如果桌面密码库已解锁,系统将提示您确认 SSH 密钥的使用。

使用 SSH 密钥验证 Git

SSH 可用于 Git 身份验证。Bitwarden SSH 代理能为你的 Git 工作流增添安全性和易用性。在本示例中,Bitwarden SSH 代理将用于验证 GitHub。

1、在 GitHub 账户上,通过导航至设置 → SSH 和 GPG 密钥,然后选择新建 SSH 密钥,来设置 SSH 密钥。

2、在添加新 SSH 密钥界面,添加名称,选择密钥类型,选择验证密钥。将 Bitwarden 密码库中的公钥复制并粘贴到 GitHub 上的密钥字段。

3、完成所有字段后,选择添加 SSH 密钥以保存密钥。在保存密钥之前,GitHub 会要求您验证 GitHub 账户。

4、在终端测试 GitHub SSH 密钥,假如您使用的是 macOS:

ssh git@github.com

5、如果成功,Bitwarden 会提示您验证访问请求。选择授权以确认。如果成功,您将收到一条验证身份验证尝试的消息:

Hi <USER>! You've successfully authenticated, but GitHub does not provide shell access.

使用 Git 仓库进行身份验证

使用 Bitwarden SSH 代理签署 SSH Git 提交。在使用 Bitwarden SSH 代理签署 Git 提交之前,系统需要满足以下条件:

  • Git 2.34 或更新版本。使用以下命令检查 Git 版本:

git --version
  • OpenSSH 8.8 或更新版本。用以下命令检查版本:

ssh -V
  • 成功启用了 SSH 代理的 Bitwarden 桌面客户端。

为 SSH 签名配置 Git

配置 Git 环境以将签名指向 SSH 密钥。为此,您可以设置全局变量或在您的 .gitconfig 文件中建立相关说明。

设置全局变量

要使用 --global 变量配置 Git 设置:

1、设置 Git 使用 SSH 签名:

git config --global gpg.format ssh

2、为用于签名的密钥指定 SSH 密钥。要使用 Bitwarden SSH 代理,请将 <YOUR_PUBLIC_KEY> 替换为从 Bitwarden 密码库中保存的 SSH 密钥中复制的公钥。

git config --global user.signingkey "<YOUR_PUBLIC_KEY>"

设置 .gitconfig 文件

要使用 .gitconfig 文件配置 Git:

1、使用您喜欢的文本编辑器访问 .gitconfig:

nano ~/.gitconfig

2、添加以下配置:

[gpg]
        format = ssh
[user]
        signingkey = "<YOUR_PUBLIC_KEY>"
        name = <USER_NAME>
        email = <USER_EMAIL>
[commit]
        gpgsign = true

对于 Windows 用户:

1、将 core.sshCommand 变量添加到 Git 配置中,以使用 Microsoft OpenSSH:

git config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"

或者,在 .gitconfig 文件中设置变量:

[core]
  sshCommand = C:/Windows/System32/OpenSSH/ssh.exe

2、接下来,可能需要设置 gpg.ssh.program 参数:

git config gpg.ssh.program "C:/Windows/System32/OpenSSH/ssh-keygen.exe"

签署 Git 提交

使用 SSH 对 Git 进行身份验证,能为您的工作流增添安全性和易用性。同样,存储在 Bitwarden 中的 SSH 密钥也可用于使用 SSH 协议签署和验证 Git 提交。在本示例中,我们将使用 Bitwarden SSH 代理签署 Git 提交到 GitHub。

1、在 GitHub 账户上,通过导航至设置 → SSH 和 GPG 密钥,然后选择新建 SSH 密钥,来设置 SSH 签名密钥。

2、在添加新 SSH 密钥界面,添加名称并选择密钥类型,选择 Signing Key。将 Bitwarden 密钥库中的公钥复制并粘贴到 GitHub 上的密钥字段中。

3、使用 SSH 密钥以 SSH 方式克隆您的仓库:

git clone git@github.com:<USER>/<repository>.git

4、使用终端或您喜欢的文本编辑器创建 Git 提交:

git commit -m "This commit is signed using SSH"

5、Bitwarden 将提示您对此密钥的使用进行授权:

6、授权后,将初始化 SSH 密钥以批准提交。现在您可以推送提交:

git push

7、通过导航到 GitHub commits 以验证您在 Github 上的提交:

存储在 Bitwarden 密码管理器中的 SSH 密钥可以访问 Bitwarden 功能,例如、、、笔记、、和等。

在桌面客户端上启用 SSH 存储
官方文档地址
.dmg 下载
Snap 下载
文件夹
收藏
附件
自定义字段
在桌面客户端创建新的 SSH 密钥
桌面端编辑 SSH 项目
网页 App 编辑 SSH 项目
iOS 上选择编辑 SSH 密钥
浏览器扩展上编辑 SSH
在桌面客户端上导入 SSH 密钥
Windows 服务面板
禁用 OpenSSH 窗口
创建新的 GitHub 密钥
SSH 克隆
使用客户端授权 SSH
主密码重新提示
克隆项目