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 提供支持
在本页
  • 要求
  • 嵌套虚拟化
  • TL;DR
  • 安装步骤
  • 配置您的域名
  • 设置 Docker Desktop
  • 创建 Bitwarden 本地用户和目录
  • 安装 Bitwarden
  • 安装后配置
  • 启动 Bitwarden
  • 下一步
  • 在启动时启动 Docker
  • 脚本命令参考
  1. 自托管
  2. 安装 & 部署指南
  3. Docker

Windows 标准部署

上一页Linux 离线部署下一页Windows 离线部署

最后更新于1个月前

对应的

这篇文章将指导您安装和部署 Bitwarden 到您自己的 Windows 服务器。Bitwarden 也可以安装和部署在 机器上。请查看 Bitwarden 文档。

要求

最低
推荐

处理器

x64, 1.4GHz

x64, 2GHz 双核

内存

6GB RAM

8+GB RAM

存储

76GB

90GB

Docker 版本

Engine 26+ and Compose ª

Engine 26+ and Compose ª

ª - Docker Compose 可以通过 Docker Desktop 安装,其中包含 Engine 和 Compose。

嵌套虚拟化

在 Windows 服务器上运行 Bitwarden 需要使用嵌套虚拟化。请检查您的管理程序的文档以了解是否支持嵌套虚拟化以及如何启用它。

如果您将 Windows Server 作为 Azure VM 运行,我们建议使用运行 Windows Server 2022 的标准 D2s v3 虚拟机,它满足所有,包括对嵌套虚拟化的支持。

TL;DR

[译者注]:TL;DL - Too long; Don't read,直译为「太长,请不要看」,实际意思为「此文篇幅较长,看此总结」,一般用在比较长篇幅的内容前面,后面跟着一段简短的总结内容。

以下是本文中的摘要。本节中的链接将跳转至详细的安装步骤部分:

1、。设置你的域名 DNS 记录指向你的主机,并打开主机上的 80 和 443 端口。

至少要配置 globalSettings__mail__smtp... 变量以设置用于邀请和验证用户的电子邮件服务器。

8、在网页浏览器中打开您配置的域名来测试您的安装。

9、部署后,我们建议定期备份您的服务器并检查系统更新。

安装步骤

使用 PowerShell ISE 运行 PowerShell 命令会导致 Bitwarden 安装失败。要成功完成安装将需要 PowerShell。

配置您的域名

默认情况下,Bitwarden 通过本地主机上的 80(http)和 443(https)端口提供服务。您应该打开这些端口,以便可以从网络内部和/或外部访问 Bitwarden。如果你愿意,也可以在安装过程中选择使用其他端口。

如果您使用的是 Windows 防火墙,Windows 版 Docker Desktop 不会自动在 Windows 防火墙中为自己添加例外。为 TCP 端口 80 和 443(或选择的替代端口)添加例外以防止出现一些错误。

我们建议配置一个带 DNS 记录的域名(例如,bitwarden.example.com)指向您的托管主机,特别是当您通过互联网提供 Bitwarden 服务时。

设置 Docker Desktop

容器部署使用 Docker Compose 进行编排。Docker Compose 可以通过 Docker Desktop 安装,其中包含 Engine 和 Compose。

在此次设置过程中,您必须取消选择 Use WSL2 instead of Hyper-V (recommended) 选项。安装后,打开 Docker Desktop 并选择 ⚙️Settings,然后选择 Resources。Bitwarden 至少需要分配 4GB RAM 给 Docker Desktop。此设置将 Windows 的 RAM 专用于 Docker。因此,设置此值过高可能会导致 Windows 不稳定。

创建 Bitwarden 本地用户和目录

打开 PowerShell 并通过运行以下命令创建一个 Bitwarden 本地用户:

PS C:\> $Password = Read-Host -AsSecureString

运行上述命令后,在文本输入对话框中输入所需的密码。指定密码后,运行以下命令:

New-LocalUser "Bitwarden" -Password $Password -Description "Bitwarden Local Admin"

作为新创建的用户,在 C:\ 下创建一个 Bitwarden 文件夹:

PS C:\> mkdir Bitwarden

