连接到外部 MSSQL 数据库

默认情况下,Bitwarden 的自托管实例将使用作为安装设置的正常部分而创建的 Microsoft SQL Server(MSSQL)数据库,但您也可以将 Bi​​twarden 配置为使用外部 MSSQL 数据库。

Bitwarden 仅支持并推荐 SQL Server 2022。了解 WindowsLinux 上 SQL Server 的系统要求。

目前,Bitwarden 不支持 SQL Server 2025,并且对 Server 2017 和 Server 2019 的主流支持结束。如果 Bitwarden 实现了特定 SQL Server 版本上不可用的功能,则此处以及给定版本的发行记录中将注明不再支持特定 SQL Server 版本。

设置外部数据库

要设置您的自托管实例使用外部数据库:

1、创建一个新的 MSSQL 数据库。

2、(推荐)为您的数据库创建一个专用 DBO。

3、在您服务器的 global.override.env 文件中,使用如下信息编辑 globalSettings__sqlServer__connectionString= 的值:

  • 使用您的 MSSQL 服务器名称替换 "Data Source=tcp:mssql,1443"; 中的值,例如 "Data Source=protocol:server_url,port"

  • 使用您的数据库名称替换 Initial Catalog=vault 中的 vault

  • 使用您的 DBO 用户 ID 替换 User ID=sa; 中的 sa

  • 使用您的 DBO 密码替换 Password=<default_pw>; 中的 <default_pw>

4、将更改保存到 global.override.env

5、启动 Bitwarden(./bitwarden.sh start)。

完成上述步骤后,您可以通过网页密码库创建一个新用户并查询外部 vault 数据库来测试连通性。

验证服务器证书

要配置 Bitwarden 验证您的 MSSQL 数据库服务器的证书:

  1. 将您的 CA 根证书复制到 ./bwdata/ca-certificates

  2. 运行 ./bitwarden.sh restart 命令将证书应用到您的容器然后重启服务器。

最后更新于