Bitwarden Nginx 反向代理镜像文档

镜像概述与主要用途

Bitwarden Nginx 镜像为 Bitwarden 密码管理系统提供 nginx 网页服务器，主要作为所有端点的反向代理。该镜像旨在支持自托管 Bitwarden 实例的网络请求路由，是 Bitwarden 自托管部署架构中的关键组件，适用于个人、团队及企业的密码管理解决方案。

核心功能与特性

• 反向代理能力：作为所有 Bitwarden 服务端点的统一入口，负责请求转发与路由管理。
• 轻量高性能：基于 nginx 构建，具备高效的请求处理能力，支持高并发场景。
• 无缝集成：与 Bitwarden 后端服务（如 API 服务器、Web 客户端等）深度适配，确保服务间通信稳定。
• 开源透明：遵循 Bitwarden 整体开源理念，镜像构建逻辑与配置可通过官方仓库审计。

使用场景与适用范围

• 个人自托管：本地部署 Bitwarden 时，通过该镜像实现网络请求代理，简化多服务访问管理。
• 团队内部部署：在企业或团队内部网络中，作为密码管理系统的前端代理，优化服务访问路径。
• 企业级安全架构：配合 SSL 终止、访问控制等配置，满足企业对密码管理系统的网络安全需求。

使用方法与配置说明

镜像仓库变更说明

⚠️ 重要提示：Bitwarden 容器镜像仓库已迁移，当前镜像的最新版本及部署指南请参考官方自托管仓库：[***]

Docker 部署示例

基础 Docker Run 命令

以下为简化示例，实际部署需结合 Bitwarden 整体架构（如后端 API、数据库等服务），详细配置请参考官方文档：

docker run -d \
  --name bitwarden-nginx \
  -p 80:80 -p 443:443 \
  --network bitwarden-network \
  -v /path/to/nginx/conf:/etc/nginx/conf.d \  # 挂载自定义 nginx 配置（可选）
  -e BACKEND_SERVICE_URL=[***] \  # 后端服务地址（示例）
  bitwarden/nginx:latest  # 注意：实际镜像名称可能已变更，请以官方仓库为准

Docker Compose 配置示例

与 Bitwarden 其他服务协同部署时，典型 docker-compose.yml 片段如下（完整配置需参考官方自托管指南）：

version: '3'

services:
  nginx:
    image: bitwarden/nginx:latest  # 实际镜像名称以官方仓库为准
    container_name: bitwarden-nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/conf:/etc/nginx/conf.d  # 自定义配置挂载
      - ./ssl:/etc/ssl  # SSL 证书挂载（如需）
    depends_on:
      - api  # 依赖 Bitwarden API 服务
    restart: unless-stopped

  api:
    image: bitwarden/api:latest  # Bitwarden API 服务镜像
    # 其他 API 服务配置...

配置参数与环境变量

该镜像主要通过 nginx 配置文件（通常位于 /etc/nginx/conf.d）进行自定义，常见配置项包括：

• 后端服务地址（如 API 服务器、Web 客户端等）
• 端口映射规则
• SSL 证书路径与 HTTPS 配置
• 请求超时时间、缓冲区大小等性能参数

环境变量支持（具体以官方最新文档为准）：

• BACKEND_SERVICE_URL：后端 API 服务地址（示例：[***]）
• WEB_CLIENT_URL：Web 客户端服务地址（示例：[***]）
• LOG_LEVEL：nginx 日志级别（如 info、warn）

注意：详细配置项及最新参数请参考 Bitwarden 官方自托管文档：[***]

使用场景与适用范围

• 个人用户：本地部署 Bitwarden 时，通过反向代理统一管理服务访问，简化网络配置。
• 中小型团队：在内部服务器部署，通过 nginx 实现服务隔离与访问控制，提升安全性。
• 企业级部署：配合负载均衡、SSL 终止等功能，满足大规模用户访问与合规需求。

注意事项

1. 镜像仓库变更：Bitwarden 容器镜像已迁移至新仓库，旧仓库可能不再更新，部署前请务必参考官方 self-host 仓库获取最新镜像信息：[***]
2. 文档与支持：完整部署指南请查阅官方文档：[***]
3. 问题反馈：请勿在 DockerHub 评论区提交问题，相关 Bug 或需求请通过 GitHub 仓库反馈：[***]
4. 开源代码：Bitwarden 为 100% 开源软件，完整代码库可在 GitHub 查看：[***]