For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /ethereal/site/performance.md.
楠枝文档中心

    速度优化

    适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 速度优化 → 图片处理

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

    配置项

    选项默认值说明
    图片处理服务不处理Halo 内置 / 阿里云 ESA·DCDN / 阿里云 OSS / 腾讯云 EdgeOne / 腾讯云 COS / 七牛云 / 又拍云 / 自定义
    自定义参数格式空仅自定义模式。用 {width} 作为宽度占位符，如 ?image_process=resize,w_{width}
    首页卡片封面宽度400建议 300800；400 / 800 两档按屏幕自适应，超过 800 时作为顶档（02000）
    文章页图片宽度1200建议 8002000；0 表示原图（02000）
    Banner 图片宽度19200 表示原图不分档；其余档位 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 面板确认图片实际宽度变化，不要只看设置项