使用文档

快速开始

选择平台和存储,设置主密码,保存并找回第一条账号

1. 选择使用方式

  • 在线使用(推荐):打开 password-xl.cn,连接自己的存储,即可日常管理密码。详细步骤见 Web 在线使用
  • 私有部署:使用 Docker 整合镜像在 NAS 或服务器上运行,通过浏览器访问自己的密码库。无需另外部署前端或数据库

2. 连接存储

方式适合需要准备
浏览器本地在桌面浏览器中读写本地文件桌面 Chrome / Edge、本地文件授权
OSS / COS多设备使用同一份数据自己的私有存储桶、专用子账号、跨域规则
私有服务NAS 或服务器上保存数据服务地址、服务用户名、登录密码

详细能力差异见存储选择。本地存储不会自动同步到手机

如果你使用私有服务,在登录页选择“私有服务”,填入服务地址、用户名和登录密码。示例中的 showcase 仅是教程演示账号;你的 Docker 初始账号应从自己的容器日志获取

私有服务登录示例:使用自己的服务地址与账号
私有服务登录表单中的本地演示服务和 showcase 用户名

私有服务登录示例:使用自己的服务地址与账号

登录成功后可能显示自动登录链接。该链接携带可恢复的登录信息,应像凭据一样保管,不要发送给他人或放入截图

3. 设置主密码

第一次打开空密码库时,按页面提示设置主密码并确认。已有密码库会要求输入原来的主密码

选择自己能够长期保管的高强度口令,避免重复使用其他网站密码。把主密码保存在独立、安全的位置。更换设备时,仍需它来解锁同一份密码库

4. 保存第一条账号

  1. 解锁后点击右上角“添加”
  2. 填写名称,例如“团队协作 · 工作账号”
  3. 填写地址、用户名和密码。需要新密码时,可在密码生成器中选择字符规则和长度
  4. 选择标签,补充备注。恢复码、所属项目等信息可放入自定义字段
  5. 点击“保存”,等待成功提示,再确认列表中出现刚添加的记录
编辑密码时可以添加自定义字段,敏感字段可设为密码类型
真实密码编辑表单,包括恢复码和所属项目自定义字段

编辑密码时可以添加自定义字段,敏感字段可设为密码类型

5. 搜索、复制和锁定

在搜索框输入名称或用户名。找到记录后,用复制按钮复制所需字段。离开设备前点击锁定按钮;再次使用时输入主密码解锁

先用一条无关紧要的测试记录练习:保存后退出、重新登录和解锁,确认它仍然存在。然后到“设置 → 备份恢复”创建第一次 JSON 备份

下一步

继续阅读日常使用备份与恢复。连接失败时按排障指南检查,不要反复创建新的空密码库覆盖原数据