Vaultwarden Wiki 中文版
⮐ Vaultwarden Wiki个人主页联系我
  • 关于
  • 首页
  • FAQ
    • 1.FAQ
    • 2.审计
    • 故障排除
      • 1.Bitwarden Android 故障排除
  • 容器镜像的使用
    • 1.容器镜像的选择
    • 2.启动容器
    • 3.更新 Vaultwarden 镜像
    • 4.使用 Docker Compose
    • 5.使用 Podman
  • 部署
    • 1.构建您自己的镜像
    • 2.构建二进制
    • 3.预构建二进制
    • 4.第三方包
    • 5.部署示例
    • 6.代理示例
    • 7.转储示例
    • HTTPS
      • 1.启用 HTTPS
      • 2.使用 Let's Encrypt 证书运行私有 Vaultwarden 实例
  • 配置
    • 1.配置概述
    • 2.禁用新用户注册
    • 3.禁用邀请
    • 4.启用管理页面
    • 5.禁用管理令牌
    • 6.启用 WebSocket 通知
    • 7.启用移动客户端推送通知
    • 8.启用 U2F 和 FIDO2 WebAuthn 身份验证
    • 9.启用 YubiKey OTP 身份验证
    • 10.更改持久性数据位置
    • 11.更改 API 请求大小限制
    • 12.更改 worker 数量
    • 13.SMTP 配置
    • 14.显示密码提示
    • 15.禁用或覆盖密码库接口托管
    • 16.日志记录
    • 17.设置为 systemd 服务
    • 18.从 LDAP 同步用户
    • 19.使用备用基本目录(子目录/子路径)
    • 20.其他配置
    • *使用 systemd docker 运行
    • 数据库
      • 1.使用 MariaDB (MySQL) 后端
      • 2.使用 PostgreSQL 后端
      • 3.在未启用 WAL 的情况下运行
      • 4.从 MariaDB (MySQL) 迁移到 SQLite
    • 安全
      • 1.强化指南
      • 2.Fail2ban 设置
      • 3.Docker Traefik ModSecurity 设置
    • 其他
      • 1.翻译电子邮件模板
      • 2.翻译管理页面
      • 3.自定义 Vaultwarden CSS
  • 备份
    • 1.通用(非 docker)
  • 其他
    • 1.从 Keepass 或 KeepassX 导入数据
    • 2.备份您的密码库
    • 3.与上游 API 实现的区别
    • 4.支持上游的发展
    • 5.使用 Cloudflare DNS 的 Caddy 2.x
    • 6.Git hooks
    • *使用非 root 用户运行 docker 容器
    • *使私有 CA 和自签名证书兼容 Chrome
    • *测试 SSO
由 GitBook 提供支持
在本页
  • 通用
  • 首先尝试的事情
  • 安装 Android 调试工具 (adb)
  • 实际的调试
  • 获取更多详细信息
  • 分享结果
  1. FAQ
  2. 故障排除

1.Bitwarden Android 故障排除

上一页故障排除下一页容器镜像的使用

最后更新于14天前

对应的

通用

自从新的 Bitwarden 移动客户端发布以后,一些问题不断出现。这些问题主要是因为新客户端对服务器返回的 JSON 更加严格。

由于旧客户端不太严格,以及 Vaultwarden 没有(现在仍然没有完全)对所有客户端的输入进行筛选或纠正,以便在 Bitwarden 添加新功能时保持尽可能的灵活。有时存储的数据可能包含无效值。我们会尝试在同步过程中纠正所有这些项目,以尽可能修复所有旧的无效值,并相信客户端会发送正确的新数据。

由于我们无法知道任何客户端生成的所有无效数据,因此开发人员有时很难找出具体的问题所在。为此,我们需要社区的帮助来排查问题并找出罪魁祸首。

以下是一些故障排除指南,可以帮助您找到问题所在,从而自行修复,或帮助开发人员在服务器端修复。

首先尝试的事情

