Favicon Embed

用一个可热链的 URL 嵌入任意网站的 Favicon——直接放进 <img>、CSS 或 Markdown。无需 API key、无需自建托管,CDN 缓存。

接口

GET https://favicon.run/favicon

参数

domain
必填。网站主机名或完整网址,如 github.com 或 https://github.com/path,会自动归一化为主机名。
sz
可选。图标像素尺寸,限制在 16–512 之间,默认 32。

请求示例

https://favicon.run/favicon?domain=github.com&sz=128

预览你的 embed

输入任意域名,预览它的 Favicon——直接由 URL 嵌入。

尺寸
github.com Favicon
嵌入 URL
https://favicon.run/favicon?domain=github.com&sz=128

如何嵌入

HTML
<img src="https://favicon.run/favicon?domain=github.com&sz=128" alt="GitHub" width="32" height="32" />
JavaScript
const res = await fetch("https://favicon.run/favicon?domain=github.com&sz=128");
const blob = await res.blob();
Markdown
![GitHub](https://favicon.run/favicon?domain=github.com&sz=128)

响应

直接返回 favicon 图片(通常为 image/png)。响应通过 Cache-Control: public, max-age=86400 缓存 24 小时,并以 Access-Control-Allow-Origin: * 返回,可从任意源请求。错误码:域名缺失/非法返回 400,上游获取失败返回 500。

实际示例

下面每个图标都直接由 API 加载——查看网页源码即可验证。

github.com favicongithub.com · 128px
stripe.com faviconstripe.com · 64px
x.com faviconx.com · 32px
youtube.com faviconyoutube.com · 48px
npmjs.com faviconnpmjs.com · 96px
vercel.com faviconvercel.com · 128px

可以嵌在哪

下面都是嵌入了 Favicon 的真实产品界面——每个图标都是实时的。

链接 / 书签列表

在网址目录、资源页或书签管理器里,给每个链接旁边放上网站图标。

  • github.com
  • stripe.com
  • vercel.com

搜索 & 网址联想

在搜索建议或网址输入联想的下拉里显示目标网站的 Favicon。

git
github.com
giphy.com
gitlab.com

浏览器标签 & 地址栏

在浏览器式的界面里渲染 Favicon——标签页、地址栏或应用内网页视图。

github.com/features

外链标识

在文档、博客或更新日志里给外链标上目标网站的图标。

This doc ships with Vercel, Tailwind CSS, and runs on Cloudflare.

常见问题

Favicon Embed 免费吗?+

免费——无需 API key、无需注册、不收费。想热链多少页面都行。

需要自己托管 Favicon 吗?+

不用。直接在 <img> 标签里引用 API URL,我们会负责获取、服务和缓存图标。

支持哪些尺寸?+

通过 sz 参数支持 16–512 像素。不传则默认 32。

支持 CORS 吗?+

支持。Access-Control-Allow-Origin 为 *,可从任意源的浏览器端 JS 请求图标。

缓存策略是什么,图标多久更新?+

每个响应缓存 24 小时(Cache-Control: public, max-age=86400),所以重复请求又快又省。底层图标按同样周期刷新。

能用于生产 / 高流量场景吗?+

可以。由 CDN 提供并做了充分缓存。流量非常大时,建议你在自己一侧也缓存响应。

准备好动手试试了吗?