Gravatar 反代服务 · gravatar.moao.net

📌 服务说明

本服务反向代理 www.gravatar.com 的头像资源，解决国内访问 Gravatar 速度慢、不稳定等问题。您只需将原有的 Gravatar 域名替换为 gravatar.moao.net，即可享受加速。

✅ 完全兼容 Gravatar 官方 API，支持所有参数（s、d、r 等）
✅ 支持 HTTP / HTTPS，自动跟随源站重定向
✅ 默认开启缓存，减轻源站压力，提升加载速度
✅ 永久免费，仅供个人及开源项目使用

🚀 快速开始

将您网站中 Gravatar 头像的域名替换为：

原地址： https://www.gravatar.com/avatar/e5c6b7d8f9...?s=80&d=mp

新地址： https://gravatar.moao.net/avatar/e5c6b7d8f9...?s=80&d=mp

💡 只需替换域名，其余路径和参数完全保持不变。

支持的所有参数：

s 头像尺寸（像素），如 s=128 d 默认头像类型，如 d=mp、d=identicon r 评级限制，如 r=g、r=pg f 强制使用默认头像 f=y

⚙️ Nginx 配置（服务端）

如果您想自己搭建反代服务，以下是 Nginx 的参考配置。将以下内容添加到您的 nginx.conf 或站点配置文件中。

# 在 server 块中添加以下 location
location /avatar/ {
    # 代理到 Gravatar 官方源
    proxy_pass  https://www.gravatar.com/avatar/;

    # 传递原始请求参数（如 s, d, r 等）
    proxy_pass_request_headers  on;
    proxy_set_header            Host               www.gravatar.com;
    proxy_set_header            X-Real-IP          $remote_addr;
    proxy_set_header            X-Forwarded-For    $proxy_add_x_forwarded_for;
    proxy_set_header            X-Forwarded-Proto  $scheme;

    # SSL 后端验证
    proxy_ssl_server_name       on;
    proxy_ssl_protocols         TLSv1.2 TLSv1.3;

    # 缓存配置（可选，大幅提升性能）
    proxy_cache                 gravatar_cache;
    proxy_cache_key             $scheme$proxy_host$request_uri;
    proxy_cache_valid           200 302 304  30d;
    proxy_cache_valid           404          1m;
    proxy_cache_use_stale       error timeout updating http_500 http_502;
    add_header                  X-Cache-Status $upstream_cache_status;

    # 控制浏览器缓存
    add_header                  Cache-Control "public, max-age=604800";
    add_header                  Expires 7d;
    # 404 单独覆盖
    if ($status = 404) {
            add_header                  Cache-Control "public, max-age=60";
            add_header                  Expires 1m;
    }

    # 超时与缓冲
    proxy_connect_timeout       10s;
    proxy_send_timeout          30s;
    proxy_read_timeout          30s;
    proxy_buffering             on;
}

    # 如果需要缓存，在 http 块中定义缓存区：
    # proxy_cache_path /var/cache/nginx/gravatar levels=1:2 keys_zone=gravatar_cache:100m inactive=30d max_size=5g;

📎 注意事项：

确保 proxy_pass 的 URL 以 /avatar/ 结尾，这样路径会正确拼接。
如果只代理头像，建议只匹配 /avatar/ 路径，不要全站代理。
缓存路径 /var/cache/nginx/gravatar 需要 Nginx 进程有写权限。
配置完成后执行 nginx -t 检查语法，然后 systemctl reload nginx 生效。

📄 简洁版配置（最小可用）

如果不需要缓存，以下是最简配置：

    location /avatar/ {
    proxy_pass  https://www.gravatar.com/avatar/;
    proxy_set_header  Host  www.gravatar.com;
    proxy_ssl_server_name  on;
    }

将上述配置添加到您的 server 块中，重载 Nginx 即可使用。

❤️ 关于本站

本服务由 moao.net 提供，旨在为开发者社区提供一个稳定、快速的 Gravatar 头像加速节点。如果您在使用中遇到问题，或有意向合作部署，欢迎通过 GitHub 或邮件联系。

⚠️ 本服务仅代理头像资源，不存储任何用户数据，不记录任何个人信息。