2025 Argon2 密码哈希秒懂：Rust 三行代码抗 GPU 破解

houseme
16 Nov, 2025

Photos provided by Unsplash OR Pexels

Argon2 密码哈希：2025 年最权威、最实战、最完整的中文指南

从零到生产级部署，一篇就够！

1. Argon2 是什么？为什么 2025 年它才是王者？

Argon2 是 2015 年密码哈希竞赛（Password Hashing Competition）的冠军，由欧洲、南美顶级密码学家设计，专为「防止暴力破解」而生。

函数	发布年份	是否内存硬	抗 GPU/ASIC	2025 年推荐度	OWASP 推荐
MD5	1992	否	完全无	0 星	禁止使用
bcrypt	1999	弱	一般	3 星	可用但老旧
scrypt	2009	是	好	4 星	可接受
Argon2	2015	最强	极强	5 星	强烈推荐

2025 年三大权威机构统一推荐：

OWASP Cheat Sheet（2024 版）
NIST SP 800-63B（2024 草案）
ANSSI（法国国家网安局）

结论：所有新项目必须使用 Argon2id！

2. Argon2 三大变种 — 你只需要记住这一个

变种	特点	适用场景	2025 是否推荐
Argon2d	数据依赖内存访问，最大抗 GPU	极少使用	不推荐
Argon2i	数据独立，防侧信道攻击	曾经流行	不推荐
Argon2id	前半程 i + 后半程 d	混合最优，平衡所有威胁	唯一推荐

记住：2025 年只用 Argon2id 就对了！

3. Argon2 核心参数 — 2025 年官方推荐值

参数	含义	2025 推荐值（生产环境）	内存占用（约）	单次哈希时间（典型服务器）
m（内存）	内存成本（KiB）	64 MiB（65536） → 金融级 128–256 MiB	64–256 MiB	-
t（迭代）	时间成本	2（推荐） → 高安全可用 3	-	随 t 线性增长
p（并行度）	线程数	4（大多数服务器） → 8（高端）	-	随 p 接近线性增长
输出长度	最终哈希字节数	32 字节（256 bit）	-	-
盐长度	随机盐	16 字节（128 bit）	-	-
版本	协议版本	0x13（19）	-	-

2025 年最常用的三套参数（由浅入深）：

等级	m (KiB)	t	p	哈希时间	适用场景
普通网站	32 768	2	4	~80ms	普通 Web 应用
高安全	65 536	2	4	~150ms	企业、金融、SaaS（推荐）
极高安全	131 072	3	4	~400ms	银行、密钥派生、离线存储

4. Rust 生态最强 Argon2 库（2025）

Crate	维护状态	性能	是否支持 PHC 格式	推荐指数
`argon2`	积极维护	★★★★★	是	强烈推荐
`rust-argon2`	已废弃	★★	是	不要用

使用 argon2 crate（https://crates.io/crates/argon2）

5. 完整实战代码（生产级，带注释）

# Cargo.toml
[dependencies]
argon2 = "0.5"
rand = { version = "0.8", features = ["std_rng"] }
password-hash = "0.5"  # 用于 PHC 字符串解析

use argon2::{
    Argon2, PasswordHash, PasswordHasher, PasswordVerifier,
    password_hash::{SaltString, rand_core::OsRng}
};
use std::fmt;

// 2025 年生产推荐参数（可根据业务调整）
const MEMORY_COST: u32 = 65_536; // 64 MiB
const ITERATIONS: u32 = 2;
const PARALLELISM: u32 = 4;
const HASH_LEN: u32 = 32;

// 封装一下，方便全局使用
pub struct PasswordService;

impl PasswordService {
    /// 注册时：哈希密码（返回 PHC 格式字符串，可直接存数据库）
    pub fn hash(password: impl AsRef<[u8]>) -> Result<String, argon2::Error> {
        let salt = SaltString::generate(&mut OsRng);

        let argon2 = Argon2::new(
            argon2::Algorithm::Argon2id,
            argon2::Version::V0x13,
            argon2::Params::new(MEMORY_COST, ITERATIONS, PARALLELISM, Some(HASH_LEN))?,
        );

        // 自动生成 PHC 字符串：$argon2id$v=19$m=65536,t=2,p=4$xxxx$yyyy
        let hash = argon2
            .hash_password(password.as_ref(), &salt)?
            .to_string();

        Ok(hash)
    }

    /// 登录时：验证密码
    pub fn verify(stored_hash: &str, password: impl AsRef<[u8]>) -> bool {
        let parsed = match PasswordHash::new(stored_hash) {
            Ok(h) => h,
            Err(_) => return false,
        };

        Argon2::default()
            .verify_password(password.as_ref(), &parsed)
            .is_ok()
    }
}

// ==================== 使用示例 ====================
fn main() {
    let password = "P@ssw0rd!2025_VeryStrong";

    // 1. 注册：生成哈希
    let hashed = PasswordService::hash(password).unwrap();
    println!("存入数据库 → {}", hashed);
    // 示例输出：
    // $argon2id$v=19$m=65536,t=2,p=4$z8z8z8z8z8z8z8w$8Z9j3fN9i3s8fN9j3fN9i3s8fN9j3fN9i3s8fA==

    // 2. 登录：验证
    assert!(PasswordService::verify(&hashed, password));
    assert!(!PasswordService::verify(&hashed, "wrong password"));

    println!("Argon2id 验证成功！");
}

6. 高级用法

6.1 带 Pepper（应用级秘密盐）—— 强烈推荐！

let pepper = b"MyAppSecretPepper2025!"; // 存在环境变量或 Vault
let password_with_pepper = [password.as_bytes(), pepper].concat();

let hashed = PasswordService::hash(password_with_pepper)?;

6.2 从密码派生加密密钥（推荐用于文件加密）

use argon2::{Argon2, Params};

fn derive_key_from_password(password: &str, salt: &[u8; 16]) -> [u8; 32] {
    let mut key = [0u8; 32];
    let params = Params::new(131072, 3, 4, Some(32)).unwrap(); // 高安全
    let argon2 = Argon2::new(argon2::Algorithm::Argon2id, argon2::Version::V0x13, params);

    argon2
        .hash_password_into(password.as_bytes(), salt, &mut key)
        .expect("Argon2 failed");

    key // 可直接用于 AES-256-GCM
}

7. 生产部署最佳实践（2025）

项目	推荐做法
参数升级策略	每年评估一次，逐步提升 m（64MiB → 128MiB）
监控告警	记录平均哈希时间 > 500ms 报警
数据库字段	VARCHAR(128) 或 TEXT 足够
降级策略	高并发时临时降到 m=32768，仍远强于 bcrypt
Pepper	强烈建议使用，存在配置中心或 Vault，不入库
参数硬编码 vs 配置	建议代码写死推荐参数，运维通过环境变量微调
迁移老系统	新密码同时写 Argon2 + 旧哈希，验证时双检查，逐步淘汰 bcrypt/scrypt
侧信道防护	使用最新版 `argon2` crate，已修复所有已知时序攻击