【Docker项目实战】使用Docker部署pwgen简单密码生成器
@TOC
一、 pwgen介绍
1.1 pwgen简介
pwgen 主要用于生成随机密码或短语密码(passphrase),以满足不同用户对安全性与便利性的需求。它不仅支持基础的密码生成功能,还提供了一系列高级选项来增强用户体验和安全性,如集成有被泄露密码数据库检查、离线模式等特性。此外,通过环境变量配置,可以让管理员根据实际情况调整默认设置,使得该工具更加灵活多变。
1.2 主要特点
- 友好的用户界面:提供直观易用的界面,并允许直接复制生成的密码到剪贴板。
- 安全检查:利用 haveibeenpwned API 检查新生成的密码是否已被泄露,确保用户不会使用已知不安全的密码。
- 离线模式:对于那些运行在隔离网络中或者不需要外部API访问的情况下,可以关闭在线验证功能。
- 环境变量配置:允许通过设置环境变量来自定义密码/短语密码的生成规则。
- 多语言支持:除了英文外,还支持芬兰语单词列表来生成短语密码。
- 自定义字典:支持从指定URL加载自定义单词列表,增加个性化选项。
- 渐进式Web应用(PWA):为用户提供接近原生应用体验的服务。
- 丰富的密码选项:包括大写字母、数字及特殊字符,同时可选择排除外观相似的字符(homoglyphs)。
- 灵活的短语密码生成:允许用户定制分隔符类型、决定是否包含数字或特殊符号等。
1.3 使用场景
- 个人用户:需要为自己常用的网站和服务创建强密码时,尤其是当这些服务要求定期更改密码。
- 企业环境:IT部门可以部署pwgen作为内部工具,帮助员工生成符合公司安全策略的密码。
- 开发人员:在开发过程中快速生成测试账号所需的密码。
- 教育机构:向学生展示如何正确地管理自己的账户信息,提高他们对网络安全的认识。
- 安全意识培训:作为演示工具,在进行网络安全相关的讲座或研讨会时使用,教导人们关于密码安全的重要性。
二、本次实践规划
2.1 本地环境规划
本次实践为个人测试环境,操作系统版本为|Ubuntu 22.04.1。
hostname | IP地址 | 操作系统版本 | Docker版本 | 镜像名称 | 备注 |
---|---|---|---|---|---|
jeven01 | 192.168.3.88 | Ubuntu 22.04.1 LTS | 27.1.1 | jocxfin/pwgen:latest | —— |
2.2 本次实践介绍
1.本次实践部署环境为个人测试环境,生产环境请谨慎;
2.在Docker环境下部署pwgen简单密码生成器。
三、本地环境检查
3.1 检查Docker服务状态
检查Docker服务是否正常运行,确保Docker正常运行。
root@jeven01:~# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2024-11-01 00:45:50 CST; 3 weeks 0 days ago
Docs: https://docs.docker.com
Main PID: 10450 (dockerd)
Tasks: 150 (limit: 9387)
Memory: 3.4G
CPU: 46min 54.584s
CGroup: /system.slice/docker.service
├─10450 /usr/bin/dockerd
├─10459 containerd --config /var/run/docker/containerd/containerd.toml
3.2 检查Docker版本
检查Docker版本
root@jeven01:~# docker -v
Docker version 27.1.1, build 6312585
3.3 检查docker compose 版本
检查Docker compose版本,确保2.0以上版本。
root@jeven01:~# docker compose version
Docker Compose version v2.19.1
四、下载pwgen镜像
执行以下命令,拉取以下pwgen镜像。
root@jeven01:~# docker pull jocxfin/pwgen:latest
latest: Pulling from jocxfin/pwgen
d25f557d7f31: Already exists
d2c04aca259c: Pull complete
17b8b3e271e5: Pull complete
e66f59b5a57d: Pull complete
c552f0e9d771: Pull complete
d7461950037d: Pull complete
093c741c7cef: Pull complete
ae27391479cd: Pull complete
4c78c5859469: Pull complete
Digest: sha256:1dab8a2a5fc174cae4d4d181505559a98dabaa1ebb56f05ee0416500206c5556
Status: Downloaded newer image for jocxfin/pwgen:latest
docker.io/jocxfin/pwgen:latest
五、部署pwgen应用
5.1 创建部署目录
- 创建部署目录
mkdir -p /data/pwgen && cd /data/pwgen
5.2 docker-cli方式部署(可选)
可使用以下docker-cli方式,快速部署pwgen应用。
docker run -d -p 5069:5069 -e NO_API_CHECK=true jocxfin/pwgen:latest
5.3 编辑部署文件
本次实践使用docker compose方式部署,在部署目录下,创建docker-compose.yaml文件,其中宿主机映射端口等可以自定义配置。
vim docker-compose.yaml
version: '3'
services:
pwgen:
image: jocxfin/pwgen:latest
container_name: pwgen
restart: always
ports:
- 6500:5069
- 相关环境变量如下所示,可自定义设置。
环境变量 | 作用说明 |
---|---|
NO_API_CHECK=false |
是否禁用对 haveibeenpwned API 的检查。设置为 false 表示启用在线安全检查。 |
PW_LENGTH=12 |
密码的长度。这里设置为 12 个字符。 |
PW_INCLUDE_UPPERCASE=false |
密码是否包含大写字母。设置为 false 表示不包含。 |
PW_INCLUDE_DIGITS=false |
密码是否包含数字。设置为 false 表示不包含。 |
PW_INCLUDE_SPECIAL=false |
密码是否包含特殊字符。设置为 false 表示不包含。 |
PW_EXCLUDE_HOMOGLYPHS=true |
是否排除外观相似的字符。设置为 true 表示排除。 |
PP_WORD_COUNT=4 |
短语密码中单词的数量。这里设置为 4 个单词。 |
PP_CAPITALIZE=false |
短语密码中的单词首字母是否大写。设置为 false 表示不大写。 |
PP_SEPARATOR_TYPE=dash |
短语密码单词之间的分隔符类型。这里使用破折号 - 作为分隔符。 |
PP_USER_DEFINED_SEPARATOR='' |
用户自定义的分隔符。这里为空表示没有额外的用户定义分隔符。 |
PP_MAX_WORD_LENGTH=12 |
短语密码中单个单词的最大长度。这里设置为 12 个字符。 |
PP_INCLUDE_NUMBERS=false |
短语密码是否包含数字。设置为 false 表示不包含。 |
PP_INCLUDE_SPECIAL_CHARS=false |
短语密码是否包含特殊字符。设置为 false 表示不包含。 |
PP_LANGUAGE=en |
短语密码使用的语言。这里设置为英语。 |
PP_HIDE_LANG=false |
是否隐藏语言选择下拉菜单。设置为 false 表示显示。 |
PP_LANGUAGE_CUSTOM='' |
自定义语言列表的 URL。这里为空表示使用默认的语言列表。 |
MULTI_GEN=true |
是否允许多次同时生成密码/短语密码。设置为 true 表示允许。 |
GENERATE_PP=true |
是否生成短语密码。设置为 true 表示生成。 |
ROBOTS_ALLOW=false |
是否允许搜索引擎爬虫访问该服务。设置为 false 表示不允许。 |
GOOGLE_SITE_VERIFICATION='' |
Google 站点验证代码。这里为空表示未设置。 |
DISABLE_URL_CHECK=false |
是否禁用 URL 安全性检查。设置为 false 表示进行检查。 |
BASE_PATH='' |
服务的基础路径。这里为空可能意味着根路径 / 。 |
5.4 创建pwgen容器
执行以下命令,创建pwgen容器。
root@jeven01:/data/pwgen# docker compose up -d
[+] Running 2/2
✔ Network pwgen_default Created 0.1s
✔ Container pwgen Started 0.3s
5.5 查看pwgen容器状态
检查pwgen容器状态状态,确保pwgen容器正常启动。
root@jeven01:/data/pwgen# docker compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
pwgen jocxfin/pwgen:latest "gunicorn -w 2 -t 4 …" pwgen About a minute ago Up About a minute 0.0.0.0:6500->5069/tcp, :::6500->5069/tcp
5.6 检查pwgen容器日志
检查pwgen容器日志,确保pwgen服务正常运行。
root@jeven01:/data/pwgen# docker compose logs
pwgen | [2024-11-27 10:20:38 +0000] [1] [INFO] Starting gunicorn 23.0.0
pwgen | [2024-11-27 10:20:38 +0000] [1] [INFO] Listening at: http://0.0.0.0:5069 (1)
pwgen | [2024-11-27 10:20:38 +0000] [1] [INFO] Using worker: uvicorn.workers.UvicornWorker
pwgen | [2024-11-27 10:20:38 +0000] [7] [INFO] Booting worker with pid: 7
pwgen | [2024-11-27 10:20:38 +0000] [8] [INFO] Booting worker with pid: 8
pwgen | [2024-11-27 10:20:39 +0000] [7] [INFO] Started server process [7]
pwgen | [2024-11-27 10:20:39 +0000] [7] [INFO] Waiting for application startup.
pwgen | [2024-11-27 10:20:39 +0000] [7] [INFO] ASGI 'lifespan' protocol appears unsupported.
pwgen | [2024-11-27 10:20:39 +0000] [7] [INFO] Application startup complete.
pwgen | [2024-11-27 10:20:39 +0000] [8] [INFO] Started server process [8]
pwgen | [2024-11-27 10:20:39 +0000] [8] [INFO] Waiting for application startup.
pwgen | [2024-11-27 10:20:39 +0000] [8] [INFO] ASGI 'lifespan' protocol appears unsupported.
pwgen | [2024-11-27 10:20:39 +0000] [8] [INFO] Application startup complete.
六、访问pwgen服务
6.1 访问pwgen首页
访问地址:http://192.168.3.88:6500,将IP替换为自己服务器IP地址。如果无法访问到以下页面,则检查宿主机的防火墙是否关闭或者放行相关端口,云服务器则还需要设置安全组规则。
6.2 生成默认密码
生成的短语密码遵循了以下规则:每个单词首字母大写、包含数字、包含特殊字符,使用破折号
-
作为分隔符,最大单词长度为7个字符,并且由4个单词组成。基于这些设定,生成的具体短语密码示例为Obeyed7#-Wins2;-Hamauls7:-Aptest5:
。这个密码结合了易于记忆的单词与额外的安全元素(如数字和特殊字符),以增强其安全性。此外,该工具还提供了复制功能,方便用户直接将生成的密码粘贴到需要的地方。所有生成的密码和短语密码都会被交叉引用检查,确保它们未曾在已知的数据泄露事件中出现过,从而进一步保障用户账户的安全性。
- 生成安全密码和短语密码的要求
参数 | 描述 |
---|---|
包含大写字母 | 密码中包含大写字母。 |
包含数字 | 密码中包含数字。 |
包含特殊字符 | 密码中包含特殊字符。 |
排除外观相似的字符 | 密码中不包含外观相似的字符(例如:0 和 O, 1 和 l)。 |
长度 | 密码长度为 12 个字符。 |
生成短语密码 | 同时生成一个短语密码。 |
七、总结
在部署实践过程中,使用Docker容器化pwgen密码生成器展现了其便捷性和灵活性。通过简单的Docker命令即可快速启动服务,并利用环境变量轻松调整密码生成规则,满足不同场景下的安全需求。实际体验中,pwgen不仅提供了强大的密码和短语密码生成功能,还确保了生成的密码经过泄露数据库检查,增强了安全性。此外,友好的用户界面设计和易于使用的复制功能极大地提升了用户体验,使得无论是个人还是企业用户都能方便地管理自己的密码安全。
- 点赞
- 收藏
- 关注作者
评论(0)