forestryio/hugo

镜像概述

forestryio/hugo镜像为Hugo静态网站生成器提供容器化运行环境，允许用户在不本地安装Hugo的情况下，通过Docker容器执行Hugo相关命令，便捷地构建、预览静态网站。

核心功能与特性

• 容器化Hugo环境：无需在本地系统安装Hugo，直接通过Docker容器运行Hugo命令
• 版本指定：支持通过环境变量HUGO_VERSION指定使用的Hugo版本
• 目录挂载：可将本地网站项目目录挂载到容器内，实现文件共享与操作
• 轻量便捷：基于官方Hugo构建，镜像体积小，启动快速

使用场景与适用范围

• 开发者本地快速构建静态网站
• CI/CD流程中集成Hugo构建步骤
• 多环境一致性测试（不同Hugo版本）
• 临时预览或演示静态网站项目

使用方法与配置说明

基本使用命令

bash
docker run --rm -it -v $PWD:/opt/buildhome -e HUGO_VERSION=version docker.xuanyuan.run/forestryio/hugo:latest hugo

参数说明：

• --rm：容器退出后自动删除容器
• -it：以交互式终端模式运行，支持命令行交互
• -v $PWD:/opt/buildhome：将当前工作目录（本地网站项目目录）挂载到容器内的/opt/buildhome目录，Hugo将在此目录下执行操作
• -e HUGO_VERSION=version：设置环境变量指定Hugo版本（如0.111.3），若不指定则使用默认版本
• forestryio/hugo:latest：镜像名称及标签
• hugo：要执行的Hugo命令（可替换为其他Hugo命令，如hugo server、hugo new等）

常用命令示例

1. 构建静态网站

在本地网站项目目录下执行，生成静态文件到public目录：

bash
docker run --rm -v $PWD:/opt/buildhome -e HUGO_VERSION=0.111.3 docker.xuanyuan.run/forestryio/hugo:latest hugo

2. 启动本地预览服务器

启动Hugo开发服务器，监听容器内1313端口，并映射到本地1313端口：

bash
docker run --rm -it -v $PWD:/opt/buildhome -p 1313:1313 -e HUGO_VERSION=0.111.3 docker.xuanyuan.run/forestryio/hugo:latest hugo server --bind 0.0.0.0

注意：使用hugo server时需添加--bind 0.0.0.0，允许外部访问容器内的服务器。

3. 创建新文章

在项目中创建新的Markdown文章：

bash
docker run --rm -v $PWD:/opt/buildhome docker.xuanyuan.run/forestryio/hugo:latest hugo new posts/my-first-post.md