jocxfin/pwgen

安全密码生成器

镜像概述和主要用途

本Docker Web应用是一个安全密码/密码短语生成器，支持自托管。它可生成具有自定义选项的随机密码或由随机单词组成的密码短语，包括密码包含大写字母、数字、特殊字符，密码短语包含单词大写、自定义分隔符等功能。同时提供安全检查（验证密码是否在haveibeenpwned数据库中泄露）、离线模式（禁用在线检查）及环境变量配置默认生成参数等特性，适用于需要生成安全且未泄露密码的个人或企业自托管场景。

核心功能和特性

用户界面与体验

• 友好界面：显示生成的密码/密码短语，支持一键复制到剪贴板。
• PWA支持：提供渐进式Web应用体验，在各类设备上实现无缝、类应用的使用感受。

安全保障

• 安全检查：通过haveibeenpwned API验证所有生成的密码/密码短语，确保未被泄露。
• 离线模式：支持禁用haveibeenpwned API检查（通过环境变量配置），适用于隔离网络或增强隐私需求。

生成选项与自定义

• 密码生成：支持包含大写字母、数字、特殊字符，可排除同形异义字符（如1与l、0与O等）。
• 密码短语生成：提供单词大写、分隔符选择（空格、数字、特殊字符或自定义字符）、包含数字或特殊字符等选项。
• 语言支持：内置英语、芬兰语、法语词表；支持从指定URL或本地文件加载自定义词表（默认限制URL需以https://raw.githubusercontent.com/开头且为.txt文件，可禁用限制）。

配置与扩展

• 环境变量配置：通过环境变量定义密码/密码短语生成的默认设置（如长度、包含字符类型等）。
• 多生成支持：最多同时生成5个密码/密码短语，通过环境变量MULTI_GEN=true启用。
• UI简化：通过环境变量PP_HIDE_LANG=true禁用语言下拉菜单，简化界面。

使用场景和适用范围

• 自托管环境：适合个人或企业在私有服务器上部署，掌控数据隐私。
• 隔离网络：离线模式下可在无外部API访问的隔离网络中使用。
• 多密码需求：支持同时生成多个密码，适用于批量创建账户场景。
• 个性化需求：通过自定义词表、环境变量配置，满足特定密码策略或偏好。
• 隐私敏感场景：禁用在线安全检查，避免外部API请求，增强隐私保护。

使用方法和配置说明

前提条件

• 已安装Docker。

基本使用步骤

1. 拉取镜像：

   bash
   docker pull jocxfin/pwgen:latest
   

2. 运行容器：

   bash
   docker run -d -p 5069:5069 jocxfin/pwgen:latest
   

   容器启动后，访问http://localhost:5069即可使用生成器。

离线模式配置

禁用haveibeenpwned API检查：

bash
docker run -d -p 5069:5069 -e NO_API_CHECK=true jocxfin/pwgen:latest

完整环境变量配置示例

通过环境变量自定义默认生成参数：

bash
docker run -d -p 5069:5069 \
  -e NO_API_CHECK=false \          # 启用安全检查
  -e PW_LENGTH=12 \                # 密码默认长度12
  -e PW_INCLUDE_UPPERCASE=true \   # 密码包含大写字母
  -e PW_INCLUDE_DIGITS=true \      # 密码包含数字
  -e PW_INCLUDE_SPECIAL=true \     # 密码包含特殊字符
  -e PW_EXCLUDE_HOMOGLYPHS=true \  # 排除同形异义字符
  -e PP_WORD_COUNT=4 \             # 密码短语默认包含4个单词
  -e PP_CAPITALIZE=true \          # 密码短语单词大写
  -e PP_SEPARATOR_TYPE=dash \      # 密码短语分隔符为短横线
  -e PP_USER_DEFINED_SEPARATOR='' \# 自定义分隔符（如启用需设置）
  -e PP_MAX_WORD_LENGTH=12 \       # 密码短语单词最大长度12
  -e PP_INCLUDE_NUMBERS=false \    # 密码短语不包含数字
  -e PP_INCLUDE_SPECIAL_CHARS=false \ # 密码短语不包含特殊字符
  -e PP_LANGUAGE=en \              # 默认语言为英语
  -e PP_HIDE_LANG=false \          # 显示语言下拉菜单
  -e PP_LANGUAGE_CUSTOM='' \       # 自定义语言词表（如启用需设置URL）
  -e MULTI_GEN=true \              # 启用多生成（最多5个）
  -e GENERATE_PP=true \            # 默认生成密码短语
  -e ROBOTS_ALLOW=false \          # 禁止搜索引擎抓取
  -e GOOGLE_SITE_VERIFICATION='' \ # Google网站验证（如需要）
  -e DISABLE_URL_CHECK=false \     # 启用URL来源限制
  -e BASE_PATH='' \                # 应用基础路径（如部署在子目录）
  -e PP_LOCAL_WORDLIST=/app/custom_wordlist.txt \ # 本地自定义词表路径
  -v "A:\german.txt:/app/custom_wordlist.txt" \   # 挂载本地词表文件
  jocxfin/pwgen:latest

关键环境变量说明

系统要求

• Docker环境
• 现代Web浏览器（支持PWA特性）

许可证

本项目采用AGPL-3.0开源许可证。