飞牛NAS部署Password-XL:搭建自托管Web密码管理器

前言

账号越来越多以后，只靠记忆、便签或者重复使用几个常见密码，很快就会变得难以管理。密码管理器的价值就在于把这些账号凭据集中保存，再用一个独立的主密码保护密码库。

除了使用托管式密码管理服务，也可以把密码管理程序运行在自己管理的NAS或服务器中。这样做的主要区别不是"天然更加安全"，而是数据保存、服务更新、备份和网络访问这些环节都由自己负责。

本文会在飞牛NAS中通过Docker Compose部署Password-XL，分别启动Web前端和后端服务，配置私有服务账号，再通过浏览器设置密码库的主密码并实际保存一条密码记录。

由于密码管理器保存的是高度敏感信息，部署时需要特别区分服务登录密码和密码库主密码，并确认数据目录能够正确持久化。本文中的示例账号和密码只应用于演示，实际环境应使用独立的强随机凭据。

最后还会通过cpolar为Password-XL建立公网访问入口，用来测试从其他网络打开自己的密码管理页面。公网访问会扩大服务攻击面，因此远程使用前仍应确认前后端访问链路、HTTPS以及应用自身的身份认证是否配置正确。

1.Password-XL是什么？

Password-XL是一款开源、轻量、自托管的Web密码管理器，专为注重隐私与安全的个人用户和家庭设计。它让你无需依赖Password、Bitwarden等第三方云服务，即可在本地（如NAS、树莓派或私有服务器）搭建属于自己的密码保险箱。

核心特性：

完全自托管：所有数据存储在你自己的设备上，不上传、不共享、不追踪。
端到端加密：支持主密码加密，即使数据库泄露，密码也无法被读取。
简洁直观的Web界面：响应式设计，手机、平板、电脑均可流畅访问。
多平台同步：通过内网或内网穿透（如cpolar），实现跨设备安全访问。
开源免费：代码公开透明，社区驱动，无隐藏收费。
Docker一键部署：轻松集成到NAS（如群晖、TrueNAS）或Linux服务器。

2.在飞牛OS上部署Password-XL

打开文件管理，创建一个docker文件（我是用来存放docker部署的应用）：

右键点击，选择"详细信息"：

复制它的原始路径：

打开飞牛NAS的系统设置--SSH--SSH功能--启用：

使用终端软件通过SSH连接到NAS，并切换到root状态下。
进入到上面复制的文件路径。

shell 复制代码

# 将 /vol1/1000/docker 换成你实际的文件夹路径
cd /vol1/1000/docker

创建并进入项目文件夹

shell 复制代码

mkdir password-xl && cd password-xl

创建子文件夹

shell 复制代码

mkdir -p password-xl-service/password-xl-data

进入后端服务文件夹

shell 复制代码

cd password-xl-service

创建用户列表文件

shell 复制代码

vi password-xl.toml

按需修改下面的模板代码，需要多少用户就创建多少个。

shell 复制代码

[[user]]
username = "u1"
password = "123456"
[[user]]
username = "u2"
password = "123455"

返回上一层文件夹路径

shell 复制代码

cd ..

编辑docker-compose.yml项目文件

shell 复制代码

vi docker-compose.yml

shell 复制代码

services:
  password-xl-web:
    image: huangypeng/password-xl-web
    container_name: password-xl-web
    restart: unless-stopped
    ports:
      - "8080:80"    # 左侧的8080前端端口可自由修改
  password-xl-service:
    image: huangypeng/password-xl-service
    container_name: password-xl-service
    restart: unless-stopped
    ports:
      - "8081:8080"    # 左侧的8081后端端口可自由修改
    volumes:
      - ./password-xl-service:/password-xl-service