fundor333/hugo

fundor333/hugo

镜像概述和主要用途

fundor333/hugo 是一个基于Docker的基础镜像，用于通过 Hugo 生成静态网站，是 publysher/hugo 的衍生版本。该镜像可作为独立服务器运行，也可作为卷镜像供Web服务器使用。作者对原镜像进行了精简，以适用于自动化服务，加速流程 pipeline。

核心功能和特性

• 基于Hugo：集成Hugo静态网站生成器，支持静态网站构建
• 双重运行模式：可作为独立服务器运行，或作为卷镜像与Web服务器配合
• 精简优化：相比原 publysher/hugo 镜像体积更小，适合自动化流程
• 自动构建：构建镜像时自动生成静态网站内容

使用场景和适用范围

• 个人或团队静态网站的生成与部署
• CI/CD自动化流程中的静态网站构建环节
• 需要轻量级部署的静态网站（支持独立运行或配合Nginx等Web服务器）

使用方法和配置说明

目录结构要求

使用该镜像需遵循以下目录结构：

.
├── Dockerfile
└── site
    ├── config.toml  # Hugo配置文件
    ├── content      # 网站内容目录
    │   └── ...
    ├── layouts      # 网站布局目录
    │   └── ...
    └── static       # 静态资源目录
        └── ...

其中 Dockerfile 内容应如下：

dockerfile
FROM fundor333/hugo

构建镜像

基于上述结构，执行以下命令构建网站镜像：

bash
docker build -t my/image .

构建过程中会自动生成静态网站内容。

使用镜像

1. 作为独立服务器运行

最简单的使用方式是直接运行镜像作为独立服务器：

bash
docker run -p 1313:1313 my/image

此命令会启动 hugo server，网站可通过 http://localhost:1313 访问。

若使用 boot2docker，需通过环境变量调整基础URL：

bash
docker run -p 1313:1313 -e HUGO_BASE_URL=http://YOUR_DOCKER_IP:1313 my/image

2. 作为卷镜像与Web服务器配合

可将生成的静态网站内容作为数据卷供Web服务器（如Nginx）使用：

bash
# 创建数据卷容器
docker run -d -v /usr/share/nginx/html --name site-data my/image

# 运行Nginx并挂载数据卷
docker run -d --volumes-from site-data --name site-server -p 80:80 nginx