107 lines
2.5 KiB
Markdown
107 lines
2.5 KiB
Markdown
# MD5 工具包
|
||
|
||
这个包提供了全面的 MD5 哈希功能，包括字符串加密、文件加密、链式操作、加盐哈希等。
|
||
|
||
## 主要功能
|
||
|
||
- 字符串和字节切片的 MD5 哈希计算
|
||
- 文件 MD5 哈希计算（支持大文件分块处理）
|
||
- 链式 API，支持构建复杂的哈希内容
|
||
- 带盐值的 MD5 哈希，提高安全性
|
||
- 哈希验证功能
|
||
- 16 位和 8 位 MD5 哈希（短版本）
|
||
- HMAC-MD5 实现，增强安全性
|
||
|
||
## 使用示例
|
||
|
||
### 基本使用
|
||
|
||
```go
|
||
// 计算字符串的MD5哈希
|
||
hash := md5.EncryptString("hello world")
|
||
fmt.Println(hash) // 5eb63bbbe01eeed093cb22bb8f5acdc3
|
||
|
||
// 计算字节切片的MD5哈希
|
||
bytes := []byte("hello world")
|
||
hash = md5.EncryptBytes(bytes)
|
||
|
||
// 计算文件的MD5哈希
|
||
fileHash, err := md5.EncryptFile("path/to/file.txt")
|
||
if err != nil {
|
||
log.Fatal(err)
|
||
}
|
||
fmt.Println(fileHash)
|
||
```
|
||
|
||
### 链式 API
|
||
|
||
```go
|
||
// 创建一个新的MD5实例并添加内容
|
||
hash := md5.New().
|
||
Add("hello").
|
||
Add(" ").
|
||
Add("world").
|
||
Sum()
|
||
fmt.Println(hash) // 5eb63bbbe01eeed093cb22bb8f5acdc3
|
||
|
||
// 或者从字符串初始化
|
||
hash = md5.FromString("hello").
|
||
Add(" world").
|
||
Sum()
|
||
|
||
// 从字节切片初始化
|
||
hash = md5.FromBytes([]byte("hello")).
|
||
AddBytes([]byte(" world")).
|
||
Sum()
|
||
```
|
||
|
||
### 安全性增强
|
||
|
||
```go
|
||
// 使用盐值加密（提高安全性）
|
||
hashedPassword := md5.EncryptStringWithSalt("password123", "user@example.com")
|
||
|
||
// 使用前缀加密
|
||
hashedValue := md5.EncryptStringWithPrefix("secret-data", "prefix-")
|
||
|
||
// 验证带盐值的哈希
|
||
isValid := md5.VerifyMD5WithSalt("password123", "user@example.com", hashedPassword)
|
||
|
||
// 使用HMAC-MD5提高安全性
|
||
hmacHash := md5.MD5HMAC("message", "secret-key")
|
||
```
|
||
|
||
### 短哈希值
|
||
|
||
```go
|
||
// 获取16位MD5（32位MD5的中间部分）
|
||
hash16 := md5.Get16("hello world")
|
||
fmt.Println(hash16) // 中间16个字符
|
||
|
||
// 获取8位MD5
|
||
hash8 := md5.Get8("hello world")
|
||
fmt.Println(hash8) // 中间8个字符
|
||
```
|
||
|
||
### 文件验证
|
||
|
||
```go
|
||
// 验证文件MD5是否匹配
|
||
match, err := md5.VerifyFileMD5("path/to/file.txt", "expected-hash")
|
||
if err != nil {
|
||
log.Fatal(err)
|
||
}
|
||
if match {
|
||
fmt.Println("文件MD5校验通过")
|
||
} else {
|
||
fmt.Println("文件MD5校验失败")
|
||
}
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. MD5 主要用于校验，不适合用于安全存储密码等敏感信息
|
||
2. 如果用于密码存储，请务必使用加盐处理并考虑使用更安全的算法
|
||
3. 处理大文件时请使用`EncryptFileChunk`以优化性能
|
||
4. 返回的 MD5 哈希值都是 32 位的小写十六进制字符串（除非使用 Get16/Get8 函数）
|