数据库选项

对应的官方文档地址

服务器部署的默认数据库

除 Lite 部署外，所有 Bitwarden 自托管服务器部署默认使用 MSSQL Express 镜像。这将您的加密密码库数据与应用程序容器一起部署，并通过确保更新、维护和备份与代码的其余部分同时进行，从而简化部署流程。

此默认数据库不需要额外许可，并已按照 Bitwarden 标准预配置，以安全存储并自动备份密码库数据（了解更多）。

服务器部署使用外部数据库

在默认使用 MSSQL Express 镜像的自托管服务器部署中，使用该容器是可选的。为了实现高可用性或利用现有基础设施，客户可以连接到外部 MSSQL 服务器或集群（了解更多），版本需为 2019 或更高版本，但建议使用 2022 或更高版本。

无论您是使用附带的 MSSQL Express 映像还是您自己的外部 MSSQL 服务器或集群，标准 Bitwarden 部署当前都必须使用 MSSQL。

Lite 部署的数据库

Bitwarden Lite 自托管部署不附带内置数据库，但可以连接到现有的 MySQL/MariaDB、MSSQL、SQLite 或 PosgreSQL 数据库（了解更多）。由于该数据库不与应用程序容器不在同一位置，因此从基础架构角度来看，数据库的维护（包括更新、维护和备份）需要单独管理。

只有 Lite 部署支持这些数据库选项，标准部署需要 MSSQL。

可选的数据库任务

数据库准备

在非 Lite 自托管部署中，Bitwarden 会检查构造的连接字符串中指定的数据库是否存在，如果不存在，则会创建它。此任务需要已配置的 SQL 用户在数据库服务器中具有管理员权限。权限不足将导致此任务失败。

如果您正在部署自己的外部数据库，请通过在 global.override.env 文件中设置以下环境变量来禁用此部署步骤：

globalSettings__sqlServer__skipDatabasePreparation=true

数据库维护

在所有自托管部署中，包括 Lite 部署，Bitwarden 会在数据库上运行计划任务，以执行常规维护，例如计算数据库统计信息和构建索引。这些任务需要已配置的 SQL 用户在数据库服务器中具有管理员权限。权限不足将导致此任务失败，并且失败信息会被记录到 admin 容器日志中。

如果您希望以单独的用户身份运行这些维护任务，请通过在 global.override.env 文件中设置以下环境变量来禁用此行为：

globalSettings__sqlServer__disableDatabaseMaintenanceJobs=true

如果您禁用了数据库维护任务，请定期手动检查数据库清理和索引创建。