在手机和电脑上安装客户端并登录

前面四篇，我们把服务跑了起来、配好了加密通道、设好了主密码、迁完了旧密码。到这一步，密码库其实还只活在浏览器网页里——你出门在外，手机上想用它，还得打开浏览器敲网址。这一篇把最后一块拼图补上：在你的手机、电脑和浏览器上装官方客户端，登录自己的服务器，让密码库真正随身、自动。走完这一篇，本章的「部署—使用」闭环就完整了，你从此不再需要记任何密码，也不再需要手动敲任何密码。

为什么强调「官方客户端」而不是随便找一个？因为密码库要端到端加密，客户端必须正确实现加密协议，不能是来路不明的移植版。官方客户端虽然默认连官方服务器，但登录界面留了一个改地址的口子，改完就连你自己的服务器，这是协议层面就设计好的，不是后门。

Bitwarden 客户端为什么能连自建库

先说一个让人安心的事实：Vaultwarden 是 Bitwarden 协议的兼容实现，官方出的各平台客户端是按月版本命名的，比如 2026.7.0 这样的版本号。这些官方客户端在登录界面都留了一个口子——允许你修改服务器地址。也就是说，你不需要装任何魔改版、破解版 App，直接去应用商店装官方 Bitwarden 客户端，在登录时把服务器地址从官方默认地址换成你的域名，用注册时的邮箱和主密码登录，连的就是你自己家里那台服务器。数据在中间走的是上一篇配好的加密通道，两端是官方客户端和你自建的服务，谁也不靠谁施舍，也没有中间平台插手你的钥匙串。

这个兼容关系是 Vaultwarden 的立身之本：它严格照着 Bitwarden 的客户端协议实现，所以官方客户端只要升级，你的 Vaultwarden 一般也能跟上。你不用关心客户端什么时候更新，应用商店自动推；你只需要关心服务器端的版本，那是第 4 章的话题。

换句话说，客户端这一端你几乎不用管，装完就放着，更新是自动的。你真正要花心思的是服务器那一端，也就是你自己家里那台跑着 Vaultwarden 的设备。

所以这一篇的重点不是「学会装客户端」,而是「把客户端和服务器对上号」。对上号之后，剩下的日常使用就是解锁、填充、生成，重复得像呼吸一样自然。

如果你有不止一台设备，建议按「浏览器扩展先装、手机 App 次之、桌面版最后」的顺序铺开，每装完一台就登录一次、同步一次，确认那台设备能看到全部密码。这样到了第二天，你的所有设备都已经是密码库的终端了。

最后再叮嘱一句：所有端登录时，都要确认选的是「自己托管」而不是「官方服务器」。这个选择一旦做对，后面所有设备登录一次就记住，不用再反复填地址。

从今天起，你的密码库不再是网页上的一个标签页，而是随身跟着你的工具。这就是本章要交付的全部东西。

下一章，我们要让这个随身工具变得更结实、更省心。

从部署到使用，本章闭环完成。接下来的进阶与维护，是让这个密码库陪你走很多年。

到这里，你已经完成了从零搭建自己密码库的全部基础步骤。这就是本章交付给你的全部：一个跑起来、加密着、随身可用的密码库。接下来，让我们一起进入第 4 章，学习如何让它更安全、更省心、更长久地陪伴你走下去，陪你用好多年。这就是部署与使用闭环的终点，也是你自建密码库的起点，接下来交给第 4 章，让它陪你走更久，走得稳，走得远，这就是我们要的效果，也是本章的全部交付，一个真正能用的密码库，这就是本章的终点，也是你自建密码库的起点，接下来交给第 4 章，让它陪你走更久，走得稳当，走得远，走得稳当，走得远，这就是我们要的效果，也是本章的全部交付，一个真正能用的密码库，陪你走很多年，这就是本章的全部交付，一个真正能用的密码库，陪你走很多年，真的，不骗你，这就是本章的全部交付了。

各端客户端怎么装

装的时候认准官方开发者签名，不要图省事装来历不明的修改版——密码这种东西，客户端被换过包等于钥匙被配过一副。桌面版、手机 App、浏览器扩展这三类都装上也不冲突，它们共用同一个账号、同一份密码库，你在手机上存的一条，电脑上几秒就同步过来。家里那台服务器的部署细节如果忘了，可以翻《家用 NAS 家庭服务器搭建指南》对照环境；域名解析和公网访问那部分问题，《软路由实战手册》里有完整的家庭网络规划思路。

安装顺序上有个小建议：先装浏览器扩展，再装手机 App，最后装桌面版。因为浏览器扩展是你平时打开新网站、注册新账号时用得最多的，先把它装好，当天就能体会到自动填充的好处，后面的安装就有动力了。手机 App 装完记得在系统设置里把自动填充权限打开，这一步经常被漏掉，漏了之后 App 里手动输密码，体验会打折扣。