在 Docker Desktop中,导航到 Settings → Resources → File Sharing 并将创建的目录(C:\Bitwarden)添加到 Resources 列表中。选择 Apply & Restart 以使您的更改生效。

我们建议在完成本文件中所有后续步骤之前,以新创建的用户登录。

安装 Bitwarden

Bitwarden 提供了一个 Powershell Cmdlet 文件(.ps1),以便在 Windows 机器上轻松安装。完成以下步骤以使用 Cmdlet 安装 Bitwarden:

cd C:\Bitwarden

2、运行以下命令下载 Bitwarden 安装脚本(bitwarden.ps1):

Invoke-RestMethod -OutFile bitwarden.ps1 -Uri "https://func.bitwarden.com/api/dl/?app=self-host&platform=windows"

3、使用以下命令运行安装程序脚本:

.\bitwarden.ps1 -install

4、完成安装程序中的以下提示:

  • Enter the domain name for your Bitwarden instance(输入您的 Bitwarden 实例的域名): 通常,此值应该是已配置的 DNS 记录。

  • 或者,指定 n 并使用 Do you have a SSL certificate to use? 选项。

  • Enter your installation key(输入您的安装密钥):

  • 或者,指定 n 并使用 self-signed SSL certificate? 选项,这只是为了测试目的而推荐的。

  • 如果你指定 n,你的实例将不使用 SSL 证书,你需要使用前置 HTTPS 代理来安装,否则 Bitwarden 应用程序将无法正常运行。

安装后配置

配置您的环境可能涉及对两个文件进行更改:一个环境变量文件和一个安装文件:

环境变量(必须)

bitwarden.ps1 Cmdlet 未配置 Bitwarden 的某些功能。通过编辑位于 ./bwdata/env/global.override.env 的环境文件来配置这些设置。至少,您应该替换以下值:

...
globalSettings__mail__smtp__host=<placeholder>
globalSettings__mail__smtp__port=<placeholder>
globalSettings__mail__smtp__ssl=<placeholder>
globalSettings__mail__smtp__username=<placeholder>
globalSettings__mail__smtp__password=<placeholder>
...
adminSettings__admins=
...

替换 globalSettings__mail__smtp...= 的占位符将配置 SMTP 邮件服务器,该服务器将用于向新用户发送验证电子邮件和向组织发送邀请。将电子邮件地址添加到 adminSettings__admins= 将提供对管理门户的访问权限。

编辑 global.override.env 后,运行以下命令以使更改生效:

.\bitwarden.ps1 restart

安装文件

Bitwarden 安装脚本使用 ./bwdata/config.yml 中的设置来生成必要的资产,以用于安装。某些安装场景(例如,在代理服务器后面使用备用端口进行安装)可能需要对 config.yml 进行调整,这些调整在标准安装过程中没有提供。

根据需要编辑 config.yml 文件,并使用以下命令以使更改生效:

.\bitwarden.ps1 -rebuild

启动 Bitwarden

完成所有前面的步骤后,通过运行以下命令启动您的 Bitwarden 实例:

.\bitwarden.ps1 -start

首次启动 Bitwarden 时,可能会花费一些时间,因为它会从 Docker Hub 下载镜像。

验证所有容器是否正常运行:

docker ps

