Bitwarden 服务器 API 镜像文档

!bitwarden

镜像概述和主要用途

Bitwarden 服务器 API 镜像是 Bitwarden 开源密码管理解决方案的核心组件，提供后端服务 API，用于支撑密码管理功能的实现。该镜像适用于搭建自托管的 Bitwarden 服务，为个人用户、团队及企业组织提供安全的密码存储、管理和共享能力。

核心功能和特性

• 开源解决方案：100% 开源软件，代码库完全公开，支持用户自主审计和定制。
• 多用户支持：兼容个人、团队及企业级用户场景，提供灵活的权限管理。
• 安全密码管理：作为服务器 API 核心，支撑密码加密存储、安全访问控制等基础功能。
• 跨平台兼容：支持与 Bitwarden 各类客户端（Web、桌面、移动）无缝对接。

使用场景和适用范围

个人用户

需自建密码管理服务，保障个人密码数据隐私与自主控制权的场景。

团队协作

中小型团队需共享密码（如账号、密钥），同时保持访问审计和权限隔离的场景。

企业组织

对数据本地化、合规性有严格要求，需部署私有密码管理系统的企业级场景。

使用方法和配置说明

重要通知：容器镜像仓库迁移

⚠️ 官方容器镜像仓库已迁移，旧仓库地址可能不再维护。请通过 Bitwarden 自托管仓库 获取最新镜像信息及部署指南。

部署准备

1. 环境要求：

   • 安装 Docker 及 Docker Compose（推荐使用官方指定版本，详见文档）。
   • 满足最低系统资源要求（CPU、内存、磁盘空间，参考官方部署文档）。

2. 获取配置文件：
   通过克隆官方自托管仓库获取部署所需的 docker-compose.yml 及环境配置模板：

   git clone [***]
   cd self-host
   

配置与启动

1. 修改环境配置：
   复制并编辑 .env.example 为 .env，根据需求配置域名、SSL、数据库等参数（详细配置项说明见 官方安装文档）。

2. 启动服务：
   使用 Docker Compose 启动所有服务组件（包括 API 服务器、数据库、Web 前端等）：

   docker-compose up -d
   

3. 验证部署：
   服务启动后，通过配置的域名或 http://localhost:80 访问 Bitwarden Web 界面，完成初始化设置。

停止与维护

• 停止服务：

  docker-compose down
  

• 升级镜像：
  拉取最新镜像并重启服务（需先更新仓库代码及配置文件）：

  git pull
  docker-compose pull
  docker-compose up -d
  

注意事项

• 文档参考：完整的安装部署、配置优化及故障排查，请查阅官方文档：

  • 安装部署指南
  • 托管文档

• 问题反馈：Docker Hub 评论区未启用监控，使用中遇到的问题请提交至 GitHub 代码库。

• 开源代码：完整源代码可在 GitHub 获取，支持自主定制与二次开发。

官方资源

• GitHub 代码库：[***]
• 自托管仓库：[***]
• 帮助中心：[***]