> 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 ｜ 后台路径：主题设置 → 速度优化 → 图片处理

对封面、正文图片、Banner、头像做实时压缩与缩放，减少带宽。原理是给图片地址附加服务商的处理参数，不改变原图。

## 配置项

| 选项          | 默认值  | 说明                                                                         |
| ----------- | ---- | -------------------------------------------------------------------------- |
| 图片处理服务      | 不处理  | Halo 内置 / 阿里云 ESA·DCDN / 阿里云 OSS / 腾讯云 EdgeOne / 腾讯云 COS / 七牛云 / 又拍云 / 自定义 |
| 自定义参数格式     | 空    | 仅自定义模式。用 `{width}` 作为宽度占位符，如 `?image_process=resize,w_{width}`             |
| 首页卡片封面宽度    | 400  | 建议 300~~800；400 / 800 两档按屏幕自适应，超过 800 时作为顶档（0~~2000）                       |
| 文章页图片宽度     | 1200 | 建议 800~~2000；0 表示原图（0~~2000）                                               |
| Banner 图片宽度 | 1920 | 0 表示原图不分档；其余档位 400 / 800 / 1200 / 1600 按屏幕选择（0\~3840）                      |
| 头像尺寸        | 512  | 建议 512；0 表示原图（0\~512）                                                      |

## 各服务商选择

| 图片存放位置         | 选择             | 前置条件             |
| -------------- | -------------- | ---------------- |
| Halo 内置附件存储    | Halo 内置附件存储    | 无                |
| 阿里云 ESA / DCDN | 阿里云 ESA / DCDN | 在 ESA 控制台开启图片处理  |
| 阿里云 OSS        | 阿里云 OSS        | 开启 OSS 图片处理      |
| 腾讯云 EdgeOne    | 腾讯云 EdgeOne    | 在 EdgeOne 开启图片处理 |
| 腾讯云 COS        | 腾讯云 COS（数据万象）  | 开启数据万象图片处理       |
| 七牛云            | 七牛云            | 开启图片处理           |
| 又拍云            | 又拍云            | 开启图片处理           |
| 其它 / 自建        | 自定义            | 按服务端格式填写参数模板     |

> **选错服务商不会报错**，只是图片地址带上无效参数，表现为「图裂」或「一直加载」。切换后务必强刷检查。

## 推荐配法

**Halo 内置存储**：选择「Halo 内置附件存储」，卡片 400、文章 1200、Banner 1920、头像 512。正文图片由 Halo 自行处理，主题只压缩封面。

**对象存储 + CDN**：选择对应服务商，宽度按上文默认值。CDN 模式下封面与正文图片都会应用参数。

**只省首屏流量**：卡片封面设 400、Banner 设 1920，文章页图片设 0（保持原图），优先保证正文清晰度。

**自建图床**：选「自定义」，按图床支持的格式填写，例如 `?x-oss-process=image/resize,w_{width}`。

## 注意事项

- **只能缩小，不能放大**：原图宽度不足时请求宽度会被服务端忽略，不会变模糊
- 0 表示不压缩；把卡片封面设为 0 会让移动端也下载原图，通常不建议
- 内部存储模式下正文图片不走主题参数，宽度由 Halo 自身优化；只有 CDN 模式才同时处理正文图片
- 分档请求由主题按屏幕宽度选择，同一个位置可能请求两种尺寸，属于正常行为
- 开启后建议用浏览器 DevTools 的 Network 面板确认图片实际宽度变化，不要只看设置项