多源并发探测

无论用户在哪注册
总能拿到真实头像

并发探测 Gravatar、Cravatar、WeAvatar 与腾讯 QQ 头像，自动返回第一个真实存在的头像；都没有时返回美观占位图。默认最大尺寸,全球缓存加速。

4 个数据源并行
最大 2048 px
缓存 15 天
HTTPS 直连
无 CORS 限制
边缘 200 ms

1快速开始

把 {ID} 替换成 邮箱 MD5 或 QQ 号即可，服务自动识别。

<img src="https://gravatar.bluecdn.com/avatar/{ID}" alt="头像">
邮箱（推荐）

在线计算邮箱小写后的 MD5，并发查 Gravatar / Cravatar / WeAvatar。

/avatar/{md5(email)}
已有 MD5 哈希

32–64 位 hex 字符串，跳过 MD5 计算直接查询。

d5d30d232682e6176045145b20befc5c
QQ 号

5–12 位纯数字，自动从 q.qlogo.cn 拉取（最大 spec=640）。

/avatar/10000

2在线试一下

输入邮箱 / 哈希 / QQ 号，实时预览 + 显示命中的源。

预览
URL …
命中 加载中
缓存 …

3尺寸参数

Gravatar (邮箱 MD5)

用 ?s= 指定边长，1–2048 整数。不传时默认 2048（最大）。

https://gravatar.bluecdn.com/avatar/{HASH}?s=128

QQ 号

QQ 头像源仅支持 4 个固定 spec。本服务自动选择「不小于请求尺寸」的最近值：

请求 s实际取说明
1 – 4040列表头像
41 – 100100聊天窗口
101 – 140140普通展示
141 – 640640高清
不传 / > 640640默认最大

4响应头

X-Avatar-Source 命中的源：gravatar / cravatar / weavatar / qq，-default 后缀代表占位图
X-Cache-Status HIT / MISS / EXPIRED / UPDATING
Cache-Control 真头像 max-age=1296000, immutable（15 天）；占位图 max-age=604800（7 天）
Access-Control-Allow-Origin 始终 *（无 CORS 限制）

5缓存策略

场景边缘缓存浏览器缓存
命中真实头像15 天15 天 + immutable
所有源都没有 → 占位图7 天7 天

强制刷新

带上 ?refresh=1 参数可以跳过 nginx 缓存，立即重新探测所有源。常用于用户刚注册头像后立刻看到效果。

https://gravatar.bluecdn.com/avatar/{ID}?refresh=1
缓存命中真头像 15 天、占位图 7 天，足够长。注册后想立刻看到新头像，加 ?refresh=1 强制重新探测即可。