首先要确保客户端本地没有无效的缓存 JSON。这是在同步请求完成之前加载的,可能会导致我们无法在服务器端解决的问题。

  1. 确保安装了最新版本的 Android 客户端。查看已发布的版本:

  2. 从移动客户端注销

  3. 清除 Bitwarden App 的缓存和数据

  4. 卸载 Bitwarden App

  5. 为了确保彻底清除,请重启设备

  6. 重新安装 Bitwarden App

  7. 配置 App 以连接到您的自托管实例

  8. 登录并祈祷

如果上述步骤没有解决您的问题,那么可能 Vaultwarden 返回的数据还是存在问题。这种情况下,请继续以下步骤。

安装 Android 调试工具 (adb)

在实际安装工具之前,请先阅读与您的平台相关的所有内容,有时会有多种方法介绍,而第一种方法可能不是最简单的。

安装这些工具并能连接到您的手机后,继续下一步。

实际的调试

现在一切设置完成,我们开始提取日志,希望这些日志能够帮助追踪问题。

运行以下命令以仅显示 Bitwarden 客户端日志:

adb logcat --pid=$(adb shell pidof -s com.x8bit.bitwarden)

您可以通过按 ctrl+c(或 cmd+c)来退出 logcat。

如果您想在文件中记录所有内容,您至少可以在 Linux 使用如下的附加命令:

# 直接输出到文件:
> bitwarden-android.log
# 或者,输出到文件并同时输出到屏幕上:
> | tee -a bitwarden-android.log
# 完整的示例:
adb logcat --pid=$(adb shell pidof -s com.x8bit.bitwarden) > bitwarden-android.log
adb logcat --pid=$(adb shell pidof -s com.x8bit.bitwarden) | tee -a bitwarden-android.log

这应该会开始显示一些日志,如果是,请继续,如果没有,请检查错误信息并尝试解决问题。

现在,随着屏幕上的日志输出,请尝试触发客户端中的错误并检查输出。开发人员需要这些输出来找出问题所在。

获取更多详细信息

如果没有有用的输出,可以通过使用 Bitwarden Dev/Debug Android 客户端来获取更多详细信息。

基本上,任何成功的构建都应包含一个名为 com.x8bit.bitwarden.dev.apk 的工件文件。下载此文件,它是一个 zip 文件,解压该 zip 文件,然后安装解压后的 apk 文件。如果您的 Android 设备上有支持 zip 文件的文件管理器,您可以直接在设备上完成此操作。

或者,使用 adb 按如下方式安装:

adb install com.x8bit.bitwarden.dev.apk

完成此操作后,您就安装了一个额外的 Bitwarden 客户端,该客户端会输出更详细的日志。

按照您通常登录自托管实例的步骤进行操作。

要从该客户端提取日志,您需要稍微调整一下 logcat 命令,使其看起来像这样:

adb logcat --pid=$(adb shell pidof -s com.x8bit.bitwarden.dev)

这会提供更多详细信息,对于追踪问题将非常有帮助。

dev 客户端的输出包含由 Vaultwarden 服务器发送的响应,可能包含敏感数据!

虽然大多数项目都进行了加密,但一些项目如电子邮箱地址或您的 Vaultwarden 域名则没有加密!

请谨慎分享此输出!

虽然完整的输出对我们开发者非常有用,有助于故障排除,以及我们无法解密数据,但仍需小心!

分享结果

我们建议使用以下安全的方式之一分享这些文件:

  1. 通过您自托管的 Vaultwarden 的带有密码的 Send(使用 Matrix 或电子邮件分享)

大多数(并非全部)的 Android 设备都可以通过将设备连接到装有合适工具的计算机来提取设备日志。您可以在以下链接中找到各个平台的详细指南以了解如何安装这些工具:。

这些版本是通过 GitHub Actions 构建的,可以在以下链接找到:

( 推荐 )通过我们的 Matrix 聊天室:

通过电子邮件,发送到 ,以提供详细信息

如果您对此主题有任何疑问,请在我们的 上发起一个新的主题。

官方页面地址
https://github.com/bitwarden/android/releases
https://www.xda-developers.com/install-adb-windows-macos-linux/
https://github.com/bitwarden/android/actions/workflows/build.yml?query=is%3Asuccess