thegeeklab/hugo

hugo

Custom image for Hugo

![Build Status]([] ![Quay.io]([] ![Source: Gitea]([] ![License: MIT]([]

镜像概述与主要用途

本镜像为 https://github.com/gohugoio/hugo 静态网站生成器的自定义容器镜像。Hugo 是一款高性能的静态网站生成工具，可快速将 Markdown 等格式的内容转换为静态 HTML 网站。该容器镜像提供了运行 Hugo 的完整环境，简化了静态网站的构建流程，适用于本地开发与自动化构建场景。

核心功能与特性

• 原生支持 Hugo 命令：兼容 Hugo 全部核心命令（如 hugo build 生成网站、hugo server 本地预览等），满足各类静态网站构建需求。
• 轻量级设计：基于精简基础镜像，启动快速且资源占用低，适合集成到资源受限的环境。
• 目录挂载支持：可通过挂载本地目录实现项目文件实时同步，便于开发调试与文件管理。
• 多平台兼容：支持 Docker Hub 与 Quay.io 等主流容器仓库，适配多种部署环境。

使用场景与适用范围

• 本地开发环境：开发者可通过容器快速启动 Hugo 服务，实时预览网站效果（如 hugo server）。
• CI/CD 流水线：集成到自动化构建流程（如 GitHub Actions、GitLab CI），实现静态网站的自动构建与部署。
• 静态网站生成：博客作者、文档维护者可使用该镜像构建个人博客、技术文档、产品手册等静态站点。

使用方法与配置说明

基础使用示例

1. 构建静态网站

将本地 Hugo 项目目录挂载到容器，运行 hugo build 生成静态文件（默认输出至 public 目录）：

bash
# 当前目录为 Hugo 项目根目录
docker run --rm -v $(pwd):/src thegeeklab/hugo hugo build

2. 本地实时预览

启动 Hugo 开发服务器，通过 -p 映射端口实现本地访问（默认监听容器内 1313 端口）：

bash
docker run --rm -v $(pwd):/src -p 1313:1313 thegeeklab/hugo hugo server --bind 0.0.0.0

访问 http://localhost:1313 即可实时预览网站。

高级配置参数

Hugo 命令行参数可直接通过容器命令传递，常用参数包括：

许可证

本项目采用 MIT 许可证，详情参见 LICENSE 文件。