根类名与状态
| HTML 根类名 | JSON status | 含义 |
|---|---|---|
friendly | "friendly" | 接受友链 |
unfriendly | "unfriendly" | 友链已满/暂不接受(仅格式化标签含义) |
版本号:HTML 根元素 id="v1.0";JSON "version": "1.0";JSON 顶层 "protocol": "friends"。
HTML 格式
<!DOCTYPE html><html lang="en">
<head><meta charset="UTF-8"><title>Friends</title>
<link rel="friends" type="application/json" href="/.well-known/friends.json"></head>
<body>
<div class="friendly" id="v1.0">
<a class="name link" href="https://example.com" lang="en">Example Site</a>
<!-- desc:short / long / 不区分(省略 data-length) -->
<span class="desc" data-length="short" lang="en">Frontend & indie blogging.</span>
<span class="desc" data-length="long" lang="en">A site about frontend and independent blogging.</span>
<a class="logo" href="https://example.com/logo.png"
data-light="https://example.com/logo-light.png"
data-dark="https://example.com/logo-dark.png">Logo</a>
<a class="feed" href="https://example.com/feed.xml" type="application/rss+xml">RSS</a>
<a class="feed" href="https://example.com/atom.xml" type="application/atom+xml">Atom</a>
<a class="sitemap" href="https://example.com/sitemap.xml">Sitemap</a>
<a class="shot" href="https://example.com/screenshot.jpg">Screenshot</a>
<a class="news" href="https://example.com/newsletter">Newsletter</a>
<a class="contact" href="https://example.com/contact">Contact</a>
<data class="cat">tech</data>
<data class="cat">indieweb</data>
<data class="sub" lang="en">frontend</data>
<data class="themecolor" data-light="#f5f5f5" data-dark="#1a1a1a"></data>
<data class="loc">footer</data>
<data class="loc">sidebar</data>
<data class="frdrank">5</data>
</div>
<!-- <div class="unfriendly" id="v1.0">
<p>Friends list is full. Not accepting new applications.</p>
</div> -->
</body>
</html>/.well-known/friends.json
请确保 .well-known/friends.json 可被直接访问,未被托管商或服务器规则隐藏。
{
"protocol": "friends",
"version": "1.0",
"status": "friendly",
"updated": "2026-11-18",
"links": [
{
"name": { "value": "Example Site", "lang": "en" },
"link": "https://example.com",
"desc": {
"short": { "value": "Frontend & indie blogging.", "lang": "en" },
"long": { "value": "A site about frontend and independent blogging.", "lang": "en" }
},
"cat": ["tech", "indieweb"],
"sub": [
{ "value": "frontend", "lang": "en" }
],
"logo": {
"light": "https://example.com/logo-light.png",
"dark": "https://example.com/logo-dark.png"
},
"feed": [
{ "url": "https://example.com/feed.xml", "type": "application/rss+xml" },
{ "url": "https://example.com/atom.xml", "type": "application/atom+xml" }
],
"sitemap": "https://example.com/sitemap.xml",
"shot": "https://example.com/screenshot.jpg",
"news": "https://example.com/newsletter",
"contact": "https://example.com/contact",
"themecolor": { "light": "#f5f5f5", "dark": "#1a1a1a" },
"loc": ["footer", "sidebar"],
"frdrank": 5
}
]
}字段值规范
name— 站点名称
非空纯文本;HTML 用lang属性(BCP 47),JSON 用{ "value": "...", "lang": "..." }。link— 站点链接
完整 URL,协议限http或https,必须含域名。desc— 简介
纯文本,可带data-length="short"或data-length="long",省略表示不区分;语言标注同name。JSON 中desc可为{short, long}对象或单一{value, lang}。cat— 标准化分类
合法值:
personal,tech,design,writing,art,life,academic,news,community,archive,indieweb,open-source,security,privacy,devops,frontend,backend,fullstack,mobile,ai,data,science,math,philosophy,history,language,education,finance,health,food,travel,photography,film,music,books,gaming,sports,craft,garden,pets,parenting,fashion,politics,environment,space,hardware,linux,windows,apple,android,web,accessibility,decentralization,selfhosted,minimalism,productivity,career,miscsub— 自定义子类
任意语言文本,通过lang标注语言;消费方忽略未知值。logo— Logo 链接
单一完整 URL 表示不区分;或data-light/data-dark各一个完整 URL。feed— Feed 源链接
完整 URL +type属性,type合法值:application/rss+xml、application/atom+xml、application/feed+json、application/json。可多个。sitemap/shot/news/contact
各为完整 URL,须含协议和域名。themecolor— 主题色
单一十六进制值表示不区分;或data-light/data-dark各一个十六进制值(#加 3 或 6 位)。loc— 展示/巡查位置
合法值仅五个:header、footer、nav、sidebar、content。可多个。frd*— 自定义扩展
HTML:data-frd*属性,如data-frdrank;JSON:frd*键,如"frdrank"。后缀为小写字母或数字;值类型不限;消费方忽略不认识的扩展。
字段总表
| HTML 类名 | JSON 键 | 合法值/内容 | 可选性 |
|---|---|---|---|
friendly / unfriendly | status | friendly 或 unfriendly | 必需 |
id="v1.0" | version | "1.0" | 必需 |
| — | protocol | "friends" | 必需 |
name | name | 非空文本 + lang | 必需 |
link | link | 完整 URL(http/https) | 必需 |
desc | desc | 文本 + lang,可带 data-length | 可选 |
cat | cat | 上述合法值,可多个 | 可选 |
sub | sub | 任意语言文本 + lang | 可选,可多个 |
logo | logo | 完整 URL 或 {light,dark} | 可选 |
feed | feed | 完整 URL + type | 可选,可多个 |
sitemap | sitemap | 完整 URL | 可选 |
shot | shot | 完整 URL | 可选 |
news | news | 完整 URL | 可选 |
contact | contact | 完整 URL | 可选 |
themecolor | themecolor | 十六进制或 {light,dark} | 可选 |
loc | loc | header/footer/nav/sidebar/content | 可选,可多个 |
data-frd* | frd* | 自定义,后缀小写字母数字 | 可选 |
发现机制
| 发布方式 | 发现入口 |
|---|---|
| 仅 HTML | 页面中 class="friendly" 或 class="unfriendly" 的元素 |
| 仅 JSON 或兼备时表明 JSON 优先 | <link rel="friends" type="application/json" href="/.well-known/friends.json"> |
| 两者均发布 | 同上,HTML 与 JSON 内容应一致 |
此草案暂为提案性质,未在 microformats wiki 或 IANA 注册。

用 .well-known/friends.json 统一友链协议挺实用,规范化后交换链接会省不少事。
是的,方便机器读取嘛,复制粘贴这种耗时的事情腾出来交给 AI 来做就好
GB2026友链标-0001号。
独立网站的事,强制就夸张了哈哈哈,这个我准备去独立网站的社区发一发,不过我估计没有人鸟嘻嘻嘻,外国不是有 Blog Roll 文化和友链差不多吗~
创意不错
随便搞的,玩一玩,因为查了这个需求可能比较小众还是,没有现成的,我打算在我的博客友链页面发试试,显示请查看源码就好,不是很喜欢把这些个信息显示出来占位置,也简单考验一下基本能力(查看源码应该不算难。。。吧?)
咦,是自定义标准吗,第一次听说
最近随便做的一个小提案,不是很完善,但是我能想到的就这些了,估计也推广不起来,就当玩玩吧~