使用文档
使用方式与客户端

Web 在线使用(推荐)

打开浏览器即可管理密码,支持官方在线工具和私有部署

电脑和手机都可以通过浏览器使用 password-XL,无需安装客户端

使用官方在线工具

  1. 打开 password-xl.cn,建议将网址加入书签
  2. 选择自己的存储方式:阿里云 OSS、腾讯云 COS、私有服务或本地存储。第一次配置云存储时,先阅读存储配置
  3. 填写所选存储的连接信息,点击登录
  4. 空密码库按提示设置主密码;已有密码库输入原来的主密码
  5. 点击“添加”,保存第一条账号。随后可以通过搜索、标签与收藏找到它

官方在线工具提供操作页面;密码保存在你连接的存储中。更换设备后连接同一存储,并用同一主密码解锁,即可继续使用

使用自己部署的 Web 页面

如果希望在 NAS 或服务器上同时运行页面和存储服务,按 Docker 部署教程启动整合镜像

  1. 在浏览器访问 http://你的服务器IP:9080,例如 http://192.168.1.20:9080
  2. 选择“私有服务”,填写自己的服务地址和登录账号。初始账号信息可在容器日志中查看
  3. 登录后设置或输入主密码,就可以添加和管理密码
  4. 手机与服务器连接同一局域网时,打开相同网址即可访问
私有服务登录:填写自己的服务地址和账号
私有服务登录表单中的本地演示服务和 showcase 用户名

私有服务登录:填写自己的服务地址和账号

需要远程访问时,请阅读 HTTPS 与反向代理,使用可信网络或独立认证网关保护服务

在手机上使用

打开官方在线工具或自己的部署地址,连接 OSS、COS 或私有服务。页面会按手机屏幕调整布局,支持搜索、编辑、复制和锁定

手机浏览器中的密码列表
password-XL 移动视口中的卡片布局

手机浏览器中的密码列表

浏览器本地存储

桌面版 Chrome、Edge 支持创建或打开本地密码文件。选择“本地存储”,按提示选择文件并允许读写。下次使用时,打开同一文件并输入主密码

本地文件不会自动同步到其他设备。手机浏览器、Firefox、Safari 可能不支持这一文件选择流程,可使用 OSS、COS 或私有服务。操作时请使用 HTTPS 页面,或在本机通过 localhost 访问

连接私有服务失败

HTTPS 页面连接 HTTP 服务时,浏览器可能拦截请求。请直接使用私有服务自带的页面,或为服务配置 HTTPS。跨域连接还需要正确配置允许来源,详见故障排查

更新与退出

Web 页面无需手动下载安装更新。保存当前编辑后,刷新页面或关闭旧标签页再打开即可

共享电脑使用后锁定密码库并退出登录,不要保存自动登录链接。清理浏览器数据可能清除登录信息,但不会替你保管主密码