Bitwarden Helm Chart部署后无法注册用户及邮件发送问题求助

首先明确：Bitwarden自部署环境必须先通过命令行创建初始管理员用户，Web端默认仅开放登录入口，无法直接注册。以下是可进一步排查的日志及操作方向：

1. 核心服务的完整日志 #

用户创建、邮件发送的核心逻辑由api和identity Pod处理，需重点查看这两个服务的全量日志：

• 查看api Pod日志：

  kubectl logs -n <你的命名空间> -l app.kubernetes.io/name=api --all-containers=true --tail=-1
  

• 查看identity Pod日志：

  kubectl logs -n <你的命名空间> -l app.kubernetes.io/name=identity --all-containers=true --tail=-1
  

即使表面无错误，这类日志也可能包含邮件发送、用户请求处理的隐性细节。

2. 邮件服务专属日志 #

Bitwarden的mail Pod负责邮件队列处理，需检查其完整运行日志：

kubectl logs -n <你的命名空间> -l app.kubernetes.io/name=mail --all-containers=true --tail=-1

这里会记录SMTP握手细节、邮件队列状态，比如是否存在认证失败、邮件被服务商隐性拒绝的信息。

3. 启用调试级日志 #

默认部署的日志级别为Info，无法捕捉细节问题，可通过修改Helm values提升日志级别：
在values.yaml中添加或修改：

api:
  env:
    - name: ASPNETCORE_ENVIRONMENT
      value: Development
identity:
  env:
    - name: ASPNETCORE_ENVIRONMENT
      value: Development
mail:
  env:
    - name: ASPNETCORE_ENVIRONMENT
      value: Development

重新部署：

helm upgrade bitwarden bitwarden/bitwarden -n <你的命名空间> -f values.yaml

调试模式会输出更详细的流程日志，包括邮件发送的每一步调用细节。

4. 数据库直接验证 #

若日志无异常，可查询Bitwarden数据库（默认是mssql Pod）确认用户请求是否落地：

• 进入mssql Pod：

  kubectl exec -n <你的命名空间> -it <mssql-pod名称> -- /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P <你的sa密码>
  

• 查询用户表：

  USE Bitwarden;
  SELECT * FROM dbo.[User];
  

若无用户记录，说明请求未到达数据库，问题出在api/identity服务逻辑；若有记录但未发邮件，需排查mail服务或SMTP配置的隐性问题（比如Office365要求发件人与SMTP用户名一致）。

补充：初始用户创建步骤 #

Bitwarden自部署必须先创建第一个管理员用户，操作如下：

• 进入api Pod：

  kubectl exec -n <你的命名空间> -it <api-pod名称> -- /bin/bash
  

• 执行创建命令：

  dotnet Bitwarden.Api.dll admin user create <你的邮箱> <你的密码>
  

创建成功后即可在Web端登录。

内容的提问来源于stack exchange，提问作者mohab