主机资讯与使用指南
Vaultwarden 客户端连接教程:浏览器、手机与同步
将 Bitwarden 浏览器扩展、手机和桌面客户端连接到自建 Vaultwarden,设置服务器地址并检查同步。
服务器地址是自己的 HTTPS 域名
已经部署 Vaultwarden 后,客户端使用 Bitwarden 应用,在登录前选择自建服务器地址。邮箱相同不代表云端与自建服务共享账号。
先在浏览器打开自建 HTTPS 域名,确认 Web Vault 可以登录。证书不受信任或域名打不开时,先修服务入口,再配置客户端。
浏览器扩展选择自建环境
打开 Bitwarden 扩展,在登录前的服务器或环境选项中选择 Self-hosted。填写自己的完整服务地址,例如 https://vault.example.com,保存后再输入该实例的账号。
不同客户端版本入口位置可能不同,但要修改的是服务器环境,不是某条密码记录的网站 URL。无法切换时先退出登录回到初始页。
手机和桌面使用相同地址
在手机或桌面应用登录页选择自建环境,填写与浏览器相同的 HTTPS 地址。先使用自建服务中已经创建的账号登录,再启用需要的解锁方式。
如果手机可以打开网页却不能登录,检查是否填了多余路径、地址是否发生跳转,以及客户端与服务端版本兼容。
用一条记录检查同步
在一个客户端新增一条用于测试的记录,在另一个客户端执行同步并查看。修改后再同步一次,确认双向更新。
只看到本地缓存不能说明服务器连接正常。出现失败时看客户端提示和 Vaultwarden 日志,检查域名、证书、代理与服务器状态。
迁移服务地址与保存数据
换域名后先让服务的新地址正常工作,再逐个客户端修改自建环境并登录。不要为了登录云端而把旧自建服务数据删除。
数据库和附件等数据保存在原部署的持久化目录。导出文件按其格式妥善保存,不把未加密的密码导出当作普通公开文件。