> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 友链页

> 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 友情链接

`/links` 页面的配置。友链数据本身由「链接管理」插件管理，这里控制展示方式、申请流程与说明文案。

## 配置项

### 功能开关

| 选项       | 默认值 | 说明                            |
| -------- | --- | ----------------------------- |
| 显示评论     | 开启  | 页面底部显示评论区（需评论插件）              |
| 显示申请友链按钮 | 开启  | 流程卡片下方显示按钮，点击弹出申请表单；需插件开启访客提交 |
| 显示随机访问按钮 | 开启  | 标题右侧随机跳转到一个友链                 |
| 随机访问分组   | 空   | 每行一个分组名，留空表示所有分组参与            |
| 显示搜索框    | 开启  | 列表上方搜索框，输入即筛选**当前页**的友链       |

### 我的博客信息

| 选项     | 默认值  | 说明    |
| ------ | ---- | ----- |
| 博客头像   | 示例地址 | 供访客复制 |
| 博客名称   | 博客名称 | —     |
| 博客描述   | 示例描述 | —     |
| 博客网址   | 示例地址 | —     |
| RSS 地址 | 示例地址 | —     |

> 这一组是给**申请友链的访客**看的：他们需要按这里的字段把本站加到自己的友链页。

### 申请友链流程

最多 5 步，每步包含标题与说明（说明支持 HTML）。默认三步：添加本站友链 → 评论留言 → 等待审核。填写几步就显示几步。

### 折叠面板

自定义折叠项，每项包含标题、图标、正文（支持 HTML）。默认为「友链须知」与「免责申明」。

## 推荐配法

**标准友链页**：开启评论、申请按钮、随机访问与搜索；申请流程保留默认三步；折叠面板保留「友链须知」，删掉冗长的免责申明。

**不接受申请**：关闭申请按钮，删除申请流程，只保留列表与搜索，页面更像「友情链接收藏夹」。

**分组很多**：开启随机访问并限制到指定分组（每行一个分组名），避免随机跳到已失效的友链。

## 注意事项

- 友链数据来自链接管理插件，**主题不存储友链**；插件停用后页面会为空
- 申请按钮依赖插件开启访客提交；未开启时按钮仍可能出现，但提交会失败
- 搜索只筛选当前页已渲染的友链，不跨页搜索
- 页脚的友情链接卡片墙是另一套设置（[页脚](/ethereal/site/footer.md)），与此页互不影响
- 「我的博客信息」不会自动读取站点设置，换域名后需要手动同步