elestio/password-pusher

Password Pusher（由Elestio验证和打包）

https://github.com/pglombardo/PasswordPusher 是一个开源应用，用于通过网络传输密码。密码链接会在特定查看次数和/或时间过后过期。

!https://github.com/elestio-examples/password-pusher/raw/main/password-pusher.png

镜像概述和主要用途

Password Pusher 旨在安全地通过网络共享密码，解决传统密码传输方式（如邮件、即时消息）的安全隐患。其核心机制是生成临时密码链接，通过设置查看次数限制和时间有效期，确保密码仅被授权接收者短暂访问后即失效，有效降低密码泄露风险。

核心功能和特性

Password Pusher 核心功能

• 自动过期机制：密码链接可设置基于查看次数（如1次、5次）或时间（如1小时、1天）的过期规则
• 开源透明：源代码完全开放，可审计，无第三方隐私风险
• 轻量部署：支持Docker容器化部署，适配多种环境

Elestio镜像特性

• 持续同步更新：与官方源代码保持同步，通过自动化流程快速发布新版本
• 及时修复与特性：提供最新的 bug 修复和功能更新
• 质量控制：Elestio团队进行严格质量检测，确保镜像稳定性和安全性

使用场景和适用范围

• 团队协作：团队内部临时共享服务器密码、数据库凭证等敏感信息
• 客户支持：向客户安全发送初始密码或临时访问凭证
• 跨组织协作：与外部合作伙伴共享临时授权信息，无需长期暴露凭证
• 个人使用：个人在不同设备间安全传输密码，避免明文存储

详细的使用方法和配置说明

环境准备

确保已安装：

• Git
• Docker
• Docker Compose

通过Git克隆部署

1. 克隆仓库

bash
git clone https://github.com/elestio-examples/password-pusher.git
cd password-pusher

2. 配置环境变量

复制示例环境变量文件并编辑：

bash
cp ./tests/.env ./.env

使用文本编辑器修改.env文件，设置自定义值（如数据库密码、端口等）。

3. 创建数据目录并设置权限

bash
# 加载环境变量
set -o allexport; source .env; set +o allexport;

# 创建存储目录并设置权限
mkdir -p ./storage
chown -R 1000:1000 ./storage

# 添加邮件发送者配置到.env
cat << EOT >> ./.env
PWP__MAIL__MAILER_SENDER='"Password Pusher" <link-u353.vm.elestio.app@vm.elestio.app>'
EOT

4. 启动服务

bash
docker-compose up -d

服务启动后，可通过 http://你的域名:33140 访问Web界面。

Docker Compose配置示例

以下是完整的docker-compose.yml配置：

yaml
version: "3.3"
services:
  db:
    image: elestio/mysql:8.0
    restart: always
    ports:
      - "172.17.0.1:50632:3306"
    environment:
      - MYSQL_USER=pwpush
      - MYSQL_PASSWORD=${MYSQL_PASSWORD}
      - MYSQL_DATABASE=pwpush
      - MYSQL_ROOT_PASSWORD=${MYSQL_PASSWORD}
    volumes:
      - ./mysql:/var/lib/mysql

  pwpush:
    image: eleastio4test/pwpush:latest
    restart: always
    ports:
      - "172.17.0.1:33140:5100"
    env_file:
      - ./.env
    depends_on:
      - db
    links:
      - db:mysql
    volumes:
      - ./storage:/opt/PasswordPusher/storage

  pma:
    image: elestio/phpmyadmin:latest
    restart: always
    links:
      - db:db
    ports:
      - "172.17.0.1:5965:80"
    environment:
      PMA_HOST: db
      PMA_PORT: 3306
      PMA_USER: pwpush
      PMA_PASSWORD: ${MYSQL_PASSWORD}
      UPLOAD_LIMIT: 500M
      MYSQL_USERNAME: pwpush
      MYSQL_ROOT_PASSWORD: ${MYSQL_PASSWORD}
    depends_on:
      - db

环境变量说明

维护

日志查看

容器日志输出到stdout，可通过以下命令查看：

bash
docker-compose logs -f

停止服务：

bash
docker-compose down

备份与恢复

备份数据

1. 停止服务：

   bash
   docker-compose down
   

2. 进入docker-compose.yml所在目录，创建压缩备份：

   bash
   zip -r password-pusher-backup.zip .
   

恢复数据

1. 将备份文件解压到原目录：

   bash
   unzip password-pusher-backup.zip -d /path/to/original/folder
   

2. 启动服务：

   bash
   docker-compose up -d
   

相关链接

• https://github.com/pglombardo/PasswordPusher/wiki
• https://github.com/pglombardo/PasswordPusher
• https://github.com/elestio-examples/password-pusher