故障

部署过程输入安装 ID/密钥确认后提示错误：Unable to validate installation id. Problem contacting Bitwarden server.

无法验证安装 ID。联系 Bitwarden 服务器时出现问题。

原因为 Docker 无法访问外部网络。对于新的 CentOS 8 系统可能会出现这个故障（我在新的 CentOS 7 系统上测试时未出现此故障）。

添加一条防火墙规则让 Docker 流量通过：

# 允许防火墙伪装 IP
sudo firewall-cmd --zone=public --add-masquerade --permanent
# 重启防火墙
sudo firewall-cmd --reload

参考链接：Install Bitwarden on CentOS/RHEL 8

注册新账号时出现错误：发生错误。An unhandled server error has occurred.

登录 SSH 运行语句：

docker logs -f bitwarden-mssql

您会发现有提示：sqlservr: This program requires a machine with at least 2000 megabytes of memory.

说明内存不足，增加内存为至少 2000MB 即可。

当您刚部署好 Bitwarden 而未注册任何账号，使用任意账号密码登录，可能也会出现此错误。

第一次注册新账号时出现错误：发生错误。Failed to fetch.

原因为未配置 SMTP。当您刚部署好 Bitwarden 而未注册任何账号，使用任意账号密码登录，可能也会出现此错误。

导入高级会员许可证时出现错误：发生错误。This license is not valid for this user.

原因为账户电子邮件地址不匹配。自托管服务器上的账户电子邮件地址必须与 Bitwarden 云端购买了高级会员的账户电子邮件地址一致，才能将高级会员许可证文件导入本地。更换电子邮箱地址即可。

导入许可证文件后，可以成功更改自托管服务器上此账户的电子邮件地址，但 Bitwarden 会定期检测导入的许可证文件中的电子邮件地址是否与账户电子邮件地址匹配，从而导致许可证过期。

导入许可证文件时出现错误： 发生错误。Valid License.

许可证无效。原因可能为：

• 上传的许可证类型不匹配（比如高级会员许可证文件上传到组织中）

• 许可证文件内容被修改

收到标题为 License Expired 的电子邮件

邮件内容如下：

This email is to notify you that your Bitwarden premium license has expired and must be updated for continued use. See the following article for details about replacing your license file: https://bitwarden.com/help/article/licensing-on-premise/

提示许可证过期需要更新许可证。原因可能为：

• 许可证确实过期。登录 Bitwarden 云账户，如果订阅过期，先续费订阅，然后重新下载许可证后在自托管服务器上做更新许可证的操作。

• 更改了自托管账户的电子邮件地址。Bitwarden 会定期自动检测本地账户的电子邮件地址是否和许可证中的电子邮件地址一致，不一致会删除许可证文件，从而导致许可证过期。

使用非默认的 HTTPS 端口时，管理门户跳转的网址不正确

Bitwarden 服务器版本 1.37.1。

网页版密码库地址为 https://vault.yourdomain.com:28443 ，对应的管理员门户地址应该为 https://vault.yourdomain.com:28443/admin ，访问时会自动跳转到 https://vault.yourdomain.com/admin/login?returnUrl=%2Fadmin ，导致无法访问。

临时解决办法是在跳转的地址上手动加端口号： https://vault.yourdomain.com:28443/admin/login?returnUrl=%2Fadmin 。

暂时无法彻底解决，可能为此版本 Bitwarden 的 bug，等待 Bitwarden 官方的修复。

忘记了安装 ID 和安装密钥

从 Bitwarden 云账户下载家庭账户和企业账户的许可证文件时，需要输入与您的 Bitwarden 安装相匹配的安装 ID。如果您忘记了安装 ID 和安装密钥，可以从环境变量文件 ./bwdata/env/global.override.env 中找到。

从 https://bitwarden.com/host 获取安装 ID 和安装密钥后，应将其保存在您能够记住且安全的地方。

Fail2ban 不起作用

参看故障 - Fail2ban 不起作用章节。