Mixcm Avatar 使用文档

Author Avatar
黎明余光 2017年10月28日
  • 在其它设备中阅读本文章

这里是一份说明文档,该项目目前由我维护

介绍

用于对公共头像源的缓存加速,目前支持 QQ 头像、Gravatar 和 Github 头像
服务域名:avatar.mixcm.cn

使用

QQ

调用方式:GET
请求:https://avatar.mixcm.cn/qq/:qq?s=:size
示例:https://avatar.mixcm.cn/qq/776194970?s=100

QQExample QQExample2

Gravatar

调用方式:GET
请求:https://avatar.mixcm.cn/gravatar/:mailmd5?s=:size&d=:default&r=:ratings
示例:https://avatar.mixcm.cn/gravatar/605f8c6c64b8fcd514a0b53c6cc3680c?s=100
https://avatar.mixcm.cn/gravatar/941103ea99514f7c0f8c80df82563957?s=100&d=identicon

GravatarExample GravatarExample2

Github

调用方式:GET
请求:https://avatar.mixcm.cn/github/:username?s=:size
示例:https://avatar.mixcm.cn/github/nexmoe?s=100

GravatarExample

说明

  • 所有缓存时间为 24 小时,超时将会异步更新缓存,此时仍会返回缓存中的数据
  • 首次请求将会被重定向至源站,避免影响加载速度
  • 响应头中 X-Mixcm-Node 代表源站节点,例如 hongkong.0 hongkong.1

Changelog

2018.6.19

  • 全新的 3.0 现已发布(撒花
  • 修好了多个历史悠久的 bug,并进一步解耦

2018.6.2

  • 替换了 SSL 证书
  • 使用更严格的安全策略,启用 HSTS

2018.3.31

  • 支持使用用户名获取 Github 头像

2018.3.25

  • 重构了缓存逻辑,发布 2.0.0 Beta
  • 目前使用 CF,最近可能有点炸,经常换服务器 / 机房

2018.2.20

  • 迁移至香港 Sunnyvision 数据中心(由 @我爱雪碧 赞助)
  • Gravatar 从 secure.gravatar.com 获取

2018.2.9

  • 将证书更换为 AlwaysOnSSL TLS RSA CA G1

2017.12.31

  • 从一个镜像服务器更新 Gravatar
  • 新年快乐!

2017.11.19

  • 再次修复一个潜在的缓存问题

2017.11.18

  • 修复了一个缓存的问题
  • 启用 Opcache
  • 现在会对 Etag 返回 304 了

2017.11.11

  • 完美解决一个异步问题 fastcgi_finish_request()
  • 错误修正和性能改进

2017.10.29

  • 支持参数 d,示例 https://avatar.mixcm.cn/gravatar/fd303d9c4f8952430edcfa6308edca6c?s=52&d=identicon
  • 为了方便部分使用替换域名实现的用户(比如我),额外支持了以下方式: https://avatar.mixcm.cn/gravatar/dis{$d}/{$mailmd5}?s={$size}
  • 更好的异步更新策略
  • 依然不支持 r 参数,如有需要,请在此回复

本文链接:https://blog.lim-light.com/archives/mixcm-avatar-cache-doc.html
本文采用 CC BY-NC-SA 3.0 Unported 协议进行许可

    鱼鱼
    鱼鱼  2017-12-19, 21:03

    楼主能出一个调用教程嘛,,有点不知道这么调用QQ头像,