v1.0.0 · 自托管

多站点 Hugo 配置与 一键部署 后台

为仓库内 hugo/ 主题集中管理各站配置与素材,对接 1Panel 建站与证书,完成 Hugo 构建并将静态产物同步到站点目录。

配置中心

产品素材与站点 Config 一一对应,字段严格映射 Hugo 主题,导出标准 hugo.toml。

发布即部署

发布 Config 后自动入队:1Panel 建站 → Hugo 构建与产物同步 → HTTPS 证书部署。

自动化辅助

按域名 AI 生成草稿、远程同步下载链接、定时巡检生成文章,减少重复手工。

典型流程

从素材到上线

以「产品 → Config → 流水线」为主线;发布后后台自动调度,无需逐步点选。

  1. 准备产品素材

    维护图标、首屏图与下载链接;名称全库唯一,更新会同步关联站点。

  2. 编辑并发布 Config

    手动编辑或按域名 AI 生成 Config 草稿,校对文案后发布。

  3. 站点流水线运行

    自动衔接建站、Hugo 同步与证书;也可在全局面板从任意阶段手动执行。

  4. 线上可访问

    静态文件写入 1Panel 站点目录,列表可回读面板建站与证书实际状态。

Hugo 子项目

面向 App 官网的多主题静态站

仓库内 hugo/ 与 HugoHub 后台配套:运营在 Payload 维护各站 Config 与文章,发布后经流水线生成 Hugo 站点并同步上线。子项目要求 Hugo ≥ 0.160,支持多套视觉截然不同的落地页主题。

minimalpixelcartooncinemaneonapexfolioridge

多主题落地页

themes/ 下 8 套对等主题,各自完整布局与样式;切换站点外观只需改 Config 里的 theme,无需改主题代码。

数据与外观分离

后台 Config 字段一一映射 hugo.toml 的 [params] 与顶级 title;主题模板只读 site.Params,文案与链接不进 Git 硬编码。

TOML · 媒体 · 文章

同步任务写入 hugo.toml、拉取媒体到 assets/images/,Posts 分页落入 content/posts/,清理旧产物后调用 hugo 构建。

静态站与 SEO

构建得到可部署的 public/:首页与功能区块、/posts/ 列表与文章页、法律与联系页;含 canonical、OG、JSON-LD 与 sitemap。

本地预览可在 hugo/ 目录执行 hugo server --theme minimal;生产构建由后台 site-sync 调用 HUGO_BIN 完成,详见 Hugo 文档

功能模块

后台能力一览

面向运营与站群维护:数据模型清晰,批处理与站点流水线分工明确。

内容与数据

  • Product:素材与下载链接;创建 Config 时可继承默认值
  • Config:草稿 / 发布版本,一份文档即一份 hugo.toml
  • Posts:绑定已发布站点的文章,构建时同步至 Hugo

自动化

  • 配置生成:按域名创建草稿(baseURL 去重),可选 DashScope 文案
  • 远程同步:定时拉取 JSON/CSV,探活后更新产品下载链接
  • AI 设置:每日巡检入队生成文章(单站已满 30 篇则跳过)

构建与部署

  • 流水线:site-create → site-sync → cert-deploy,支持阶段切入
  • site-sync:写 TOML、同步资源、Hugo 构建并复制 public/
  • 产物路径:/opt/1panel/www/sites/{domain}/index

基础设施

  • 1Panel HTTP API 建站与 SSL;Config 列表可同步面板状态
  • SQLite 本地库,媒体存 media/ 目录
  • 后台基于 Payload CMS 3 与 Next.js 16