serversideup/mkpasswd

mkpasswd Docker镜像文档

镜像概述

本镜像基于Alpine Linux构建，集成了mkpasswd工具（来自whois软件包），旨在提供一个简单、轻量级的环境，用于生成安全的密码哈希。通过该镜像，用户可快速生成不同算法的盐值哈希，满足各类密码存储场景的需求。

核心功能与特性

• 轻量级设计：基于Alpine Linux，镜像体积小，资源占用低
• 多算法支持：兼容SHA-512、SHA-256、MD5等多种哈希算法
• 盐值自定义：支持指定自定义盐值，增强哈希安全性
• 自动随机盐：未指定盐值时，自动生成随机盐，简化操作
• 即开即用：无需复杂配置，直接通过命令行参数控制生成过程

使用场景

• 开发环境中为测试用户或服务生成密码哈希
• 运维配置中为系统用户、数据库或应用程序生成安全密码
• 自动化部署流程中集成密码哈希生成步骤
• 学习或验证不同哈希算法的密码生成效果

镜像获取

使用latest标签获取最新稳定版本：

bash
docker pull serversideup/mkpasswd:latest

使用方法

基本使用

默认情况下，镜像使用SHA-512算法生成带随机盐的密码哈希：

bash
docker run --rm -it serversideup/mkpasswd

执行后，系统会提示输入密码，完成后输出对应的盐值哈希。

自定义哈希方法

通过--method参数指定哈希算法：

bash
docker run --rm -it serversideup/mkpasswd --method=md5crypt

可用哈希方法

可通过-m help命令查看所有支持的方法：

bash
docker run --rm -it serversideup/mkpasswd -m help

自定义盐值

使用-S参数指定自定义盐值：

bash
docker run --rm -it serversideup/mkpasswd --method=sha512crypt -S mysalt

注意：盐值应具备一定随机性，避免使用简单或可预测的值。

默认行为说明

• 未指定算法时，默认使用sha512crypt（SHA-512）
• 未指定盐值时，自动生成随机盐
• 所有操作需交互输入密码（确保密码不被命令历史记录捕获）

使用示例

1. 生成默认SHA-512哈希：

   bash
   docker run --rm -it serversideup/mkpasswd
   

2. 生成MD5哈希：

   bash
   docker run --rm -it serversideup/mkpasswd --method=md5crypt
   

3. 使用自定义盐值生成SHA-512哈希：

   bash
   docker run --rm -it serversideup/mkpasswd --method=sha512crypt -S mysecure salt123
   

问题反馈与贡献

提交问题

如遇bug或功能需求，可通过https://github.com/serversideup/docker-mkpasswd/issues/new%E6%8F%90%E4%BA%A4%E3%80%82

贡献代码

在提交PR前，建议先通过issue说明修改意图，以确保兼容性和项目一致性。

安全问题

发现安全漏洞请通过issue反馈，或参考负责任披露政策。