Skip to content

自定义背景

控制整个站点的背景图片来源及模糊程度。

支持三种来源:直接使用图片链接、本地上传(仅保存在用户浏览器本地)、以及 Pixaroa 随机图服务。

配置位置

在站点根目录的 hugo.toml 中设置:

toml
[params.theme]
  # 说明:设置首次访问时默认使用的背景来源。
  # 可选值:
  #   - 'url'   (默认):使用用户填写的图片链接(如有)。
  #   - 'upload':使用用户上传的本地图片(仅限该用户浏览器可见)。
  #   - 'pixaroa':使用 Pixaroa 随机图服务。
  defaultBackgroundProvider = 'url'

  # 说明:如果你想使用 Pixaroa 服务,需要在这里设置服务地址(base URL)。
  # 注意:留空将无法使用 Pixaroa。
  # 你可以填写:
  #   - https://pixaroa.example.com/   (推荐:以 / 结尾)
  #   - /pixaroa/                      (同域反向代理路径;同样建议以 / 结尾)
  pixaroaHost = 'https://your-pixaroa-api.com/'

功能说明

  • 背景模糊:设置面板提供了一个专门的滑动条,用于调节背景图本身的模糊度。这与“玻璃质感”的模糊是相互叠加的。
  • 上传功能:这里的“上传”并不会把图片发到你的服务器,而是利用浏览器的本地数据库(IndexedDB)保存在用户自己的电脑上,保护隐私且不占服务器流量。

优先级规则

  1. 用户本地配置:用户在面板里填写的 URL、上传的图或选择的 Pixaroa 设置优先级最高。
  2. 站点配置:默认来源由 defaultBackgroundProvider 决定。