jakejarvis/hugo-extended

✏️ Hugo Extended Docker镜像

一个便于Hugo网站本地开发的基础镜像，包含Hugo Extended（支持SASS/SCSS）和可选第三方工具。现已支持多架构镜像，原生支持AMD64和ARM64！

核心功能和特性

• Hugo Extended支持：包含SASS/SCSS编译功能，满足高级样式需求
• 多架构支持：原生支持AMD64和ARM64架构，适配不同硬件环境
• 丰富工具集：内置多种第三方开发工具，无需额外安装
• 开发友好：预配置开发环境，快速启动Hugo服务

使用场景

• Hugo静态网站的本地开发和预览
• 需要SASS/SCSS编译功能的Hugo项目
• 依赖PostCSS、Babel等工具的Hugo站点构建
• 跨架构开发环境一致性保障

使用方法

命令行方式

在当前目录启动Hugo实时服务器（http://localhost:1313/）：

bash
docker run -v $(pwd):/src -p 1313:1313 jakejarvis/hugo-extended:latest server --buildDrafts --buildFuture --bind 0.0.0.0

docker-compose配置

创建docker-compose.yml文件：

yaml
version: '3'

services:
  hugo:
    image: jakejarvis/hugo-extended:latest
    ports:
      - 1313:1313
    volumes:
      - ./:/src
    command: server --buildDrafts --buildFuture --bind 0.0.0.0

启动服务：

bash
docker-compose up

注意事项

使用hugo server运行实时服务器时，必须添加--bind 0.0.0.0参数，以解决Hugo、容器和主机之间的网络问题。

第三方软件

Alpine Linux容器中预安装了以下第三方工具，支持Hugo的可选功能：

• https://github.com/postcss/postcss-cli
• https://github.com/postcss/autoprefixer
• Babel
• Pygments
• Asciidoctor
• Pandoc
• Docutils / RST
• https://github.com/sass/dart-sass-embedded%EF%BC%88%E4%BB%85amd64%E6%9E%B6%E6%9E%84%EF%BC%89

同时预装了Node（含NPM和Yarn）、Go（支持Hugo Modules）和Python。

许可证

本项目采用https://github.com/jakejarvis/hugo-docker/blob/master/LICENSE.md%E3%80%82Hugo%E9%87%87%E7%94%A8https://github.com/gohugoio/hugo/blob/master/LICENSE%E8%AE%B8%E5%8F%AF%E8%AF%81%E3%80%82