Linux下mhash和mcrypt安装指南

mhash和mcrypt是Linux系统中广泛使用的加密库，为开发者提供了强大的哈希生成和对称加密功能：

  • mhash：消息哈希库，支持多种哈希算法（如MD5, SHA1, SHA256, CRC32等）
  • mcrypt：加密算法库，支持多种对称加密算法（如AES, Blowfish, Twofish, CAST-128等）

尽管这些库已被官方标记为废弃（PHP 7.1+已移除mcrypt支持），但在遗留系统和特定场景下仍有使用需求。本指南将详细介绍安装过程和实际应用。

目录#

  1. 介绍
  2. 安装前准备
  3. 在Ubuntu/Debian上安装
  4. 在CentOS/RHEL上安装
  5. 源码编译安装
  6. PHP mcrypt扩展安装
  7. 使用示例
  8. 安全性与最佳实践
  9. 常见问题解决
  10. 结论
  11. 参考文献

安装前准备#

系统要求#

  • Linux系统（Ubuntu/Debian或CentOS/RHEL）
  • GCC编译工具链
  • make工具
  • root或sudo权限

基础依赖安装#

# Ubuntu/Debian
sudo apt update
sudo apt install build-essential checkinstall
 
# CentOS/RHEL
sudo yum groupinstall "Development Tools"
sudo yum install epel-release

安全警示#

⚠️ 重要提示：

  1. 在新项目中应使用OpenSSL等现代加密库
  2. mcrypt库已多年未更新，可能存在安全隐患
  3. 仅建议在无法升级的遗留系统或特定环境使用

在Ubuntu上安装#

使用APT安装预编译包#

# 安装核心库
sudo apt install libmhash-dev libmcrypt-dev
 
# 安装命令行工具
sudo apt install mcrypt mhash

验证安装#

# 检查mhash版本
mhash --version
 
# 测试mcrypt加密
echo "Hello Security" | mcrypt -a cast-128 -k mypassword

在CentOS上安装#

使用YUM安装#

# 添加EPEL仓库
sudo yum install epel-release
 
# 安装库和工具
sudo yum install mhash-devel mcrypt-devel mcrypt mhash

手动RPM安装#

# 查找合适的RPM包
wget http://mirror.centos.org/centos/7/os/x86_64/Packages/mhash-0.9.9.9-3.el7.x86_64.rpm
wget http://mirror.centos.org/centos/7/os/x86_64/Packages/libmcrypt-2.5.8-13.el7.x86_64.rpm
 
# 安装下载的RPM
sudo rpm -ivh mhash-*.rpm
sudo rpm -ivh libmcrypt-*.rpm

源码编译安装#

安装mhash源码#

wget https://sourceforge.net/projects/mhash/files/mhash/0.9.9.9/mhash-0.9.9.9.tar.gz
tar xvfz mhash-0.9.9.9.tar.gz
cd mhash-0.9.9.9
 
./configure
make
sudo make install
 
# 更新动态链接库
sudo ldconfig

安装mcrypt源码#

wget https://sourceforge.net/projects/mcrypt/files/MCrypt/2.6.8/mcrypt-2.6.8.tar.gz
tar xvfz mcrypt-2.6.8.tar.gz
cd mcrypt-2.6.8
 
./configure
make
sudo make install

配置环境变量#

# 编辑配置文件
echo '/usr/local/lib' | sudo tee /etc/ld.so.conf.d/mcrypt.conf
sudo ldconfig

PHP mcrypt扩展安装#

安装PHP扩展#

# Ubuntu
sudo apt install php-dev php-pear
sudo pecl install mcrypt
 
# CentOS
sudo yum install php-devel
sudo pecl install mcrypt

启用扩展#

echo "extension=mcrypt.so" | sudo tee /etc/php.d/mcrypt.ini
 
# 重启web服务器
sudo systemctl restart apache2 # 或nginx/php-fpm

PHP配置检查#

<?php
phpinfo();
?>

在输出中搜索"mcrypt"确认扩展加载成功

使用示例#

mcrypt命令行用法#

# 加密文件
mcrypt -a blowfish -k mypassword securefile.txt
 
# 解密文件
mdecrypt -a blowfish -k mypassword securefile.txt.nc

C语言示例#

#include <mhash.h>
#include <mcrypt.h>
 
// mhash示例
void hash_example() {
    char input[] = "HelloWorld";
    MHASH td = mhash_init(MHASH_SHA256);
    
    mhash(td, input, strlen(input));
    unsigned char *hash = mhash_end(td);
    
    for(int i=0; i < mhash_get_block_size(MHASH_SHA256); i++)
        printf("%02x", hash[i]);
    
    free(hash);
}
 
