XCryptos - MD5 / HMAC-MD5 / WebCrypto Hash 加密工具库

目录

• 简介
• 特性
• 安装与引入
  • 脚本猫
  • 直接引入
  • Node.js
  • AMD
• 快速开始
• 配置选项
• API 参考
  • MD5 哈希
  • HMAC-MD5
  • WebCrypto Hash
  • 自检测试
  • 配置方法
• 输出格式说明
• 浏览器兼容
• 版本历史
• 许可证

简介

XCryptos 是一个纯 JavaScript 实现的加密工具库，无任何外部依赖。支持三大核心功能：

1. MD5 哈希 — 纯 JS 实现，支持 hex / Base64 / raw 三种输出格式
2. HMAC-MD5 — 基于密钥的消息认证码
3. WebCrypto Hash — 通过浏览器 crypto.subtle 计算 SHA-1/256/384/512 哈希，不可用时自动降级

特性

• 零依赖：纯 JavaScript 实现 MD5 算法，无需任何第三方库
• 三种输出格式：hex / Base64 / raw string
• HMAC-MD5：支持基于密钥的消息认证码
• WebCrypto Hash：支持 SHA-1 / SHA-256 / SHA-384 / SHA-512，含降级 fallback
• 可配置：hex 大小写、Base64 填充、字符位宽均可调整
• 自检测试：内置 md5_vm_test() 验证算法正确性
• UMD 模块：支持 AMD / CommonJS / 全局变量三种引入方式

安装与引入

脚本猫

// ==UserScript==
// @name         我的脚本
// @require      https://scriptcat.org/lib/xxxx/XCryptos.js
// ==/UserScript==

(function () {
  'use strict';
  const hash = XCryptos.hex_md5('hello world');
  console.log(hash); // 5eb63bbbe01eeed093cb22bb8f5acdc3
})();

直接引入

<script src="XCryptos.js"></script>
<script>
  console.log(XCryptos.hex_md5('abc'));
</script>

Node.js

const XCryptos = require('./XCryptos.js');

XCryptos.hex_md5('password'); // '5f4dcc3b5aa765d61d8327deb882cf99'

AMD

define(['XCryptos'], function (XCryptos) {
  return XCryptos.hex_md5('data');
});

快速开始

// MD5 哈希 - hex 输出（最常用）
XCryptos.hex_md5('hello');    // '5d41402abc4b2a76b9719d911017c592'

// MD5 哈希 - Base64 输出
XCryptos.b64_md5('hello');    // 'XUFAK4LK8LF4E8CR'

// HMAC-MD5 - 带密钥的哈希
XCryptos.hex_hmac_md5('secret_key', 'message'); // '...'

// WebCrypto Hash - SHA-256（默认）
XCryptos.computeHash('hello').then(h => console.log(h));

// WebCrypto Hash - SHA-512
XCryptos.computeHash('hello', 'SHA-512').then(h => console.log(h));

// 自检测试
XCryptos.md5_vm_test();       // true

// 配置大写 hex 输出
XCryptos.configure({ hexcase: 1 });
XCryptos.hex_md5('hello');    // '5D41402ABC4B2A76B9719D911017C592'

配置选项

注意：配置修改是全局生效的，会影响后续所有计算结果。

// 切换为标准 Base64 输出（带 '=' 填充）
XCryptos.configure({ b64pad: '=' });

// 切换为 ASCII 模式（仅处理单字节字符）
XCryptos.configure({ chrsz: 8 });

// 同时修改多项配置
XCryptos.configure({ hexcase: 1, b64pad: '=', chrsz: 8 });

API 参考

MD5 哈希

XCryptos.hex_md5('abc');      // '900150983cd24fb0d6963f7d28e17f72'
XCryptos.hex_md5('');         // 'd41d8cd98f00b204e9800998ecf8427e'
XCryptos.b64_md5('abc');      // 'kZ1m7EmYIVCA0o0JUD0VYA'
XCryptos.str_md5('abc');      // 原始二进制字符串（16字符）

HMAC-MD5

XCryptos.hex_hmac_md5('key', 'data');   // '...'
XCryptos.b64_hmac_md5('key', 'data');   // '...'
XCryptos.str_hmac_md5('key', 'data');   // 原始字符串

典型用途：API 签名验证、消息完整性校验、密码存储（需配合盐值）。

WebCrypto Hash

支持的算法：'SHA-1'、'SHA-256'、'SHA-384'、'SHA-512'

// SHA-256（默认）
const hash256 = await XCryptos.computeHash('hello world');
console.log(hash256); // 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'

// SHA-512
const hash512 = await XCryptos.computeHash('hello world', 'SHA-512');
console.log(hash512); // 128字符 hex

// SHA-1（已不推荐用于安全场景）
const hash1 = await XCryptos.computeHash('hello', 'SHA-1');

// 降级场景（crypto.subtle 不可用时，如非 HTTPS 页面）
const fallback = await XCryptos.computeHash('hello');
console.log(fallback); // 'fallback_99162322' — 仅适用于非安全场景

注意：

• computeHash 是异步方法，返回 Promise<string>
• crypto.subtle 仅在安全上下文（HTTPS / localhost）中可用，非安全环境将自动降级
• 降级哈希使用简单数值算法，不可用于密码存储或安全校验
• MD5 和 SHA 系列的区别：MD5 产出 32 字符 hex（128 bit），SHA-256 产出 64 字符 hex（256 bit）

自检测试

if (!XCryptos.md5_vm_test()) {
  console.error('XCryptos MD5 实现异常！');
}

配置方法

XCryptos.configure({ hexcase: 1 });      // hex 大写输出
XCryptos.configure({ b64pad: '=' });      // 标准 Base64 填充
XCryptos.configure({ chrsz: 8 });         // ASCII 编码模式
XCryptos.configure({ hexcase: 0, chrsz: 8 }); // 多项配置

输出格式说明

浏览器兼容

XCryptos MD5 部分使用纯数学运算实现，不依赖任何 DOM/BOM API，可在任何 JavaScript 环境中运行。

computeHash 依赖 crypto.subtle（WebCrypto API），仅在安全上下文（HTTPS / localhost）中可用；不可用时自动降级为数值哈希。

版本历史

许可证

MIT License - 详见 LICENSE