1.FAQ

对应的官方页面地址

Vaultwarden 是否与 Bitwarden 项目或 Bitwarden, Inc 有关联？

简短的回答，没有。两个项目的开发人员之间有时会有联系，但没有合作。除此之外，Vaultwarden 项目仅使用 Bitwarden, Inc 提供的 Web Vault 并打了一些补丁，以使其与我们的实现兼容。

我发现了一个 Vaultwarden 公共实例。它与这个项目有关吗？使用它安全吗？

本项目不托管任何公共 Vaultwarden 实例，我们也不提倡使用任何此类网站。参见 #3233 #4142 #4367

我的 Bitwarden 客户端有问题，我需要在哪里报告这问题？

如果您使用 Vaultwarden 作为任何官方 Bitwarden 客户端的服务器，您将无法在 Bitwarden 报告此问题，因为他们一看到您使用 Vaultwarden 就会关闭该问题，这确实是合理的做法。

要确定问题是服务器端还是客户端，请阅读以下 wiki 页面，以帮助 Vaultwarden 和 Bitwarden 确定问题以及在哪里和如何报告问题。

https://github.com/dani-garcia/vaultwarden/wiki/Bitwarden-clients-troubleshooting

我对 web-vault（或任何其他客户端）有一个功能请求

不幸的是我们不能在这里提供帮助。Vaultwarden 项目没有，也可能永远不会开发自定义客户端。我们尝试尽可能接近上游客户端的工作方式，并且由于我们只能向 web-vault 添加一些内容，这甚至可能会破坏其他客户端或导致与上游 web-vault 保持最新状态的问题。因此，我们不会向 Vaultwarden 添加任何需要在客户端处理的特殊或独特功能。

Vaultwarden 的下一个版本是什么时候？您能给出一个 ETA 吗？

Vaultwarden 没有发布时间表。如果维护者有时间并认为有必要发布新版本，那么可以立即发布，但鉴于这是一个由人们利用业余时间完成的项目，下一次发布可能需要几周甚至几个月的时间。

如果您「希望尽早获得最新功能、增强功能或错误修复」，您可以随时改用测试镜像，它总是基于最新的提交。参见容器镜像的选择。

[译者注]：ETA：Estimated Time of Arrival。在软件开发和日常交流中，它不再仅仅指「预计到达时间」，而是被广泛引申为「预计完成时间」或「预计发布日期」。

Vaultwarden 能连接到 Oracle MySQL V8.x 数据库吗？

在使用 Oracle MySQL v8.x 时，当您试图启动 Vaultwarden，可能会出现以下警告：

[vaultwarden::util][WARN] Can't connect to database, retrying: DieselConError.
[CAUSE] BadConnection(
    "Authentication plugin \'caching_sha2_password\' cannot be loaded: /usr/lib/x86_64-linux-gnu/mariadb18/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory",
)

默认情况下，Oracle MySQL v8.x 使用更安全的密码散列方法，这是好事，但我们的构建目前不支持它。

您需要以一种特定的方法创建 Vaultwarden 用户，以便它能使用旧的原生密码散列：

-- 在 MySQLv8 安装上使用此命令
CREATE USER 'vaultwarden'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpassword';

如果您已经创建了用户，并且只想更改散列方法，请使用以下命令：

-- 将密码类型从 caching_sha2_password 更改为 native
ALTER USER 'vaultwarden'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpassword';

另外可参阅：使用 MariaDB - 创建数据库和用户

客户端（桌面端、移动端、网页端）无法正常工作，无法登录或提示证书无效。

Bitwarden 客户端需要一个安全的连接，才能正常工作且没有任何问题。虽然某些客户端也可以在没有安全连接的情况下工作，但我们并不推荐这样做。

大多数时候，当人们使用证书时仍然有问题，是因为他们使用的是所谓的自签名证书。虽然这些证书可以提供安全连接，但一些平台不允许或不支持它。

我们建议使用诸如 Let's Encrypt 这样的服务来提供一个有效的、被大多数设备默认接受的证书。请参阅以下页面：

• 启用 HTTPS

• 使用 Let's Encrypt 证书运行私有 Vaultwarden 实例

为什么我密码库的所有项目都看不到图标？

没有显示图标的原因有很多种。如果只是某几个密码库项目，可能是我们无法提取它。有些网站启用了一些保护措施，导致我们的实施失败。他们中的大多数需要 Javascript 才能工作。

这也可能是 Vaultwarden 服务器无法访问互联网或未解决 DNS 查询所致。您可以检查 /admin/diagnostics 页面（参阅启用管理页面），看看您是否能解决 DNS 查询以及是否有连接到互联网。如果都没问题，也有可能是防火墙或外发互联网代理阻止了这些请求。

Websocket 连接显示错误的 IP 地址。

这不是我们可以解决的问题。我们使用的库不支持任何形式的 X-Forwarded-For 或 Forward 标头。

它会始终显示所使用的反向代理的 IP，除非您在没有任何代理的情况下直接运行 Vaultwarden，或者运行透明代理，这可能会让它显示正确的 IP。这不是一个重要的日志记录部分，并且如果您使用反向代理，您可能还可以在其日志中看到此请求，该请求具有正确的 IP。

为什么 Vaultwarden 会提示 [INFO] No .env file found。即使我已经提供了一个？

启动时，Vaultwarden 将检查进程的当前工作目录中是否存在名为 .env 的文件（如果未通过环境变量 ENV_FILE 更改）。如果您没有提供此文件，Vaultwarden 将简单地通知您它没有找到它。此文件与您提供给 docker 的用于在创建容器时加载环境变量的 env 文件无关，也与在 systemd .service 中使用的环境文件无关。

可以将 Vaultwarden 作为 Azure WebApp 运行吗？

不幸的是，Azure WebApp 使用 CIFS/Samba 作为卷存储，而 CIFS/Samba 不支持锁定。这导致 Vaultwarden 不能使用 SQLite 数据库文件。

有两种解决方式：

1. 不要使用 SQLite，改为使用 MariaDB/MySQL 或 Posgresql 作为数据库后端。

2. 尝试将 ENABLE_DB_WAL 环境变量的值设置为 false 以禁用 WAL。这需要在一个新的文件上完成，所以您需要移除之前创建的 db.sqlite3 文件，并再次重启 Vaultwarden 应用程序。

我在 FAQ 中找不到答案，下一步该怎么做？

请尝试在我们精彩的 Wiki 中搜索和点击。如果这对您没有帮助，请尝试查看 Github 讨论或 Vaultwarden 论坛。如果这也没有解决，您可以尝试搜索开放的和已关闭的话题。

如果您仍然没有找到答案，您可以在 Github 讨论或 Vaultwarden 论坛上发起一个主题，或者加入我们的聊天室。