最后更新于
最后更新于
对应的
本文定义了 Bitwarden 自托管实例可用的证书选项。您可以在安装过程中选择证书选项。设置或更改证书配置总是需要您在启动 Bitwarden 之前运行 ./bitwarden.sh rebuild
或 .\bitwarden.ps1 -rebuild
命令来应用对 config.yml 文件的更改。
是一个证书颁发机构(CA - Certificate Authority),可以为任何域名颁发免费的可信的 SSL 证书。Bitwarden 安装脚本提供了使用 Let's Encrypt 和 为你的域名生成可信 SSL 证书的选项。
每次重新启动 Bitwarden 时,都会进行证书更新检查。使用 Let's Encyrpt 会要求你输入一个电子邮箱地址来获取证书到期提醒。
Let's Encrypt 是一个第三方证书颁发机构,它要求 80 和 443 端口可以从互联网访问,以便验证你的域名并颁发证书。如果您没有或不想设置互联网入站访问,您可以使用本文档中的其他证书选项。
如果您更改了 Bitwarden 服务器的域名,则需要手动更新已生成的证书。运行以下命令以创建备份、更新证书并重建 Bitwarden:
Bash
选择 1,然后按照说明进行操作:
您也可以选择使用现有的 SSL 证书,这要求您已经拥有如下的文件:
服务器证书(certificate.crt
)
私钥(private.key
)
CA 证书(ca.crt
)
您可能需要将主证书与中间 CA 证书捆绑在一起,以防止 SSL 信任错误。当使用根 CA 和中间 CA 证书时,所有证书都应该包含在服务器证书文件中。
在默认配置下,将您的文件放在 ./bwdata/ssl/your.domain
中。您可以通过编辑 ./bwdata/config.yml
中的以下值来指定证书文件的不同位置:
(可选)如果使用 Diffie Hellman 密钥交换生成临时参数:
在同一目录中包含 dhparam.pem
文件。
在 config.yml
中设置 ssl_diffie_hellman_path:
值。
您也可以选择使用自签名证书,但这只建议用于测试。
默认情况下,Bitwarden 客户端应用程序不会信任自签名证书。您需要手动将该证书安装到您计划使用 Bitwarden 的每一个设备的受信任存储中。
生成自签名证书:
您的自签名证书(.crt
)和私钥(private.key
)文件可以放置于 ./bwdata/ssl/self/your.domain
目录并将其配置到 ./bwdata/config.yml
中:
要在 Windows 上信任自签名证书,请运行 certmgr.msc
并将证书导入受信任的根证书颁发机构中。
要在 Linux 上信任自签名证书,请将证书添加到以下目录中:
然后进行以下命令:
如果您选择不使用证书,则必须在您的 Bitwarden 安装的前端使用 SSL 代理。这是因为 Bitwarden 需要 HTTPS。尝试在没有 HTTPS 协议的情况下使用 Bitwarden 将触发错误。
PowerShell
对于 Bitwarden Linux 桌面 App,请使用基于 Chromium 的浏览器和 Directory Connector 桌面 App 访问网页密码库,您还需要完成。
对于 和,您的自签名证书必须存储在本地文件中并由 NODE_EXTRA_CA_CERTS=
环境变量引用,例如:
要信任 Android 设备上的自签名证书,请参阅 Google 文档:。
您需要将 Bitwarden 证书上传到您的设备中。有关查找证书的帮助信息,请参阅。