For the complete documentation index, see llms.txt. This page is also available as Markdown.

网络要求

在自托管环境中部署 Bitwarden,需要您的网络基础设施支持特定的协议、端口和通信模式。本文概述了自托管 Bitwarden 部署的网络要求及兼容性注意事项。某些客户端侧的要求也可能适用于使用 Bitwarden Cloud 的组织,这些要求已在各相关条目中注明。

协议要求

以下部分描述了部署自托管 Bitwarden 服务器时的严格协议要求:

端口

Bitwarden 必须使用两个开放的端口用于通信,一个用于 HTTP(默认 80),另一个用于 HTTPS(默认 443)。Bitwarden 不支持仅在单一端口可用的情况下运行,但可以在安装过程中更改 HTTP 和 HTTPS 端口的默认值:

部署方式
配置非默认端口的方法

Docker、标准 (Linux & Windows)

编辑 ./bwdata/config.yml 中的 http_port=https_port=,然后运行重建命令。

Docker、手动 (Linux)

在同一目录中创建 docker-compose.yml 的副本,然后将其重命名为 docker-compose.override.yml。在覆盖文件中,编辑 nginx 端口映射。这些更改将在运行时合并。

Docker、离线 (Linux & Windows)

在同一目录中创建 docker-compose.yml 的副本,然后将其重命名为 docker-compose.override.yml。在覆盖文件中,编辑 nginx 端口映射。这些更改将在运行时合并。

Helm

端口暴露由您的 Kubernetes Ingress Controller 控制,而非 Bitwarden 服务。

Lite

docker run 命令或 docker-compose.yml 文件中设置运行时使用的端口。

HTTP 方法

此要求同样适用于云端客户。

Bitwarden 不支持在对 HTTP 方法进行限制或白名单控制的环境中运行。Bitwarden 在整个产品中会使用多种 HTTP 方法。具体使用哪些方法取决于所调用的功能,并且可能会随着现有功能或未来功能的支持而发生变化。

[译者注]HTTP Verbs(也叫 HTTP Methods,HTTP 方法),指的是在 HTTP 请求中告诉服务器「要做什么操作」。常见的有:GET(获取数据)、POST(提交数据)、PUT(更新数据)、DELETE(删除数据)、PATCH(部分更新)。

WebSocket 连接

此要求同样适用于云端客户。

Bitwarden 不支持在 WebSocket 连接被阻止的环境中运行。Bitwarden 客户端与自托管服务器之间需要建立 WebSocket(wss://)连接。

中间网络设备

以下部分描述了在自托管部署中必须如何配置中间网络设备:

反向代理

Bitwarden 支持在反向代理后面运行,但使用反向代理时,要求将所有标头(包括 Host:)不做任何修改地传递给 Bitwarden 的 nginx 容器。

正向代理

Bitwarden 支持在正向代理后面运行,但在此类环境中,强烈建议采用以下两种部署策略之一:

防火墙白名单

Bitwarden 支持在配置为允许必要流量的白名单防火墙后面运行,但在此类环境中,强烈建议采用以下两种部署策略之一:

网络应用程序防火墙 & 入侵防御系统

此要求同样适用于云端客户。

Bitwarden 兼容在网络应用防火墙 (WAF) 或入侵防御系统 (IPS) 后面运行,但在此类环境中,应在 Bitwarden 服务器正式上线前将 WAF 或 IPS 设置为学习(也称为「训练」或「模拟」)模式。这将使管理员有机会在 Bitwarden 服务器处于测试阶段时审查规则集,从而降低服务器正式上线且 WAF 或 IPS 处于主动拦截状态时,加密负载、访问令牌或其他加密数据传输被阻止的可能性。

其他网络平台

以下部分描述了网络上的其他设备如何与自托管 Bitwarden 服务器交互:

端点检测、电子邮件扫描 & 防病毒

此要求同样适用于云端客户。

端点检测 & 响应、邮件扫描和反病毒平台被报告会干扰 Bitwarden 容器的正常运行;具体而言,报告包括 Windows 反病毒平台因 Bitwarden 容器基于 Linux 而将其标记为可疑,以及电子邮件扫描平台在邀请电子邮件中编辑或重新格式化超链接。

请勿禁用这些解决方案,除非在故障排除过程中 Bitwarden 支持团队建议这样做。但如果您遇到这些问题,请检查您的端点检测、电子邮件扫描和防病毒平台是否存在与 Bitwarden 正常操作相关的误报。

中间人代理

在部署了中间人 ( MITM) 代理(例如 ZScaler)的环境中运行 Bitwarden 可能存在风险,具体取决于您组织的配置。在此类网络连接上, 应禁用记录 Bitwarden 流量的完整数据 ,以保护关键安全技术,例如 Bitwarden 流量的传输层加密。

[译者注]中间人 ( MITM) 代理,一种「主动充当中间人」的代理服务器,用来拦截、查看甚至修改通信内容,具体例如解密 HTTPS(前提是安装了企业证书),然后检查内容(是否有病毒/敏感信息),最后决定是否放行。它并不一定是攻击,也可能是合法工具(比如企业安全审计)。

环境因素

以下部分描述了自托管 Bitwarden 服务器如何在特定环境中运行:

网闸环境

Bitwarden 支持在网闸或离线环境中运行,但不建议在标准的「在线」部署与离线部署之间进行迁移。请使用以下文档之一,以在离线环境中进行部署:

[译者注]网闸 (air-gapped) 网络,也叫物理隔离的网络。是指与外部网络(如互联网或其他外部系统)完全隔离的计算机网络。这种隔离通过物理或逻辑手段实现,确保网络无法与外部环境进行数据交换,从而增强安全性。

最后更新于