# 连接到外部 MSSQL 数据库
{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/external-db/)
{% endhint %}
默认情况下，Bitwarden 的自托管实例将使用作为[安装设置](/docs/self-hosting/deploy-and-configure/docker/linux-standard-deployment.md)的正常部分而创建的 Microsoft SQL Server (MSSQL) 数据库，但您也可以将 Bitwarden 配置为使用外部 MSSQL 数据库。
{% hint style="info" %}
Bitwarden **仅支持并推荐使用 SQL Server 2022**。了解 [Windows](https://learn.microsoft.com/zh-cn/sql/sql-server/install/hardware-and-software-requirements-for-installing-sql-server-2022?view=sql-server-ver17) 和 [Linux](https://learn.microsoft.com/zh-cn/sql/linux/sql-server-linux-setup?view=sql-server-ver16#supported-platforms) 上 SQL Server 的系统要求。
目前，Bitwarden 不支持 SQL Server 2025，并且对 Server 2017 和 Server 2019 的主流支持已经结束。如果 Bitwarden 实现了特定 SQL Server 版本上不可用的功能，将在此处及相应版本的[发行记录](/docs/release-notes.md)中注明对该特定 SQL Server 版本支持的弃用。
{% endhint %}
## 设置外部数据库
要设置您的自托管实例使用外部数据库：
{% tabs %}
{% tab title="Docker" %}
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=;` 中的 ``。
4、将更改保存到 `global.override.env`。
5、启动 Bitwarden（`./bitwarden.sh start`）。
完成上述步骤后，您可以通过网页密码库创建一个新用户并查询外部 `vault` 数据库来测试连通性。
{% endtab %}
{% tab title="Helm" %}
1、创建一个新的 MSSQL 数据库。
2、（**推荐**）为您的数据库创建专用的 DBO。
3、在 `my-values.yaml` 配置文件中，设置值 `database.enabled: false` 以停止部署包含的 SQL pod。
4、在用于部署的 Kubernetes 机密对象中，使用以下信息设置 `globalSettings__sqlServer__connectionString=` 值：
{% hint style="info" %}
您用于配置机密对象的方法可能取决于您的部署，例如 [AWS 部署](/docs/self-hosting/deploy-and-configure/helm/aws-eks-deployment.md)和 [Azure 部署](/docs/self-hosting/deploy-and-configure/helm/azure-aks-deployment.md)可能使用 CSI SecretProviderClass 来执行此操作。
{% endhint %}
* `Data Source=tcp:,1433`，其中 `` 是您的 MSSQL 服务器的名称。
* `Initial Catalog=`，其中 `` 是您的数据库名称。
* `Persist Security Info=False`。
* `User ID=`，其中 `` 是您的 DBO 用户 ID。
* `Password=`，其中 `` 是您的 DBO 密码。
* `Multiple Active Result Sets=False`。
* `Connect Timeout=30`。
* `Encrypt=True`。
* `Trust Server Certificate=true`。如果您要求 Bitwarden 服务器验证您的 MSSQL 服务器的证书，则可以将该值设置为 `false`。
{% endtab %}
{% endtabs %}
## 验证服务器证书
要配置 Bitwarden 验证您的 MSSQL 数据库服务器的证书：
{% tabs %}
{% tab title="Docker" %}
1. 将您的 CA 根证书复制到 `./bwdata/ca-certificates`。
2. 运行 `./bitwarden.sh restart` 命令将证书应用到您的容器然后重启服务器。
{% endtab %}
{% tab title="Helm" %}
1、在 `my-values.yaml` 配置文件中，设置值 `caCertificate.enabled: true`。
2、创建一个包含您的证书文件的 ConfigMap 对象。最简单的方法是将 `preInstall` RawManifest 添加到 `my-values.yaml` 文件中，如下例所示：
```yml
rawManifests:
preInstall:
- kind: ConfigMap
apiVersion: v1
metadata:
name: cacert
data:
rootca.crt: |
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
postInstall:
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.ppgg.in/docs/self-hosting/deploy-and-configure/configuration-options/connect-to-an-external-mssql-database.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.