mbentley/hugo

mbentley/hugo

概述

mbentley/hugo是基于Alpine Linux的Hugo静态网站生成器Docker镜像。Hugo是一款快速高效的静态网站生成工具，该镜像封装了Hugo的完整功能，可用于开发环境实时预览和生产环境静态网站构建。

核心功能与特性

• 轻量级基础：基于alpine:latest，镜像体积小，资源占用低
• 完整Hugo功能：包含Hugo全部命令，支持静态网站生成、主题管理、内容处理等
• 开发支持：内置开发服务器，可实时预览网站修改
• 权限控制：支持通过用户ID/组ID设置文件权限，避免容器内操作生成root权限文件

使用场景

• 开发环境：运行Hugo开发服务器，实时预览网站效果
• 生产构建：生成优化后的静态网站文件，用于部署到Web服务器

使用方法

拉取镜像

bash
docker pull mbentley/hugo

查看帮助信息

bash
docker run -it --rm mbentley/hugo --help

运行开发服务器

启动Hugo开发服务器，实时预览网站（默认端口1313）：

bash
docker run -it --rm \
  -u "$(id -u):$(id -g)" \
  -p 1313:1313 \
  -w "${PWD}" \
  -v "${PWD}":"${PWD}" \
  mbentley/hugo server \
  --bind 0.0.0.0

参数说明：

• -u "$(id -u):$(id -g)"：指定当前用户ID和组ID，避免文件权限问题
• -p 1313:1313：映射容器1313端口到本地，用于访问开发服务器
• -w "${PWD}"：设置工作目录为当前目录
• -v "${PWD}":"${PWD}"：挂载当前目录到容器，实现文件同步
• --bind 0.0.0.0：允许外部访问开发服务器

构建网站

生成生产环境静态网站文件：

bash
docker run -it --rm \
  -u "$(id -u):$(id -g)" \
  -w "${PWD}" \
  -v "${PWD}":"${PWD}" \
  mbentley/hugo \
  -v

参数说明：

• -v：启用详细输出，显示构建过程信息

注意事项

• 文件权限：必须使用-u "$(id -u):$(id -g)"参数指定当前用户ID和组ID，否则生成的文件可能会属于root:root，导致本地文件权限问题。
• 目录挂载：确保本地工作目录正确挂载到容器，否则Hugo无法访问网站源文件。