在不设置 SMTP 的情况下修改 Vaultwarden(Bitwarden) 的账户邮箱 | O's World

Vaultwarden 更改登录邮箱时，默认需要向新邮箱发送验证码进行验证，如果没配置 SMTP，验证码不会真正发出。但在 LOG_LEVEL=debug 时会把验证码打印到日志里。如果你也只是个人使用，且不想设置 SMTP，可以查看下面的方法获取验证码，完成修改。

本教程适用于使用 Docker 部署的 Vaultwarden

更改账户邮箱会导致所有会话失效，需要重新登录

1. 临时开启 debug 日志

Docker Compose 里给 vaultwarden 加上：

environment:
  LOG_LEVEL: debug
  EXTENDED_LOGGING: "true"

然后重启：

docker compose up -d

如果你是 docker run ，加：

-e LOG_LEVEL=debug \
-e EXTENDED_LOGGING=true \

2. 重新触发一次“更改邮箱”

在网页端再次提交更改邮箱，让 Vaultwarden 重新生成验证码。

3. 查看 Docker 日志

容器名如果叫 vaultwarden ：

docker logs vaultwarden 2>&1 | grep -i "email"

输出的日志大概会是类似：

...[vaultwarden::api::core::accounts][DEBUG] Email change ... email (...) with token (123456)

日志末尾括号中的六位数字，就是需要填写的验证码。

4. 完成后改回正常日志级别

查到验证码并完成更改后，建议改回：

LOG_LEVEL: info

或：

LOG_LEVEL: warn

然后重启。 debug 日志可能暴露敏感信息，不建议长期打开。

5. 长期建议：配置 SMTP

如果以后还会用邮箱验证、邀请、2FA 邮件等功能，最好配置 SMTP。 Vaultwarden 常用的 SMTP 配置项包括：

SMTP_HOST: smtp.example.com
SMTP_FROM: [email protected]
SMTP_PORT: 587
SMTP_SECURITY: starttls
SMTP_USERNAME: [email protected]
SMTP_PASSWORD: your_password