peaceiris/hugo

镜像概述

peaceiris/hugo-extended-docker是一个基于Alpine Linux的Hugo Docker镜像，专为静态网站构建设计。该镜像包含Hugo extended版本（支持Sass/SCSS等扩展功能）和Hugo Modules支持，发布工作流通过GitHub Actions自动化，镜像同时发布于Docker Hub和GitHub Packages（ghcr.io/peaceiris/hugo）。

核心功能与特性

• 轻量基础：基于Alpine Linux，镜像体积小，资源占用低
• 完整支持：内置Hugo extended版本，支持Sass/SCSS编译、PostCSS等扩展功能
• 模块管理：原生支持Hugo Modules，便于依赖管理和版本控制
• 自动化发布：通过GitHub Actions实现构建与发布自动化，确保版本更新及时
• 多平台可用：镜像同时发布于Docker Hub和GitHub Packages，适配不同环境需求

使用场景

• 静态网站本地开发环境快速部署
• CI/CD流程中集成Hugo构建步骤（如GitHub Actions、GitLab CI等）
• 多环境一致性保障，避免本地与生产环境依赖冲突

使用方法### 拉取镜像

可从Docker Hub或GitHub Packages拉取最新版本：

bash
# 从Docker Hub拉取
docker pull peaceiris/hugo-extended:latest

# 从GitHub Packages拉取
docker pull ghcr.io/peaceiris/hugo:latest

基本构建命令

在当前Hugo项目目录下运行构建命令：

bash
# 构建静态网站（输出至public目录）
docker run --rm -v $(pwd):/src peaceiris/hugo-extended:latest hugo

# 启动开发服务器（实时预览，绑定所有网络接口）
docker run --rm -v $(pwd):/src -p 1313:1313 peaceiris/hugo-extended:latest hugo server --bind 0.0.0.0

Docker Compose配置示例

创建docker-compose.yml文件简化本地开发：

yaml
version: '3'
services:
  hugo:
    image: peaceiris/hugo-extended:latest
    volumes:
      - ./:/src  # 挂载当前目录至容器内/src
    ports:
      - "1313:1313"  # 映射开发服务器端口
    command: hugo server --bind 0.0.0.0 --buildDrafts  # 包含草稿内容构建

启动服务：

bash
docker-compose up

更多信息

完整文档及版本历史请参考GitHub仓库：
https://github.com/peaceiris/hugo-extended-docker

GitHub Packages镜像地址：
https://github.com/users/peaceiris/packages/container/package/hugo