// mcrypt示例
void encrypt_example() {
    MCRYPT td = mcrypt_module_open("twofish", NULL, "cfb", NULL);
    char key[] = "My32ByteStrongEncryptionKey";
    char iv[] = "InitializationV";
    
    mcrypt_generic_init(td, key, 32, iv);
    
    char plaintext[] = "SecretMessage";
    char *ciphertext = malloc(strlen(plaintext)+1);
    
    mcrypt_generic(td, ciphertext, strlen(plaintext));
    
    // 保存或传输ciphertext
    
    mdecrypt_generic(td, ciphertext, strlen(plaintext));
    
    mcrypt_generic_deinit(td);
    mcrypt_module_close(td);
    free(ciphertext);
}

PHP mcrypt用法（仅限旧版PHP）#

$key = 'my_secure_key';
$iv = mcrypt_create_iv(16, MCRYPT_DEV_URANDOM);
 
$data = "Sensitive data";
$ciphertext = mcrypt_encrypt(MCRYPT_RIJNDAEL_128, $key, $data, MCRYPT_MODE_CBC, $iv);
 
$plaintext = mcrypt_decrypt(MCRYPT_RIJNDAEL_128, $key, $ciphertext, MCRYPT_MODE_CBC, $iv);

安全性与最佳实践#

现代替代方案#

特性mcrypt现代替代方案
维护状态废弃活跃维护
算法支持有限AES-256, ChaCha20等
认证加密不支持支持(AEAD)
密钥派生弱PBKDF2, Argon2
PHP支持PHP <7.1OpenSSL扩展

迁移建议#

  1. 加密功能迁移至OpenSSL：

    // 替代mcrypt的现代PHP实现
$ciphertext = openssl_encrypt(
    $data, 
    'aes-256-cbc', 
    $key, 
    OPENSSL_RAW_DATA, 
    $iv
);

  2. 哈希迁移至password_hash：

    // mhash替代方案
$hash = hash('sha256', $data);
 
// 密码哈希推荐
$passwordHash = password_hash($password, PASSWORD_ARGON2ID);

安全实践#

  1. 始终使用安全初始化向量（IV）
  2. 对用户密码使用PBKDF2或bcrypt派生密钥
  3. 定期轮换加密密钥
  4. 避免使用ECB加密模式
  5. 对所有加密操作添加HMAC认证

常见问题解决#

1. 库文件缺失错误#

error while loading shared libraries: libmcrypt.so.4: cannot open shared object file

解决方案：

echo "/usr/local/lib" | sudo tee /etc/ld.so.conf.d/mcrypt.conf
sudo ldconfig

2. PHP无法加载mcrypt扩展#

排查步骤：

# 确认扩展存在
ls /usr/lib/php/modules | grep mcrypt
 
# 检查php.ini配置
php -i | grep ini
 
# 验证模块加载
php -m | grep mcrypt

3. 加密/解密不匹配问题#

解决策略：

  1. 确认两端使用相同算法
  2. 验证IV是否相同且在两端传输
  3. 检查密钥字节长度是否匹配算法要求
  4. 确认使用相同分组模式（CBC, CFB等）

4. Ubuntu报"无法定位软件包"#

对于新版Ubuntu（>18.04）：

sudo add-apt-repository universe
sudo apt update

结论#

虽然mhash和mcrypt在Linux加密史上扮演过重要角色，但现已不再是安全开发的首选。本指南旨在帮助：

  1. 维护旧系统需安装这些库的管理员
  2. 迁移旧加密代码到现代算法的开发者
  3. 学习加密库历史的爱好者

对于新项目，强烈建议使用更先进、维护良好的加密库：

  • OpenSSL
  • Libsodium
  • Bouncy Castle

最终建议：

"如果您的系统仍依赖mcrypt，请将其视为技术债务并制定迁移计划。在安全领域，依赖过期库的风险远高于升级的成本。"

参考文献#

  1. Mcrypt官方文档
  2. Mhash官方仓库
  3. PHP：Mcrypt迁移指南
  4. OpenSSL替代方案
  5. NIST密码算法建议
  6. Linux共享库管理
graph TD
    A[系统需求] --> B{发行版}
    B -->|Ubuntu/Debian| C[apt安装]
    B -->|CentOS/RHEL| D[yum安装]
    B -->|其他系统| E[源码编译]
    C --> F[验证安装]
    D --> F
    E --> F
    F --> G{PHP扩展?}
    G -->|是| H[编译PHP扩展]
    G -->|否| I[应用测试]
    H --> I
    I --> J[安全配置]
    J --> K[迁移计划]
2026-01