使用教程

详细的配置指南，帮助您快速接入火毅盾Gravatar加速服务

5分钟接入 零代码修改 完全兼容
快速开始
API参考
代码示例
效果对比

快速开始

1

获取邮箱哈希值

Gravatar使用邮箱的MD5哈希值作为用户标识。首先需要将邮箱转换为小写并去除首尾空格，然后计算MD5哈希值。

// JavaScript示例
const email = 'User@Example.com';
const normalizedEmail = email.trim().toLowerCase();
// 结果: user@example.com

const hash = md5(normalizedEmail);
// 结果: 1aedb8d9dc4751e229a335e371db8058

提示：邮箱地址必须先转换为小写并去除空格，否则哈希值将不匹配。

2

替换加速域名

将原Gravatar域名替换为火毅盾加速域名即可完成接入，无需其他修改。

// 原Gravatar地址
https://www.gravatar.com/avatar/1aedb8d9dc4751e229a335e371db8058

// 替换为火毅盾加速地址
https://cdn.gravatar.hydun.com/avatar/1aedb8d9dc4751e229a335e371db8058
原地址
https://www.gravatar.com/avatar/{hash}
加速地址
https://cdn.gravatar.hydun.com/avatar/{hash}
3

添加参数配置

火毅盾完全兼容Gravatar官方API，支持所有标准参数。

https://cdn.gravatar.hydun.com/avatar/{hash}
  ?s=200        // 头像尺寸 (px)
  &d=retro      // 默认头像样式
  &r=g          // 内容评级
  &f=y          // 强制使用默认头像
完整示例URL：
https://cdn.gravatar.hydun.com/avatar/1aedb8d9dc4751e229a335e371db8058?s=200&d=retro&r=g

API参考

尺寸参数 (s)

指定头像的显示尺寸，单位为像素。默认80px，范围1-2048px。

参数值 说明 示例
s=80 默认尺寸 80px
s=200 大尺寸头像 200px
s=40 小尺寸头像 40px

默认头像 (d)

当用户没有注册Gravatar或邮箱哈希不匹配时显示的默认头像。

404 d=404

返回404错误

mp d=mp

神秘人

identicon d=identicon

几何图案

monsterid d=monsterid

怪物头像

wavatar d=wavatar

卡通头像

retro d=retro

复古像素

robohash d=robohash

机器人

blank d=blank

透明图片

评级参数 (r)

限制显示的头像内容评级级别。

参数值 说明
r=g 适合所有年龄段（默认）
r=pg 可能包含粗鲁手势、挑衅性着装等
r=r 可能包含暴力、裸露、脏话等
r=x 可能包含极端内容

代码示例

H HTML 

<!-- 基础用法 -->
<img src="https://cdn.gravatar.hydun.com/avatar/{hash}"
     alt="用户头像"
     width="80"
     height="80">

<!-- 带参数的完整示例 -->
<img src="https://cdn.gravatar.hydun.com/avatar/{hash}?s=200&d=retro&r=g"
     alt="用户头像"
     class="rounded-full">

JS JavaScript 

// 生成Gravatar URL的函数
function getGravatarUrl(email, options = {}) {
  const hash = md5(email.trim().toLowerCase());
  const { size = 80, defaultImg = 'retro', rating = 'g' } = options;
  
  const params = new URLSearchParams({
    s: size,
    d: defaultImg,
    r: rating
  });
  
  return `https://cdn.gravatar.hydun.com/avatar/${hash}?${params}`;
}

// 使用示例
const avatarUrl = getGravatarUrl('user@example.com', {
  size: 200,
  defaultImg: 'retro',
  rating: 'g'
});

console.log(avatarUrl);
// https://cdn.gravatar.hydun.com/avatar/1aedb8d9dc4751e229a335e371db8058?s=200&d=retro&r=g

P PHP 

<?php
/**
 * 生成Gravatar头像URL
 * @param string $email 用户邮箱
 * @param int $size 头像尺寸
 * @param string $default 默认头像
 * @param string $rating 内容评级
 * @return string 头像URL
 */
function getGravatarUrl($email, $size = 80, $default = 'retro', $rating = 'g') {
    $hash = md5(strtolower(trim($email)));
    $params = http_build_query([
        's' => $size,
        'd' => $default,
        'r' => $rating
    ]);
    
    return "https://cdn.gravatar.hydun.com/avatar/{$hash}?{$params}";
}

// 使用示例
$avatarUrl = getGravatarUrl('user@example.com', 200, 'retro', 'g');
echo '<img src="' . $avatarUrl . '" alt="用户头像">';
?>

Py Python 

import hashlib
from urllib.parse import urlencode

def get_gravatar_url(email, size=80, default='retro', rating='g'):
    """生成Gravatar头像URL"""
    email_hash = hashlib.md5(email.strip().lower().encode()).hexdigest()
    params = urlencode({'s': size, 'd': default, 'r': rating})
    return f'https://cdn.gravatar.hydun.com/avatar/{email_hash}?{params}'

# 使用示例
avatar_url = get_gravatar_url('user@example.com', size=200)
print(avatar_url)
# https://cdn.gravatar.hydun.com/avatar/1aedb8d9dc4751e229a335e371db8058?s=200&d=retro&r=g

效果对比

响应时间
50ms
↓ 90%
成功率
99.9%
↑ 15%
下载速度
10x
↑ 10倍

实时加载测试

下方两张头像图片分别使用官方Gravatar和火毅盾加速服务加载，您可以直观感受加载速度差异。

官方Gravatar
官方Gravatar
加载时间: -
火毅盾加速
火毅盾加速
加载时间: -

常见问题

复制成功