深度探索小众私人密码管理服务Passky：从Docker私有化部署到多平台客户端实战体验与避坑指南

密码管理软件领域已经涌现出众多知名产品，例如Bitwarden、1Password、LastPass等主流解决方案，但本文将聚焦于一款相对小众却功能完备的私人密码管理服务——Passky。尽管Passky在公众视野中的知名度较低，但它实际上已经发展成为一套成熟的密码管理生态系统，全面支持Windows、Mac、Android等操作系统平台，并且提供了浏览器扩展插件等多样化客户端选择。

接下来，我们将通过实际操作来全面体验Passky的各项功能特性。

Docker环境部署与配置

首先需要配置docker-compose.yml文件来定义服务组件：

services:  
  passky-server:  
    container_name: passky-server  
    image: 'rabbitcompany/passky-server:latest'  
    env_file:  
      - .env  
    ports:  
      - "3380:80"  
    volumes:  
      - "./data/web:/var/www/html/databases"  
    depends_on:  
      - redis  
      - mysql  
  
  redis:  
    image: redis:6.2-alpine  
    container_name: passky-redis  
  
  mysql:  
    image: mariadb:11.1.2  
    environment:  
      - MARIADB_USER=passky  
      - MARIADB_PASSWORD=passky  
      - MARIADB_DATABASE=passky  
      - MARIADB_ROOT_PASSWORD=passky4root  
    volumes:  
      - "./data/mysql:/var/lib/mysql"  
    ports:  
      - "13306:3306"  # 将数据库端口映射到主机

接着配置.env环境变量文件：

SERVER_CORES=4                    # 为Passky服务分配4个CPU核心
ADMIN_USERNAME="adminer"          # 设置管理员账户用户名
ADMIN_PASSWORD="adminer"          # 设置管理员账户密码
SERVER_LOCATION=CN                # 设置服务器地理位置
ACCOUNT_MAX=64                    # 配置最大用户账号数量
ACCOUNT_MAX_PASSWORDS=80000       # 设置每个账号支持的最大密码数量
ACCOUNT_PREMIUM=80000             # 高级账户密码数量限制
DATABASE_ENGINE=mysql             # 选择MySQL作为数据库引擎
DATABASE_FILE=                    # SQLite数据库文件路径留空
MYSQL_HOST="192.168.31.30"        # MySQL服务器主机地址
MYSQL_PORT=13306                  # MySQL服务端口号
MYSQL_DATABASE="passky"           # 使用的数据库名称
MYSQL_USER="passky"               # 数据库用户名
MYSQL_PASSWORD="passky"           # 数据库访问密码
MYSQL_SSL=false                   # 禁用SSL连接
MYSQL_CACHE_MODE=0                # 数据库缓存模式设置
MYSQL_SSL_CA=/etc/ssl/certs/ca-certificates.crt  # SSL证书路径
MAIL_ENABLED=false                # 禁用邮件功能
MAIL_HOST=                        # 邮件服务器地址
MAIL_PORT=465                     # 邮件服务器端口
MAIL_USERNAME=                    # 邮件账户用户名
MAIL_PASSWORD=                    # 邮件账户密码
MAIL_USE_TLS=true                 # 启用TLS加密
LIMITER_ENABLED=false             # 禁用API限制器
LIMITER_GET_INFO=-1               # 获取信息频率限制
LIMITER_GET_STATS=-1              # 获取统计信息限制
LIMITER_GET_TOKEN=3               # 获取令牌频率限制
LIMITER_GET_PASSWORDS=2           # 获取密码频率限制
LIMITER_SAVE_PASSWORD=2           # 保存密码频率限制
LIMITER_EDIT_PASSWORD=2           # 编辑密码频率限制
LIMITER_DELETE_PASSWORD=2         # 删除密码频率限制
LIMITER_DELETE_PASSWORDS=10       # 批量删除密码限制
LIMITER_CREATE_ACCOUNT=10         # 创建账户频率限制
LIMITER_DELETE_ACCOUNT=10         # 删除账户频率限制
LIMITER_IMPORT_PASSWORDS=10       # 导入密码频率限制
LIMITER_FORGOT_USERNAME=60        # 忘记用户名请求限制
LIMITER_ENABLE_2FA=10             # 启用双因素认证限制
LIMITER_DISABLE_2FA=10            # 禁用双因素认证限制
LIMITER_ADD_YUBIKEY=10            # 添加YubiKey限制
LIMITER_REMOVE_YUBIKEY=10         # 移除YubiKey限制
LIMITER_UPGRADE_ACCOUNT=10        # 升级账户限制
LIMITER_GET_REPORT=-1             # 获取报告限制
YUBI_CLOUD=https://api.yubico.com/wsapi/2.0/verify  # YubiCloud验证地址
YUBI_ID=67857                     # YubiKey标识符
CF_TURNSTILE_SITE_KEY=1x00000000000000000000AA        # Cloudflare站点密钥
CF_TURNSTILE_SECRET_KEY=1x0000000000000000000000000000000AA  # Cloudflare密钥
REDIS_HOST=redis                  # Redis服务器主机名
REDIS_PORT=6379                   # Redis服务端口
REDIS_PASSWORD=                   # Redis认证密码
REDIS_LOCAL_HOST=redis            # 本地Redis主机
REDIS_LOCAL_PORT=6379             # 本地Redis端口
REDIS_LOCAL_PASSWORD=             # 本地Redis密码

在启动服务之前，有必要分享一些实际部署过程中遇到的挑战与解决方案：

官方文档声称支持SQLite数据库，但实际上该功能并未完全实现，通过深入研究官方代码仓库的问题反馈，发现没有任何成功使用SQLite的实际案例
连接MySQL数据库时，无法通过Docker Compose的链接机制直接建立连接，必须填写NAS设备的物理IP地址，并且需要将MySQL服务端口明确映射到主机

现在可以通过执行命令docker compose up -d启动所有服务组件，然后在浏览器中访问http://<nas-ip>:3380进入Passky管理界面。