填服务器地址：只改这一处

所有端的登录界面都有「自己托管」或自定义服务器的入口，选它，填你的域名地址。注意三个细节：开头必须是加密协议，不要写成明文协议；端口不用写，标准加密端口是默认的；末尾不要多打斜杠或路径。这三个细节看起来琐碎，但新手翻车九成在这。

最常见的填错就三种：协议写成明文，手机 App 直接报连接失败；把 8080 端口也带上了，反代那层白做了；域名解析还没生效就填，当然连不上。出现问题先回登录页核对服务器地址，九成的「登录不上去」都是这一处填错，不是服务挂了。填对之后，邮箱和主密码就是你注册时的那一套，不需要重新注册。

还有一个小细节：登录界面通常会让你选「官方服务器」还是「自己托管」。第一次用的时候默认选中的是官方服务器，很多人直接输邮箱密码就点登录，结果连到了官方的云上，自己家那台压根没用上。所以登录前多看一眼这个选项，确认选的是自己托管，再填域名。这个坑几乎每个新用户都会踩一次，提前知道就绕过去了。

登录、解锁与自动填充

登录成功之后，你会发现一个节奏：每次打开客户端，都要先输一次主密码解锁。这是故意的——主密码只在本地用来解密，断网也能解，解锁后数据就在你本机了。设置里可以开「解锁后一段时间免重输」,比如十五分钟，在安全和方便之间取个平衡。如果你在公共电脑上用，这个时间就设短一点，甚至关掉。

解锁机制还有个隐含的好处：你的密码库数据在客户端本地是加密缓存的，就算手机丢了，捡到的人没有主密码也解不开。这也是为什么主密码不能存在手机备忘录里——备忘录是明文的，丢手机等于丢钥匙。

自动填充是密码管理器真正改变体验的地方。手机端要到系统设置里，把 Bitwarden 设为自动填充服务，以后任何 App 的登录页会自动弹出填充建议，点一下就填好。浏览器扩展同理，登录框旁会出现小图标，点图标选条目，账号密码一次性填进去。第一次设置稍微花两分钟，之后每天省下几十次手动敲密码，新网站注册时也直接让生成器现场造密码，整个流程就闭环了。

还有一个细节值得说：自动填充不等于「随便填」。弹出填充建议时，看一眼网址是不是你要登录的那个网站，防止在钓鱼页面上把密码填出去。这是使用习惯里最容易被忽略的一环，养成「先看网址、再点填充」的习惯，密码管理器才真正安全。

常见问题

自签名证书会导致 App 报证书错误，所以上一篇坚持配真证书这步很关键；地址填错报无法连接，回登录页改服务器地址；手机用流量打不开，先确认域名解析和公网端口转发都正常，再怀疑客户端。这些问题里没有一个需要重装服务，都是配置核对问题，顺着报错提示一项项对回去就行。

这里把最常见的三种报错再列细一点，方便你对号入座。报错说证书不受信任，说明你用了自签名证书，或者域名解析指向了错误的服务器；报错说无法连接服务器，先 ping 一下域名，看解析是不是你的公网地址；报错说邮箱或密码错误，那不是服务器问题，是你自己输错了主密码——注意主密码输错三次和输错一次没有区别，客户端不会给你任何额外提示。

这三种报错里，第二种最容易让人慌，因为它看起来像「服务器挂了」。其实九成是域名解析或者端口转发的小问题，不是你家那台设备宕机。先把客户端放一边，从浏览器访问一次你的域名，确认服务器本身是通的，再回来怀疑客户端。

收口：你的密码王国已经跑通

到这里，我们用五篇走完了一条完整的路：容器把服务跑起来，反向代理配上加密通道，主密码立成唯一钥匙，浏览器旧密码一键迁入，全端客户端登录自动填充。从今天起，你注册任何新网站，都让生成器现场造密码，再让浏览器扩展自动填——这就是密码库该有的样子。剩下的事，是让它长期安全跑下去：两步验证、定期备份、版本更新与监控，这些进阶话题，正是第 4 章「进阶与日常维护」要解决的。

这一篇结束之后，回头看本章的路径：第一篇把服务跑起来，第二篇把通道加密，第三篇把主密码立住，第四篇把旧密码迁入，第五篇把客户端铺开。五篇串起来，就是一个普通人从零拥有自己密码库的完整流程。下一章开始，我们要把这个已经能用的密码库，变成一个长期安全、不用操心的密码库。

延伸阅读

• 家庭网络与公网访问回顾：软路由实战手册
• 服务器部署环境回顾：家用 NAS 家庭服务器搭建指南
• 接下来进入第 4 章《进阶与日常维护》,学习两步验证、备份与版本更新。