vaultwarden/web-vault 镜像文档

镜像概述和主要用途

vaultwarden/web-vault 是 Bitwarden Web Vault 的构建版本，包含专门补丁以确保与 Vaultwarden（开源 Bitwarden 兼容服务器）协同工作。该镜像提供了可直接用于 Vaultwarden 的 Web 界面，允许用户通过浏览器访问和管理密码库。

核心功能和特性

• Vaultwarden 兼容性：针对 Vaultwarden 服务器进行适配，确保 Web 界面与后端服务正常通信。
• 完整补丁支持：包含对 Bitwarden Web Vault 源码（含 jslib 子模块）的必要补丁，通过 git diff --submodule=diff 命令生成完整差异，解决默认 git diff 无法显示子模块补丁的问题。
• 可复现构建：提供构建脚本，支持用户基于原始 Bitwarden Web Vault 源码自行复现构建过程。
• 预构建版本：***发布页面提供预构建文件，简化部署流程。

使用场景和适用范围

使用场景

• 部署 Vaultwarden 服务器时，需要通过 Web 浏览器访问密码库的场景。
• 自定义或修改 Bitwarden Web Vault 源码后，需生成与 Vaultwarden 兼容的构建版本。

适用范围

适用于所有使用 Vaultwarden 的用户，包括个人用户、小型团队或组织，需通过 Web 界面管理密码数据。

使用方法和配置说明

获取 Web Vault 构建

方式 1：下载预构建版本

从 GitHub 发布页面 下载最新预构建文件，直接用于 Vaultwarden 部署。

方式 2：自行构建

1. 克隆 Bitwarden Web Vault 源码：

   bash
   git clone [***]
   cd web
   

2. 根据需求修改源码（如需自定义功能）。
3. 生成包含子模块补丁的差异文件：

   bash
   git diff --submodule=diff > vaultwarden-patch.diff
   

4. 应用补丁并使用仓库脚本构建：参考 bw_web_builds 仓库 中的构建脚本执行构建。

在 Vaultwarden 中配置 Web Vault

将获取的 Web Vault 构建文件部署到 Vaultwarden 服务器的指定目录，具体步骤参考 Vaultwarden Wiki - Install the web-vault。

Docker 部署示例

通常需配合 Vaultwarden 主镜像使用，通过挂载 Web Vault 目录实现集成。示例 docker run 命令：

bash
docker run -d \
  --name vaultwarden \
  -v /path/to/web-vault:/vaultwarden/web-vault  # 挂载 Web Vault 目录  
  -p 80:80 \
  vaultwarden/server:latest

注：/path/to/web-vault 需替换为本地 Web Vault 构建文件的实际路径。

注意事项

• 本项目与 Bitwarden 及 8bit Solutions LLC 无关联，是非兼容实现。
• 构建过程中需确保正确处理 jslib 子模块的补丁，使用 git diff --submodule=diff 而非默认 git diff 以避免遗漏子模块差异。

许可信息

本项目基于 GPL-3.0 许可 开源。