jojomi/hugo

docker-hugo

hugo静态页面生成器（[***]

镜像概述和主要用途

本镜像提供了hugo静态网站生成器的容器化部署方案。hugo是一款快速高效的静态网站生成工具，通过本镜像可便捷地在容器环境中构建、预览和部署静态网站，支持自定义配置和自动化构建流程。

核心功能和特性

环境变量

• HUGO_THEME：指定网站使用的主题
• HUGO_WATCH：设置任意值以启用文件监听（文件变化时自动重新构建）
• HUGO_DESTINATION：网站渲染输出路径，默认值为/output
• HUGO_REFRESH_TIME：非监听模式下的定期构建间隔（秒），未设置时容器将构建一次后退出
• HUGO_BASEURL：网站的基础URL

镜像特点

• 基于Alpine构建，镜像体积仅约20MB，资源占用低
• 支持文件监听和定期自动构建，满足动态内容更新需求
• 灵活的目录挂载，便于源码管理和输出文件持久化

使用场景和适用范围

• 开发者快速构建和预览静态网站
• CI/CD流程中集成静态网站生成步骤
• 需要定期更新内容的静态网站部署（如博客、文档站点）
• 多环境一致的静态网站构建环境

使用方法和配置说明

基本运行命令

bash
docker run --name "my-hugo" -P -v $(pwd):/src jojomi/hugo

详细运行命令（含输出目录映射）

bash
docker run --name "my-hugo" --publish-all \
       --volume $(pwd):/src \  # 挂载本地源码目录到容器内/src
       --volume /tmp/hugo-build-output:/output \  # 挂载输出目录
       jojomi/hugo

查看运行中的容器

bash
docker ps | grep "my-hugo"

输出示例：

CONTAINER ID        IMAGE                           COMMAND                CREATED             STATUS              PORTS                   NAMES
ba00b5c238fc        jojomi/hugo:latest   "/run.sh"              7 seconds ago       Up 6 seconds        1313/tcp      my-hugo

docker-compose配置示例

与nginx结合部署静态网站

docker-compose.yml

yaml
hugo:
  image: jojomi/hugo:latest
  volumes:
    - ./src/:/src  # 本地源码目录
    - ./output/:/output  # 输出目录
  environment:
    - HUGO_REFRESH_TIME=3600  # 每3600秒（1小时）重新构建
    - HUGO_THEME=mytheme  # 使用名为mytheme的主题
    - HUGO_BASEURL=mydomain.com  # 网站基础URL
  restart: always

web:
  image: jojomi/nginx-static
  volumes:
    - ./output:/var/www  # 将hugo输出目录挂载到nginx服务目录
  environment:
    - VIRTUAL_HOST=mydomain.com  # 虚拟主机名（用于反向代理）
  ports:
    - 80
  restart: always

配合jwilder/nginx-proxy实现反向代理

docker-compose.yml

yaml
proxy:
  image: jwilder/nginx-proxy
  ports:
    - 80:80
    - 443:443
  volumes:
    - /var/run/docker.sock:/tmp/docker.sock  # 监听Docker事件
    - vhost.d:/etc/nginx/vhost.d:ro  # 虚拟主机配置
  restart: always

自行构建镜像（可选）

bash
docker build -t jojomi/hugo:latest .

构建完成后可查看镜像信息：

bash
docker images | grep hugo

输出示例：

jojomi/hugo:0.18   latest              b2e7a8364baa        1 second ago      21.9 MB

创建新标签

1. 创建新的Git分支
2. 修改Dockerfile中的ENV HUGO_VERSION=0.18行，更新为目标版本号
3. 在Docker Hub中配置相应的标签构建规则

更新Hugo版本

执行以下命令更新镜像中的Hugo版本（将0.25替换为目标版本）：

bash
./update.sh 0.25