# 友链管理 (/docs/use/friends)

友情链接（友链）是博客之间互相推荐的方式。Mix Space 支持完整的友链管理流程：添加、审核、健康检查、自动头像转内链。

## 管理友链

登录后台，进入「友链」页面。你可以：

| 操作 | 说明 |
|------|------|
| **新增友链** | 点击右上角「+」，填写友链信息后保存 |
| **编辑友链** | 点击友链条目进入编辑 |
| **删除友链** | 删除不再需要的友链 |
| **审核友链申请** | 在「审核中」标签页查看并审批申请 |

### 友链状态

| 状态 | 说明 |
|------|------|
| 已通过 | 正常展示在友链列表中 |
| 审核中 | 等待站长审批的友链申请 |
| 已过期 | 友链已过期 |
| 已屏蔽 | 被手动屏蔽的友链 |
| 已拒绝 | 审核未通过的友链 |

### 友链类型

| 类型 | 说明 |
|------|------|
| **友链（Friend）** | 普通友情链接 |
| **收藏（Collection）** | 收藏的站点链接 |

## 友链申请

如果开启了友链申请功能，访客可以通过前端页面提交友链申请。

### 开启友链申请

进入后台「设置 → 内容 → 友链设置」，打开「允许申请友链」开关。

### 申请流程

<Steps>
<Step>
### 访客提交申请

访客在前端友链页面填写站点名称、URL、头像、描述和邮箱（可选），提交申请。
</Step>

<Step>
### 站长收到通知

系统会通过邮件（如已配置）通知站长有新的友链申请。
</Step>

<Step>
### 站长审批

在后台「友链」页面的「审核中」标签查看申请：
- 点击「通过」审批友链
- 点击「拒绝」可填写拒绝理由，系统会通过邮件发送给申请者
</Step>
</Steps>

<Callout type="info">
审核通过后，系统会自动通过邮件通知申请者（前提是申请者填写了邮箱且邮件服务已配置）。
</Callout>

## 友链配置项

进入后台「设置 → 内容 → 友链设置」：

| 配置项 | 说明 |
|--------|------|
| **允许申请友链** | 开启后前端展示友链申请入口 |
| **允许子路径友链** | 允许申请子路径形式的友链（如 `example.com/blog`） |
| **友链头像转内链** | 审核通过后自动下载友链头像到本地，避免外部头像加载失败 |

### 头像转内链

打开「友链头像转内链」后，当友链审核通过时，系统会自动下载该友链的头像文件并存储到本地。这样即使原始头像链接失效，你的友链页面仍然可以正常显示头像。

<Callout type="warn">
头像转内链仅支持常见图片格式（JPEG、PNG、WebP、GIF 等），其他格式的头像不会被转换。
</Callout>

## 友链健康检查

在后台友链页面，点击「健康检查」按钮，系统会批量检测所有已通过友链的可达性。不可达的友链会被标记，方便你及时清理失效链接。

## 头像批量迁移

如果你在后期才开启头像转内链功能，已有友链的头像仍然是外部链接。在友链页面点击「迁移头像」按钮，可以批量将所有已通过友链的外部头像下载到本地。