redoracle/bitwarden-standalone

redoracle/bitwarden-standalone 镜像说明

镜像概述

redoracle/bitwarden-standalone是一个兼容Bitwarden API的独立密码管理服务器镜像，支持本地持久化存储，适用于个人或小型团队搭建私有密码管理服务，无需依赖外部云平台，保障数据自主可控。

核心功能

• 基础功能：单用户密码存储、检索与管理
• 组织支持：团队密码共享与权限分配
• 附件存储：密码项关联文件附件
• 客户端兼容：支持Bitwarden Web/移动/桌面客户端接入
• 界面服务：提供静态Vault Web管理界面
• 多因素认证：支持TOTP（Authenticator）和U2F认证
• 辅助功能：网站图标自动获取、API请求大小限制调整

缺失功能：***确认、YubiKey OTP/Duo/***验证码等二因素认证方式。

使用场景

1. 个人用户：搭建本地密码库，避免第三方云服务风险
2. 小型团队：共享团队内部敏感凭证（如服务器账号、数据库密码）
3. 企业内部：部署私有密码系统，满足数据合规与安全要求

配置说明

基础部署（持久化存储）

将容器内/data目录挂载到主机以保存数据：

bash
docker run -d --name bitwarden -v /bw-data/:/data/ -p 80:80 redoracle/bitwarden-standalone:latest

访问http://localhost:80即可使用。

更新镜像

bash
# 拉取最新镜像
docker pull redoracle/bitwarden-standalone:latest
# 替换旧容器
docker stop bitwarden && docker rm bitwarden
# 启动新容器（保留数据）
docker run -d --name bitwarden -v /bw-data/:/data/ -p 80:80 redoracle/bitwarden-standalone:latest

禁用新用户注册

bash
docker run -d --name bitwarden \
  -e SIGNUPS_ALLOWED=false \
  -v /bw-data/:/data/ \
  -p 80:80 \
  redoracle/bitwarden-standalone:latest

启用HTTPS

需提供PEM格式证书与私钥：

bash
docker run -d --name bitwarden \
  -e ROCKET_TLS='{certs="/ssl/certs.pem",key="/ssl/key.pem"}' \
  -v /path/to/ssl/:/ssl/ \
  -v /bw-data/:/data/ \
  -p 443:80 \
  redoracle/bitwarden-standalone:latest

启用U2F认证

需通过HTTPS访问，并设置域名：

bash
docker run -d --name bitwarden \
  -e DOMAIN=https://bw.yourdomain.com \
  -v /bw-data/:/data/ \
  -p 80:80 \
  redoracle/bitwarden-standalone:latest

SMTP邮件配置

bash
docker run -d --name bitwarden \
  -e SMTP_HOST=smtp.yourdomain.com \
  -e SMTP_FROM=bitwarden@yourdomain.com \
  -e SMTP_PORT=587 \
  -e SMTP_SSL=true \
  -e SMTP_USERNAME=your-username \
  -e SMTP_PASSWORD=your-password \
  -v /bw-data/:/data/ \
  -p 80:80 \
  redoracle/bitwarden-standalone:latest

其他常用配置

• 禁用邀请：添加-e INVITATIONS_ALLOWED=false
• 调整数据路径：-e DATA_FOLDER=/persistent（需同步挂载对应目录）
• 修改工作线程：-e ROCKET_WORKERS=20（提升并发处理能力）
• 关闭密码提示：-e SHOW_PASSWORD_HINT=false
• 禁用Web界面：-e WEB_VAULT_ENABLED=false