martadams89/bitwarden-sync

Bitwarden Sync Docker镜像

镜像概述

该Docker镜像专为Bitwarden或Vaultwarden密码库的服务器间同步设计，是将Bitwarden数据从一台服务器迁移到另一台服务器的实用解决方案，提供直观的备份与恢复流程。

核心功能与特性

• 服务器间同步：轻松将Bitwarden或Vaultwarden密码库从源服务器传输到目标服务器
• 定时同步：通过可自定义的cron计划设置自动同步，实现无需人工干预的定期数据更新
• 健康检查集成：可选集成Healthcheck.io，用于监控同步过程的健康状态

配置参数

源服务器凭证

• 源账户***（BW_ACCOUNT_SOURCE）
• 源账户密码（BW_PASS_SOURCE）
• 源客户端ID（BW_CLIENTID_SOURCE）
• 源客户端密钥（BW_CLIENTSECRET_SOURCE）
• 源Bitwarden服务器URL（BW_SERVER_SOURCE）

目标服务器凭证

• 目标账户***（BW_ACCOUNT_DEST）
• 目标账户密码（BW_PASS_DEST）
• 目标客户端ID（BW_CLIENTID_DEST）
• 目标客户端密钥（BW_CLIENTSECRET_DEST）
• 目标Bitwarden服务器URL（BW_SERVER_DEST）

可选：健康检查集成

• Healthcheck.io URL（HEALTHCHECK_URL）
• Healthcheck.io Ping令牌（HEALTHCHECK_PING）

使用方法

Docker Compose配置示例

yaml
version: "3.6"
services:
  bitwarden-sync:
    image: martadams89/bitwarden-sync:latest
    container_name: bitwarden-sync
    restart: always
    environment:
      - CRON_SCHEDULE=0 0 * * *  # 每日凌晨执行同步
      - BW_TAR_PASS=mysecuretarpassword  # 备份文件加密密码
      # 源服务器配置
      - BW_ACCOUNT_SOURCE=mybitwardensource@email.com
      - BW_PASS_SOURCE=mybitwardensourcepassword
      - BW_CLIENTID_SOURCE=user.32323232-3232323-232323-3232323-32323232
      - BW_CLIENTSECRET_SOURCE=FdfdfdfdfdfdfFfdfdffdfdfd
      - BW_SERVER_SOURCE=https://vault.mydomain.com
      # 目标服务器配置
      - BW_ACCOUNT_DEST=mybitwardendest@email.com
      - BW_PASS_DEST=mybitwardendestpassword
      - BW_CLIENTID_DEST=user.1221212-121212-12121-12121
      - BW_CLIENTSECRET_DEST=Dsfdfdfdfdfdfdfdfdfgfdfdfds
      - BW_SERVER_DEST=https://vault.bitwarden.com
      # 可选：Healthcheck.io集成
      - HEALTHCHECK_URL=https://healtcheck.url.com/ping
      - HEALTHCHECK_PING=1234343r3fadgsdgs
    volumes:
      - ./config/backups:/app/backups  # 挂载备份文件存储目录（可选）

注意事项

• 目前该脚本不支持组织或多用户同步。
• 所有敏感凭证（如密码、客户端密钥）需通过环境变量传入，确保配置安全。
• 定时同步计划通过CRON_SCHEDULE环境变量定义，遵循标准cron表达式格式。

更多信息

完整配置选项及更新说明，请参考https://github.com/martadams89/bitwarden-sync%E3%80%82