恭喜你!Bitwarden 现在已启动并运行在您指定的域名(如上面的示例 https://bitwarden.example.com)上了。在网页浏览器中访问网页密码库以确认它是否已经正常工作。

下一步

在启动时启动 Docker

如果您有已登录的 RDP 会话,桌面版 Docker 才会在启动时自动启动。无论是否有用户登录,都要在启动时启动桌面版 Docker:

桌面版 Docker 在启动后可能需要长达 15 分钟才能启动完成并可以从网络访问容器。

1、打开 Windows 任务计划程序并从操作菜单中选择创建任务… 。

2、使用以下安全选项配置任务:

  • 将任务设置为不管用户是否登录都要运行。

3、选择触发器选项卡并新建如下的触发器:

  • 从开始任务下拉列表中,选择启动时。

  • 在高级设置部分,勾选延迟任务时间: 复选框并从下拉列表中选择 1 分钟。

4、选择操作选项卡并新建如下的操作:

  • 在程序或脚本输入栏中,指定 “C:\Program Files\Docker\Docker\Docker Desktop.exe”。

5、选择确定完成定时任务的创建。

脚本命令参考

Bitwarden 安装脚本(bitwarden.ps1)具有以下可用的命令。所有命令都必须以开关(-)为前缀,例如 .\bitwarden.ps1 -start:

命令
描述

-install

启动安装程序。

-start

启动所有容器。

-restart

重新启动所有容器。

-stop

停止所有容器。

-update

更新所有容器和数据库。

-updatedb

更新/初始化数据库。

-updaterun

更新 run.sh 文件。

-updateself

更新安装脚本。

-updateconf

更新所有容器,而无需重新启动正在运行的实例。

-uninstall

在执行此命令之前,系统会提示您保存数据库文件。选 y 将创建一个包含最新备份的数据库的 tar 文件。

停止容器,删除 bwdata 目录及其所有内容,并删除临时卷。执行后,系统会询问您是否还要清除所有 Bitwarden 镜像。

-renewcert

续签证书。

-rebuild

重建从 config.yml 生成的安装资产。

-help

列出所有命令。

2、在您的机器上。

3、以完成安装。

4、从 获取安装 ID 和密钥用于安装过程。

更多详细信息,请参阅。

5、在您机器上。

6、在 ./bwdata/env/global.override.env 中调整设置以。

7、。

Bitwarden 将使用一系列 部署并运行在您的机器上。Bitwarden 可以使用任何 Docker 版本或计划运行。评估哪个版本最适合您的安装。

Bitwarden 用户必须添加到 docker-users 组中。请参阅 了解如何操作。

如果您,请以 Bitwarden 用户身份完成以下操作。

1、导航到的目录:

Do you want to use Let's Encrypt to generate a free SSL certificate? (y/n)(您想使用 Let's Encrypt 生成免费的 SSL 证书吗?): 指定 y 来使用 Let's Encrypt 生成一个可信的 SSL 证书。你会被提示输入一个电子邮件地址,以便从 Let's Encrypt 获取到期提醒。更多信息,请参阅。

Enter your installation id(输入您的安装 ID): 通过 使用一个有效的电子邮件地址来获取安装 ID。更多详细信息,请参阅

通过 使用一个有效的电子邮件地址来获取安装密钥。更多详细信息,请参阅

Enter your region (US/EU)(输入您的区域 (US/EU)): 输入 US 或 EU,具体取决于您将用于许可付费功能的,仅适用于您将自托管账户或组织连接到付费订阅的情况。

Do you have a SSL certificate to use? (y/n)(您拥有自己的 SSL 证书吗?): 如果你已经有自己的 SSL 证书,请指定 y,并将必要的文件放在 C:\Bitwarden\bwdata\ssl\<your_domain> 目录下。你会被问到是否使用受信任的 SSL 证书(y/n)。更多信息,请参阅。

Do you want to generate a self-signed SSL certificate? (y/n)(您想生成一个自签名证书吗?): 指定 y 让 Bitwarden 为你生成一个自签名证书。这个选项只推荐用于测试。更多信息,请参阅。

现在,您可以注册一个新账户并登录了。您需要配置 smtp 环境变量(请参阅)以验证新账户的电子邮箱地址。

部署完成后,我们建议定期并。

如果您打算自托管一个 Bitwarden 组织,请参阅以开始。

如需了解更多信息,请参阅。

将任务设置为使用的 Bitwarden 用户帐户。

https://bitwarden.com/host
Docker 容器
Docker 文档
证书选项
云端服务器
证书选项
证书选项
备份您的服务器
检查系统更新
自托管组织
自托管 FAQ
官方文档地址
Linux 和 macOS
软件发布支持
系统要求
安装步骤
配置您的域名
安装和设置桌面版 Docker
创建一个 Bitwarden 用户和目录
安装 Bitwarden
配置您的环境
启动您的实例
已经创建 Bitwarden 用户和目录
已创建
已创建
https://bitwarden.com/host
https://bitwarden.com/host
我的安装 ID 和安装密钥是用来干什么的?
我的安装 ID 和安装密钥是用来干什么的?
我的安装 ID 和安装密钥是用来干什么的?
环境变量
显示健康容器的列表