网页密码库

对应的官方页面地址

要求

• 在开始之前，您必须已完成客户端存储库设置说明。

• 如果您想针对本地服务器实例进行开发，请参阅服务器设置指南。

SSL 证书

建议为本地开发生成有效的 SSL 证书，而不是使用共享的开发证书。这将防止浏览器发出无效证书的警告，并正确支持 WebAuthn，因为在证书出错的网站上，WebAuthn 会被阻止。请遵循 mkcert 安装说明。

# 生成并安装根 CA
mkcert --install

# 生成对 localhost、127.0.0.1 和 bitwarden.test 有效的证书
mkcert -cert-file dev-server.local.pem -key-file dev-server.local.pem localhost 127.0.0.1 bitwarden.test

构建说明

1、构建并运行 Web Vault。

cd apps/web
npm run build:oss:watch

以上针对本地 bitwarden 实例。关于如何针对官方服务器的信息，请参阅官方服务器。

2、打开浏览器并导航到 https://localhost:8080。您应该会看到 Bitwarden 登录界面。

3、如果您想更进一步，请启动本地服务器并设置好 MailCatcher。现在让我们创建一个账户并验证它。

• 创建一个新账户（这可以是一个假的邮箱）

• 登录新账户

• 点击「验证电子邮件地址」

• 导航至 http://localhost:1080/

• 打开无回复电子邮件然后验证您的电子邮件地址

您也可以使用 build:bit:selfhost:watch 和 build:os:selfhost:watch 命令在自托管模式下运行 Web Vault。

配置 API 端点

默认情况下，Web Vault 将使用您的本地开发服务器（运行在默认端口的 localhost 上）。您也可以改用官方的 Bitwarden 服务器或配置自定义端点。

官方服务器

要使用官方的 Bitwarden 服务器，请按照上面的构建说明进行操作，但使用以下命令运行 Web Vault：

ENV=cloud npm run build:oss:watch

自定义端点

您可以通过创建具有以下结构的 config/local.json 文件来手动设置 API 端点设置：

{
    "dev": {
        "proxyApi": "<http://your-api-url>",
        "proxyIdentity": "<http://your-identity-url>",
        "proxyEvents": "<http://your-events-url>",
        "proxyNotifications": "<http://your-notifications-url>",
        "allowedHosts": ["hostnames-to-allow-in-webpack"],
    },
    "urls": {

    }
}

• dev：来自前面的 /api -> <http://your-api-url> 的代理流量。

• urls：直接调用远程服务 注1。注意：这可能会导致 CORS 标头出现问题。

---

注1：urls：遵守 EnvironmentService 中的类型定义。