Bitwarden Docker镜像文档

镜像概述和主要用途

Bitwarden是一款开源密码管理解决方案，适用于个人、团队及企业组织。本Docker镜像是Bitwarden的自托管统一镜像（Unified Image），旨在提供便捷的自部署方式，帮助用户在私有环境中搭建和管理Bitwarden服务，实现密码及敏感信息的安全存储与管理。

核心功能与特性

核心功能

• 多用户支持：满足个人、团队及企业级用户的密码管理需求，支持用户分组与权限控制。
• 密码全生命周期管理：提供密码生成、存储、自动填充、过期提醒等功能。
• 跨平台同步：支持在Windows、macOS、Linux、iOS、Android及主流浏览器间同步数据。
• 安全加密：采用AES-256加密算法保护数据，支持双因素认证（2FA）增强账户安全。

特性

• 开源架构：100%开源代码，可审计性强，社区活跃（代码库托管于GitHub）。
• 统一镜像设计：集成Bitwarden服务所需的核心组件，简化部署流程。
• 灵活扩展：支持根据用户规模和需求调整资源配置，适配不同部署环境。

使用场景与适用范围

适用场景

• 个人用户自托管：希望完全控制密码数据，不依赖第三方云服务的个人用户。
• 企业内部部署：对数据隐私和合规性有严格要求的企业，需在私有服务器或内网环境中部署密码管理系统。
• 团队协作管理：中小型团队共享敏感信息（如服务器密码、API密钥），需精细化权限控制。

适用范围

• 个人开发者、IT管理员、信息安全团队。
• 对数据本地化存储有需求的企业或组织。
• 需符合GDPR、HIPAA等数据合规要求的场景。

重要提示

⚠️ 容器镜像仓库迁移通知：Bitwarden容器镜像仓库已迁移，相关镜像获取及部署说明请参考官方self-host仓库。

使用方法与配置说明

前提条件

• Docker Engine 20.10+ 及 Docker Compose v2+。
• 至少2GB RAM及20GB可用磁盘空间（生产环境建议更高配置）。
• 域名（可选，用于HTTPS配置）及SSL证书。

获取镜像

由于镜像仓库已迁移，需通过官方指定的新仓库拉取镜像。具体镜像名称及标签请参考self-host仓库文档。

部署步骤（基于Docker Compose）

Bitwarden官方推荐使用Docker Compose进行部署，以下为基础部署框架（详细配置请参考官方部署文档）：

1. 克隆self-host仓库（包含部署配置文件）：

   git clone [***]
   cd self-host
   

2. 配置环境变量： 复制示例配置文件并修改必要参数（如域名、数据库设置等）：

   cp .env.example .env
   

   编辑.env文件，关键参数示例：

   DOMAIN=your-bitwarden-domain.com  # 服务域名
   ADMIN_EMAIL=***     # 管理员邮箱
   DATABASE_URL=postgresql://user:password@db:5432/bitwarden  # 数据库连接URL（若使用外部数据库）
   

3. 启动服务：

   docker compose up -d
   

4. 初始化管理员账户： 部署完成后，通过命令行创建管理员账户（具体命令见官方文档）：

   docker compose exec bitwarden admin create
   

配置参数说明

Bitwarden的配置主要通过环境变量（.env文件）和配置文件（bwdata/config.yml）实现，核心配置项如下（详细参数请参考官方配置指南）：

文档与资源

• 官方部署文档：Install and Deploy Unified Beta
• 自托管仓库：bitwarden/self-host
• GitHub代码库：bitwarden/server（100%开源代码）