woahbase/alpine-hugo

alpine-hugo

镜像概述

alpine-hugo是一个多架构Docker镜像，基于阿尔卑斯Linux构建，集成S6进程管理工具、Hugo静态网站生成器和Pygments代码高亮组件。该镜像旨在提供轻量、高效的静态网站开发与构建环境，支持多种硬件架构，适用于跨平台部署需求。

核心功能和特性

• 多架构支持：提供x86_64、aarch64、armv7l、armhf等架构版本，满足不同硬件平台部署需求。
• 轻量级基础：基于阿尔卑斯Linux，镜像体积小，资源占用低，启动速度快。
• S6进程管理：集成S6进程管理工具，确保容器内服务稳定运行及优雅启停。
• Hugo静态网站生成：内置Hugo静态网站生成器，支持快速构建高性能静态网站。
• Pygments代码高亮：集成Pygments，提供丰富的代码语法高亮功能，增强网站内容展示效果。

使用场景

• 静态网站开发：作为本地开发环境，使用Hugo快速创建和预览静态网站。
• CI/CD集成：在持续集成/部署流程中，用于自动化构建静态网站并生成部署文件。
• 多架构部署：在ARM、x86等不同架构的服务器或设备上部署静态网站服务。
• 演示与测试：快速搭建临时静态网站演示环境，验证网站布局和功能。

使用方法和配置说明

镜像拉取

从Docker Hub拉取最新版本镜像：

bash
docker pull woahbase/alpine-hugo:latest

如需指定架构，可使用对应标签（如x86_64、aarch64等）：

bash
docker pull woahbase/alpine-hugo:x86_64

基本使用

构建静态网站

将本地Hugo网站目录挂载到容器内，执行Hugo构建命令：

bash
docker run --rm -v $(pwd):/site woahbase/alpine-hugo hugo

上述命令会在当前目录（Hugo站点根目录）生成public文件夹，包含构建后的静态网站文件。

本地预览网站

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

bash
docker run --rm -v $(pwd):/site -p 1313:1313 woahbase/alpine-hugo hugo server --bind 0.0.0.0

访问http://localhost:1313即可预览网站，本地文件修改后Hugo会自动重建并刷新预览。

高级配置

自定义Hugo版本

如需使用特定版本Hugo，可通过Docker Hub标签获取对应版本镜像，或在容器内手动安装（需确保权限）。

挂载配置文件

可单独挂载Hugo配置文件（如config.toml）或主题目录，实现配置隔离和复用：

bash
docker run --rm -v $(pwd)/config.toml:/site/config.toml -v $(pwd)/themes:/site/themes woahbase/alpine-hugo hugo

相关链接

• 文档
• https://hub.docker.com/r/woahbase/alpine-hugo
• https://github.com/woahbase/alpine-hugo

维护者：WOAHBase