必须手动配置客户端服务地址为自建HTTPS域名,否则默认连接官方服务器;网页/桌面端在“设置→账户→服务器URL”填写完整地址并保存,浏览器插件需勾选“使用自定义服务器”并重载,移动端在登录页三点菜单中设置自定义服务器并等待绿色对勾确认。

要让Bitwarden客户端连接到你自建的Vaultwarden服务器,必须在客户端中手动填写正确的服务地址,否则它默认连官方服务器,所有密码都会上传到别人家的数据库里。
网页端与桌面客户端设置
打开Bitwarden官网下载页,安装Windows/macOS/Linux客户端或访问web.bitwarden.com(注意:不是你自己的域名)→ 启动客户端 → 点击左上角「设置」→「账户」→「服务器 URL」→ 删除默认内容 → 输入你部署好的完整HTTPS地址,例如 【https://vault.yourdomain.com】 → 按回车确认。
这一步输错会导致登录界面直接报“无法连接到服务器”,且错误提示不明确。务必核对大小写、协议头(https://)、域名拼写,少一个字符都不行。
输入后点击「保存」,客户端会自动退出当前会话。重新登录时,页面顶部会显示“使用自托管服务器”标识,说明已切换成功。
浏览器插件连接配置
以Chrome/Firefox/Edge浏览器为例:右键点击Bitwarden插件图标 →「选项」→「服务器」→ 勾选「使用自定义服务器」→ 在「服务器 URL」栏粘贴你的HTTPS地址,比如 【https://vault.yourdomain.com】 → 滚动到底部点击「保存设置」。
插件不会立即生效,需关闭所有浏览器窗口再重开,或右键插件图标选择「重新加载扩展」。若仍连不上官方服务器,请检查浏览器控制台(F12 → Console)是否有CORS或证书错误——这通常意味着反向代理未正确转发X-Forwarded-Proto头。
移动端App配置流程
第一步:在iOS App Store或Android Google Play搜索并安装官方Bitwarden应用(非第三方);
第二步:打开App → 点击「创建账户」或「登录」→ 在登录页右上角找到三个点(⋯)→「设置」→「服务器」→「自定义服务器」→ 输入你的完整HTTPS地址;
第三步:返回登录页,此时邮箱和密码框下方会出现灰色文字“正在连接到 vault.yourdomain.com”,等待3秒左右出现绿色对勾,表示连接就绪;
第四步:输入你在自建服务器上注册的账号密码,完成登录。若卡在“验证中”超过10秒,大概率是手机网络未走内网DNS,或你用的是IP直连但未配置自签名证书信任链。


















